ĐIỀU 5: KIẾN TRÚC 5 TẦNG

§1. Cấu trúc

Tầng 5: GIÁM SÁT + CẢI TIẾN — Phát hiện bất đồng bộ, auto-fix, 2 động cơ
Tầng 4: CHUYÊN MÔN (đích đến) — Quy trình nghiệp vụ thực tế
Tầng 3: MODULES NỀN TẢNG — Table, Comment, Workflow, CI/CD
Tầng 2: CƠ SỞ (nguyên liệu) — Registries, Metadata, DOT, Fields, Taxonomy
Tầng 1: HẠ TẦNG — VPS, Docker, PG, Directus, Nuxt, Agent Data, Qdrant

§2. Luật xây dựng

KHÔNG BAO GIỜ xây tầng trên khi tầng dưới chưa vững. Vi phạm = xây trên bùn = sẽ sụp.

§3. Hiện trạng (2026-03)

Tầng 1: ✅ ỔN ĐỊNH

• VPS Contabo EU ($8/month). Docker 6 services.
• PostgreSQL 16 DUY NHẤT. MySQL = RETIRED.
• Directus CMS + API + Admin + Flows.
• Nuxt 3 (màn hình, chỉ đọc).
• Agent Data + Qdrant (tri thức + vector).
• GCP: chỉ Secret Manager (~$2/month).
• Chatwoot: CHỐT DÙNG — CSKH đa kênh.
• Lark Suite Enterprise: CHỐT DÙNG — chat nội bộ + Base (kết nối PG) + webhook.
• i18n: vi-VN, ja-JP, en-US (kiến trúc sẵn sàng).
• Multi-domain: kiến trúc sẵn sàng (Điều 17).

Tầng 2: ✅ HOÀN THÀNH

• 138 collections (33 species, 100% coverage). 15,307+ births (Gap=0).
• 17 PG TRIGGER realtime. verify_counts()=0 MISMATCH.
• 5-Layer Registries UI. Tab Pivot LIVE. pivot_count() DUY NHẤT.

Tầng 3: 🟡 MODULES HOẠT ĐỘNG

• Registries 5-layer UI. DirectusTable. Lớp 3 per entity.
• Cần: state machine, Label Law deploy, DOT reporting.

Tầng 4: ⬜ CHƯA BẮT ĐẦU (đúng — Tầng 3 chưa hoàn thiện)

Tầng 5: 🟡 TIẾN BỘ LỚN

• Điều 30 BAN HÀNH (Playwright E2E).
• Điều 31 BAN HÀNH (contracts 100%, runner, watchdog).
• Điều 26 BAN HÀNH (Pivot System live).
• Universal Measurement Framework.

→ Chi tiết: knowledge/dev/architecture/5-layers.md