# VŨ TRỤ SỬ THI ĐIỆN ẢNH: ĐÔNG A HÙNG KÝ (DONG A: THE IRON DYNASTY)
## NON SÔNG VỮNG ÂU VÀNG - 40-EPISODE HISTORICAL CINEMATIC EPIC

> **Tên thương hiệu đăng ký bản quyền**: **ĐÔNG A HÙNG KÝ: NON SÔNG VỮNG ÂU VÀNG**  
> **Tên phát hành quốc tế**: **DONG A: THE IRON DYNASTY**  
> **Quy mô dự án**: 40 Tập (Episodes) phân bổ trong 6 Mùa sử thi (Seasons) - Mỗi tập chuẩn thời lượng 30 Phút (1,800 Giây)  
> **Cấu trúc kỹ thuật**: Chuẩn Hollywood 3 Hồi (Three-Act Screenplay), phân rã thành các cảnh và từng shot ngắn chuẩn 10 Giây (`10s Atomic Shots`) với mô hình âm thanh vòm 4 Stems độc lập (BGM, Ambience, Foley, Vocal) tối ưu cho công nghệ làm phim AI (FLUX.1, Wan2.1, Edge-TTS, PureScale 4K).  
> **Niên đại lịch sử**: 175 năm toàn thịnh và oai hùng của triều đại nhà Trần (1225 - 1400).

---

### I. HỆ THỐNG CẤU TRÚC 6 MÙA SỬ THI & THƯ MỤC DỰ ÁN

```
c:\Projects\Tran_Empire\
├── README.md                                           # Cẩm nang điều hướng & tổng thể dự án
├── 00_Project_Bible/                                   # Bộ tài liệu nền tảng khảo cổ, lịch sử & nghệ thuật
│   ├── MASTER_BIBLE.md                                 # Tôn chỉ nghệ thuật, chiaroscuro lighting, 4-stem audio
│   ├── HISTORICAL_SOURCES_ORTHODOX.md                  # Khảo chứng sử liệu Toàn Thư, Cương Mục, Nguyên Sử
│   ├── CHARACTER_BIBLE.md                              # Hồ sơ 30+ nhân vật lịch sử cốt lõi
│   ├── COSTUMES_AND_VISUAL_LANGUAGE.md                 # Khảo cổ phục trang, tục xăm mình Giao Long, gốm hoa nâu
│   ├── MILITARY_AND_MARTIAL_ARTS.md                    # Binh pháp "Dĩ đoản chế trường", bãi cọc Bạch Đằng, võ Đông A
│   └── SOUNDTRACK_AND_STEMS_SPEC.md                    # Quy chuẩn 4 Stems (BGM, Ambience, Foley, Vocal)
├── 01_Episode_Guides/                                  # Cẩm nang phân rã toàn bộ 40 tập phim
│   ├── SERIES_STRUCTURE_40_EPISODES.md                 # Đề cương 40 tập (3 Hồi, Synopsis, Cao trào, Cliffhangers)
│   └── TIMELINE_1225_1400.md                           # Niên biểu 175 năm triều Trần
├── 02_AI_Prompts/                                      # Kho công cụ prompts AI biên dịch sẵn sàng
│   ├── master_prompt_rules.json                        # Quy chuẩn âm bản & phong cách thị giác 13th Century
│   ├── characters_consistent_prompts.json              # Seeds nhận diện nhân vật lịch sử
│   ├── ep01_compiled_prompts.json -> ep35_...          # 13 tệp JSON prompt đã biên dịch theo từng shot 10s
├── Season_01_Song_Cuon_Hai_Trieu/                      # Mùa 1: Dựng nghiệp Trần gia (EP01 - EP06)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP01_Song_Gio_Hai_Ap, EP02_Ban_Co_Ly_Tran, EP03_Chieu_Nhuong_Ngoi)
├── Season_02_Tieng_Sam_Dong_Bo_Dau/                    # Mùa 2: Kháng chiến lần thứ nhất (EP07 - EP11)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP08_Huyet_Chien_Binh_Le_Nguyen, EP10_Tieng_Sam_Dong_Bo_Dau)
├── Season_03_Huyet_The_Sat_That/                       # Mùa 3: Hào khí Đông A & Chuẩn bị đại chiến (EP12 - EP18)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP14_Hich_Tuong_Si, EP17_Hoi_Nghi_Dien_Hong)
├── Season_04_Lua_Thieu_Chuong_Duong/                   # Mùa 4: Phản công kháng chiến lần hai (EP19 - EP25)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP20_Trung_Liet_Tran_Binh_Trong, EP23_Lua_Thieu_Chuong_Duong_Do)
├── Season_05_Rong_Bay_Bach_Dang_Giang/                 # Mùa 5: Đại thắng kháng chiến lần ba (EP26 - EP32)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP28_Cat_Dut_Van_Luong_Van_Don, EP30_Rong_Bay_Bach_Dang_Giang)
├── Season_06_May_Trang_Non_Yen_Tu/                     # Mùa 6: Thiền phái Trúc Lâm & Hoàng hôn vương triều (EP33 - EP40)
│   ├── SEASON_BIBLE.md | EPISODE_GUIDE.md | AI_PROMPTS_MASTER.json
│   └── screenplays/ (EP34_Truc_Lam_Yen_Tu, EP35_Huyen_Tran_Cong_Chua)
├── 03_Screenplays/                                     # Kho lưu trữ kịch bản phân nhánh đồng bộ (Arc 1 -> Arc 6)
├── credits/                                            # Hồ sơ bản quyền & Giải pháp FOSS Zero-Cost
│   ├── README.md                                       # Tuyên ngôn bản quyền & chính sách pháp lý
│   ├── 01_HISTORICAL_CITATIONS_AND_PUBLIC_DOMAIN.md    # Dẫn nguồn sử liệu cổ & chứng nhận Public Domain
│   ├── 02_AI_AND_SOFTWARE_LICENSES.md                  # Ma trận FOSS thay thế miễn phí 100% chất lượng tương đương
│   ├── 03_AUDIO_AND_MUSIC_ATTRIBUTION.md               # Nguồn âm thanh CC0/Public Domain 4 Stems
│   └── 04_END_CREDITS_ROLL_TEMPLATE.md                 # Mẫu chạy chữ kết phim chuẩn điện ảnh quốc tế
└── tools/                                              # Bộ công cụ tự động hóa & kiểm thử
    ├── screenplay_validator.py                         # Kiểm thử 3 Hồi, số shot 10s, 4 audio stems
    └── prompt_compiler.py                              # Biên dịch kịch bản sang JSON prompts cho AI
```

