# Historical-2d Studio - Architecture & Engineering Directives (2026)

## 1. Mục Tiêu & Định Vị Dự Án
- **Tên dự án**: Historical-2d.
- **Vai trò**: Phân xưởng sản xuất nội dung video 2D chuyên biệt (Sa bàn chiến thuật - Battle Map Sandbox và Infographic lịch sử thế giới) độc lập, hỗ trợ hệ sinh thái *Historical*.
- **Trọng tâm sản xuất**:
  - Tái hiện các chiến dịch, trận đánh huyền thoại và biến động địa chính trị thế giới qua sa bàn phòng tác chiến (War Room Tabletop).
  - Tối ưu hóa tuyệt đối cho cấu hình phần cứng khiêm tốn / đa luồng (Dual Xeon 56-thread, GTX 1660S 6GB VRAM, 64GB RAM).
  - Cam kết 100% tài nguyên sạch bản quyền (Public Domain Geodata, CC0/ODbL, tự vẽ vector SVG, font mở OFL).

---

## 2. Phần Cứng Máy Chủ & Quy Chuẩn Tối Ưu Hóa
- **CPU**: Dual Intel Xeon E5-2680 v4 (28 Cores / 56 Threads, 2.40 GHz).
- **RAM**: 64 GB ECC DDR4 (Hỗ trợ nạp trước toàn bộ raster elevation map và geojson ranh giới vào bộ nhớ).
- **GPU**: NVIDIA GeForce GTX 1660 Super (6GB VRAM, NVENC Turing Hardware Encoder).
- **Chiến lược phân bổ tải**:
  - **Tầng tính toán & Animation 2D**: 100% CPU đa luồng (Motion Canvas, Remotion headless đa tiến trình, hoặc Python Numpy/OpenCV đa luồng).
  - **Tầng nén & xuất video**: GPU Turing NVENC (`hevc_nvenc` hoặc `h264_nvenc`) preset `p4` hoặc `p6`, CQ 19, zero latency, loại bỏ nghẽn cổ chai CPU khi render frame.

---

## 3. Hệ Thống Công Cụ & Thư Viện Cốt Lõi (Chốt 2026)
1. **Dữ liệu Địa lý & Sa bàn Lịch sử**:
   - `Natural Earth Data`: Ranh giới địa lý, sông ngòi, bờ biển (Public Domain CC0).
   - `OpenHistoricalMap (OHM) Time-Travel API`: Truy vấn ranh giới đế chế theo niên đại (`year=-216`, `year=1285`).
   - `SRTM / ETOPO / Terrain-RGB`: Dữ liệu độ cao số tạo bóng địa hình 3D thực tế trên nền WebGPU (Hillshade Shaded Relief).
2. **Engine Diễn Hoạt & Sinh Frame 2D**:
   - `MapLibre GL v4/v5 (WebGPU)`: Dựng sa bàn nghiêng 3D terrain, camera di chuyển mượt mà >120 FPS trên GPU phổ thông.
   - `Rust Headless Vector Renderer` (`resvg` / `vello` trên WGPU): Tận dụng trọn vẹn 56 luồng CPU Xeon để rasterize vector SVG 4K không qua Chromium.
   - `Python 2D Tactical Engine` (`Pillow`, `OpenCV`, `Numpy`): Sinh sa bàn chiến thuật, vẽ mũi tên Bézier xung lực, khối quân bài gỗ (Tactical Counters).
3. **Mã Hóa & Xuất Video**:
   - `FFmpeg` tích hợp sẵn hardware acceleration `hevc_nvenc` (CQ 19, preset p4, `-bf 0`).
   - Đóng gói định dạng YouTube Multi-Language Audio 2026 chuẩn EBU R128 (-14 LUFS).

---

## 4. Quy Chuẩn Thẩm Mỹ Chiến Thuật (War Room Aesthetic)
- **Palette Màu**:
  - Nền bản đồ: Giấy da dê sẫm màu (`#1A1713` đến `#26211A`) hoặc phiến đá Obsidian (`#0F1115`).
  - Phe Đồng Minh / Nhân vật chính: Xanh Navy Hoàng gia (`#1A365D`) viền Vàng Kim (`#D4AF37`).
  - Phe Đối Địch: Đỏ son Chiaroscuro (`#8B1E1E` đến `#B22222`).
  - Mũi tên chiến thuật: Đường cong Bézier phân đoạn, viền phát quang nhẹ (soft glow), mũi tên nhọn có gợn xung lực.
