# FREEEXILE DESIGN REQUEST: Astral Map Device & Boss Arena Terrain Tiles

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SYS-MAP-DEVICE-ARENA`
- **ID**: `DRQ-20261001-SYS-MAP-DEVICE-ARENA`
- **Tên Yêu Cầu (Title)**: Trận Đài Tinh Đồ Nghi 6 Cổng & Địa Hình Sàn Đấu Trường Trảm Ma (Astral Map Device & Boss Arena Terrain Tiles)
- **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)**: [server/world/procedural_map_engine.py](file:///c:/Projects/FreeExile/server/world/procedural_map_engine.py) & [docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `SPRITE`
- **Asset Type**: `Sprite`
- **Mức Độ Ưu Tiên (Priority)**: `HIGH`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `isometric_animator`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/map/map_device_atlas.png`
- **Target Path**: `client/webapp/assets/map/map_device_atlas.png`
- **Kích Thước (Dimensions)**: `512x512` (Must be 2^n)
- **Dimensions**: `512x512` (Must be 2^n)
- **Ngân Sách Dung Lượng (Size Budget)**: `< 2MB`
- **Size Budget**: `< 2MB`
- **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
Tinh Đồ Nghi (Astral Map Device) là đài tế kích hoạt Bí Cảnh 6 Cổng đặt tại trung tâm Sào Huyệt Cá Nhân. Thiết bị gồm 6 khe cắm Tàn Đồ khắc chữ Bát Quái cổ xưa, khi kích hoạt sẽ phóng ra 6 luồng sáng mở ra 6 cổng dịch chuyển vào các vùng đất chết không gian vô tận.
Đồng thời, yêu cầu bổ sung bộ gạch lát sàn Đấu Trường Boss (Boss Arena Floor Tiles) theo 2 trường phái:
- **Biển Dung Nham Hỏa Ngục (Lava Arena)**: Các khối đá nứt toác phát sáng mạch dung nham đỏ rực.
- **Hầm Xương Cổ Quán (Bone Arena)**: Sàn lát từ xương thú hóa thạch và phù điêu phong ấn cổ đại.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác choáng ngợp, kỳ vĩ của không gian vũ trụ Cổ Võ. Khi đứng trước Tinh Đồ Nghi và bước vào Đấu Trường Boss, người chơi cảm nhận rõ rệt áp lực sinh tử và độ nguy hiểm cùng cực của trận chiến.

---

## 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)** | Isometric 2.5D (Tỷ lệ 2:1, góc nghiêng 30 độ) |
| **Độ Phân Giải (Resolution)** | `512x512` (Atlas Tinh Đồ Nghi `512x512` và Tileset Đấu Trường `512x512` - Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.webp` |
| **Kênh Màu & PBR Mapping** | Albedo + Tangent Space Sobel Normal Map + Emissive Core Mask |
| **Tần Số Quét & Khung Hình** | Chuẩn ProMotion 120 FPS ($8.33\text{ ms/frame}$) tối ưu hóa Metal shader |
| **Bảng Màu & Hệ Ngũ Hành** | Hỏa ngục (Đỏ cam dung nham), U minh (Trắng đục xương khô / Lam tím hư vô) |
| **Giao Diện Di Động (Safe Area)** | Tương thích engine culling isometric, footprint collision chính xác |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 2MB` cho toàn bộ bộ sprite và tileset |
| **Yêu Cầu Normal Map** | `YES` (chuẩn Tangent-Space Sobel với kênh Blue mean > 128) |

---

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

- [x] `map_device_atlas.png`
- [x] `map_device_atlas_normal.png`
- [x] `tile_boss_arena_lava.png`
- [x] `tile_boss_arena_bone.png`
- [x] `map_device_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 (< 2MB cho atlas sprite).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$), không méo tỷ lệ isometric.
- [ ] 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).
- [ ] Tái hiện tinh thần Map Device kinh điển nhưng mang hồn cốt Cổ Võ Việt Nam/Á Đông nguyên bản.
- [ ] 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.