🐉 Tài liệu chủ — Game 12 Con Giáp · SX tự động bằng Agent
Master Document · Gom toàn bộ kết quả + quy trình riêng game 12 Con Giáp

Tài liệu chủ: Game 12 Con Giáp — Quy trình sản xuất
vận hành hoàn toàn tự động bằng Agent (DeepSeek Pro / Flash)

Tài liệu này gom toàn bộ kết quả đã ban hành (hồ sơ 113 Task Card 9 trường, bộ 21 template, bản timeline cũ) và áp dụng chúng để xây quy trình sản xuất riêng cho game 12 Con Giáp: 12 con giáp × ngũ hành = 60 nhân vật · nuôi & nâng cấp linh thú bằng thức ăn kiếm từ nhiệm vụ · tổ đội · mỗi server = 1 hành tinh có đặc điểm buff/debuff riêng + bản đồ riêng · mở thêm hành tinh theo tăng trưởng người chơi · mở dần tính năng trong vận hành. Toàn bộ sản xuất do agent điều khiển: task dễ → DeepSeek Flash, task khó → DeepSeek Pro, chạy tự động đến khi phát hành Beta, hiển thị bằng dashboard dạng node graph (không phải kanban).

60 nhân vật
12 con giáp × 5 hành (Kim Mộc Thủy Hỏa Thổ)
11 task card
Đặc thù game, đủ 9 trường, có phân loại Flash/Pro
9 pha
Quy trình chuẩn đã ban hành, cổng chất lượng từng pha
1 hành tinh = 1 server
Sharding theo hành tinh, mở mới theo CCU
Node graph
Dashboard pipeline trực quan, không kanban
Auto → Beta
Orchestrator tự chạy hết chuỗi task đến cổng Beta

1 · Tổng quan game 12 Con Giáp

1.1 · Ý tưởng cốt lõi (Game Vision)

Thành phầnNội dung
Fantasy sentenceNgười chơi nhập năm sinh → nhận con giáp định mệnh → nuôi dưỡng, tiến hóa và cùng nó chinh phục các hành tinh.
Nhân vật12 con giáp × 5 ngũ hành = 60 tổ hợp nhân vật. Con giáp quyết định bộ kỹ năng & hình dáng; ngũ hành quyết định hệ thuộc tính & hệ tương sinh/khắc (Kim→Mộc→Thổ→Thủy→Hỏa→Kim; sinh: Mộc sinh Hỏa, Hỏa sinh Thổ, Thổ sinh Kim, Kim sinh Thủy, Thủy sinh Mộc).
Vòng lặp lõi (giai đoạn đầu)Làm nhiệm vụ → kiếm thức ăn → cho linh thú ăn → nuôi & nâng cấp (cấp, sao, tiến hóa) → mạnh hơn → làm nhiệm vụ khó hơn.
Vòng lặp xã hội (giai đoạn sau)Tổ đội (party 2–4 người) cùng làm nhiệm vụ/boss; phối hợp ngũ hành tương sinh để tạo combo đội hình.
Hành tinh = ServerMỗi server = 1 hành tinh với đặc điểm riêng (vd: Hỏa Tinh buff Hỏa +30%, debuff Thủy −20%) và bản đồ riêng. Người chơi mới được phân vào hành tinh phù hợp; mở hành tinh mới khi CCU tăng trong vận hành.
Nền tảngMobile (iOS + Android), thiết bị tối thiểu 3GB RAM, 30fps mục tiêu.
Kinh doanhF2P + battle pass + skin linh thú + vật phẩm tiến hóa (không pay-to-win tuyệt đối ở PvP — nguyên tắc đã ban hành).
Vận hànhMở dần tính năng theo giai đoạn (phễu mở khóa): tuần đầu chỉ nuôi+nhiệm vụ → tuần 2 tổ đội → tuần 4 hành tinh mới… — kiểm soát tải nội dung và giữ game luôn "có cái mới".

1.2 · Bản đồ hệ thống (các khối cần sản xuất)

KhốiThành phầnĐộ phức tạp (→ model)
Nền tảng nhân vậtXác định con giáp theo năm sinh (âm lịch), 60 tổ hợp, chỉ số ngũ hành, bộ kỹ năng mỗi giápPRO
Nuôi dưỡngThức ăn (thu thập, phân loại), cho ăn, cấp độ, sao, tiến hóa, hiệu ứng trưởng thànhPRO
Nhiệm vụNhiệm vụ chính/ngày/sự kiện, bảng thưởng thức ăn, độ khó tăng dầnFLASH
Tổ độiParty 2–4, matchmaking, combo ngũ hành đội hình, chat nhanhPRO
Hành tinh (server)Sharding theo hành tinh, đặc điểm buff/debuff, bản đồ riêng, chuyển hành tinh, mở hành tinh mớiPRO
Kinh tế & thương mạiTiền tệ, shop, battle pass, skin, gacha tiến hóa (nếu có)PRO
Nền tảng chungLogin, chat, guild, event CMS, analytics, anti-cheat, CDNTheo chuẩn hồ sơ chính (§2, TC-2-xx)

2 · Quy trình sản xuất 9 pha (áp dụng chuẩn đã ban hành)

Dùng lại đúng quy trình 9 pha của hồ sơ chính (quy-trinh-san-xuat-game-3d-mobile.html) — mọi nhiệm vụ là Task Card 9 trường, mọi nghiệm thu theo template TP-01→TP-21, mọi cổng chấm bằng tiêu chí chất lượng, không có tiêu chí nào liên quan đến ngày tháng. Điểm khác biệt riêng của game 12 Con Giáp được ghi đậm.