- **Biểu tượng quân đội**: Khối thẻ bài quân sự cách điệu từ chuẩn NATO APP-6 (Kỵ binh, Bộ binh, Cung thủ, Thủy binh, Pháo binh).
- **Infographic HUD**: Bộ đếm thương vong thời gian thực, thước đo tương quan lực lượng, mốc niên đại lịch sử.

---

## 5. Quy Chuẩn Âm Thanh, Thuyết Minh & Phụ Đề Đa Ngôn Ngữ
1. **Thiết Kế Âm Thanh Sa Trường (War Room Soundscape)**:
   - Âm thanh vòm định vị sa bàn (Binaural Spatial Panning): Chuyển dịch âm thanh stereo theo tọa độ di chuyển của kỵ binh/mũi tên chiến thuật.
   - SFX sa bàn: Tiếng gõ cờ gỗ, tiếng lật giấy bản đồ da dê, tiếng chấm la bàn.
   - Ambience không gian sa trường: Trống trận trầm hùng (Taiko / Orchestral war drums), tiếng vó ngựa qua bộ lọc âm thấp `lowpass=f=800`.
   - Nhạc nền: 100% Public Domain / CC0 / YouTube Audio Library.
2. **Người Dẫn Truyện Đa Ngôn Ngữ (Multilingual Documentary Voiceover)**:
   - Chuẩn mô hình chính: **Kokoro-82M v2.3.2** (siêu nhẹ ~327MB, chạy CPU 56 luồng với RTF 0.05-0.1x, zero GPU VRAM, giấy phép Apache 2.0).
   - Dự phòng / Cloud: `Edge-TTS Neural Voice` và `F5-TTS` (Zero-shot cloning từ tư liệu lịch sử).
   - Giọng chuẩn tài liệu: Tiếng Anh (`en-US-ChristopherNeural` - Baritone uy nghiêm), Tiếng Việt (`vi-VN-NamMinhNeural` - Hào hùng sử thi), cùng các track `de-DE`, `fr-FR`, `es-ES`, `ja-JP`.
3. **Phụ Đề Đa Ngôn Ngữ (Kinetic ASS & Multilingual Subtitles)**:
   - Định dạng: ASS (Advanced SubStation Alpha) nhúng phong cách điện ảnh với Dynamic Keyword Highlight (Vàng Kim `#D4AF37` cho niên đại, danh xưng, thương vong).
   - Căn chỉnh mốc thời gian bằng WhisperX v3 (Phoneme-level forced alignment).
   - Đóng gói trực tiếp luồng Multi-Language Audio Track MP4 theo chuẩn quốc tế YouTube 2026.

---

## 6. Định Hướng Thị Trường & Khán Giả Mục Tiêu (R&D Directives)
- **Thị trường cốt lõi**: Tier 1 (US, UK, CA, AU, DE, Bắc Âu) - Mục tiêu RPM $18 - $35.
- **Chân dung khán giả**: Nam giới 28–50 tuổi (kỹ sư công nghệ, tài chính, quân nhân cựu binh), học vấn cao, tư duy phản biện logic.
- **Xu hướng Connected TV (CTV)**: >60% thời lượng xem diễn ra trên màn hình TV phòng khách. Thời lượng chuẩn: 20–35 phút (Single Deep-Dive) và 45–90 phút (Full Campaign Omnibus).
- **Nguyên tắc "Tactical Sobriety"**:
  - Triệt tiêu 100% "AI Slop" (ảnh biến dạng, giọng vô hồn, giật gân rẻ tiền).
  - Tôn trọng "Màn sương chiến tranh" (*Fog of War*), bóc tách nguyên nhân – hệ quả, logistics tiếp tế và địa hình vi mô.
- **5 Chiến dịch Át chủ bài**:
  1. *Desert Storm 1991: The Stealth & SEAD Midnight Symphony* (24m, RPM $25 - $35).
  2. *Cannae 216 BC: The Anatomy of a Perfect Encirclement* (22m, RPM $18 - $24).
  3. *Midway 1942: The Fatal 5 Minutes of Kido Butai* (28m, RPM $22 - $30).
  4. *Battle of the Bulge 1944: The Bastogne Siege & Race for Fuel* (26m, RPM $20 - $28).
  5. *Grozny 1994: The New Year's Eve Armor Meatgrinder* (25m, RPM $18 - $26).

