# FREEEXILE DESIGN REQUEST: AoI Grid Boundary & Network Telemetry Visual Badges

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SRV-AOI-SYNC-TELEMETRY-VISUAL`
- **ID**: `DRQ-20261001-SRV-AOI-SYNC-TELEMETRY-VISUAL`
- **Tên Yêu Cầu (Title)**: Biểu Tượng Chỉ Số Đồng Bộ Khu Vực AoI & Trạng Thái Mạng Tickrate 30Hz (AoI Grid Boundary & Network Telemetry Visual Badges)
- **Phòng Ban Khởi Tạo (Requesting Dept)**: Server & AI Agents (Server Engineer & AI Architect)
- **Department**: Server & AI Agents
- **Tài Liệu Nguồn Căn Cứ (Source Document)**: [server/world/server_engine_loop.py](file:///c:/Projects/FreeExile/server/world/server_engine_loop.py) & [docs/standards/ENGINEERING_STANDARDS_2026.md](file:///c:/Projects/FreeExile/docs/standards/ENGINEERING_STANDARDS_2026.md)
- **Phân Loại Tài Nguyên (Asset Category)**: `UI`
- **Asset Type**: `UI`
- **Mức Độ Ưu Tiên (Priority)**: `LOW`
- **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/telemetry/network_telemetry_atlas.png`
- **Target Path**: `client/webapp/assets/ui/telemetry/network_telemetry_atlas.png`
- **Kích Thước (Dimensions)**: `256x128` (Must be 2^n)
- **Dimensions**: `256x128` (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)**: `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
Nhằm hỗ trợ công tác kiểm thử mạng, đo lường độ trễ và giám sát hiệu năng đồng bộ vùng không gian (Area of Interest - AoI) giữa Server loop 30Hz và Client loop 120Hz:
- **Huy Hiệu Nhịp Server Tickrate (30Hz Indicator)**: Biểu tượng bát quái nhấp nháy 3 màu: Xanh lục mượt mà (30Hz), Vàng cảnh báo (20-25Hz), Đỏ giật lag (<15Hz).
- **Huy Hiệu Độ Trễ Mạng (Ping MS Latency Badge)**: Chỉ số trễ mạng thiết kế theo phong cách ngọc bội giang hồ đổi màu theo SLA (P99 < 25ms xanh lục, < 60ms vàng, > 100ms đỏ).
- **Lưới Tọa Độ AoI Ranh Giới (AoI Grid Debug Boundary)**: Đường ranh giới mắt lưới ô vuông bán trong suốt hiển thị vùng bao phủ thực thể mạng khi bật chế độ nhà phát triển.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Giao diện gãy gọn, tinh xảo, hòa hợp với chủ đề kiếm hiệp mà không gây rối mắt, cung cấp thông tin kỹ thuật chính xác cho lập trình viên và người chơi kiểm tra đường truyề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)** | 2D Debug Overlay / Status HUD Icons |
| **Độ Phân Giải (Resolution)** | `256x128` (Atlas các huy hiệu telemetry `64x64`) kèm texture lưới `128x128` (Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.webp` |
| **Kênh Màu & PBR Mapping** | Albedo (RGBA 32-bit), màu sắc phát quang rõ ràng |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion, cập nhật số liệu mỗi giây 1 lần |
| **Bảng Màu & Hệ Ngũ Hành** | Xanh ngọc bích mượt mà, vàng hổ phách cảnh báo, đỏ chu sa trễ nhịp |
| **Giao Diện Di Động (Safe Area)** | Góc trên cùng màn hình cạnh thanh hiển thị FPS |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 50KB` cho toàn bộ tài nguyên telemetry |
| **Yêu Cầu Normal Map** | `NO` |

---

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

- [x] `network_telemetry_atlas.png`
- [x] `aoi_grid_debug_line.png`
- [x] `telemetry_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 UI telemetry).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Hiển thị chính xác không gây giật khung hình.
- **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).
- [ ] Biểu tượng kỹ thuật được mỹ thuật hóa tinh tế, phù hợp thế giới quan.
- [ ] 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.