PhaNội dung áp dụngĐiểm đặc thù 12 Con GiápCổng chất lượng (gate)
Pha 0 · Ý tưởngNghiên cứu thị trường game nuôi thú/casual+MMO; chốt concept; GDD v1; economy v1Bài toán 60 tổ hợp nhân vật; USP "năm sinh → con giáp định mệnh"; mô hình hành tinh = serverM0: GDD ký, kinh tế mô phỏng ổn định, ma trận 60 nhân vật khả thi
Pha 1 · Tiền SXPrototype nuôi/nâng cấp; vertical slice (1 giáp hoàn chỉnh + 1 hành tinh nhỏ); chốt tech stackSlice phải chứng minh: nhập năm sinh → chọn giáp → nuôi → tiến hóa → tổ đội 2 ngườiM1: NPS ≥ 30, 0 crash/100 lượt, pipeline nhân vật đóng băng
Pha 2 · Hệ thống lõiServer (20 card TC-2-xx) + client gameplay + hiệu năng; đủ 12 con giáp phiên bản cơ bảnHành tinh service: sharding theo planet-id, bảng đặc điểm buff/debuff, sinh bản đồ theo tham số hành tinhMọi hệ thống end-to-end; 1 hành tinh mở được–đóng được tự động
Pha 3 · Nội dungĐủ 60 tổ hợp (12 giáp × 5 hành) qua pipeline chuẩn; 3 hành tinh mẫu + bản đồ; localization; marketing60 nhân vật = 12 bộ kỹ năng × 5 biến thể hành (tái dùng pipeline, đổi thuộc tính + VFX màu hành)Content freeze: đủ 60 tổ hợp, 3 hành tinh, 12 ngôn ngữ
Pha 4 · AlphaỔn định, hiệu năng, thanh toán, chaos test, pen-testTest chuyển hành tinh + mở hành tinh mới không downtimeM2: crash-free ≥ 99.5%, 0 P0, ≤ 20 P1
Pha 5 · Beta đóng/mởCBT 20.000 người → OBT 3 thị trường → KPI thậtĐo: tỉ lệ giữ con giáp định mệnh, tỉ lệ nuôi tiếp sau 7 ngày, tỉ lệ tổ độiM3: KPI trong dải chấp nhận, hạ tầng ≥ 30.000 CCU
Pha 6 · Soft launch2 thị trường nhỏ, 20 A/B test, phân tích churnA/B: hiệu ứng "năm sinh trùng con giáp", giá thức ăn, nhịp tiến hóaM4: GO global bằng dữ liệu
Pha 7 · GlobalStore 150 nước, 200k CCU, war room, hotfixKịch bản mở 10 hành tinh trong 24 giờ đầu (đợt người chơi mới)M5: launch sạch, báo cáo 14 ngày
Pha 8 · Live OpsSự kiện tuần, vá 2 tuần, mùa 6 tuần, mở rộng quýMở hành tinh mới theo CCU + mở dần tính năng (feature rollout) + sự kiện theo con giáp nămLiên tục: SLO, không sự cố lặp lại
📌 Quy tắc kế thừa: mọi task chung (login, matchmaking, IAP, analytics…) dùng nguyên task card TC-2-xx của hồ sơ chính; chỉ những hệ thống riêng của game 12 Con Giáp mới cần task card mới — liệt kê ở mục 3 bên dưới. Mọi tài liệu điền theo bộ 21 template (bo-template-tai-lieu-san-xuat-game.html).

3 · 11 Task Card đặc thù game 12 Con Giáp

Mỗi card đủ 9 trường theo chuẩn đã ban hành; các trường chung tham chiếu chuẩn vai trò §2 của hồ sơ chính. Góc phải mỗi card ghi FLASH (task dễ) hoặc PRO (task khó) — đây chính là định tuyến agent. Tiêu chí phân loại chi tiết ở mục 4.

TC-Z-01Đặc tả 60 tổ hợp nhân vật (12 giáp × ngũ hành)TKPRO
✅ Cần làm gì
Đặc tả đầy đủ 60 tổ hợp: mỗi con giáp 1 bộ kỹ năng (3 kỹ năng + chiêu cuối) và hình dáng; mỗi ngũ hành 1 bộ chỉ số/biến thể (màu VFX, kháng hệ, hệ tương sinh/khắc); lập ma trận 12×5 có tên, lore 1 câu, vai trò đội hình (tank/DPS/hỗ trợ/khống chế).
🎓 Skill cần có
theo chuẩn §2.2/§2.4 hồ sơ chính ↗ + kiến thức văn hóa 12 con giáp + ngũ hành tương sinh/khắc.
📥 Đầu vào
Game Vision (mục 1) · bảng 10 quan hệ ngũ hành · benchmark game nuôi thú (đối thủ) · GDD v1.
🛠️ Công cụ
Confluence (spec) · Excel ma trận 12×5 · Miro sơ đồ quan hệ hành.
🔄 Quy trình
  1. Định nghĩa 5 hành: chỉ số nền, kháng, tương sinh/khắc.
  2. Định nghĩa 12 giáp: bộ kỹ năng + vai trò + lore.
  3. Lập ma trận 60 tổ hợp (kỹ năng giáp × biến thể hành).
  4. Review chéo kinh tế (mỗi tổ hợp có lý do tồn tại).
  5. Ký đóng băng ma trận.
