# FREEEXILE DESIGN REQUEST: Agent Delegation Harvest Report UI Overlay

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SRV-HARVEST-REPORT-OVERLAY`
- **ID**: `DRQ-20261001-SRV-HARVEST-REPORT-OVERLAY`
- **Tên Yêu Cầu (Title)**: Giao Diện Báo Cáo Thu Hoạch Bản Năng & Tinh Thần Lực (Agent Delegation Harvest Report UI Overlay)
- **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/agent_orb_service.py](file:///c:/Projects/FreeExile/server/world/agent_orb_service.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)**: `MEDIUM`
- **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/delegation/harvest_report_modal.png`
- **Target Path**: `client/webapp/assets/ui/delegation/harvest_report_modal.png`
- **Kích Thước (Dimensions)**: `1024x512` (Must be 2^n)
- **Dimensions**: `1024x512` (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)**: `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
Khi người chơi đăng nhập trở lại game sau quãng thời gian ủy thác Chiến Hồn Tế Cốt, hệ thống tự động hiển thị Báo Cáo Thu Hoạch Bản Năng (`DelegationHarvestReport`):
- **Bảng Thống Kê Tổng Kết**: Tổng thời gian sinh tồn nơi hoang dã, số quái vật đã trảm diệt, lượng EXP tích lũy, số lượng Huyết Thạch và Bụi Huyết Cốt nhặt được.
- **Khung Hiển Thị Dòng Suy Nghĩ AI (LLM Thought Stream)**: Hộp cuộn hiển thị trích đoạn phân tích chiến thuật thời gian thực của các mô hình AI (DeepSeek V3, Claude 3.5, GPT-4o, Gemini) trong lúc săn mồi và né đòn.
- **Nút Nhận Thưởng (Claim Rewards Button)**: Nút bấm chạm khắc ấn rồng hoàng kim để chuyển toàn bộ chiến lợi phẩm vào rương đồ cá nhân.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Cảm giác thỏa mãn tuyệt đối khi nhận thành quả cày cuốc sau một ngày làm việc bận rộn. Báo cáo minh bạch, chi tiết, thú vị khi đọc lại dòng suy nghĩ chiến thuật của thú hồn AI.

---

## 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 / Modal Summary Dialog |
| **Độ Phân Giải (Resolution)** | `1024x512` (Khung báo cáo) kết hợp Atlas icon chỉ số `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 (RGBA 32-bit) chi tiết bìa da cổ và phù điêu kim loại |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion mượt mà khi cuộn log chiến thuật |
| **Bảng Màu & Hệ Ngũ Hành** | Nâu trầm da cổ, vàng kim chiến thắng, đỏ son dấu triện thu hoạch |
| **Giao Diện Di Động (Safe Area)** | Tối ưu hiển thị trung tâm màn hình, nút Nhận Thưởng $\ge 54\times 54\text{ pt}$ |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho toàn bộ tài nguyên UI báo cáo |
| **Yêu Cầu Normal Map** | `NO` |

---

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

- [x] `harvest_report_modal.png`
- [x] `harvest_stat_icons_atlas.png`
- [x] `btn_claim_rewards.png`
- [x] `harvest_ui_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 modal).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Bố cục giao diện co giãn tốt trên mọi kích thước màn hình di động.
- **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).
- [ ] Trực quan hóa phần thưởng cày cuốc đầy hưng phấn và cuốn hút.
- [ ] 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.