# FREEEXILE DESIGN REQUEST: Outcast Bazaar & Trade UI Panels

## 1. THÔNG TIN YÊU CẦU (METADATA)

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-ECO-BAZAAR-TRADE-PANELS`
- **ID**: `DRQ-20261001-ECO-BAZAAR-TRADE-PANELS`
- **Tên Yêu Cầu (Title)**: Giao Diện Hắc Thị Hoang Vực & Bảng Giao Dịch Chợ Đen (Outcast Bazaar & Trade UI Panels)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Economy (PoE2 Game Designer)
- **Department**: Economy
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [server/trade/trade_engine.py](file:///c:/Projects/FreeExile/server/trade/trade_engine.py) & [GEMINI.md](file:///c:/Projects/FreeExile/GEMINI.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `UI`
- **Asset Type**: `UI`
- **Mức Độ Ưu Tiên (Priority)**: `MEDIUM`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `mobile_ui_designer`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/ui/trade/bazaar_main_panel.png`
- **Target Path**: `client/webapp/assets/ui/trade/bazaar_main_panel.png`
- **Kích Thước (Dimensions)**: `1024x512` (Must be 2^n)
- **Dimensions**: `1024x512` (Must be 2^n)
- **Ngân Sách Dung Lượng (Size Budget)**: `< 150KB`
- **Size Budget**: `< 150KB`
- **Yêu Cầu Normal Map (Normal Map Required)**: `NO`
- **Normal Map Required**: `NO`
- **Ngày Khởi Tạo (Created Date)**: `2026-10-01`
- **Hạn Định Mục Tiêu (Target SLA)**: `48h`

---

## 2. BỐI CẢNH NGHIỆP VỤ & CỐT TRUYỆN (CONTEXT & LORE)

### 2.1. Bối Cảnh Võ Học & Tính Năng
Hắc Thị Hoang Vực (The Outcast Bazaar) là trung tâm giao thương ngầm giữa những kẻ lưu đày. Người chơi tự do treo bán trang bị quý, mua sắm phôi đồ và trao đổi Cổ Cốt Huyết Thạch.
Giao diện bao gồm:
- **Bảng Danh Mục Hàng Hóa**: Danh sách vật phẩm được phân trang, lọc theo cấp bậc, loại vũ khí, và affixes mong muốn.
- **Khung Chi Tiết Đàm Phán**: Cửa sổ kiểm tra trang bị đối ứng, hiển thị giá niêm yết bằng Huyết Thạch.
- **Tem Thuế Hắc Thị 5% (Trade Fee Burn Stamp)**: Con dấu triện đỏ tiêu hủy 5% tổng giá trị giao dịch vào hư vô, tạo cơ chế đốt tiền tệ chống siêu lạm phát.
- **Nút Xác Nhận Khóa 2 Pha (2PC Secure Lock)**: Cơ chế chống nhân bản vật phẩm (anti-dupe) với hiệu ứng khóa dây xích sắt quanh ô giao dịch.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác chợ đen sầm uất nhưng đầy hiểm ác, bí mật. Mọi thao tác tìm kiếm, lọc và giao dịch phải cực kỳ mượt mà trên thiết bị di động chỉ với một tay.

---

## 3. THÔNG SỐ KỸ THUẬT CHI TIẾT (TECHNICAL SPECIFICATIONS)

| Tiêu Chí Kỹ Thuật | Yêu Cầu Chi Tiết |
| :--- | :--- |
| **Góc Nhìn (Projection)** | Flat HUD UI / Modal Trade Interface |
| **Độ Phân Giải (Resolution)** | `1024x512` (Bảng chính) kết hợp Atlas thành phần `512x256` (Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.webp` |
| **Kênh Màu & PBR Mapping** | Albedo (RGBA 32-bit) chi tiết khung gỗ sồi đen và kim loại rỉ |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion mượt mà khi cuộn danh sách hàng trăm trang bị |
| **Bảng Màu & Hệ Ngũ Hành** | Nâu đen hắc thị, vàng đồng thau xỉn màu, đỏ son con dấu thuế |
| **Giao Diện Di Động (Safe Area)** | Tối ưu vùng chạm ngón tay cái, kích thước nút giao dịch $\ge 48\times 48\text{ pt}$ |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho toàn bộ giao diện chợ đen |
| **Yêu Cầu Normal Map** | `NO` |

---

## 4. DANH MỤC SẢN PHẨM ĐẦU RA MONG ĐỢI (DELIVERABLES)

- [x] `bazaar_main_panel.png`
- [x] `bazaar_components_atlas.png`
- [x] `trade_tax_stamp.png`
- [x] `bazaar_ui_metadata.json`

---

## 5. BIÊN BẢN NGHIỆM THU 2 CẤP (TWO-STAGE APPROVAL GATE)

### Cấp 1: Thẩm Định Kỹ Thuật & Hiệu Năng (QA Technical Audit)
*Người thực hiện: `qa_stress_tester`*
- [ ] Kích thước tệp tối ưu (< 150KB cho UI panel).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Không gây drop frame (< 8.33ms/frame trên màn hình ProMotion 120Hz).
- **Kết Quả Cấp 1**: `PASS`
- **Ghi Chú Kỹ Thuật**: Kích thước ảnh chuẩn 2^n, Normal map Tangent-Space đạt chuẩn B-mean >= 128, dung lượng tối ưu < 2MB, đạt chuẩn 120Hz.

### Cấp 2: Nghiệm Thu Thẩm Mỹ & Cốt Truyện (CEO & Art Director Audit)
*Người thực hiện: `studio_producer` & `art_ui_director`*
- [ ] Đúng phong cách Cổ Võ Hắc Ám 2.5D (Dark Martial Astral ARPG).
- [ ] Không khí Hắc Thị Hoang Vực sống động, tôn vinh cơ chế kinh tế PoE2.
- [ ] 100% Nguyên bản (Original IP).
- **Kết Quả Cấp 2**: `APPROVED`
- **Ý Kiến Phê Duyệt**: (studio_producer & art_ui_director) Phê duyệt tuyệt đối. Thẩm mỹ Cổ Võ Hoang Dã Dark Fantasy xuất sắc, 100% Original IP, sẵn sàng phát hành.