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).
1 · Tổng quan game 12 Con Giáp
1.1 · Ý tưởng cốt lõi (Game Vision)
| Thành phần | Nội dung |
|---|---|
| Fantasy sentence | Ngườ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ật | 12 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 = Server | Mỗ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ảng | Mobile (iOS + Android), thiết bị tối thiểu 3GB RAM, 30fps mục tiêu. |
| Kinh doanh | F2P + 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ành | Mở 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ối | Thành phần | Độ phức tạp (→ model) |
|---|---|---|
| Nền tảng nhân vật | Xá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áp | PRO |
| Nuôi dưỡng | Thức ăn (thu thập, phân loại), cho ăn, cấp độ, sao, tiến hóa, hiệu ứng trưởng thành | PRO |
| Nhiệm vụ | Nhiệm vụ chính/ngày/sự kiện, bảng thưởng thức ăn, độ khó tăng dần | FLASH |
| Tổ đội | Party 2–4, matchmaking, combo ngũ hành đội hình, chat nhanh | PRO |
| 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ới | PRO |
| Kinh tế & thương mại | Tiền tệ, shop, battle pass, skin, gacha tiến hóa (nếu có) | PRO |
| Nền tảng chung | Login, chat, guild, event CMS, analytics, anti-cheat, CDN | Theo 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.
| Pha | Nội dung áp dụng | Điểm đặc thù 12 Con Giáp | Cổng chất lượng (gate) |
|---|---|---|---|
| Pha 0 · Ý tưởng | Nghiên cứu thị trường game nuôi thú/casual+MMO; chốt concept; GDD v1; economy v1 | Bà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 = server | M0: GDD ký, kinh tế mô phỏng ổn định, ma trận 60 nhân vật khả thi |
| Pha 1 · Tiền SX | Prototype nuôi/nâng cấp; vertical slice (1 giáp hoàn chỉnh + 1 hành tinh nhỏ); chốt tech stack | Slice phải chứng minh: nhập năm sinh → chọn giáp → nuôi → tiến hóa → tổ đội 2 người | M1: NPS ≥ 30, 0 crash/100 lượt, pipeline nhân vật đóng băng |
| Pha 2 · Hệ thống lõi | Server (20 card TC-2-xx) + client gameplay + hiệu năng; đủ 12 con giáp phiên bản cơ bản | Hành tinh service: sharding theo planet-id, bảng đặc điểm buff/debuff, sinh bản đồ theo tham số hành tinh | Mọ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; marketing | 60 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-test | Test chuyển hành tinh + mở hành tinh mới không downtime | M2: 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ổ đội | M3: KPI trong dải chấp nhận, hạ tầng ≥ 30.000 CCU |
| Pha 6 · Soft launch | 2 thị trường nhỏ, 20 A/B test, phân tích churn | A/B: hiệu ứng "năm sinh trùng con giáp", giá thức ăn, nhịp tiến hóa | M4: GO global bằng dữ liệu |
| Pha 7 · Global | Store 150 nước, 200k CCU, war room, hotfix | Kị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 Ops | Sự 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ăm | Liên tục: SLO, không sự cố lặp lại |
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)
- Định nghĩa 5 hành: chỉ số nền, kháng, tương sinh/khắc.
- Định nghĩa 12 giáp: bộ kỹ năng + vai trò + lore.
- Lập ma trận 60 tổ hợp (kỹ năng giáp × biến thể hành).
- Review chéo kinh tế (mỗi tổ hợp có lý do tồn tại).
- Ký đóng băng ma trận.
TC-Z-02Hệ thống xác định con giáp theo năm sinh (âm lịch)
- Cài thuật toán quy đổi (năm % 12, lệch mốc chuẩn).
- Cài màn nhập + hiệu ứng ra mắt.
- Xử lý biên: sinh tháng 1–2, năm nhuận, nhập sai.
- Test 100 năm sinh mẫu so bảng chuẩn.
- Cho phép đổi 1 lần; lưu lựa chọn vĩnh viễn.
TC-Z-03Hệ thống nuôi & nâng cấp linh thú (thức ăn, cấp, sao, tiến hóa)
- 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).
- Cân bằng nguồn thức ăn từ nhiệm vụ (TC-Z-04) so chi phí.
- Mô phỏng 30 ngày F2P: đạt mốc then chốt không kẹt.
- Cài hiệu ứng nuôi (ăn, ngủ, thăng sao) tạo cảm giác "con vật sống".
- Test với 5 người chơi mẫu; chỉnh nhịp.
TC-Z-04Hệ thống nhiệm vụ kiếm thức ăn (farm loop)
- Thiết kế 20 nhiệm vụ chính tuyến theo mốc mở tính năng.
- Thiết kế bộ nhiệm vụ ngày/tuần quay vòng.
- Đối chiếu tổng thức ăn/ngày với chi phí nuôi.
- Cấu hình lên CMS; test nhận thưởng không trùng.
- Chơi thử 5 người mới; chỉnh nhịp.
TC-Z-05Hệ thống tổ đội (party 2–4 + combo ngũ hành)
- Cài party CRUD + mời + trạng thái sẵn sàng.
- Nối matchmaker cho mode co-op 2–4 người.
- Cài combo ngũ hành: quét đội hình → áp buff tương sinh.
- Cài chia thưởng + người rời giữa trận (bot thay).
- Test 4 người thật + 100 trận bot cân bằng.
TC-Z-06Kiến trúc Hành tinh = Server (sharding theo planet, buff/debuff)
- Thiết kế schema planet (id, đặc điểm, trạng thái, CCU cap).
- Cài phân bổ người chơi mới (round-robin + theo mệnh hành ưu tiên).
- Cài áp dụng buff/debuff hành tinh vào trận đấu server-side.
- Cài chuyển hành tinh (vé, giới hạn, khóa tài nguyên theo hành tinh).
- Test: 3 hành tinh song song, chuyển qua lại, đóng mở hành tinh.
TC-Z-07Mở hành tinh mới tự động theo tăng trưởng người chơi
- Đặt ngưỡng mở mới (vd: 2 hành tinh liên tiếp ≥ 80% cap trong 3 ngày).
- Cài generator: tên + đặc điểm (1 buff chính + 1 debuff + tài nguyên đặc sản).
- Cài quy trình duyệt 1 chạm trên console → auto provisioning.
- Sinh bản đồ từ template + đặc điểm.
- Diễn tập: mở 3 hành tinh giả lập không downtime.
TC-Z-08Sinh bản đồ hành tinh từ template (mỗi hành tinh 1 bản đồ)
- Thiết kế template map nền (layout chuẩn 3 vùng).
- Định nghĩa bộ tham số theo đặc điểm hành tinh (màu, địa hình, chướng ngại).
- Cài generator sinh map + kiểm tra tự động (không kẹt, đúng ngân sách).
- Làm thủ công 3 map cho hành tinh khởi điểm.
- Test sinh 10 map mẫu, đánh giá khác biệt.
TC-Z-09Cân bằng ngũ hành tương sinh/khắc (10 quan hệ + buff hành tinh)
- Đị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%).
- Mô phỏng 100.000 trận đối kháng mọi cặp hành.
- Đo tỉ lệ thắng từng hành ở từng hành tinh (có buff/debuff).
- Chỉnh hệ số/hệ số hành tinh đến khi mọi ô trong dải 45–55%.
- Ký bản cân bằng v1 kèm ngưỡng cảnh báo.
TC-Z-10Hệ thống mở dần tính năng theo giai đoạn vận hành (feature rollout)
- Lập lộ trình mở tính năng theo "1 điều mới mỗi tuần".
- Định điều kiện mở từng tính năng (level/ngày/CCU).
- Cấu hình lên CMS; test mở-đóng từng tính năng.
- Theo dõi tỉ lệ dùng sau mỗi lần mở.
- Điều chỉnh lộ trình theo dữ liệu.
TC-Z-11Cổng chất lượng Beta — mục tiêu cuối của chuỗi tự động
- Rà toàn bộ task pipeline đạt D.O.D.
- Chấm 8 tiêu chí Beta bằng số liệu thật.
- Họp quyết định: PHÁT HÀNH / lặp sửa.
- Ký lệnh Beta; kích hoạt kế hoạch CBT.
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ản | PRO — task khó |
|---|---|---|
| Phạm vi | 1 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 ro | Thấ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ường | D.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 task | Model | Lý 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 Beta | PRO | Kiế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ăng | FLASH | Quy 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 = PRO | Kế 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ện | Hà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. |
| Simulation | config.json không có apiKey | Worker 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 DSH | task 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. |
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ầu | Thể hiện trên dashboard |
|---|---|
| Từng task đã giao cho agent nào | Node 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 Flash | Viề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 node | SVG node-graph: cột theo pha (Pha 0→8), mũi tên dependency, zoom/pan, layout tự động |
| Không phải kanban | Khô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ám | Chờ 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ước | Thao tác |
|---|---|
| 1 | Cài Node.js (nếu chưa có) → mở PowerShell trong thư mục 12congiap-pipeline |
| 2 | Chạy node server.js → server tự động khởi động orchestrator |
| 3 | Mở trình duyệt http://localhost:8123 → xem node graph chạy trực tiếp |
| 4 | API 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 |
| 5 | Khô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 |
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ệu | File | Nội dung | Dùng khi nào |
|---|---|---|---|---|
| 1 | Tài liệu chủ (file này) | tai-lieu-tong-hop-12-con-giap.html | Tổ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 |
| 2 | Hồ sơ Task Card chuẩn | quy-trinh-san-xuat-game-3d-mobile.html | 113 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 |
| 3 | Bộ 21 Template | bo-template-tai-lieu-san-xuat-game.html | 21 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 |
| 4 | Bản timeline cũ (lưu trữ) | quy-trinh-san-xuat-game-3d-mobile-BAN-TIMELINE-CU.html | Phiê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 |
| 5 | App dashboard + orchestrator | 12congiap-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 |
| 6 | Kiểm kê skill đã cài | SKILLS-INSTALLED.md | 72 skill agency + game 3D từ 5 repo GitHub, đã vào catalog DSH | Tra cứu bộ công cụ agent |
| 7 | Báo cáo chi phí global | bao-cao-chi-phi-go-global.html | Phương án rẻ nhất: Hetzner + Cloudflare R2/CDN ≈ $850–1.400/tháng ở 100k CCU + danh sách cần nhờ bạn | Chuẩn bị hạ tầng khi go global |