📏 Metrics đo
Đủ 60/60 tổ hợp có tên + lore + vai trò · mỗi giáp đủ 4 kỹ năng · mỗi hành có 3 biến thể số liệu (tấn công/phòng/hỗ trợ) · 0 tổ hợp trùng vai trò hoàn toàn.
📤 Output
Ma trận 12×5 (Excel) + spec kỹ năng 12 giáp + tài liệu quan hệ ngũ hành.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người chơi đọc 1 câu hiểu tổ hợp này mạnh/khắc gì. Khối lượng: 60 tổ hợp × đủ 5 trường.
📋 Mẫu D.O.D
☐ Ma trận 60/60 đủ trường, Game Director ký☐ 12 bộ kỹ năng không trùng cơ chế quá 40%☐ Quan hệ ngũ hành 10 cặp ghi rõ hệ số
TC-Z-02Hệ thống xác định con giáp theo năm sinh (âm lịch)LTTKFLASH
✅ Cần làm gì
Xây màn nhập năm sinh → quy đổi con giáp theo chu kỳ 12 năm của lịch âm (lưu ý người sinh tháng 1–2 dương lịch có thể thuộc năm âm lịch trước); hiển thị con giáp định mệnh + hiệu ứng ra mắt ấn tượng; cho đổi lại 1 lần nếu nhập nhầm.
🎓 Skill cần có
theo chuẩn §2.5 ↗ + bảng quy tắc 12 con giáp (Tý, Sửu, Dần, Mão, Thìn, Tỵ, Ngọ, Mùi, Thân, Dậu, Tuất, Hợi).
📥 Đầu vào
Bảng quy tắc năm âm lịch (TK cung cấp) · ma trận 60 tổ hợp (TC-Z-01) · art màn hình từ UI.
🛠️ Công cụ
Engine UI · bảng cấu hình chu kỳ 12 năm · công cụ test 100 năm sinh.
🔄 Quy trình
  1. Cài thuật toán quy đổi (năm % 12, lệch mốc chuẩn).
  2. Cài màn nhập + hiệu ứng ra mắt.
  3. Xử lý biên: sinh tháng 1–2, năm nhuận, nhập sai.
  4. Test 100 năm sinh mẫu so bảng chuẩn.
  5. Cho phép đổi 1 lần; lưu lựa chọn vĩnh viễn.
📏 Metrics đo
100/100 năm sinh test khớp bảng chuẩn · tỉ lệ hoàn thành màn nhập ≥ 90% (funnel) · thời gian quy đổi < 50ms · 0 lỗi chọn sai giáp ở biên tháng 1–2.
📤 Output
Màn chọn giáp trong build + bảng test 100 năm sinh + tài liệu quy tắc.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người sinh 15/02/1999 và 20/02/1999 nhận đúng con giáp khác nhau theo âm lịch. Khối lượng: 1 màn hình + 100 test case.
📋 Mẫu D.O.D
☐ 100/100 test case năm sinh pass☐ Hiệu ứng ra mắt được duyệt☐ Đổi 1 lần hoạt động; funnel ≥ 90%
TC-Z-03Hệ thống nuôi & nâng cấp linh thú (thức ăn, cấp, sao, tiến hóa)TKLTPRO
✅ Cần làm gì
Xây vòng lặp nuôi dưỡng: thức ăn (3–5 loại theo độ quý) → cho ăn (có giới hạn/ngày, hiệu ứng ăn) → tăng cấp (chỉ số) → sao (đột phá cần nguyên liệu) → tiến hóa (đổi hình dáng, mở kỹ năng mới); mọi thông số trong bảng cấu hình kinh tế.
🎓 Skill cần có
theo chuẩn §2.2/§2.4/§2.5 ↗ + thiết kế vòng lặp "nuôi thú" gây nghiện (benchmark: Neo Pets, Pokémon, game nuôi thú casual).
📥 Đầu vào
Economy sheet v1 (nguồn thức ăn, chi phí cấp) · ma trận 60 tổ hợp · art linh thú 3 giai đoạn (non/trưởng thành/tiến hóa).
🛠️ Công cụ
Excel (đường cong cấp/sao) · engine config · công cụ mô phỏng tiến trình 30 ngày.
🔄 Quy trình
  1. Thiết kế đường cong: cấp (mỗi cấp +X% chỉ số), sao (đột phá mỗi 10 cấp), tiến hóa (3 giai đoạn hình dáng).
  2. Cân bằng nguồn thức ăn từ nhiệm vụ (TC-Z-04) so chi phí.
  3. Mô phỏng 30 ngày F2P: đạt mốc then chốt không kẹt.
  4. Cài hiệu ứng nuôi (ăn, ngủ, thăng sao) tạo cảm giác "con vật sống".
  5. Test với 5 người chơi mẫu; chỉnh nhịp.
📏 Metrics đo
F2P đạt tiến hóa 1 trong 14 ngày chơi (mô phỏng) · đường cong cấp không kẹt (mọi mốc có nguồn thức ăn khả thi) · tỉ lệ quay lại cho ăn ngày 2 ≥ 60% (mục tiêu D1) · mọi thông số chỉnh được từ config.
📤 Output
Hệ nuôi trong build + bảng đường cong cấp/sao + báo cáo mô phỏng 30 ngày.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: mỗi lần cho ăn có phản hồi thỏa mãn (hiệu ứng + âm thanh + số nhảy). Khối lượng: 5 loại thức ăn × 3 giai đoạn tiến hóa × đường cong đầy đủ.
📋 Mẫu D.O.D
☐ Mô phỏng 30 ngày F2P không kẹt☐ 3 giai đoạn tiến hóa có art + kỹ năng mới☐ Hiệu ứng nuôi được playtest ≥ 7/10☐ Lead kinh tế ký đường cong
TC-Z-04Hệ thống nhiệm vụ kiếm thức ăn (farm loop)TKFLASH
✅ Cần làm gì
Xây bộ nhiệm vụ sinh thức ăn: nhiệm vụ chính tuyến (mở tính năng), nhiệm vụ ngày (3–5 việc), nhiệm vụ tuần, "rương thức ăn" theo mốc tiến trình; nhịp thưởng khớp đường cong nuôi (TC-Z-03) không thừa không thiếu.
🎓 Skill cần có
theo chuẩn §2.2 ↗ + thiết kế nhiệm vụ có nhịp, dùng lại bộ cơ chế nhiệm vụ chuẩn.
📥 Đầu vào
Economy sheet (nguồn thức ăn/ngày) · bộ cơ chế màn chơi · spec nuôi (TC-Z-03).
🛠️ Công cụ
Engine editor (dựng nhiệm vụ) · CMS (nhiệm vụ ngày cấu hình được) · bảng đối chiếu thưởng.
🔄 Quy trình
  1. Thiết kế 20 nhiệm vụ chính tuyến theo mốc mở tính năng.
  2. Thiết kế bộ nhiệm vụ ngày/tuần quay vòng.
  3. Đối chiếu tổng thức ăn/ngày với chi phí nuôi.
  4. Cấu hình lên CMS; test nhận thưởng không trùng.
  5. Chơi thử 5 người mới; chỉnh nhịp.
