# THIẾT KẾ YÊU CẦU ĐỒ HỌA: HỆ THỐNG 5 HỆ NHÂN VẬT CỔ VÕ HOANG DÃ & ANIMATION TOÀN DIỆN
**Mã yêu cầu**: `DRQ-20260930-MARTIAL-CHARACTER-ECOSYSTEM`  
**Ngày khởi tạo**: 2026-09-30  
**Người khởi tạo**: `poe2_game_designer` & `studio_producer`  
**Bộ phận tiếp nhận**: `concept_artist`, `isometric_animator`, `tech_art_pipeline`, `art_ui_director`  
**Trạng thái**: APPROVED  
**Mức độ ưu tiên**: CRITICAL  

---

## 1. MỤC TIÊU & BỐI CẢNH (OBJECTIVE & CONTEXT)
Dự án FreeExile thiết lập hoàn chỉnh hệ thống 5 loại Thần Binh Cổ Võ và 10 Hệ Phái Thăng Hoa Ngũ Hành (Kim, Mộc, Thủy, Hỏa, Thổ). 

Phòng Thiết kế đã tạo hình đầy đủ **5 Hệ Nhân Vật Cổ Võ Độc Bản (100% Original IP)** mang đậm linh hồn Dark Fantasy Gai Góc (PoE2 Spirit), đi kèm bộ Texture Atlases hoạt ảnh đồng bộ vận tốc (Motion-Matched) cho từng hệ phái:

1. **Kiếm Tu / Kiếm Ma (Void Blade Sovereign - Hệ Kim)**: Vũ khí Thanh Phong Cổ Kiếm (`azure_wind_sword`). Nhanh nhẹn, né tránh, kiếm khí lướt gió.
2. **Cuồng Đao / Huyết Ngục Cuồng Ma (Bloodfire Berserker - Hệ Hỏa)**: Vũ khí Liệt Huyết Cuồng Đao (`infernal_blade`). Thể phách cơ bắp gai góc, chém lan quét sạch diện rộng, hút máu, lửa địa ngục.
3. **Man Xạ Thủ / U Minh Cốt Xạ (Plague Bone Archer - Hệ Mộc)**: Vũ khí Cổ Cốt Xạ Cung (`wpn_feral_bone_bow`). Áo choàng da thú, xạ kích tầm xa, bẫy rập xương gai, tên độc hủ thực.
4. **Thần Thương / Băng Cực Thương Quân (Glacial Lancer - Hệ Thủy/Thổ)**: Vũ khí Thứ Cốt Thần Thương (`wpn_spiked_bone_spear`). Giáp vảy đá rỉ sét bọc băng lam, đâm xuyên giáp, tạo gai băng địa chấn, cản phá quái vật.
5. **U Ảnh Thích Khách / Xà Nha Song Thoa (Twin Fang Stalker - Hệ Lôi/Âm)**: Vũ khí Song Xà Đoản Đao (`wpn_twin_fang_daggers`). Áo choàng đen tuyền phủ mũ trùm, song thoa chớp nhoáng, bạo kích chí mạng, lôi điện cuồng phong.

---

## 2. DANH MỤC SẢN PHẨM BÀN GIAO (DELIVERABLES)
1. **5 Master Character Sprites**: `client/webapp/assets/characters/char_<class>.png` (512x600 RGBA).
2. **5 Tangent-Space Normal Maps**: `client/webapp/assets/characters/char_<class>_normal.png` (PBR Dynamic Lighting).
3. **5 Kinematic Animation Atlases**: `client/webapp/assets/animations/char_<class>_anim_atlas.png` (1280x960 RGBA).
4. **5 Normal Map Atlases**: `client/webapp/assets/animations/char_<class>_anim_atlas_normal.png`.
5. **5 Kinematics Manifest JSON**: `client/webapp/assets/animations/char_<class>_anim_manifest.json`.
6. **Tích hợp UI & Runtime**: 
   - Modal Chọn & Tạo Nhân Vật 5 hệ phái (`client/webapp/index.html`, `js/ui/char_creation.js`).
   - Song Binh Hợp Nhất (Weapon Swap Tab/X) cặp vũ khí đặc thù cho từng hệ phái (`js/engine/iso_math.js`).
   - Bộ render thực thể và vệt bóng tàn ảnh (`js/engine/entity_renderer.js`).
   - Kiểm thử tự hành khép kín TDD (`tests/unit/test_martial_character_ecosystem.py`).

---

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

### Cấp 1: Thẩm Định Kỹ Thuật (QA & Tech Art Audit)
- **Người thẩm định**: `qa_stress_tester` & `tech_art_pipeline`
- **Kết Quả Cấp 1**: `PASS`
- **Ghi Chú Kỹ Thuật**: 
  - Kích thước Texture Atlases 1280x960 RGBA (8x5 grid, mỗi frame 160x192 px), dung lượng < 2MB / atlas tối ưu hóa VRAM Apple Metal / Mobile.
  - Đồng bộ vận tốc chân `foot_speed_sync_formula` triệt tiêu 100% hiện tượng trượt chân (zero foot-sliding).
  - Normal Map Tangent-Space chuẩn OpenGL/Metal (RGB [128, 128, 255] baseline), PBR phản xạ ánh sáng chân thực.
  - Toàn bộ 5 test cases trong `test_martial_character_ecosystem.py` vượt qua 100% (Green).
  - Không vi phạm Hard Cap hygiene (file $\le 500$ dòng).

### Cấp 2: Nghiệm Thu Nghệ Thuật & Thiết Kế (CEO & Art Director Sign-off)
- **Người thẩm định**: `studio_producer` & `art_ui_director`
- **Kết Quả Cấp 2**: `APPROVED`
- **Ý Kiến Phê Duyệt**: 
  - Tạo hình 5 hệ nhân vật toát lên khí chất Cổ Võ Hoang Dã Dark Fantasy gai góc (100% Original IP), phân biệt rõ rệt về hình thái (Silhouettes), vũ khí và phong cách Ngũ Hành.
  - Chuyển động animation nhịp nhàng, có độ giật lực (lunge) và quán tính né tránh (dodge i-frame) tương xứng với tinh thần Path of Exile 2.
  - Phê duyệt đưa vào bản dựng chính thức!