# FREEEXILE DESIGN REQUEST: World Atmosphere Fog & Depth Parallax Layers

## 1. THÔNG TIN YÊU CẦU (METADATA)

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-CLI-WORLD-BACKGROUND-LAYERS`
- **ID**: `DRQ-20261001-CLI-WORLD-BACKGROUND-LAYERS`
- **Tên Yêu Cầu (Title)**: Lớp Mây Khí Tầng Không & Sương Mù Hắc Ám Thế Giới Mở (World Atmosphere Fog & Depth Parallax Layers)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Client Engine (Lead Client Architect)
- **Department**: Client Engine
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [client/webapp/js/engine/world_renderer.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/world_renderer.js) & [client/webapp/js/engine/fog_of_war.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/fog_of_war.js)
- **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)**: `isometric_animator`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/map/atmosphere/world_fog_noise_texture.png`
- **Target Path**: `client/webapp/assets/map/atmosphere/world_fog_noise_texture.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)**: `< 150KB`
- **Size Budget**: `< 150KB`
- **Yêu Cầu Normal Map (Normal Map Required)**: `NO`
- **Normal Map Required**: `NO`
- **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
Thế giới hoang dã FreeExile là vùng đất bị lưu đày chìm đắm trong sương độc và tà khí ngút trời. Hệ thống render thế giới (World Renderer) cần các lớp chất liệu đồ họa khí quyển:
- **World Fog Noise Texture (Texture Sương Mù Trôi)**: Lớp sương khói mờ ảo trôi lăn tăn trên mặt đất isometric theo hướng gió, tạo cảm giác không gian có chiều sâu và độ ẩm thực tế.
- **Fog of War Edge Vignette (Viền Mờ Màn Sương Chiến Tranh)**: Đường viền chuyển sắc mềm mại giữa vùng đã khám phá (Visible/Explored) và vùng đen chưa thám hiểm (Unexplored), triệt tiêu các vết răng cưa thô ráp của lưới ô tile grid.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Biến thế giới game 2.5D isometric trở nên sống động, ma mị, kích thích tinh thần thám hiểm và cảnh giác trước những mối nguy hiểm rình rập ẩn sau làn sương mù dày đặ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 Atmospheric Overlay |
| **Độ Phân Giải (Resolution)** | `512x512` (Texture sương liền mạch - Seamless Tiling - Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit), `.webp` |
| **Kênh Màu & PBR Mapping** | Alpha Gradient Perlin Noise mờ ảo, không yêu cầu Normal Map |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion mượt mà khi cuộn offset tọa độ UV theo thời gian |
| **Bảng Màu & Hệ Ngũ Hành** | Xám tro sương khói, lam đen u ám, điểm xuyết sắc tím tà khí |
| **Giao Diện Di Động (Safe Area)** | Tối ưu hóa bộ nhớ RAM, kích thước file nén nhỏ gọn |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho texture sương mù |
| **Yêu Cầu Normal Map** | `NO` |

---

## 4. DANH MỤC SẢN PHẨM ĐẦU RA MONG ĐỢI (DELIVERABLES)

- [x] `world_fog_noise_texture.png`
- [x] `fog_of_war_edge_vignette.png`
- [x] `atmosphere_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).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$), lặp liền mạch (Seamless tiling).
- [ ] Không gây drop frame trên màn hình ProMotion 120Hz.
- **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).
- [ ] Lớp khí quyển hòa quyện tự nhiên với mặt đất và kiến trúc hoang dã.
- [ ] 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.