📏 Metrics đo
Tổng thức ăn/ngày = nhu cầu đường cong ±10% · 100% nhiệm vụ nhận thưởng đúng 1 lần (idempotent) · người mới luôn có "việc tiếp theo" trong 30 phút đầu · tỉ lệ hoàn thành nhiệm vụ ngày ≥ 60%.
📤 Output
Bộ nhiệm vụ trong build + bảng đối chiếu thưởng + báo cáo playtest nhịp.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: "kiếm ăn cho thú cưng" là động lực cảm xúc — mỗi nhiệm vụ gắn với câu chuyện con giáp. Khối lượng: 20 nhiệm vụ chính + 5 ngày + 3 tuần.
📋 Mẫu D.O.D
☐ Đối chiếu thưởng/chi phí ±10%☐ Idempotent 100% (test 100 lần nhận)☐ 5 người mới chơi thử không kẹt
TC-Z-05Hệ thống tổ đội (party 2–4 + combo ngũ hành)LTSVTKPRO
✅ Cần làm gì
Xây tổ đội: tạo party 2–4 người, mời bạn/guild, matchmaking tìm đồng đội cùng độ khó, combo ngũ hành (2 giáp tương sinh trong đội → buff cộng hưởng), làm nhiệm vụ/boss chung, chia thưởng công bằng, xử lý người rời giữa trận.
🎓 Skill cần có
theo chuẩn §2.5/§2.6 ↗ + tái dùng matchmaker (TC-2-07) và lobby (TC-2-10) của hồ sơ chính.
📥 Đầu vào
Spec combo ngũ hành (từ TC-Z-01) · matchmaker + lobby đã có · boss co-op.
🛠️ Công cụ
Engine + server · bảng cấu hình combo · bot mô phỏng party.
🔄 Quy trình
  1. Cài party CRUD + mời + trạng thái sẵn sàng.
  2. Nối matchmaker cho mode co-op 2–4 người.
  3. Cài combo ngũ hành: quét đội hình → áp buff tương sinh.
  4. Cài chia thưởng + người rời giữa trận (bot thay).
  5. Test 4 người thật + 100 trận bot cân bằng.
📏 Metrics đo
Ghép đội < 30s p95 · combo ngũ hành tính đúng 100% (test 60 tổ hợp mẫu) · party giữ nguyên nhóm 100% · người rời giữa trận không phá trận · tỉ lệ dùng tổ đội ở người chơi đủ điều kiện ≥ 40%.
📤 Output
Hệ tổ đội trong build + bảng combo ngũ hành + báo cáo test 100 trận.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người chơi chủ động rủ bạn "đúng hệ tương sinh" để tối ưu đội hình — tạo động lực xã hội. Khối lượng: 1 mode co-op × 60 tổ hợp test combo.
📋 Mẫu D.O.D
☐ Combo ngũ hành đúng 60/60 tổ hợp test☐ Ghép đội p95 < 30s; party giữ nguyên☐ Người rời giữa trận được xử lý☐ 4 người thật chơi thành công
TC-Z-06Kiến trúc Hành tinh = Server (sharding theo planet, buff/debuff)SVOPSPRO
✅ Cần làm gì
Xây nền tảng hành tinh: mỗi server = 1 hành tinh (planet-id làm shard key), mỗi hành tinh có bảng đặc điểm (buff/debuff theo ngũ hành, tài nguyên đặc sản, giới hạn CCU), người chơi mới được phân bổ tự động vào hành tinh phù hợp (cân tải + mệnh hành), chuyển hành tinh có điều kiện (vé/giới hạn).
🎓 Skill cần có
theo chuẩn §2.6/§2.7 ↗ + thiết kế sharding theo domain (planet), phân bổ người chơi mới.
📥 Đầu vào
Kiến trúc v2 hồ sơ chính · bảng đặc điểm hành tinh (TK) · dự báo CCU.
🛠️ Công cụ
Go/C++ · K8s · Redis · bảng quản trị hành tinh (planet console).
🔄 Quy trình
  1. Thiết kế schema planet (id, đặc điểm, trạng thái, CCU cap).
  2. Cài phân bổ người chơi mới (round-robin + theo mệnh hành ưu tiên).
  3. Cài áp dụng buff/debuff hành tinh vào trận đấu server-side.
  4. Cài chuyển hành tinh (vé, giới hạn, khóa tài nguyên theo hành tinh).
  5. Test: 3 hành tinh song song, chuyển qua lại, đóng mở hành tinh.
