Tài liệu sống được đồng bộ theo codebase hiện tại.
Bản đồ apps, modules, packages và ownership.
Cấu trúc mức cao
| Thư mục | Vai trò |
|---|
apps/api | API boundary cho toàn hệ thống |
apps/admin | Platform control plane |
apps/saas | Tenant operator surface (SaaS dashboard) |
apps/renderer | Public website runtime |
apps/docs | Documentation portal |
modules/* | Domain/module ownership |
packages/* | Shared tooling hoặc package hỗ trợ |
docs/ | Source nội dung tài liệu |
memory-bank/ | Source of truth cho bối cảnh và roadmap |
Ownership rule ngắn gọn
- App không sở hữu dữ liệu domain.
- Module mới là nơi sở hữu schema, contract và runtime capability.
- Backend compose route từ module manifests.
Khi nào sửa ở đâu
| Bạn muốn sửa | Nơi bắt đầu đúng |
|---|
| Schema dữ liệu | module sở hữu bảng đó |
| API logic | apps/api hoặc service/repository trong module |
| Màn hình admin | apps/admin hoặc modules/*/admin |
| Màn hình SaaS | apps/saas hoặc modules/*/saas |
| Public runtime | apps/renderer qua API domain resolution |