Appearance
Mục lục tài liệu
Version: 2.0
Date: 2026-11-16
Status: Working baseline
SoT duy nhất dưới docs/ (VitePress). Văn xuôi tiếng Việt; thuật ngữ chuyên ngành giữ English.
1. 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 |
| 05b. | Platform Core DB | /architecture/database/01-platform-core |
| 05c. | Hướng dẫn dùng Platform Core | /architecture/13-platform-core-usage-guide |
| 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 |
2. Architecture (docs/architecture/)
| # | Tên | Trang |
|---|---|---|
| 01. | Tổng quan kiến trúc | /architecture/01-overview |
| 02. | Mục lục & quyết định nền | /architecture/02-master-index-and-decisions |
| 03. | Kiến trúc tham chiếu nền tảng | /architecture/03-platform-reference-architecture |
| 04. | Account, Workspace & quyền | /architecture/04-identity-workspace-and-access-model |
| 05. | Lưu trữ & File Service | /architecture/05-storage-and-file-service |
| 06. | Kiến trúc Chat | /architecture/06-minap-chat-architecture |
| 07. | Payment & Invoice | /architecture/07-shared-payment-and-invoice-services |
| 08. | Application A — Salon | /architecture/08-application-a-salon-product-brief |
| 09. | SDK nền tảng & hợp đồng App | /architecture/09-platform-sdk-and-application-contracts |
| 10. | Lộ trình phát triển & kickoff Cursor | /architecture/10-development-roadmap-and-cursor-kickoff |
| 11. | Quyết định & câu hỏi mở | /architecture/11-decisions-and-open-questions |
| 13. | Hướng dẫn dùng Platform Core | /architecture/13-platform-core-usage-guide |
2.1 Database (docs/architecture/database/)
| # | Tên | Trang |
|---|---|---|
| 00. | Tổng quan Database | /architecture/database/00-overview |
| 01. | Platform Core DB | /architecture/database/01-platform-core |
| 02. | File Service DB | /architecture/database/02-file-service |
| 03. | Payment Integration DB | /architecture/database/03-payment-integration |
| 04. | Invoice Integration DB | /architecture/database/04-invoice-integration |
| 20. | Journey → data ownership | /architecture/database/20-user-journey-data-ownership |
| 90. | Store bên ngoài | /architecture/database/90-external-stores |
| 91. | MySQL vs PostgreSQL | /architecture/database/91-engine-mysql-vs-postgresql |
| 92. | Object storage sau MinIO | /architecture/database/92-object-storage-after-minio |
| —. | Mục lục gói DB | /architecture/database/ |
3. Framework (docs/framework/)
| # | Tên | Trang |
|---|---|---|
| 01. | Tổng quan Framework | /framework/01-overview |
| 02. | Tích hợp Spec Kit | /framework/02-spec-kit-integration |
| 03. | Ma trận trách nhiệm Agent | /framework/03-agent-responsibility-matrix |
| 04. | Quy trình SDD | /framework/04-sdd-workflow |
| 05. | Human Approval Gates | /framework/05-human-approval-gates |
| 06. | Constitution & quản trị | /framework/06-constitution-governance |
| 07. | Mẫu Application Constitution | /framework/07-application-constitution-template |
| 08. | Cấu trúc thư mục | /framework/08-directory-structure |
| 09. | QA & truy vết | /framework/09-qa-traceability |
| 10. | Lộ trình & pilot | /framework/10-rollout-and-pilot |
| 11. | Quyết định framework | /framework/11-decisions |
| 12. | Topology workspace | /framework/12-workspace-topology |
| 13. | Ngôn ngữ tài liệu | /framework/13-documentation-language |
| 14. | Hướng dẫn đầu–cuối | /framework/14-end-to-end-usage-guide |
| 15. | Baseline tooling repo (Node/UI) | /framework/15-repo-tooling-baseline |
| — | Nguồn Spec Kit / Superpowers | /framework/SOURCES |
4. Mapping tài liệu
| # | Tên | Trang |
|---|---|---|
| 01. | Mapping Architecture | /mapping-architecture |
| 02. | Mapping Framework | /mapping-framework |
5. Governance (hay dùng khi duyệt)
| Tên | Path | Dùng khi |
|---|---|---|
| Platform Constitution | governance/minap-platform-constitution.md | Nguyên tắc chung của MINAP |
| Mẫu ghi nhận phê duyệt | governance/approval-record-template.md | Sau khi duyệt Gate |
| Mẫu yêu cầu thay đổi | governance/change-request-template.md | Đổi phạm vi / kiến trúc đã duyệt |
| Mẫu work item | governance/sdd-work-item-template.md | Tạo việc SDD mới |