Skip to content

Bản đồ tài liệu ​

Version: 2.0
Date: 2026-11-16
Status: Working baseline

Một SoT ​

LoạiỞ đâuDùng khi nào
SoT duy nhấtdocs/ (VitePress)Owner đọc/feedback/duyệt Gate; Agent implement theo đây
Spec / governancespecs/, 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ênTrang
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ênTrangNội dung ngắn
01.Tổng quan kiến trúcđọcCách đọc gói kiến trúc
02.Mục lục & quyết định nềnđọcNhững gì DECIDED / OPEN
03.Kiến trúc tham chiếu nền tảngđọcPlatform Core, Application, deploy
04.Account, Workspace & quyềnđọcAccount, Workspace, phân quyền
05.Lưu trữ & File ServiceđọcFile Service, MinIO/S3, quota
06.Kiến trúc ChatđọcGeneral Chat / Business Chat
07.Payment & InvoiceđọcPayment & Invoice dùng chung
08.Application A — SalonđọcBrief sản phẩm Salon
09.SDK nền tảng & hợp đồng AppđọcSDK và contract tích hợp Application
10.Lộ trình phát triển & kickoff CursorđọcThứ tự xây dựng nền tảng
11.Quyết định & câu hỏi mởđọcSổ quyết định / câu hỏi còn lại
DB.Gói DatabaseđọcPlatform DB (Core / File / Payment / Invoice) — không gồm Application
DB00.Tổng quan DatabaseđọcOwnership + quan hệ datastore
DB01.Platform Core DBđọcBảng + cột foundation (SoT)
DB20.Journey → data ownershipđọcUser flow → lưu gì / DB nào / owner
DB91.MySQL vs PostgreSQLđọcSo sánh engine + D-022 (DECIDED R1–R5)
DB92.Object storage sau MinIOđọcThay MinIO Community (PROPOSED)

02. Mapping Framework ​

Bảng đầy đủ: 02. Mapping Framework

#TênTrangNội dung ngắn
01.Tổng quan FrameworkđọcOrchestrator + Spec Kit + Superpowers (D-019)
02.Tích hợp Spec KitđọcSpec Kit + Superpowers / MINAP / cài Cursor
03.Ma trận trách nhiệm AgentđọcAi được sửa artifact nào
04.Quy trình SDDđọcSpec Kit → Superpowers implement (D-019)
05.Human Approval GatesđọcGate 1A / 1B / 1C / 4 / 5
06.Constitution & quản trịđọcConstitution hierarchy
07.Mẫu Application ConstitutionđọcTemplate cho từng App
08.Cấu trúc thư mụcđọcLayout hub / nested repo
09.QA & truy vếtđọcAC → test; Testing ≠ Converge
10.Lộ trình & pilotđọcPhase + Authentication pilot
11.Quyết định frameworkđọcQuyết định / câu hỏi mở
12.Topology workspaceđọcHub + nhiều git repo
13.Ngôn ngữ tài liệuđọcSoT VI + thuật ngữ English; một lớp docs/
14.Hướng dẫn đầu–cuốiđọcHuman prompt → Spec Kit → Gate → Superpowers → QA
15.Baseline tooling repo (Node/UI)đọcPin Node/pnpm, ESLint/Prettier, pnpm check, version lock, Docker catalog — tham chiếu platform-ui

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English