# FREEEXILE DESIGN REQUEST: Feral Crafting Station UI & Anvil Forge Interface

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SYS-CRAFTING-STATION-UI`
- **ID**: `DRQ-20261001-SYS-CRAFTING-STATION-UI`
- **Tên Yêu Cầu (Title)**: Giao Diện Lò Rèn Cổ Huyết & Bàn Thao Tác Chế Tác Đa Tầng (Feral Crafting Station UI & Anvil Forge)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Systems (Lead Systems Designer)
- **Department**: Systems
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md) & [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)**: `HIGH`
- **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/crafting/crafting_station_panel.png`
- **Target Path**: `client/webapp/assets/ui/crafting/crafting_station_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
Lò Rèn Cổ Huyết (Feral Blood Forge) là trạm chế tác trung tâm trong sào huyệt cá nhân. Người chơi đặt trang bị phôi vào đe rèn, sử dụng các loại Cổ Cốt Huyết Thạch và Thần Thạch Chế Tác (Chaos Reroll, Exalt Slam, Annul, Transmute) để rèn đúc thuộc tính.
Giao diện phải trực quan hóa:
- **Khay Đặt Trang Bị Phôi**: Khe cắm trang bị trung tâm với ánh hào quang hắc ám bao quanh.
- **Bảng Danh Mục 15 Tiers Affix**: Hiển thị tiền tố (Prefixes) và hậu tố (Suffixes) với huy hiệu phân cấp rõ ràng (T1 siêu hiếm viền vàng kim đến T15 viền xám).
- **Phí Vàng Lũy Thừa**: Ô hiển thị lượng vàng tiêu hao tự động tính toán theo cấp phôi $(BaseFee \times (1 + iLvl/25)^{1.6})$.
- **Nút Thao Tác Đập Đá**: Nút bấm mang phong cách khắc đá cổ xưa, có phản hồi thị giác khi búa rèn giáng xuống.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác đanh thép, chắc chắn, hồi hộp kịch tính trong từng cú đập đá chế tác đồ. Bố cục 2 cột cân xứng dễ thao tác bằng ngón cái trên màn hình điện thoại di động.

---

## 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 Dialog Box |
| **Độ Phân Giải (Resolution)** | `1024x512` (Panel chính) kết hợp Atlas biểu tượng `256x256` (Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.webp` (lossy 90% web) |
| **Kênh Màu & PBR Mapping** | Albedo (RGBA 32-bit), giao diện phẳng không yêu cầu Normal Map |
| **Tần Số Quét & Khung Hình** | Chuẩn ProMotion 120 FPS ($8.33\text{ ms/frame}$), hiệu ứng mở modal không giật lag |
| **Bảng Màu & Hệ Ngũ Hành** | Nền đá xám đen, viền sắt rỉ sét cổ phong, điểm nhấn ngọn lửa hỏa ngục đỏ cam |
| **Giao Diện Di Động (Safe Area)** | Tối ưu notch tai thỏ iPhone, vùng nút bấm đập đá $\ge 64\times 64\text{ pt}$ |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho toàn bộ tài nguyên UI |
| **Yêu Cầu Normal Map** | `NO` |

---

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

- [x] `crafting_station_panel.png`
- [x] `crafting_slots_atlas.png`
- [x] `crafting_tier_badges.png`
- [x] `crafting_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 méo tỷ lệ.
- [ ] Không gây drop frame (< 8.33ms/frame trên màn hình ProMotion 120Hz).
- [ ] Bố cục tương thích Dynamic Island và Safe Area trên iOS.
- **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).
- [ ] Tôn vinh nét cổ kính uy nghiêm của Lò Rèn Cổ Huyết.
- [ ] 100% Nguyên bản (Original IP).
- [ ] Trải nghiệm UX chế tác trực quan, cuốn hút.
- **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.