📏 Metrics đo
Phân bổ người chơi mới cân tải (lệch ≤ 15% giữa các hành tinh) · buff/debuff tính đúng 100% (test 60 tổ hợp × 3 hành tinh) · chuyển hành tinh không mất dữ liệu · 1 hành tinh chết không ảnh hưởng hành tinh khác.
📤 Output
Planet service + planet console + tài liệu vận hành hành tinh.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: hành tinh vừa là server vừa là "nội dung" — mỗi hành tinh phải khác biệt đáng kể, không chỉ đổi tên. Khối lượng: 3 hành tinh mẫu × đủ kịch bản test.
📋 Mẫu D.O.D
☐ Sharding planet-id hoạt động, phân bổ lệch ≤ 15%☐ Buff/debuff đúng 100% test☐ Chuyển hành tinh không mất dữ liệu☐ Planet console cho OPS thao tác 1 chạm
TC-Z-07Mở hành tinh mới tự động theo tăng trưởng người chơiSVOPSDXPRO
✅ Cần làm gì
Xây cơ chế mở hành tinh mới trong vận hành: khi CCU/người chơi mới vượt ngưỡng → tự đề xuất mở hành tinh mới (kèm tên, đặc điểm sinh ngẫu nhiên theo bộ quy tắc) → OPS duyệt 1 chạm → sinh hạ tầng + bản đồ từ template → đón người chơi mới; không downtime.
🎓 Skill cần có
theo chuẩn §2.6/§2.7 ↗ + provisioning tự động, sinh cấu hình theo quy tắc.
📥 Đầu vào
Planet service (TC-Z-06) · bộ quy tắc sinh đặc điểm hành tinh · template bản đồ (TC-Z-08) · ngưỡng mở mới (DX tính).
🛠️ Công cụ
K8s + IaC · planet console · bộ sinh đặc điểm (generator) · dashboard ngưỡng.
🔄 Quy trình
  1. Đặt ngưỡng mở mới (vd: 2 hành tinh liên tiếp ≥ 80% cap trong 3 ngày).
  2. Cài generator: tên + đặc điểm (1 buff chính + 1 debuff + tài nguyên đặc sản).
  3. Cài quy trình duyệt 1 chạm trên console → auto provisioning.
  4. Sinh bản đồ từ template + đặc điểm.
  5. Diễn tập: mở 3 hành tinh giả lập không downtime.
📏 Metrics đo
Mở hành tinh mới ≤ 15 phút từ lúc duyệt · 0 downtime · hành tinh mới đạt chuẩn đặc điểm (không trùng hành tinh cũ) · cảnh báo đạt ngưỡng hoạt động đúng · chi phí/hành tinh trong ngân sách.
📤 Output
Cơ chế mở hành tinh + generator đặc điểm + runbook mở hành tinh mới.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: "mở server" trở thành sự kiện nội dung (hành tinh mới = chủ đề mới) thay vì thao tác kỹ thuật. Khối lượng: 1 cơ chế + 3 lần diễn tập.
📋 Mẫu D.O.D
☐ Duyệt 1 chạm → live ≤ 15 phút, 0 downtime☐ Generator không trùng đặc điểm hành tinh cũ☐ Runbook được diễn tập 3 lần☐ Cảnh báo ngưỡng hoạt động đúng
TC-Z-08Sinh bản đồ hành tinh từ template (mỗi hành tinh 1 bản đồ)MTTATKPRO
✅ Cần làm gì
Xây hệ sinh bản đồ hành tinh: 1 template map nền + bộ tham số hành tinh (địa hình, bảng màu, cây cối, vật cản, khu vực) → mỗi hành tinh mới tự sinh 1 bản đồ khác biệt nhưng vẫn đúng ngân sách hiệu năng; thêm 2–3 bản đồ thủ công cho các hành tinh khởi điểm.
🎓 Skill cần có
theo chuẩn §2.9/§2.10/§2.3 ↗ + sinh địa hình thủ tục (Houdini/engine), thiết kế hệ tham số.
📥 Đầu vào
Bộ đặc điểm hành tinh (TC-Z-07) · art bible · ngân sách hiệu năng map · graybox kit.
🛠️ Công cụ
Houdini/Blender (thủ tục) · engine · công cụ kiểm tra map tự động.
🔄 Quy trình
  1. Thiết kế template map nền (layout chuẩn 3 vùng).
  2. Định nghĩa bộ tham số theo đặc điểm hành tinh (màu, địa hình, chướng ngại).
  3. Cài generator sinh map + kiểm tra tự động (không kẹt, đúng ngân sách).
  4. Làm thủ công 3 map cho hành tinh khởi điểm.
  5. Test sinh 10 map mẫu, đánh giá khác biệt.