---

## 7. Cơ Cấu Tổ Chức & Nhân Sự Studio Historical-2d
1. **Seven Nguyen**: Studio Owner & Executive Producer (Chủ studio, định hướng chiến lược và phê duyệt tối cao).
2. **Antigravity**: Studio CEO & Lead Orchestrator (Giám đốc Điều hành, phân bổ tài nguyên phần cứng, điều phối quy trình tự hành khép kín).
3. **Thomas**: Head of R&D & Audience Intelligence (Giám đốc R&D, nghiên cứu tệp khán giả Tier 1, bóc tách thuật toán và xu hướng thị trường).
4. **Victor Vance**: Head of Scriptwriting & Military History (Giám đốc Biên kịch & Cố vấn Quân sử, xây dựng kịch bản 3 hồi, cấu trúc JSON timeline tác chiến).
5. **Marcus Sterling**: Lead Cartographer & Tactical Map Artist (Trưởng Ban Đồ họa Sa bàn & Dữ liệu Không gian, quản trị QGIS/OHM/WebGPU, thẻ bài NATO APP-6 và thẩm mỹ Chiaroscuro).
6. **Elena Rostova**: Lead Motion & Pipeline Automation Engineer (Kỹ sư trưởng Diễn hoạt & Tự động hóa Pipeline, tối ưu hóa engine cho 56 luồng CPU Xeon và NVENC GPU).
7. **Arthur Pendelton**: Head of Audio & Multilingual Localization (Đạo diễn Âm thanh & Bản địa hóa, thiết kế âm thanh vòm Binaural, Kokoro-82M v2.3.2, Kinetic ASS, chuẩn -14 LUFS).
8. **Diana Vance**: Head of QA, Compliance & YouTube Growth (Trưởng Ban Kiểm thử Chất lượng & Tăng trưởng YouTube, bảo vệ bản quyền 100%, kiểm thử A/V sync, SEO quốc tế và Thumbnail CTR > 78%).

---

## 8. Quy Chuẩn Điều Hành Tối Cao Của CEO (CEO Orchestration & Delegation Protocol)
Theo chỉ thị tối cao từ Chủ studio **Seven Nguyen**, CEO Antigravity tuyệt đối **không tự ý lao vào làm ngay** khi nhận yêu cầu, mà bắt buộc thực thi nghiêm ngặt quy trình điều hành 5 bước:

1. **Phân Tích Yêu Cầu & Phân Bổ Nhân Sự (Task Analysis & Assignment)**:
   - Bóc tách đề bài: Xác định rõ yêu cầu này giao cho ai phụ trách chính (Victor, Marcus, Elena, Arthur, Diana, hay Thomas)?
   - Xác định tính phối hợp: Có cần kết hợp đa nhân sự (Cross-functional) hay không?
   - Thiết lập chuẩn đầu ra: Định nghĩa tường minh **Kết quả kỳ vọng (Expected Deliverables & KPIs)** từ mỗi nhân sự.
2. **Ủy Nhiệm & Chờ Phản Hồi (Delegation & Dispatch)**:
   - Giao việc chi tiết cho nhân sự chuyên trách thông qua subagent.
   - Chờ hệ thống thông báo phản hồi tự động (không busy-poll).
3. **Đối Soát & Đánh Giá Chất Lượng (Verification & Evaluation)**:
   - Thu nhận kết quả từ nhân sự, đối chiếu nghiêm ngặt với tiêu chuẩn kỳ vọng ban đầu.
   - Nếu chưa đạt: yêu cầu tinh chỉnh; Nếu đạt: chuyển sang bước tổng hợp.
4. **Lập Báo Cáo Điều Hành Chuyên Nghiệp (Executive Synthesis Report with Timestamp)**:
   - Lập báo cáo tổng hợp chuyên nghiệp gửi Chủ studio Seven Nguyen, bắt buộc đính kèm **Timestamp** thời gian thực tế.
5. **Kích Hoạt Triển Khai Thực Tế (Execution & Implementation)**:
   - Chỉ sau khi báo cáo được tổng hợp và đối soát hoàn chỉnh, CEO mới chỉ huy các bước triển khai mã nguồn và sản xuất thực tế trên hệ thống.