# THẬP NGŨ NIÊN (THE FIFTEEN SPRINGS)
## KIỆT TÁC ĐIỆN ẢNH AI 3 GIỜ - ĐOẠN TRƯỜNG KÝ (AI CINEMA PRODUCTION REPOSITORY)

[![Production Status](https://img.shields.io/badge/Production-Automated_Pipeline_v2.0-blue.svg)]()
[![IP Protection](https://img.shields.io/badge/Copyright-Nguyen_Si_Son-green.svg)]()
[![YouTube Monetization](https://img.shields.io/badge/Monetization-100%25_Green_Dollar_Safe-brightgreen.svg)]()
[![AI Video Engine](https://img.shields.io/badge/Motion_Engine-Muse.ai-purple.svg)]()

> **Dự án**: **THẬP NGŨ NIÊN** (Tiêu đề đầy đủ: **THẬP NGŨ NIÊN: ĐOẠN TRƯỜNG KÝ** / Tên quốc tế: **THE FIFTEEN SPRINGS** / **FIFTEEN AUTUMNS**)  
> **Tác giả kiêm Chủ sở hữu IP**: **NGUYỄN SĨ SƠN** (Sinh ngày: 08/08/1990, CCCD: 031090010018)  
> **Nguyên tác văn học**: *Đoạn Trường Tân Thanh - Truyện Kiều* của Đại thi hào Nguyễn Du (1765 - 1820, Thuộc phạm vi công chúng - Public Domain theo Điều 43 Luật SHTT)  
> **Tổng thời lượng**: 180 Phút (3 Giờ điện ảnh hoàn chỉnh)  
> **Công nghệ lõi**: Gemini Banana (Google Imagen 3 Concept & Keyframes) + Muse2API Gateway & Muse.ai (Video Motion Engine qua REST API `http://127.0.0.1:18610/v1` & browser fallback) + NVIDIA GeForce GTX 1660 Super Local Pipeline (PureScale 4K UHD & FFmpeg EBU R128).

---

## 1. HỆ THỐNG ĐỊNH DẠNG PHÁT HÀNH ĐA TẦNG (MULTI-FORMAT DISTRIBUTION)

1. **6 Tập Điện Ảnh 30 Phút (Full Feature / Mini-series)**: Cấu trúc 3 hồi kinh điển với Cliffhanger cao trào cuối mỗi tập, phục vụ phát hành OTT, YouTube Cinema, và màn ảnh lớn.
2. **18 Phân Tập 10 Phút (Sub-episodes)**: Tối ưu nhịp độ kịch tính, mỗi tập giữ trọn vẹn một bước ngoặt số phận độc lập (chi tiết tại [`01_Scripts_And_Episodes/EPISODE_GUIDE_10MIN.md`](file:///C:/Projects/KieuStory/01_Scripts_And_Episodes/EPISODE_GUIDE_10MIN.md)).
3. **12 Phân Đoạn 5 Phút (Thematic Climax Arcs)**: Dành cho các phân đoạn âm nhạc & bi kịch đặc sắc (4 khúc đàn Kiều, Đêm trao duyên, Hầu đàn Hoạn Thư, Tử chiến Từ Hải).
4. **Chuỗi Video Ngắn 1 Phút (Shorts / Reels / TikTok 9:16)**: Cấu trúc 3s Hook + 45s Climax + 10s Cliffhanger CTA nhằm kéo lượng truy cập viral khổng lồ.

---

## 2. BẢN ĐỒ CẤU TRÚC HỆ THỐNG (REPOSITORY ARCHITECTURE)

```
C:\Projects\KieuStory\
├── README.md                                <-- Tài liệu tổng quan dự án & mục lục điều phối
├── AGENTS.md                                <-- Chỉ thị kỹ thuật & giao thức tự động hóa cho AI Agents
├── GEMINI.md                                <-- Ngữ cảnh dự án, sơ đồ kiến trúc & tra cứu nhanh
├── MUSE_API_AGENT_GUIDE.md                  <-- Đặc tả kỹ thuật Muse2API Gateway (REST API OpenAI-compatible)
├── 00_Project_Bible/                        <-- Sổ tay đạo diễn, tạo hình nhân vật, bối cảnh & âm thanh
│   ├── README.md                            <-- Mục lục chi tiết Project Bible
│   ├── MASTER_BIBLE.md                      <-- Đề cương, tầm nhìn & chiến lược điện ảnh 3 giờ
│   ├── CHARACTER_BIBLE.md                   <-- Tạo hình 32 nhân vật & prompt chuẩn hóa
│   ├── ENVIRONMENT_BIBLE.md                 <-- Thiết kế đại bối cảnh cổ phong Á Đông/Việt
│   ├── SAFETY_AND_MONETIZATION_GUIDELINES.md <-- Cẩm nang đạo diễn cảnh nhạy cảm (100% Green Dollar)
│   ├── TIMELINE_AND_AGING_MATRIX.md         <-- Trục thời gian 15 năm & ma trận biến chuyển tuổi tác
│   └── CINEMATIC_AUDIO_PIPELINE.md          <-- Kiến trúc âm thanh 4 lớp & EBU R128 (-14 LUFS)
├── 01_Scripts_And_Episodes/                 <-- Toàn văn kịch bản trường thiên & cấu trúc phát hành
│   ├── EPISODE_GUIDE_30MIN.md               <-- Kịch bản chi tiết 6 tập dài 30 phút
│   ├── EPISODE_GUIDE_10MIN.md               <-- Cấu trúc phân đoạn 18 tập ngắn 10 phút
│   ├── SHORTS_STRUCTURE_5M_AND_1M.md        <-- Kịch bản 12 tập 5m & chuỗi Shorts 1m
│   ├── KIEU_STORY_TRUYEN_DAI_VAN_XUOI_...md <-- 60.000 từ kịch bản văn xuôi trường thiên
│   └── NGUYEN_TAC_TRUYEN_KIEU_LUC_BAT_...md <-- 3.254 câu thơ lục bát nguyên tác Nguyễn Du
├── 02_AI_Prompts/                           <-- Bộ dữ liệu câu lệnh mỹ thuật AI chuẩn hóa
│   ├── gemini_banana_prompts.json           <-- Prompt sinh ảnh nhân vật & bối cảnh 8K
│   ├── muse_ai_video_prompts.json           <-- Prompt tạo chuyển động video (T2V & I2V)
│   └── suno_ai_soundtrack_prompts.md        <-- Prompt sinh nhạc nền ngũ cung cổ phong
├── 03_Storyboards/                          <-- Bảng phân cảnh chi tiết từng shot
│   ├── README.md                            <-- Quy chuẩn Storyboard & Cinematography
│   └── Ep01_Gia_Bien_Storyboard.md          <-- Bảng phân cảnh cao trào Tập 1
├── 04_Assets/                               <-- Kho tài nguyên sản xuất (Raw & Processed)
│   ├── characters/                          <-- Ảnh chân dung 32 nhân vật (720p & master)
│   ├── backgrounds/                         <-- Ảnh bối cảnh 8K
│   ├── keyframes/                           <-- Start frames & Tail frames nối shot
│   ├── videos/                              <-- Video shot đã render & Master scene
│   ├── audio_sfx/                           <-- Nhạc nền BGM, foley, ambience
│   └── archive/                             <-- Bằng chứng IP: Các bản nháp, thử nghiệm, loại bỏ
├── 05_Production_Pipeline/                  <-- Bộ công cụ tự động hóa sản xuất video AI
│   ├── README.md                            <-- Hướng dẫn vận hành Pipeline tự động
│   ├── production_orchestrator.py           <-- Cỗ máy điều phối sản xuất chính (Render, Batch, Concat)
│   ├── run_shot.py                          <-- Render shot đơn lẻ qua agent-browser --session muse
│   ├── continuity_checker.py                <-- So sánh histogram & độ khớp thị giác
│   ├── audio_continuity_engine.py           <-- Master âm thanh điện ảnh chuẩn EBU R128 (-14 LUFS)
│   ├── pipeline_helper.py                   <-- Quản lý danh mục prompt & xuất file
│   └── archive_scripts/                     <-- Lưu trữ các script thử nghiệm đơn lẻ thời kỳ đầu
├── 06_Exports/                              <-- Thư mục xuất bản phẩm hoàn thiện
│   ├── episodes_30m/                        <-- Video 30 phút hoàn thiện (Chuẩn chiếu rạp/OTT)
│   ├── shorts_5m/                           <-- Video 5 phút (Vòng cung kịch tính)
│   └── shorts_1m_9x16/                      <-- Video Shorts 9:16 dọc (Viral traffic)
├── FilmMaker/                               <-- Hệ thống kịch bản phân cảnh điện ảnh 6 tập (180p)
│   ├── README.md                            <-- Tổng quan bộ kịch bản phân cảnh Hollywood Format
│   ├── INDEX_VA_DANH_MUC_CANH_QUAY.md       <-- Bảng chỉ mục 130 phân cảnh toàn biên
│   └── TAP_01_... đến TAP_06_...            <-- Kịch bản chi tiết từng tập phim
└── license/                                 <-- Hồ sơ pháp lý & đăng ký sở hữu trí tuệ
    ├── README.md                            <-- Chiến lược bảo hộ quyền tác giả & nhãn hiệu
    ├── CHECKLIST_NOP_HO_SO_THUC_TE.md       <-- Cẩm nang nộp hồ sơ thực tế tại cơ quan nhà nước
    ├── 01_Ho_So_Cuc_Ban_Quyen_Tac_Gia/      <-- Đăng ký Kịch bản & Tác phẩm Điện ảnh
    ├── 02_Ho_So_Cuc_So_Huu_Tri_Tue_Nhan...  <-- Đăng ký Nhãn hiệu "THẬP NGŨ NIÊN"
    └── 03_Hop_Dong_Va_Thoa_Thuan_Phap_Ly/  <-- NDA, IP Assignment & AI Terms Review
```

---

## 3. CẨM NANG KHỞI CHẠY NHANH (QUICK START RUNBOOK)

Hệ thống cung cấp cỗ máy điều phối sản xuất tự động khép kín qua CLI:

```bash
# 1. Xem tiến độ sản xuất tổng quan toàn bộ phim:
python "05_Production_Pipeline\production_orchestrator.py" --status

# 2. Liệt kê danh mục shot của một cảnh quay:
python "05_Production_Pipeline\production_orchestrator.py" --list-shots ep01_scene02

# 3. Tự động render toàn bộ một cảnh theo chuỗi Head-Tail liên hoàn và tự động ghép Master:
python "05_Production_Pipeline\production_orchestrator.py" --batch-scene ep01_scene02

# 4. Ghép nối các shot thành video Master Scene bảo toàn 100% âm thanh AAC:
python "05_Production_Pipeline\production_orchestrator.py" --concat-scene ep01_scene02

# 5. Master âm thanh chuẩn YouTube Green Dollar (-14 LUFS) kết hợp BGM:
python "05_Production_Pipeline\production_orchestrator.py" --master-audio ep01_scene02 --bgm "04_Assets/audio_sfx/scene01_bgm.m4a"

# 6. Quản lý tiến độ sản xuất theo 6 Tập độc lập:
python "05_Production_Pipeline\episode_manager.py" --status
python "05_Production_Pipeline\episode_manager.py" --sync-to-master

# 7. Render song song đa luồng (Multi-Worker 5-6 accounts Muse.ai):
python "05_Production_Pipeline\multi_worker_orchestrator.py" --verify
python "05_Production_Pipeline\multi_worker_orchestrator.py" --dispatch-episodes

# 8. Thẩm định chất lượng tự động nội bộ (Critic Quality Gate - $0 API Key):
python "05_Production_Pipeline\antigravity_critic_gate.py" --video "04_Assets/videos/ep02_scene01_master.mp4"
```

---

## 4. HỒ SƠ PHÁP LÝ & BẢO HỘ SỞ HỮU TRÍ TUỆ (IP NOTICE)

- **Nguyên tác văn học**: Thi phẩm *Đoạn Trường Tân Thanh* của Đại thi hào Nguyễn Du (>200 năm) đã thuộc về công chúng (Public Domain) theo Điều 43 Luật SHTT Việt Nam.
- **Quyền tác giả tác phẩm phái sinh**: Tác giả **Nguyễn Sĩ Sơn** sở hữu độc quyền quyền tác giả đối với toàn bộ phần sáng tạo mới: Kịch bản văn xuôi 60.000 từ, cấu trúc 6 tập mini-series, lời thoại, hệ thống tạo hình 32 nhân vật (Character Bible), thiết kế bối cảnh (Environment Bible), storyboard, prompt AI và tác phẩm điện ảnh hoàn chỉnh.
- **Bằng chứng sáng tạo Human-in-the-Loop**: Thư mục [`04_Assets/archive/`](file:///C:/Projects/KieuStory/04_Assets/archive/) lưu trữ toàn bộ lịch sử nháp, thử nghiệm và loại bỏ chứng minh quá trình lao động trí tuệ con người (tuyển chọn, điều phối và chỉ đạo nghệ thuật).
