Incomex AI Portal
KB-7E4F rev 5

Đ43 Migrations Folder — Index + Log triển khai 8 Phase

7 min read Revision 5
dieu43migrationsreadmephase-trackerunderstand-anythinguser-requirement

Đ43 MIGRATIONS — Folder tập trung triển khai Điều 43

Tạo: 2026-04-17 S178 Fix 9 Cập nhật: 2026-05-26 — thêm User Requirement về Understand-Anything / external context graph tools Mục đích: Gom toàn bộ artifact triển khai Đ43 vào 1 folder. Chủ tịch tìm bằng mắt dễ, không rải rác nhiều nơi. Living folder — thêm/sửa file theo tiến độ 8 Phase.

📍 VỊ TRÍ

knowledge/dev/laws/dieu43-migrations/

Truy cập web: https://vps.incomexsaigoncorp.vn/knowledge/dev/laws/dieu43-migrations/

⭐ USER REQUIREMENT MỚI — Understand-Anything / External Context Graph Tools

Trước khi tiếp tục Phase 4+ của Điều 43, đặc biệt phần context graph, architecture map, AI onboarding, dependency graph, semantic code search, diff impact analysis, agent PHẢI đọc:

knowledge/dev/laws/dieu43-migrations/requirements/user-requirement-understand-anything-integration.md

Nguyên tắc User chốt ngày 2026-05-26:

Cái xã hội / open-source đã làm tốt thì ưu tiên tích hợp, adapter hóa, tránh làm lại. Những gì thị trường chưa có và là đặc thù riêng của Incomex — luật, PG-first SSOT, DOT/IU governance, Context Pack sống, health/enforcement — thì tiếp tục tự xây.

Understand-Anything và các công cụ tương tự phải được xem là ứng viên tích hợp ưu tiên cho lớp codebase/context graph, nhưng KHÔNG thay thế Điều 43.

📊 PROGRESS 8 PHASE

Phase Nội dung Trạng thái Ngày
1 SQL Schema Migration ✅ PASS (11/11 verify, idempotent 2 lần) 2026-04-17 Fix 11
2 Filesystem Init DOT (2 script .sh + 4 folder VPS) 🟡 ĐANG LÀM —
3 KB Folder Init (placeholder) ✅ DONE Desktop-side 2026-04-17 Fix 11
4 ★ Soạn 2 DOT build + verify (NẶNG NHẤT) ⏸️ Chờ — phải đọc User Requirement Understand-Anything trước khi tiếp tục —
5 Register 2 DOT vào dot_tools ⏸️ Chờ — block bởi 5 reference tables Đ35 —
6 Cron Install DOT ⏸️ Chờ —
7 PG Triggers (on-law-enact + on-dot-register) ⏸️ Chờ —
8 First Run + Enactment (UPDATE law_v43_enacted_at) ⏸️ Chờ —

📁 DANH MỤC FILE

Requirements / User decisions

File Trạng thái Ghi chú
requirements/user-requirement-understand-anything-integration.md ✅ v1 User Requirement: ưu tiên tích hợp Understand-Anything / external context graph tools, tránh làm lại phần xã hội đã có

Phase 1 — SQL Schema Migration ✅

File Trạng thái Ghi chú
00-prereq-dot-operations.sql ✅ v1 Tạo dot_operations + seed 18 ops Đ35 v5.1 §4.1
01-dieu43-block1-schema.sql ✅ v1 4 bảng + 1 view + seed 2 op CONTEXT_PACK_*
report-phase1-apply.md ✅ v1 11/11 PASS, idempotent 2 lần, docker exec postgres psql -U directus

Phase 3 — KB Folder Init ✅ (Desktop-side)

File Trạng thái
knowledge/current-state/context-pack/README.md ✅ v1
knowledge/current-state/context-pack-staging/README.md ✅ v1

Phase 2 — Filesystem Init DOT 🟡 (prompt CLI sẵn sàng)

Dự kiến output trên VPS:

  • /opt/incomex/dot/bin/dot-dieu43-fs-init.sh (Tier B)
  • /opt/incomex/dot/bin/dot-dieu43-fs-verify.sh (Tier A)
  • 4 folder: /opt/incomex/context-pack/{current, .tmp, staging, previous}