---

### II. BẢNG TIẾN ĐỘ KỊCH BẢN VÀ BIÊN DỊCH PROMPT ĐÃ HOÀN TẤT (100% PASS VALIDATOR)

| Tập | Tên tập phim | Mùa phim | Tình trạng kịch bản | Shots (10s) | Prompt JSON |
| :---: | :--- | :--- | :---: | :---: | :---: |
| **EP01** | Sóng Gió Hải Ấp & Loạn Thế Cuối Lý | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 40 Shots | `ep01_compiled_prompts.json` |
| **EP02** | Bàn Cờ Lý - Trần & Hôn Nhân Định Mệnh | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 16 Shots | `ep02_compiled_prompts.json` |
| **EP03** | Chiếu Nhường Ngôi & Vương Triều Khởi Nguyên | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 22 Shots | `ep03_compiled_prompts.json` |
| **EP04** | Biến Loạn Sông Cái & Bước Chân Lên Yên Tử | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 25 Shots | `ep04_compiled_prompts.json` |
| **EP05** | Hoàng Triều Hai Bậc & Kỷ Cương Thái Sư | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 22 Shots | `ep05_compiled_prompts.json` |
| **EP06** | Đời Sống Đông A & Lễ Hội Thủy Binh | Mùa 1 (Trọn vẹn) | **Đã hoàn thành** (PASSED) | 22 Shots | `ep06_compiled_prompts.json` |
| **EP08** | Huyết Chiến Bình Lệ Nguyên | Mùa 2 | **Đã hoàn thành** (PASSED) | 18 Shots | `ep08_compiled_prompts.json` |
| **EP10** | Tiếng Sấm Đông Bộ Đầu (1258) | Mùa 2 | **Đã hoàn thành** (PASSED) | 24 Shots | `ep10_compiled_prompts.json` |
| **EP14** | Áng Văn Thiên Cổ - Hịch Tướng Sĩ (1284) | Mùa 3 | **Đã hoàn thành** (PASSED) | 15 Shots | `ep14_compiled_prompts.json` |
| **EP17** | Hào Khí Đông A - Hội Nghị Diên Hồng | Mùa 3 | **Đã hoàn thành** (PASSED) | 17 Shots | `ep17_compiled_prompts.json` |
| **EP20** | Trung Liệt Trần Bình Trọng | Mùa 4 | **Đã hoàn thành** (PASSED) | 19 Shots | `ep20_compiled_prompts.json` |
| **EP23** | Lửa Thiêu Chương Dương Độ (1285) | Mùa 4 | **Đã hoàn thành** (PASSED) | 13 Shots | `ep23_compiled_prompts.json` |
| **EP28** | Cắt Đứt Vận Lương Vân Đồn (1288) | Mùa 5 | **Đã hoàn thành** (PASSED) | 13 Shots | `ep28_compiled_prompts.json` |
| **EP30** | Rồng Bay Bạch Đằng Giang (1288) | Mùa 5 | **Đã hoàn thành** (PASSED) | 21 Shots | `ep30_compiled_prompts.json` |
| **EP34** | Trúc Lâm Yên Tử - Buông Bỏ Hồng Trần | Mùa 6 | **Đã hoàn thành** (PASSED) | 18 Shots | `ep34_compiled_prompts.json` |
| **EP35** | Huyền Trân Công Chúa & Lời Thề Ô Lý | Mùa 6 | **Đã hoàn thành** (PASSED) | 13 Shots | `ep35_compiled_prompts.json` |

