KB-11CB

S186 Short Roadmap — Điều 38 with Nuxt Laws Page

3 min read Revision 1
s186roadmapdieu38text-as-codenuxtknowledge-lawspg-units

S186 Short Roadmap — Điều 38 with Nuxt Laws Page

Date: 2026-04-28

Anchor

Điều 38 Text-as-Code aims to SQL hóa KB/text/noSQL into PostgreSQL-governed information units, metadata, components, BOM, review/change-set, checker/DOT, Directus surface, Nuxt reading surface, and downstream KG/vector projections.

Already done / do not repeat

LSL-01, L1–L5, C1/C1A/C2/C3, P5/P5b/P6/P7, P7B/P7C sandbox, P8, G6 dry-run, Gate A DDL, Trigger Guard DROP repair.

Short roadmap from now

  1. Đã xong — Không quay lại

    • Legal/doctrine/design/schema/checker/pilot/sandbox/P8/G6/Gate A/Trigger Guard repair.
  2. Gate B — Gắn bảng điều khiển Directus

    • Register 14 tac_* collections meta-only.
    • No seed, no roles, no registry/birth.
    • Goal: Directus sees PG schema.
  3. Gate C — Nạp từ điển nền

    • Seed 61 vocab/config rows.
    • Goal: lifecycle/type/config vocabulary exists for operation.
  4. G8B — Cấp thẻ vận hành

    • Roles, policies, permissions, tokens for TAC.
    • Goal: governed access for humans/agents through Directus.
  5. G11 — Chủ tịch nghiệm thu

    • Compile evidence pack.
    • User approval to close P9 production readiness.
  6. P9 Closeout — Khóa dây chuyền production

    • Update index/state docs.
    • Log follow-ups intentionally out of Gate B/C: registry/birth/catalog sync, DOT/checker automation gaps.
  7. Nuxt Laws Page — Mở cửa xem miếng PG

    • Create/add page under https://vps.incomexsaigoncorp.vn/knowledge/laws.
    • Use existing Nuxt mechanism to render PG information-unit structure.
    • Goal: humans can browse law/document structure as units, metadata, publication/member tree, not only raw markdown.
    • Read-only first. No edit workflow until review/change-set path is approved.
  8. Migration rộng — Đưa corpus vào kho miếng thông tin

    • Migrate laws/SOP/KB gradually into PG unit system.
    • Preserve old KB as source/parallel read during zero-downtime migration.
    • Use change-set/review; no direct bulk truth overwrite.
  9. KG/Vector sync — Gắn mắt thần, không đổi nguồn chân lý

    • Project PG truth to Qdrant/KG for retrieval/reasoning.
    • Qdrant/KG remain projections; PostgreSQL remains SSOT.

Ultra-short metaphor

  1. Đã xây xong nhà máy thử và móng nhà máy thật.
  2. Gate B: gắn bảng điều khiển.
  3. Gate C: nạp từ điển vận hành.
  4. G8B: phát thẻ nhân viên.
  5. G11: chủ đầu tư nghiệm thu.
  6. Nuxt Laws Page: mở showroom xem từng miếng PG.
  7. Migration rộng: đưa toàn bộ nguyên liệu tri thức vào dây chuyền.
  8. KG/Vector: lắp mắt thần tìm kiếm, nhưng không thay kho gốc.

Guardrails

  • Nuxt page is a read surface, not SSOT.
  • PostgreSQL remains SSOT.
  • Directus remains gateway/admin surface.
  • Nuxt page should not create/edit truth until review/change-set workflow is explicitly authorized.
  • Do not let UI work bypass Gate C/G8B/G11 if it needs seeded vocab or governed access.