📏 Metrics đo
Mỗi map sinh đạt: draw call ≤ 300 · 0 lỗi kẹt/xuyên (kiểm tra tự động) · 10 map sinh có độ khác biệt đánh giá ≥ 7/10 (mù đôi) · thời gian sinh 1 map trong ngưỡng vận hành.
📤 Output
Generator map + 3 map thủ công + báo cáo 10 map mẫu.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người chơi chuyển hành tinh thấy "thế giới mới" thật sự, không phải đổi màu map cũ. Khối lượng: 1 generator + 3 map thủ công + 10 map test.
📋 Mẫu D.O.D
☐ 10 map sinh đạt mọi ngân sách + không lỗi địa hình☐ Đánh giá mù đôi khác biệt ≥ 7/10☐ 3 map thủ công hoàn chỉnh☐ Generator tích hợp vào quy trình mở hành tinh
TC-Z-09Cân bằng ngũ hành tương sinh/khắc (10 quan hệ + buff hành tinh)TKDXPRO
✅ Cần làm gì
Cân bằng 2 lớp: (1) ngũ hành tương sinh/khắc (10 quan hệ, mỗi quan hệ 1 hệ số sát thương/kháng) đảm bảo 5 hành cân bằng vòng tròn; (2) buff/debuff hành tinh không làm 1 hành nào "bỏ xó" hay "độc tôn" ở bất kỳ hành tinh nào.
🎓 Skill cần có
theo chuẩn §2.4/§2.16 ↗ + mô phỏng Monte Carlo, ma trận đối kháng.
📥 Đầu vào
Ma trận 60 tổ hợp (TC-Z-01) · bảng đặc điểm hành tinh · dữ liệu trận đấu (bot + thật).
🛠️ Công cụ
Python/R mô phỏng · Excel ma trận · dashboard tỉ lệ thắng theo hành.
🔄 Quy trình
  1. Định hệ số 10 quan hệ sinh/khắc khởi điểm (vd: khắc +25% sát thương, bị khắc −25%).
  2. Mô phỏng 100.000 trận đối kháng mọi cặp hành.
  3. Đo tỉ lệ thắng từng hành ở từng hành tinh (có buff/debuff).
  4. Chỉnh hệ số/hệ số hành tinh đến khi mọi ô trong dải 45–55%.
  5. Ký bản cân bằng v1 kèm ngưỡng cảnh báo.
📏 Metrics đo
Tỉ lệ thắng mỗi hành 45–55% ở mọi hành tinh (mô phỏng) · 0 hành bị chọn < 5% ở bất kỳ hành tinh nào · vòng tròn khắc cân đối (không hành nào bị 2 hành khắc mà không khắc ai) · mọi chỉnh sửa có mô phỏng trước-sau.
📤 Output
Bảng hệ số ngũ hành + bảng buff hành tinh cân bằng + báo cáo mô phỏng 100.000 trận.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người chơi chọn hành theo sở thích + chiến thuật, không vì hành nào "auto mạnh". Khối lượng: 10 quan hệ × 3 hành tinh × 100.000 trận mô phỏng.
📋 Mẫu D.O.D
☐ Mọi ô hành×hành tinh trong dải 45–55%☐ 0 hành bỏ xó (< 5% chọn)☐ Ngưỡng cảnh báo lệch được thiết lập☐ Game Director ký bản cân bằng
TC-Z-10Hệ thống mở dần tính năng theo giai đoạn vận hành (feature rollout)SPTKSVFLASH
✅ Cần làm gì
Thiết kế phễu mở khóa tính năng theo giai đoạn: tuần 1 chỉ nuôi + nhiệm vụ → tuần 2 tổ đội → tuần 3 hành tinh thứ 2 → tuần 4 guild + sự kiện…; mỗi tính năng có điều kiện mở (cấp người chơi, số ngày, mốc CCU server) cấu hình trên CMS không cần build mới.
🎓 Skill cần có
theo chuẩn §2.1/§2.2 ↗ + thiết kế onboarding theo phễu (bài học D30 = vấn đề giờ đầu).
📥 Đầu vào
Danh sách tính năng theo pha · CMS (TC-2-19) · mục tiêu retention từng tuần.
🛠️ Công cụ
CMS (cấu hình điều kiện mở) · bảng roadmap tính năng · dashboard mức dùng từng tính năng.
🔄 Quy trình
  1. Lập lộ trình mở tính năng theo "1 điều mới mỗi tuần".
  2. Định điều kiện mở từng tính năng (level/ngày/CCU).
  3. Cấu hình lên CMS; test mở-đóng từng tính năng.
  4. Theo dõi tỉ lệ dùng sau mỗi lần mở.
  5. Điều chỉnh lộ trình theo dữ liệu.
📏 Metrics đo
Mỗi tuần có đúng 1 "điều mới" mở cho người chơi · mở/đóng tính năng qua CMS ≤ 5 phút · tỉ lệ dùng tính năng mới tuần đầu ≥ 30% người đủ điều kiện · không mở 2 tính năng lớn cùng tuần.
📤 Output
Lộ trình mở tính năng 12 tuần + cấu hình CMS + báo cáo tỉ lệ dùng.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: người chơi mới không "ngộp"; người chơi cũ luôn chờ "tuần sau có gì". Khối lượng: 12 tuần × 1 tính năng.
📋 Mẫu D.O.D
☐ Lộ trình 12 tuần được ký☐ Mở/đóng qua CMS ≤ 5 phút☐ Tỉ lệ dùng tính năng mới ≥ 30%☐ Báo cáo điều chỉnh lộ trình có dữ liệu
TC-Z-11Cổng chất lượng Beta — mục tiêu cuối của chuỗi tự độngSPQAPRO
✅ Cần làm gì
Chấm toàn bộ tiêu chí thoát để phát hành Beta (điểm kết thúc của chuỗi agent tự động): crash, hiệu năng, thanh toán, hạ tầng hành tinh, nội dung tối thiểu Beta (12 giáp cơ bản × 2 hành, 1 hành tinh, nuôi + tổ đội); ký lệnh phát hành Beta.
🎓 Skill cần có
theo chuẩn §2.1 ↗ + dùng template TP-16 (biên bản cổng chất lượng).
📥 Đầu vào
Output của toàn bộ task trong pipeline (dashboard) · template TP-16 · ngưỡng Beta đã chốt.
🛠️ Công cụ
Dashboard pipeline (mục 5) · biên bản TP-16 · bảng chấm tiêu chí.
🔄 Quy trình
  1. Rà toàn bộ task pipeline đạt D.O.D.
  2. Chấm 8 tiêu chí Beta bằng số liệu thật.
  3. Họp quyết định: PHÁT HÀNH / lặp sửa.
  4. Ký lệnh Beta; kích hoạt kế hoạch CBT.
