KB-224C

01 — Overview & Control

3 min read Revision 1
architectureoverviewcontrolgate0read-only2026-05-30

title: 01 — Overview & Control date: 2026-05-30 status: READ-ONLY, zero mutation

01 — Overview & Control

Objective

Produce the master design and safe dress-rehearsal plan for a standardized Registries/Pivot surface at /knowledge/registries-pivot, that:

  • counts 100% via Pivot (Điều 26), with zero Nuxt counting;
  • contains no hardcode / disguised-hardcode of categories, species, layers, counts, routes or lists;
  • is PG-first → Directus/API exposed → Nuxt render-shell only (Điều 28);
  • navigates parent → child → grandchild → … → the object's own DB/relationship substrate, reusing /knowledge/registries as the navigational model and /knowledge/pivot as the canonical counting reference.

Out of scope this session: production UI, PG mutation, schema creation, Nuxt prod changes, asking the user.

Hard Gate 0 — evidence (live, 2026-05-30 ~13:50 UTC)

Check Result
Host = contabo VPS PASS — postgres, incomex-directus (11.5), incomex-nuxt, incomex-nginx, incomex-qdrant healthy
/knowledge/registries HTTP 200 PASS — "Danh mục hệ thống" Meta-Catalog
/knowledge/pivot HTTP 200 PASS — "Pivot — Thống kê theo Lớp cấu tạo"
Live PG read-only PASS — role context_pack_readonly, READ ONLY tx
No apply channel CONFIRMED — only KB doc writes
No mutation CONFIRMED — entry == exit
No prod Nuxt change CONFIRMED

Page source files: /knowledge/registriespages/knowledge/registries.vue + /api/registry/health + Directus reads; /knowledge/pivotpages/knowledge/pivot.vue + pivot reads. Nuxt source is not on the MCP read_file allowlist; behaviour established from live render + live PG view defs + prior VERIFIED v2 audit (registries-pivot-foundation-reuse-audit-rebuild-blueprint-2026-05-30/03,04). Byte-level .vue inspection not re-performed (documented partial).

Integrity discipline

Per the prior pack's lesson (never author ahead of query results), every count/structural claim was live-queried before being finalized. An erratum (doc 13) records that early drafts written before the delayed result-batch flushed contained fabricated specifics, all corrected before KB upload.

Relationship to prior work

Builds on registries-pivot-foundation-reuse-audit-rebuild-blueprint-2026-05-30 (VERIFIED v2) + law-capability-discovery-second-pass-cross-check-2026-05-30; honors gpt-direction-registries-pivot-rebuild-reuse-foundation-2026-05-30.md. New decision: mission elevates /knowledge/registries-pivot to canonical; doc 09 reconciles with the prior "converge, no third page" recommendation.

Back to Knowledge Hub knowledge/dev/reports/architecture/registries-pivot-os-agency-surface-master-design-2026-05-30/01-overview-control.md