Appearance
Bản đồ tài liệu
Version: 2.0
Date: 2026-11-16
Status: Working baseline
Một SoT
| Loại | Ở đâu | Dùng khi nào |
|---|---|---|
| SoT duy nhất | docs/ (VitePress) | Owner đọc/feedback/duyệt Gate; Agent implement theo đây |
| Spec / governance | specs/, nested */specs/, governance/ | Artifact SDD và policy — cùng quy ước ngôn ngữ (VI + thuật ngữ EN) |
Chính sách: /framework/13-documentation-language.
Nên đọc theo thứ tự
| # | Tên | Trang |
|---|---|---|
| 01. | Bản đồ | /map |
| 02. | Mục lục đầy đủ | /document-index |
| 02b. | Repository Catalog | /repositories |
| 03. | Thuật ngữ | /glossary |
| 04. | Quyết định nền tảng | /architecture/02-master-index-and-decisions |
| 05. | Account & Workspace | /architecture/04-identity-workspace-and-access-model |
| 05d. | Tổng quan Database | /architecture/database/00-overview |
| 06. | Lộ trình phát triển | /architecture/10-development-roadmap-and-cursor-kickoff |
| 07. | Human Approval Gates | /framework/05-human-approval-gates |
| 08. | Hướng dẫn đầu–cuối (AI Team) | /framework/14-end-to-end-usage-guide |
| 09. | Topology workspace | /framework/12-workspace-topology |
01. Mapping Architecture
Bảng đầy đủ: 01. Mapping Architecture
| # | Tên | Trang | Nội dung ngắn |
|---|---|---|---|
| 01. | Tổng quan kiến trúc | đọc | Cách đọc gói kiến trúc |
| 02. | Mục lục & quyết định nền | đọc | Những gì DECIDED / OPEN |
| 03. | Kiến trúc tham chiếu nền tảng | đọc | Platform Core, Application, deploy |
| 04. | Account, Workspace & quyền | đọc | Account, Workspace, phân quyền |
| 05. | Lưu trữ & File Service | đọc | File Service, MinIO/S3, quota |
| 06. | Kiến trúc Chat | đọc | General Chat / Business Chat |
| 07. | Payment & Invoice | đọc | Payment & Invoice dùng chung |
| 08. | Application A — Salon | đọc | Brief sản phẩm Salon |
| 09. | SDK nền tảng & hợp đồng App | đọc | SDK và contract tích hợp Application |
| 10. | Lộ trình phát triển & kickoff Cursor | đọc | Thứ tự xây dựng nền tảng |
| 11. | Quyết định & câu hỏi mở | đọc | Sổ quyết định / câu hỏi còn lại |
| DB. | Gói Database | đọc | Platform DB (Core / File / Payment / Invoice) — không gồm Application |
| DB00. | Tổng quan Database | đọc | Ownership + quan hệ datastore |
| DB01. | Platform Core DB | đọc | Bảng + cột foundation (SoT) |
| DB20. | Journey → data ownership | đọc | User flow → lưu gì / DB nào / owner |
| DB91. | MySQL vs PostgreSQL | đọc | So sánh engine + D-022 (DECIDED R1–R5) |
| DB92. | Object storage sau MinIO | đọc | Thay MinIO Community (PROPOSED) |
02. Mapping Framework
Bảng đầy đủ: 02. Mapping Framework
| # | Tên | Trang | Nội dung ngắn |
|---|---|---|---|
| 01. | Tổng quan Framework | đọc | Orchestrator + Spec Kit + Superpowers (D-019) |
| 02. | Tích hợp Spec Kit | đọc | Spec Kit + Superpowers / MINAP / cài Cursor |
| 03. | Ma trận trách nhiệm Agent | đọc | Ai được sửa artifact nào |
| 04. | Quy trình SDD | đọc | Spec Kit → Superpowers implement (D-019) |
| 05. | Human Approval Gates | đọc | Gate 1A / 1B / 1C / 4 / 5 |
| 06. | Constitution & quản trị | đọc | Constitution hierarchy |
| 07. | Mẫu Application Constitution | đọc | Template cho từng App |
| 08. | Cấu trúc thư mục | đọc | Layout hub / nested repo |
| 09. | QA & truy vết | đọc | AC → test; Testing ≠ Converge |
| 10. | Lộ trình & pilot | đọc | Phase + Authentication pilot |
| 11. | Quyết định framework | đọc | Quyết định / câu hỏi mở |
| 12. | Topology workspace | đọc | Hub + nhiều git repo |
| 13. | Ngôn ngữ tài liệu | đọc | SoT VI + thuật ngữ English; một lớp docs/ |
| 14. | Hướng dẫn đầu–cuối | đọc | Human prompt → Spec Kit → Gate → Superpowers → QA |
| 15. | Baseline tooling repo (Node/UI) | đọc | Pin Node/pnpm, ESLint/Prettier, pnpm check, version lock, Docker catalog — tham chiếu platform-ui |