# FREEEXILE DESIGN REQUEST: Passive Tree Interactive Nodes & Constellation Background

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SYS-PASSIVE-TREE-NODES`
- **ID**: `DRQ-20261001-SYS-PASSIVE-TREE-NODES`
- **Tên Yêu Cầu (Title)**: Bộ Biểu Tượng Node Tương Tác Huyết Cốt Ma Đồ & Nền Tinh Đồ Hư Không (Passive Tree Interactive Nodes & Constellation Background)
- **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/ENGINEERING_STANDARDS_2026.md](file:///c:/Projects/FreeExile/docs/standards/ENGINEERING_STANDARDS_2026.md) & [server/world/passive_tree_catalog.py](file:///c:/Projects/FreeExile/server/world/passive_tree_catalog.py)
- **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/passive_tree/passive_node_atlas.png`
- **Target Path**: `client/webapp/assets/ui/passive_tree/passive_node_atlas.png`
- **Kích Thước (Dimensions)**: `1024x1024` (Must be 2^n)
- **Dimensions**: `1024x1024` (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)**: `YES`
- **Normal Map Required**: `YES`
- **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ệ thống Huyết Cốt Ma Đồ (Passive Meridian Tree) là linh hồn phát triển nhân vật của FreeExile với hơn 1.500 nút kinh mạch thể phách đan xen. Người chơi khai mở từng khiếu huyệt để hấp thụ ma khí, chuyển hóa huyết tủy và định hình phong cách võ học. Giao diện đòi hỏi 5 cấp độ icon nổi khối:
- **Small Passive**: Nút kinh mạch phụ tăng chỉ số cơ bản (Khí Huyết, Nội Lực, Thân Pháp).
- **Notable**: Nút yếu huyệt trung cấp mang lại đột phá chỉ số chiến đấu đặc thù.
- **Keystone**: Đại huyệt biến đổi cơ chế toàn diện (đổi máu lấy sát thương, miễn nhiễm sát thương ngũ hành...).
- **Socket Gem**: Khổng khiếu cắm Ma Võ Tàn Cốt hoặc Dị Biến Tà Ấn.
- **Line Connector**: Kinh mạch dẫn khí nối giữa các nút với 2 trạng thái sáng (kích hoạt) và tối (chưa kích hoạt).

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác ma mị, thâm sâu, tối giản nhưng đậm chất Cổ Võ Hắc Ám. Các nút kinh mạch phát sáng nhẹ nhàng (emissive pulse) khi được phân bổ điểm, đường dẫn khí lưu chuyển sống động trên nền trời sao hư vô mờ ảo.

---

## 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 / Interactive Canvas Overlay |
| **Độ Phân Giải (Resolution)** | `1024x1024` (Atlas tổng hợp các node `64x64`, `128x128`, `256x256` - Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.webp` (tối ưu hóa nén web) |
| **Kênh Màu & PBR Mapping** | Albedo (RGBA) + Tangent Space Sobel Normal Map + Emissive Mask |
| **Tần Số Quét & Khung Hình** | Chuẩn ProMotion 120 FPS ($8.33\text{ ms/frame}$) mượt mà khi zoom/pan |
| **Bảng Màu & Hệ Ngũ Hành** | Huyết sắc (Đỏ thẫm ma đạo), Hoàng kim (Keystone), Huyền thanh (Socket) |
| **Giao Diện Di Động (Safe Area)** | Tối ưu cảm ứng mobile, kích thước vùng chạm tối thiểu $\ge 44\times 44\text{ pt}$ |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho Atlas node và texture nền |
| **Yêu Cầu Normal Map** | `YES` (chuẩn Tangent-Space Sobel) |

---

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

- [x] `passive_node_atlas.png`
- [x] `passive_node_atlas_normal.png`
- [x] `passive_node_atlas_emissive.png`
- [x] `constellation_bg.png`
- [x] `passive_nodes_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 icon/atlas).
- [ ] 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).
- [ ] Normal map chuẩn Tangent-Space (Kênh Blue mean > 128).
- **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).
- [ ] Tinh thần PoE2 kịch tính kết hợp Cổ Võ hoang dã.
- [ ] 100% Nguyên bản (Original IP).
- [ ] Bố cục giao diện công thái học mượt mà trên iPhone/iPad.
- **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.