📏 Metrics đo
Crash-free ≥ 99% · 0 P0, ≤ 30 P1 · 30fps máy tầm trung · thanh toán sandbox 20/20 · mở hành tinh mới diễn tập pass · đủ nội dung tối thiểu Beta · 100% task pipeline D.O.D đạt.
📤 Output
Biên bản cổng Beta (TP-16) + lệnh phát hành Beta + báo cáo tổng pipeline.
🏅 Tiêu chuẩn chất lượng & khối lượng
Chất lượng: đây là đích đến của chuỗi tự động — Beta chỉ phát khi mọi tiêu chí đạt, không có tiêu chí thời gian. Khối lượng: 8 tiêu chí × số liệu thật.
📋 Mẫu D.O.D
☐ 8/8 tiêu chí Beta đạt bằng số liệu☐ 100% task pipeline D.O.D đạt☐ Biên bản TP-16 có chữ ký☐ Lệnh phát hành Beta được ban hành

4 · Hệ thống sản xuất điều khiển bởi Agent (Flash / Pro)

Toàn bộ quá trình sản xuất và quản lý game do agent điều khiển, chạy tự động từ task đầu tiên đến task phát hành Beta. Nguyên tắc định tuyến: task đơn giản → DeepSeek Flash (nhanh, rẻ), task khó → DeepSeek Pro (suy luận sâu).

4.1 · Kiến trúc orchestrator

 config.json (API key tùy chọn)          tasks.json (pipeline: 40+ task, dependency, độ khó)
        │                                        │
        ▼                                        ▼
 ┌─────────────────────────── ORCHESTRATOR ───────────────────────────────┐
 │ 1. Quét task có dependency đã xong → đưa vào hàng đợi sẵn sàng          │
 │ 2. ROUTER phân loại: task đơn giản → FLASH · task khó → PRO            │
 │ 3. Giao agent ảo (agent-01..agent-08) theo vai trò (TK/LT/SV/MT/QA…)   │
 │ 4. Worker gọi model (API thật nếu có key / chế độ SIMULATION nếu không) │
 │ 5. Lưu output → chấm D.O.D (template TP-02) → chuyển trạng thái node    │
 │ 6. Lặp lại cho đến khi task cuối "TC-Z-11 Cổng Beta" đạt → DỪNG         │
 └─────────────────────────────────────────────────────────────────────────┘
        │
        ▼
 DASHBOARD (node graph): mỗi node = 1 task · màu = trạng thái · viền = Flash/Pro
        · mũi tên = dependency · click node = xem agent, model, input, output

4.2 · Tiêu chí phân loại Flash / Pro

Tiêu chíFLASH — task đơn giảnPRO — task khó
Phạm vi1 bộ phận, 1 hệ thống con, theo template có sẵnĐa bộ phận, kiến trúc hệ thống, quyết định thiết kế mở
Đầu vàoĐầu vào rõ, có mẫu điền (TP-xx)Đầu vào mơ hồ, cần nghiên cứu/đối chiếu nhiều nguồn
Rủi roThấp — sai thì sửa rẻ (text, checklist, báo cáo)Cao — tiền thật, dữ liệu người chơi, bảo mật, pháp lý, kinh tế
Đo lườngD.O.D đơn giản, kiểm tra được bằng mẫuĐa metrics, cần mô phỏng/kiểm định thống kê
Ví dụPatch note (TP-19), test case (TP-07), mô tả store, checklist asset, biên bản bàn giao, nhiệm vụ ngày (TC-Z-04)GDD, kinh tế/gacha/IAP, matchmaking, kiến trúc hành tinh (TC-Z-06/07), cân bằng ngũ hành (TC-Z-09), cổng chất lượng (TC-Z-11)

4.3 · Bảng định tuyến model cho toàn bộ pipeline

Nhóm taskModelLý do
TC-Z-01 Đặc tả 60 tổ hợp · TC-Z-03 Nuôi/nâng cấp · TC-Z-05 Tổ đội · TC-Z-06 Hành tinh=server · TC-Z-07 Mở hành tinh · TC-Z-08 Sinh bản đồ · TC-Z-09 Cân bằng ngũ hành · TC-Z-11 Cổng BetaPROKiến trúc, kinh tế, cân bằng, đa phụ thuộc, rủi ro cao
TC-Z-02 Năm sinh → con giáp · TC-Z-04 Nhiệm vụ kiếm thức ăn · TC-Z-10 Mở dần tính năngFLASHQuy tắc rõ, theo template, rủi ro thấp
Nền tảng chung (kế thừa hồ sơ chính): login, chat, guild, analytics, CMS… (TC-2-xx)Theo phân loại gốc trong hồ sơ chính (mục 5) — phần lớn server lõi = PROKế thừa nguyên chuẩn đã ban hành
Tài liệu & báo cáo (patch note, store checklist, LQA, playtest report, bàn giao)FLASHĐiền theo template TP-xx, kiểm tra bằng checklist

4.4 · Chế độ chạy

Chế độĐiều kiệnHành vi
API-LIVE (đang bật)config.json có apiKey (đã điền)Worker gọi DeepSeek API thật: task Flash → deepseek-chat, task Pro → deepseek-reasoner; output là tài liệu agent thật sinh ra. Đã kiểm chứng: T001 ra 13.417 ký tự nội dung thật.
Simulationconfig.json không có apiKeyWorker tự sinh output theo mẫu D.O.D của task (ghi nhãn [SIM]) — dùng để kiểm chứng luồng và dashboard không tốn tiền.
Bridge cho agent DSHtask có "model": "dsh"Orchestrator đưa task vào hộp thư bridge/inbox/, trạng thái waiting-agent; agent DSH xử lý rồi nộp qua node cli.js complete — đã test end-to-end thành công.
⚠️ Nguyên tắc an toàn: kể cả khi chạy API thật, các cổng chất lượng (gate) vẫn chấm D.O.D theo template — agent không được tự duyệt chính mình; task có tiêu chí không đạt sẽ tự chuyển trạng thái "cần sửa" và được giao lại cho model Pro xử lý 1 lần.