Phase 4+ (chưa đụng)

Trước Phase 4+ phải đọc User Requirement Understand-Anything ở trên để tránh tự xây lại codebase/context graph scanner nếu có thể tích hợp công cụ ngoài.

🔗 TÀI LIỆU THAM CHIẾU

  • Luật chính: knowledge/dev/laws/dieu43-system-context-law.md v1.2 FINAL rev 6
  • User Requirement mới: knowledge/dev/laws/dieu43-migrations/requirements/user-requirement-understand-anything-integration.md
  • Phụ lục 8 Phase: knowledge/dev/laws/dieu43-phu-luc-ban-do-he-thong.md
  • Hiến pháp: knowledge/dev/laws/constitution.md v4.6.1
  • Đ33 PG Law: knowledge/dev/laws/dieu33-postgresql-law.md v2.0
  • Đ35 DOT Governance: knowledge/dev/laws/dieu35-dot-governance-law.md v5.1 FINAL
  • Đ41 VPS-as-SSOT: knowledge/dev/laws/dieu41-luat-van-hanh-ma-vps-v1.0.md

⚠️ GHI CHÚ QUAN TRỌNG

  1. User Requirement 2026-05-26 là checkpoint bắt buộc trước Phase 4+. Agent không được mặc định tự viết scanner/context graph engine mới nếu có thể tích hợp Understand-Anything hoặc công cụ tương tự bằng adapter.

  2. VPS = SSOT mã (Đ41). CLI fetch file từ KB về /tmp/ trên VPS, chạy thẳng trên VPS. CẤM scp về local, CẤM git clone/pull repo VPS.

  3. Idempotent bắt buộc. Mọi file .sql + .sh chạy lại không lỗi. Đã verify Phase 1 chạy 2 lần vẫn PASS.

  4. PG User thật trên VPS là directus, KHÔNG phải postgres (Fix 11 phát hiện). Mọi prompt psql phải dùng docker exec postgres psql -U directus -d <dbname>. Role postgres KHÔNG tồn tại trong container. Đã ghi memory #26.

  5. Phase 5 dependency: dot-dot-register cần các FK reference tables Đ35 v5.1 §4.1: dot_tiers, dot_trigger_types, dot_coverage_statuses, dot_domains, dot_coverage_required, dot_config. File 00-prereq-*.sql Phase 1 CHỈ tạo dot_operations. Khi chạm Phase 5, Desktop sẽ soạn file prereq bổ sung HOẶC quyết chạy Đ35 v5.1 BLOCK 1 đầy đủ.

  6. Phases tuần tự, không gộp. Mỗi Phase: 1 prompt CLI → báo cáo → Desktop duyệt → Phase tiếp.

  7. Prompt CLI theo nguyên tắc “MỤC TIÊU MỞ” (OR, Huyền chốt Fix 11): chỉ ghi mục tiêu + tiêu chí đo + ràng buộc luật. KHÔNG chi tiết từng lệnh shell. Agent có ngữ cảnh sát hơn Desktop → tự quyết cách làm. Đã ghi memory #25.

📊 LOG TRIỂN KHAI

Ngày Phase Hành động Kết quả
2026-04-17 Fix 9 — Tạo folder + upload 01-dieu43-block1-schema.sql rev 1 ✅
2026-04-17 Fix 9 — Tạo README folder ✅
2026-04-17 Fix 11 1 Upload 00-prereq-dot-operations.sql rev 1 ✅
2026-04-17 Fix 11 1 Soạn + gửi prompt CLI Phase 1 APPLY ✅
2026-04-17 Fix 11 1 CLI chạy Phase 1: 11/11 PASS, idempotent 2 lần. Sửa -U postgres → -U directus tại chỗ ✅
2026-04-17 Fix 11 3 Desktop upload 2 placeholder KB (context-pack + context-pack-staging) ✅
2026-04-17 Fix 11 2 Soạn prompt CLI Phase 2 theo nguyên tắc MỤC TIÊU MỞ 🟡
2026-05-26 Requirement Ghi User Requirement: ưu tiên tích hợp Understand-Anything / external context graph tools trước Phase 4+ ✅

Folder dieu43-migrations | Updated 2026-05-26 | User Requirement added for Understand-Anything integration.