REGISTRY-ENGINE — Kế hoạch kiểm soát toàn diện

v1.2 | 2026-03-08 S107 — ✅ REGISTRY-ENGINE HOÀN THÀNH (PR #451 S106). 4 collections, 248 items, 13 auto-ID flows, 3-layer drill-down UI. Tiếp: Lớp 3 Section-Based (TD-104), Semantic Linking (TD-100).

Trạng thái: ✅ HOÀN THÀNH (S106 PR #451)

Registry Engine đã triển khai thành công:

• ✅ 4 collections mới: dot_tools (97), ui_pages (39), collection_registry (113), agents (6)
• ✅ 13 auto-ID flows: PREFIX-NNN tự gán khi tạo item
• ✅ 3-layer drill-down UI: Lớp 1 → Lớp 2 → Lớp 3
• ✅ dot-registry-diff: quét thực tế vs SSOT
• ✅ meta_catalog: 14 records active (thêm entity_dependencies S107)
• ✅ Orphan Scanner: 100% coverage (PR #455)
• ✅ Selftest: dot-selftest-registries 30 PASS (PR #457)

Tiếp theo (S107+)

• TD-104: Lớp 3 Section-Based Detail Pages — config-driven, auto-link PREFIX-NNN
• TD-100: Semantic Linking Engine — 3 lớp kết nối (explicit, classification, semantic)
• TD-083: Duplicate Engine — chống double tổng quát

search_knowledge("registry engine plan")

Vấn đề gốc rễ

11 danh mục trong meta_catalog nhưng:

• 4 danh mục KHÔNG CÓ Directus collection (mồ côi hoàn toàn)
• 1 danh mục bị khoá quyền (modules 403)
• 0/11 có auto-ID tự động
• 0/11 có click drill-down
• 0/11 có cơ chế kiểm soát diff

Hệ thống đang CÓ LUẬT nhưng KHÔNG CÓ HÀNH PHÁP.

Kiến trúc mục tiêu: 3 Lớp Liên Thông

Lớp 1: meta_catalog (11 types) → /knowledge/registries
  ↓ click Số lượng
Lớp 2: registry items → /knowledge/registries/[entityType]  
  ↓ click item
Lớp 3: chi tiết → trang riêng hoặc generic detail page

3 Missions chia nhỏ

Mission 1: REGISTRY-FOUNDATION (Phần A + B + C + F)

• Tạo 4 collections mới (dot_tools, ui_pages, collection_registry, agents)
• Fix modules permissions + populate
• Populate TẤT CẢ dữ liệu cũ vào registries
• Tạo 10 Auto-ID Flows (Directus)
• Tạo Auto-Count mechanism
• Kết quả: 0 mồ côi, mọi thứ mới tự có ID

Mission 2: REGISTRY-UI (Phần D)

• Drill-down từ Lớp 1 → Lớp 2 → Lớp 3
• Đăng ký table_registry cho mỗi Lớp 2
• DirectusTable cho tất cả bảng mới
• Kết quả: Web liên thông 3 lớp

Mission 3: REGISTRY-ENFORCE (Phần E)

• dot-registry-diff tool
• Scheduled scan + auto-report
• Auto-create tasks khi phát hiện lệch
• Kết quả: Tự phát hiện, tự cảnh báo

Thứ tự: Mission 1 → ORPHAN-SCAN → DUPLICATE-ENGINE

Ưu tiên sau CHECKPOINT-NODE-IDENTITY (cập nhật S106):

1. 🔴🔴 TD-094 ORPHAN-SCAN — dot-orphan-scan: kiểm kê ngược, coverage report → TRƯỚC Duplicate Engine vì: (a) Nhanh hơn (quét + so sánh, không cần AI/vector) (b) Cho biết THỰC TRẠNG coverage → biết cần fix gì (c) Là nền tảng cho mọi thứ khác (không biết % thì không biết đã đủ chưa)
2. 🔴 TD-083 DUPLICATE-ENGINE — chống double tổng quát
3. 🟡 TD-085 dot-catalog-sync auto — gộp vào deploy chain

Bổ sung meta_catalog (REGISTRY-ENGINE hoặc Phase 2)

Cần thêm vào meta_catalog khi có permissions:

• CAT-011: Checkpoint Types (CP), registry: checkpoint_types, layer 3
• CAT-012: Checkpoint Sets (CPS), registry: checkpoint_sets, layer 3 — CẦN TẠO collection
• CAT-013: Nodes / Workflow Steps (ND), registry: workflow_steps, layer 3
• CAT-014: Journey Templates (JT), registry: journey_templates, layer 4 — CẦN TẠO collection

Tech Debt mới từ S106 thảo luận

• TD-078: Checkpoint Sets (Phase 2)
• TD-079: State Machine mode (Phase 4-5)
• TD-080: Checkpoint types → CP-NNN
• TD-081: Workflow steps → ND-0001
• TD-082: Journey Templates (Phase 4-5)
• TD-083: Duplicate Engine tổng quát (Phase 2, ưu tiên cao)