5 · Dashboard node graph — trực quan hóa chuỗi sản xuất

App chạy local trên máy Windows, viết bằng Node.js + HTML/JS thuần (không cần cài thư viện). Giao diện là chuỗi pipeline dạng graph node (không phải kanban board): mỗi node là 1 task, mũi tên là dependency, nhìn một cái thấy toàn bộ dây chuyền sản xuất và chỗ nào đang chạy.

5.1 · Những gì dashboard thể hiện (đúng yêu cầu)

Yêu cầuThể hiện trên dashboard
Từng task đã giao cho agent nàoNode ghi tên agent (agent-01…agent-08) + vai trò (TK/LT/SV/MT/QA/OPS/MK/SP); click node mở panel chi tiết
Bộ não là Pro hay FlashViền node: tím = Pro · xanh cyan = Flash + nhãn chữ trên node + bộ lọc theo model
Output là gìPanel chi tiết hiển thị output từng task (văn bản agent sinh ra), kèm trạng thái D.O.D
Chuỗi pipeline dạng graph nodeSVG node-graph: cột theo pha (Pha 0→8), mũi tên dependency, zoom/pan, layout tự động
Không phải kanbanKhông có cột bảng kéo-thả — chỉ có đồ thị có hướng (DAG) + bảng log phụ

5.2 · Trạng thái & màu node

MàuÝ nghĩa
XámChờ dependency (chưa thể chạy)
Xanh dương (nhấp nháy)Đang chạy — worker đang gọi model
Xanh láHoàn thành — D.O.D đạt, có output
ĐỏThất bại — đang chờ model Pro xử lý lại
Vàng (node cuối)BETA RELEASED — đích của chuỗi tự động

5.3 · Cách chạy trên máy này

BướcThao tác
1Cài Node.js (nếu chưa có) → mở PowerShell trong thư mục 12congiap-pipeline
2Chạy node server.js → server tự động khởi động orchestrator
3Mở trình duyệt http://localhost:8123 → xem node graph chạy trực tiếp
4API key DeepSeek đã được điền trong config.json → mặc định chạy chế độ API-LIVE (bộ não thật). Xóa key để quay về simulation
5Không cần thao tác gì thêm — pipeline tự chạy từ task đầu đến task phát hành Beta rồi dừng
🔌 Đã tích hợp với agent DSH (cầu điều phối 2 chiều): agent điều khiển pipeline qua REST + node cli.js (thêm task, tạm dừng, giám sát) và pipeline giao task đặc biệt (model=dsh) cho agent qua hộp thư bridge/inbox/ — xem chi tiết INTEGRATION.md. Đã cài 72 skill từ GitHub vào DSH (agency + game 3D) — xem SKILLS-INSTALLED.md. Phương án hạ tầng global rẻ nhất: bao-cao-chi-phi-go-global.html (Hetzner + Cloudflare R2 ≈ $850–1.400/tháng ở 100k CCU).

6 · Mục lục toàn bộ tài liệu đã ban hành (gom về 1 chỗ)

#Tài liệuFileNội dungDùng khi nào
1Tài liệu chủ (file này)tai-lieu-tong-hop-12-con-giap.htmlTổng quan game 12 Con Giáp + quy trình 9 pha + 11 task card đặc thù + hệ agent Flash/Pro + dashboardĐiểm vào duy nhất của dự án 12 Con Giáp
2Hồ sơ Task Card chuẩnquy-trinh-san-xuat-game-3d-mobile.html113 task card 9 trường (mọi pha, 19 chuẩn vai trò, kiến trúc 12 server, 16 nguồn nghiên cứu)Tra cứu task chung (login, matchmaking, IAP…) — kế thừa nguyên văn
3Bộ 21 Templatebo-template-tai-lieu-san-xuat-game.html21 biểu mẫu điền được (TP-00 → TP-21) kèm nút sao chép/inĐiền mọi tài liệu trong dự án; agent cũng điền theo các mẫu này
4Bản timeline cũ (lưu trữ)quy-trinh-san-xuat-game-3d-mobile-BAN-TIMELINE-CU.htmlPhiên bản ước lượng theo ngày (đã bị thay thế bởi chuẩn 9 trường)Chỉ tham khảo lịch sử, không dùng cho 12 Con Giáp
5App dashboard + orchestrator12congiap-pipeline/ (node server.js)Node graph + agent tự động Flash/Pro/Dsh chạy đến Beta + cầu tích hợp agent DSH (cli.js, bridge)Vận hành sản xuất hằng ngày
6Kiểm kê skill đã càiSKILLS-INSTALLED.md72 skill agency + game 3D từ 5 repo GitHub, đã vào catalog DSHTra cứu bộ công cụ agent
7Báo cáo chi phí globalbao-cao-chi-phi-go-global.htmlPhương án rẻ nhất: Hetzner + Cloudflare R2/CDN ≈ $850–1.400/tháng ở 100k CCU + danh sách cần nhờ bạnChuẩn bị hạ tầng khi go global
✅ Điểm kết thúc chuỗi tự động: task cuối cùng của pipeline là TC-Z-11 — Cổng chất lượng Beta. Khi node này chuyển XANH LÁ với đủ 8/8 tiêu chí, hệ thống tự dừng và game đạt trạng thái BETA RELEASED — toàn bộ quá trình từ GDD đến Beta không cần con người can thiệp.