# FREEEXILE DESIGN REQUEST: Hideout & Safe Haven Props Set

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SYS-HIDEOUT-SAFEHAVEN-PROPS`
- **ID**: `DRQ-20261001-SYS-HIDEOUT-SAFEHAVEN-PROPS`
- **Tên Yêu Cầu (Title)**: Bộ Prop Trang Trí Sào Huyệt Cá Nhân & Căn Cứ Doanh Trại An Toàn (Hideout & Safe Haven Props Set)
- **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)
- **Phân Loại Tài Nguyên (Asset Category)**: `SPRITE`
- **Asset Type**: `Sprite`
- **Mức Độ Ưu Tiên (Priority)**: `MEDIUM`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `concept_artist`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/map/props/hideout_props_atlas.png`
- **Target Path**: `client/webapp/assets/map/props/hideout_props_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)**: `< 50KB`
- **Size Budget**: `< 50KB`
- **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)**: `72h`

---

## 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
Sào Huyệt Cá Nhân (`zone_player_hideout`) và Doanh Trại An Toàn (`zone_boundless_sanctuary`) là các vùng tuyệt đối an toàn (Safe Haven Purity), nơi quái vật không bao giờ xuất hiện. Đây là không gian riêng để người chơi nghỉ ngơi, tinh luyện công phu, giao lưu và thử nghiệm các cấu hình build võ học.
Bộ props bao gồm:
- **Mộc Nhân Bất Hoại (Target Dummy)**: Bù nhìn gỗ khắc trận đồ bát quái để thử nghiệm combo chiêu thức và đo DPS thực tế.
- **Bàn Trà Cổ Võ (Martial Tea Table)**: Bộ bàn ghế đá thô sơ phủ rêu phong, nơi nhân vật đàm đạo và hồi phục tâm trí.
- **Rương Chứa Cổ Thạch (Ancient Relic Chest)**: Rương rèn từ hợp kim đen viền chỉ bạc để cất giữ di sản.
- **Đài Lửa Tịnh Hóa (Purifying Brazier)**: Đuốc lửa thiêng xua tan tà khí xung quanh doanh trại.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác tĩnh lặng, an yên, đối lập hoàn toàn với sự tàn khốc nơi hoang dã. Từng chi tiết đạo cụ toát lên phong thái ẩn sĩ giang hồ trầm mặc.

---

## 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 gộp các props `128x128`, `256x256` - 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 |
| **Tần Số Quét & Khung Hình** | Chuẩn ProMotion 120 FPS ($8.33\text{ ms/frame}$) tối ưu hóa footprint collision |
| **Bảng Màu & Hệ Ngũ Hành** | Nâu gỗ trầm, xám đá cổ thạch, vàng rơm, ánh lửa cam ấm áp |
| **Giao Diện Di Động (Safe Area)** | Tối ưu hóa bộ nhớ RAM, kích thước file nén cực thấp |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 50KB` cho mỗi prop hoặc `< 150KB` cho atlas tổng |
| **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] `hideout_props_atlas.png`
- [x] `hideout_props_atlas_normal.png`
- [x] `target_dummy_prop.png`
- [x] `hideout_props_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 (< 50KB cho prop, < 150KB cho atlas).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$), footprint collision chân thực.
- [ ] Không gây giật lag khi tương tác vật lý trong sào huyệt.
- [ ] 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).
- [ ] Không gian sào huyệt toát lên chất giang hồ lưu đày mộc mạc.
- [ ] 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.