---

### III. MA TRẬN CÔNG NGHỆ ZERO-COST THAY THẾ GIẢI PHÁP TRẢ PHÍ (100% MIỄN PHÍ)

| Hạng mục sản xuất | Công cụ thương mại có phí | Phương án FOSS / Miễn phí 100% | Giấy phép | Chất lượng & Lợi thế |
| :--- | :--- | :--- | :--- | :--- |
| **Tạo hình ảnh (Keyframes)** | Midjourney Pro ($60/tháng) | **FLUX.1-schnell / SDXL** | Apache 2.0 / Open RAIL-M | Render cục bộ trên GPU, tùy biến Lora phục trang Việt cổ, zero chi phí |
| **Sinh chuyển động (Video)** | Runway Gen-3 / Kling Pro | **Wan2.1 (Alibaba) / HunyuanVideo** | Apache 2.0 / Open-Source | Mô hình video nguồn mở hàng đầu thế giới, chuyển động 10s mượt mà |
| **Giọng nói nhân vật (Voice)** | ElevenLabs Creator ($22/tháng) | **Edge-TTS / F5-TTS** | MIT / Apache 2.0 | Giọng đọc tiếng Việt tự nhiên, truyền cảm, hỗ trợ nhiều vùng miền |
| **Nâng cấp độ phân giải (4K)**| Topaz Video AI ($299) | **PureScale 4K (PureVision + SPAN)** | Open Source (PyTorch) | Có sẵn trong repo, render 4K UHD sắc nét, khử muỗi nén H.264 |
| **Dựng phim & Hòa âm 4 Stems**| Adobe Premiere Pro ($30/tháng) | **DaVinci Resolve Free / FFmpeg** | Free Commercial / LGPL v2.1+ | Hòa âm 4 Stems chuẩn Fairlight, chỉnh màu Chiaroscuro chuyên nghiệp |

---

### IV. HƯỚNG DẪN VẬN HÀNH BỘ CÔNG CỤ (TOOLS USAGE)

#### 1. Kiểm tra tính hợp lệ toàn bộ kịch bản:
```bash
# Kiểm tra 1 tệp kịch bản cụ thể:
c:\Projects\Historical\venv\Scripts\python.exe tools/screenplay_validator.py Season_01_Song_Cuon_Hai_Trieu/screenplays/EP01_Song_Gio_Hai_Ap.md

# Kiểm tra hàng loạt tất cả các tập:
c:\Projects\Historical\venv\Scripts\python.exe -c "import glob, subprocess; [subprocess.run(['c:/Projects/Historical/venv/Scripts/python.exe', 'tools/screenplay_validator.py', f]) for f in glob.glob('Season_*/screenplays/*.md')]"
```

#### 2. Biên dịch kịch bản sang JSON Prompts cho AI:
```bash
c:\Projects\Historical\venv\Scripts\python.exe tools/prompt_compiler.py Season_01_Song_Cuon_Hai_Trieu/screenplays/EP01_Song_Gio_Hai_Ap.md --output 02_AI_Prompts/ep01_compiled_prompts.json
```
