Appearance
Kiến trúc Database — Tổng quan
Version: 0.6
Date: 2026-11-17
Status: Working baseline (skeleton; engine D-022 DECIDED)
1. Mục đích
Mô tả các datastore platform trong phạm vi thiết kế database lần này: ai sở hữu, tên vật lý, và quan hệ logic.
Quy ước: mỗi database = một tài liệu chính (01–04, …) chứa cả mục lục và thiết kế cột/ER — không tách file schema riêng dưới /architecture/12-….
Trong phạm vi gói này: Platform Core, File Service, Payment Integration, Invoice Integration, store ngoài (ranh giới).
Ngoài phạm vi gói này: DB domain của từng Application (A/B/C, kể cả Salon chỉ là dự kiến) — thiết kế khi có Application Gate / discovery riêng.
Cách đọc theo journey: 20. Journey → data ownership (bắt đầu từ đăng ký / login lần đầu).
2. Nguyên tắc (từ architecture SoT)
- Không share database giữa Applications — khi Application có DB riêng, Application không đọc DB của Application khác (nguyên tắc nền; schema App không nằm trong gói này).
- Ownership rõ — Platform Core, File Service, Payment, Invoice sở hữu dữ liệu của mình.
- Business ID dạng
{prefix}_{nanoid}(D-017); sắp xếp thời gian quacreated_at. - Thời gian = UTC (offset 0): mọi timestamp nghiệp vụ lưu/so sánh theo UTC. PostgreSQL: ưu tiên
TIMESTAMPTZ, session/TimeZone=UTC(cài đặt server & app connection). Client (web/app) chủ động format sang local TZ khi hiển thị. Cron File Service:node-cronvớitimezone: 'UTC'; off-peak = giờ UTC trong biểu thức — không cộtwindow_tz. - Hệ thống ngoài (Keycloak, object store, Matrix, Infisical) không thiết kế schema nghiệp vụ MINAP ở đây — xem 90. Store bên ngoài.
3. Danh mục
3.1 Relational DB trong phạm vi gói này
Quy ước tên vật lý (Owner):
- MySQL / MariaDB → cột Tên vật lý = database name
- PostgreSQL → cột Tên vật lý = schema name (không dùng
publiclàm SoT ownership; mỗi bounded context một schema)
| ID | Tên | Tên vật lý | Engine | Mô tả | Owner path | Tài liệu | Trạng thái |
|---|---|---|---|---|---|---|---|
db-platform-core | Platform Core DB | platform_core | PostgreSQL DECIDED (D-022) | Account, Workspace, membership; sau này catalog / app_… / entitlement | platform-core/ | 01 | Một phần (Account/Workspace đã có); catalog/app_…/entitlement PROPOSED |
db-file-service | File Service DB | file_service | PostgreSQL DECIDED (D-022) | Metadata file (file_id, quota, object key) — không chứa bytes | platform-file-service/ | 02 | Ownership DECIDED; bảng/schema chi tiết OPEN |
db-payment | Payment Integration DB | payment | PostgreSQL DECIDED (D-022) | Trạng thái / connector payment dùng chung | reserved platform-payment/ | 03 | Capability PROPOSED; engine DECIDED |
db-invoice | Invoice Integration DB | invoice | PostgreSQL DECIDED (D-022) | Trạng thái / connector invoice–tax dùng chung | reserved platform-invoice/ | 04 | Capability PROPOSED; engine DECIDED |
ID = mã ổn định trong docs (
db-…). Tên = tên gọi đọc được. Tên vật lý = PostgreSQL schema name (D-022). Chi tiết: file01–04.
3.2 Ngoài phạm vi — Application DB
DB domain của Application (A/B/C, Salon, …) không thuộc gói thiết kế database lần này. Chúng sẽ có tài liệu riêng khi Application được Gate / discovery. Nguyên tắc ownership Application vẫn giữ ở architecture SoT tổng thể.
3.3 Không phải RDBMS nghiệp vụ MINAP (vẫn ghi tài liệu)
| ID | Tên | Vai trò | Tài liệu |
|---|---|---|---|
store-keycloak | Keycloak DB | IdP users / credentials | 90 |
store-object | MinIO / S3 / R2 | Bytes file | 90 |
store-matrix | Matrix / Synapse DB | Chat state | 90 |
store-infisical | Infisical | Secrets / ENV (D-016) | 90 |
store-variant-cache | Variant disk + variant_cache | Cache multi-size; GC bằng job app | File Service + 90 |
4. Quan hệ logic
5. Engine / topology
Phân tích + quyết định: 91. Engine MySQL vs PostgreSQL — R1–R5 DECIDED (D-022).
| Chủ đề | Trạng thái |
|---|---|
| Engine mặc định (R1) | DECIDED PostgreSQL |
| Platform Core (R2) | DECIDED PostgreSQL → schema platform_core |
| File / Payment / Invoice (R3) | DECIDED PostgreSQL → schema file_service / payment / invoice |
| Topology non-prod (R4) | DECIDED phương án A — một Postgres database + nhiều schema |
| Dual-engine (R5) | DECIDED không mặc định MySQL+Postgres trong lớp này |
| Backup / HA; isolation production | OPEN |
6. Mẫu tài liệu (mỗi file database)
Một file = một database (không tách “mục lục” và “schema chi tiết” thành hai trang architecture). Mỗi 0x-*.md nên có:
- Mục đích + owner repo
- Engine / topology
- ER
- Bảng → cột (kiểu, null, PK/FK, nguồn dữ liệu, ghi chú)
- Index / bất biến
- Ngoài phạm vi
Ví dụ đã đầy đủ: 01. Platform Core. File / Payment / Invoice bổ sung cột trong chính 02–04 khi thiết kế.
7. Vòng feedback
Owner đọc và feedback trực tiếp trên SoT dưới docs/architecture/database/. Thay đổi material: sửa một lần tại đây.