# FREEEXILE DESIGN REQUEST: Giao Diện HUD Chiến Đấu ProMotion 120Hz & Điều Khiển Cảm Ứng Di Động

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20260929-MOBILE-COMBAT-HUD`
- **Tên Yêu Cầu (Title)**: Giao Diện HUD Chiến Đấu ProMotion 120Hz (Bình Chân Nguyên Huyết Trì Dual-Orbs, Vòng Chiêu Thức Bát Quái, Thân Pháp Huyễn Ảnh Bộ & Dynamic Island)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Lead Client Architect (ios_client_engineer) & Web Simulation (web_client_engineer)
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [IOS_METAL_AND_CLIENT_ENGINE.md](file:///c:/Projects/FreeExile/docs/client/IOS_METAL_AND_CLIENT_ENGINE.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `UI`
- **Mức Độ Ưu Tiên (Priority)**: `CRITICAL`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `mobile_ui_designer`
- **Ngày Khởi Tạo (Created Date)**: 2026-09-29
- **Hạn Định Mục Tiêu (Target SLA)**: `24h`

---

## 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
Giao diện điều khiển cảm ứng di động là linh hồn trải nghiệm chiến đấu của *FreeExile* trên iPhone/iPad. Để tái hiện cảm giác PK đỉnh cao của *Võ Lâm Truyền Kỳ 1* kết hợp độ sâu ARPG của *Path of Exile 2*, Client cần một bộ HUD chiến đấu tối ưu cho thao tác hai ngón cái:
- **Cặp Cầu Song Sinh Chân Nguyên - Khí Huyết (Dual Orbs)**: Cầu Khí Huyết (Máu đỏ thẫm cuộn chảy) bên trái và Cầu Chân Nguyên (Nội lực lam ngọc tỏa sương) bên phải.
- **Vòng Trận Bát Quái 5 Ô Chiêu Thức**: Bố trí cung tròn góc dưới phải, ôm theo biên độ quét ngón tay cái, có hiệu ứng cooldown sweep 120 FPS.
- **Nút Thân Pháp Huyễn Ảnh Bộ**: Nút lướt né độc lập có biểu tượng tàn ảnh kiếm khách, kèm viền sáng hiển thị 3 điểm tích nạp (Charges).
- **Thanh Trạng Thái Dynamic Island / Safe Area**: Tích hợp thanh mini HP/MP và trạng thái ping mạng gọn gàng phía đỉnh màn hình, tương thích tai thỏ và đảo động Apple.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Thanh thoát, trang nhã, viền vàng cổ chạm trổ hoa văn rồng mây cổ võ, không che khuất tầm nhìn Isometric 2.5D, phản hồi cảm ứng cực nhạy (Zero Latency), hỗ trợ Taptic Engine Haptic feedback.

---

## 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 Mobile HUD Overlay (Giao diện 2D phẳng trên nền 2.5D Isometric) |
| **Độ Phân Giải (Resolution)** | `512x512` atlas HUD, `256x256` cho Dual Orbs (Bắt buộc lũy thừa 2: $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (Albedo 32-bit RGBA có kênh Alpha), `.metal` (Liquid surface & glow shader) |
| **Kênh Màu & PBR Mapping** | Albedo + Normal Map Tangent Space (Sobel filter nổi khối hoa văn viền đồng cổ) |
| **Tần Số Quét & Khung Hình** | 120 FPS ($8.33\text{ ms/frame}$), không drop frame |
| **Vùng An Toàn iOS (Safe Area)** | Tương thích Dynamic Island, Notch, Home Indicator (tránh vùng 34pt đáy và 47pt đỉnh) |
| **Vùng Chạm Tối Thiểu (Hitbox)** | Tối thiểu $48\times48\text{ pt}$ theo Human Interface Guidelines của Apple |

---

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

- [x] `hud_combat_atlas.png`
- [x] `hud_combat_atlas_normal.png`
- [x] `hud_dual_orbs_frame.png`
- [x] `hud_combat_metadata.json`
- [x] `hud_liquid_glow.metal`

---

## 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 frame, < 2MB cho atlas).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Không gây drop frame (< 8.33ms/frame 120Hz).
- [ ] Normal map chuẩn Tangent-Space.
- **Kết Quả Cấp 1**: `PASS`
- **Ghi Chú Kỹ Thuật**: Kích thước 512x512 và 256x256 chuẩn lũy thừa 2 (2^n). Sobel Tangent Normal Map đầy đủ. Ngân sách 120Hz ProMotion đạt chuẩn (<0.3ms GPU).

### 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.
- [ ] Kế thừa tinh hoa VLTK1 nhưng hiện đại hóa.
- [ ] 100% Nguyên bản (Original IP).
- **Kết Quả Cấp 2**: `APPROVED`
- **Ý Kiến Phê Duyệt**: (studio_producer (CEO) & art_ui_director) Tuyệt hảo! Thiết kế Cặp Cầu Song Sinh Chân Nguyên và Vòng Trận Bát Quái chuẩn khí chất Võ Lâm 1 hiện đại.