# FREEEXILE DESIGN REQUEST: Agent Orb Activation Pillar & Spirit Totem VFX

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

- **Mã Yêu Cầu (Request ID)**: `DRQ-20261001-SRV-AGENT-ORB-ACTIVATION-VFX`
- **ID**: `DRQ-20261001-SRV-AGENT-ORB-ACTIVATION-VFX`
- **Tên Yêu Cầu (Title)**: Hoạt Ảnh Kích Hoạt Chiến Hồn Tế Cốt 3 Cấp Độ (Agent Orb Activation Pillar & Spirit Totem VFX)
- **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)**: `VFX`
- **Asset Type**: `VFX`
- **Mức Độ Ưu Tiên (Priority)**: `LOW`
- **Sub-Agent Tiếp Nhận Chỉ Định (Assigned Subagent)**: `vfx_tech_artist`
- **Đường Dẫn Mục Tiêu (Target Path)**: `client/webapp/assets/savage_vfx/agent_orb_activation_pillars.png`
- **Target Path**: `client/webapp/assets/savage_vfx/agent_orb_activation_pillars.png`
- **Kích Thước (Dimensions)**: `256x512` (Must be 2^n)
- **Dimensions**: `256x512` (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
Hệ thống Chiến Hồn Tế Cốt (`Agent_Orb` / Feral Totem) cho phép người chơi uỷ thác bản năng chiến đấu cho AI Agent tự động săn mồi và sinh tồn khi vắng mặt. Khi kích hoạt vật phẩm, nhân vật đứng tại chỗ thi triển bí thuật tế cốt phóng ra cột sáng linh hồn:
1. **Bậc 1 - Sơ Cấp (Thanh Đồng - 2H)**: Cột sáng màu xanh ngọc bích tỏa ra phù chú dã thú mờ ảo quanh thân thể.
2. **Bậc 2 - Trung Cấp (Bạch Ngân - 8H)**: Cột sáng tím tử la ma đạo uy lực kèm vòng sóng năng lượng tỏa rộng 3 mét.
3. **Bậc 3 - Vô Song (Hoàng Kim - 24H)**: Cột sáng thái cực hoàng kim ngút trời, đồ hình Bát Quái cổ xoay chiều dưới chân và bóng hình thú hồn gầm thét.

### 2.2. Mục Tiêu Trải Nghiệm Người Dùng (UX Goal)
Khoảnh khắc trao gửi linh hồn đầy linh thiêng, thể hiện sức mạnh thần bí của Chiến Hồn Tế Cốt, tạo sự yên tâm cho người chơi trước khi ủy thác nhân vật cho hệ thống AI tự hành.

---

## 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 Vertical Light Pillar Billboard / Metal Compute VFX |
| **Độ Phân Giải (Resolution)** | `256x512` (Atlas cột sáng 3 bậc) kết hợp vòng trận đồ chân `256x256` (Chuẩn $2^n$) |
| **Định Dạng Tệp (File Format)** | `.png` (RGBA 32-bit lossless), `.metal` (Compute/Fragment shader) |
| **Kênh Màu & PBR Mapping** | Additive Blending Alpha Mask, Gradient rực rỡ, không yêu cầu Normal Map |
| **Tần Số Quét & Khung Hình** | 120 FPS ProMotion ($8.33\text{ ms/frame}$), hiệu ứng kích hoạt kéo dài 1.5s |
| **Bảng Màu & Hệ Ngũ Hành** | Xanh ngọc thanh đồng, tím tử la bạch ngân, hoàng kim vô song |
| **Giao Diện Di Động (Safe Area)** | Tối ưu hóa bộ nhớ RAM, giải phóng bộ nhớ ngay sau khi kết thúc diễn hoạt |
| **Ngân Sách Dung Lượng (Size Budget)** | `< 150KB` cho texture atlas và shader file |
| **Yêu Cầu Normal Map** | `NO` |

---

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

- [x] `agent_orb_activation_pillars.png`
- [x] `agent_summon_rune_circle.png`
- [x] `agent_orb_beam.metal`
- [x] `agent_orb_vfx_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 VFX atlas).
- [ ] Kích thước ảnh chuẩn lũy thừa 2 ($2^n$).
- [ ] Không gây drop frame trên màn hình ProMotion 120Hz khi kích hoạt.
- **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).
- [ ] Thể hiện rõ nét sự khác biệt giữa 3 bậc ủy thác Chiến Hồn Tế Cố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.