dot-iu-cutter v0.5 Schema Q5 — Scope & Object Inventory

Phase: v0_5_schema_Q5_and_evidenced_by_command_review_planning · Nature: design_only / command_review_preparation · Date: 2026-05-18 Authority (consumed, NOT reopened — QG1): GPT review …evidenced-by-vocab-cap4-design-gpt-review-2026-05-18 (status: DESIGN_SUPPLEMENT_COMPLETE__READY_FOR_GATED_COMMAND_REVIEW_PLANNING, next_phase: v0_5_schema_Q5_and_evidenced_by_command_review_planning); WS-1/WS-2/WS-3 authority package; evidenced_by vocab-amend + Cap-4 + verification/rollback design; fabric-addendum consolidated open decisions; pre-scale index DDL authoring (GPT PASS) + handoff 2026-05-17.

⚠️ GATING BANNER

phase: design_only
object_inventory_is: a logical catalogue for a FUTURE command-review — NOT a migration
executable_sql: none            # QG2 — no DDL/DML anywhere in this file
table_view_function_index_created: none
vocab_amended: false
cap4_checker_code_changed: false
directus_mutated: false
dry_run: none
execution_authorized: false
self_advance: PROHIBITED
decision_authority: GPT / User ONLY

This file enumerates which logical objects must become physical, and in what order of necessity. It writes no SQL and creates nothing (QG2/QG3). The WS-1/WS-2/WS-3 and evidenced_by designs are used as authority, not reopened (QG1).

---

1. Scope

Convert the now-complete supplemental design into a controlled implementation catalogue. In scope: the schema-Q5 registry / fabric-substrate objects, the evidenced_by vocab store surface, and the Cap-4 checker extension surface — each as a logical object with a pending physical decision. Out of scope (forbidden): any executable migration SQL, table/view/function/index creation, real vocab change, Cap-4 checker code change, production write, backfill, CUT/VERIFY, dry-run, Directus mutation, vector/NoSQL integration, git commit, self-advance to authoring/execution.

2. Object inventory (logical → physical-pending)

Each object is already logically specified in the cited authority document; here it is only catalogued with its physical-decision state. No shape is re-derived (QG1).

OBJ-01 metadata_key_registry:
  authority: WS-2 D1 (metadata-key-registry-design §1)
  logical_status: SPECIFIED (pseudo-schema YAML; PK metadata_key, key_namespace,
    key_type, allowed_values_policy, cardinality_policy, mutability_policy,
    index_policy, hot_threshold_hint, lifecycle, owner_role, created_by/at)
  physical_status: NOT CREATED — shape decision = OD-VC2-class / OD-L5 (schema)
  anti_hardcode: metadata keys resolved via this registry, never literal

OBJ-02 source_family_registry:
  authority: WS-2 D2 (source-family-grammar-authority-design §1)
  logical_status: SPECIFIED (PK source_family, authority_semantics_default,
    grammar_profile_ref, version_policy, status_policy,
    default_parser_profile_ref, lifecycle) + seed ≥9 families
  physical_status: NOT CREATED

OBJ-03 grammar_profile:
  authority: WS-2 D3 + canon §2 (model NOT redesigned)
  logical_status: SPECIFIED (grammar_profile_ref PK, level_definitions[],
    status_marker_rules, address_template_ref) + 2 concrete profiles
    (incomex-architecture-constitution-v4, vn-national-law)
  physical_status: NOT CREATED
  sub_objects (carried, NOT new design):
    - matcher_config_registry  (matcher_kind/matcher_ref rows — config, not regex inline)
    - address_template_registry (address_template_ref rows; ties to OD-A1/BR-A1)

OBJ-04 entity_kind_registry:
  authority: WS-2 D5 (entity-registry-and-address-namespacing §D5)
  logical_status: SPECIFIED (PK entity_kind, display, description,
    default_source_system_hint, lifecycle) + seed sql_entity/code_module/
    git_file/directus_item/report_path
  physical_status: NOT CREATED

OBJ-05 entity_reference_registry:
  authority: WS-2 D5 + WS-1 binding-authority note (OD-FA5 APPROVE_CORE_MINIMAL)
  logical_status: SPECIFIED core-minimal (entity_ref_id PK, entity_kind FK,
    source_system, natural_key, authority_note, lifecycle);
    permission_policy_ref + snapshot_policy_ref = DEFERRED placeholders
  physical_status: NOT CREATED

OBJ-06 authority_override:
  authority: WS-2 D4 (source-family-grammar-authority §3)
  logical_status: SPECIFIED (override_id PK, scope unit|span, iu_id, span_ref,
    authority_role, reason, set_by/at, provenance)
  physical_status: NOT CREATED; span-level mechanism detail deferred to real
    mixed-authority pilot (NOT over-designed)

OBJ-07 assembly_profile:
  authority: WS-1 G1 / OD-FA1
  logical_status: CONTRACT resolve_in_WS1; physical shape OPEN (BR-FA1)
  physical_status: NOT CREATED — defer_WS3 per OD-FA1

OBJ-08 topic_registry / topic_vocab:
  authority: WS-1 G3 / OD-FA3 (Option C) / P11D-α
  logical_status: CONTRACT + ownership + duplicate-mitigation resolve_in_WS1
  physical_status: NOT CREATED — physical topic_vocab defer_post_pilot
    (gated Pilot Tier 1 + duplicate-rate + APR Điều 32 — BR-FA3)

OBJ-09 edge_type vocab extension (evidenced_by):
  authority: evidenced-by-vocab-amend-design §2
  logical_status: SPECIFIED logical vocab entry (evidenced_by / reverse
    evidences / owner_law_code NRM-LAW-44 / relation Cap-4 / default proposed /
    provenance_required true)
  physical_status: NOT AMENDED — vocab-entry physical shape = OD-VC2
    (dot_config row / framework record / JSON schema) UNDECIDED

OBJ-10 Cap-4 checker config/extension surface:
  authority: evidenced-by-cap4-checker-extension-design §2–§9
  logical_status: SPECIFIED rule families R-EP/R-AU/R-NO/R-PV/R-LC/R-AD
    + decision flow (logical, no code)
  physical_status: NOT MODIFIED — deploy mechanism = OD-VC3
    (versioned rule set / reversible toggle) UNDECIDED

OBJ-11 pre-scale indexes (7):
  authority: pre-scale-index-ddl-authoring (GPT PASS; D-2 APPROVED_PARTIAL,
    D-5 DEFERRED_TO_SEPARATE_SOVEREIGN_CYCLE)
  logical_status: DDL DRAFTED + verification/rollback authored
  physical_status: NOT EXECUTED — dry-run + sovereign command-review pending

PRE-REQ source_document registry:
  authority: handoff §4.2 + WS-2 D6 (address_docprefix)
  status: REFERENCED dependency for OBJ-03 address_template + OD-A1/BR-A1;
    NOT yet logically specified in a Q5 doc — flagged as a sequencing
    prerequisite, NOT designed here (QG1: no new design)

3. Necessity classification

must_have_for_first_schema_Q5:        # the registry/fabric substrate that makes
  - OBJ-02 source_family_registry      #   "registries and assembly/profile
  - OBJ-03 grammar_profile (+ matcher_config_registry + address_template_registry)
  - OBJ-04 entity_kind_registry        #   contracts become real" (GPT review reason)
  - OBJ-05 entity_reference_registry (core-minimal)
  - OBJ-06 authority_override
  - OBJ-01 metadata_key_registry
  rationale: these are the non-hardcode resolution substrate every later layer
    (assembly, address, authority, label, evidenced_by checker) reads from;
    creating vocab/checker without them risks an edge type with no substrate
    (GPT review explicit risk).

should_have_later:                     # logical contract NOW, physical later
  - OBJ-07 assembly_profile  (logical resolve_in_WS1; physical defer_WS3 — BR-FA1)
  - OBJ-09 edge_type vocab extension (step 2, AFTER substrate — sequencing doc)
  - OBJ-10 Cap-4 checker extension   (step 3, AFTER vocab — sequencing doc)
  - OBJ-11 pre-scale 7 indexes       (own dry-run→sovereign cycle — D-5)

defer_post_pilot:
  - OBJ-08 topic_vocab physical (BR-FA3; gated Pilot Tier 1 + APR Điều 32)
  - OBJ-05 permission_policy_ref / snapshot_policy_ref (OD-FA5 deferred)
  - metadata_value EAV vs JSONB physical projection (OD-L2) + hot-key promoted
    columns/indexes (OD-L3/L4) — own promotion DDL cycle
  - PRE-REQ source_document registry physical (ingestion-layer; own design first)

4. Dependencies between objects

edges (consumer -> dependency):
  source_family_registry.grammar_profile_ref      -> grammar_profile
  source_family_registry.default_parser_profile_ref -> parser_profile registry (ingestion; advisory)
  grammar_profile.level_definitions[].matcher_ref  -> matcher_config_registry
  grammar_profile.address_template_ref             -> address_template_registry
  address_template_registry (docprefix)            -> source_document registry (PRE-REQ; OD-A1/BR-A1)
  authority_override.iu_id (scope=unit)            -> IU identity
  authority_override.span_ref (scope=span)         -> source_span (ingestion §2)
  entity_reference_registry.entity_kind            -> entity_kind_registry
  authority resolution (default)                   -> source_family_registry.authority_semantics_default
  assembly_profile                                 -> source_family_registry + authority_override + grammar_profile
  topic_registry/topic_vocab                       -> assembly output (assembly_profile)
  Cap-4 checker (R-AU)                             -> authority_semantics (source_family + authority_override)
  Cap-4 checker (R-EP/R-NO)                         -> entity_reference_registry boundary (raw_entity routing)
  Cap-4 checker (R-AD3)                              -> edge_type vocab extension (must read evidenced_by from vocab, never hardcoded)
  evidenced_by vocab entry                          -> edge_type vocab framework store (physical shape OD-VC2)
critical_ordering_implication:
  - substrate (source_family/grammar/entity_kind/entity_reference/authority_override/
    metadata_key) MUST physically precede vocab amend, which MUST precede Cap-4
    checker enforcement, which MUST precede any evidenced_by row.
  - source_document registry is a transitive prerequisite of grammar/address —
    flagged for the sequencing doc; NOT silently absorbed into Q5.

5. Statements

• QG1: WS-1/WS-2/WS-3 + evidenced_by designs consumed as authority; no shape redesigned. QG2/QG3: zero executable SQL/code; object inventory only present (QG3 satisfied).
• All physical-decision states reference an existing OD/BR (OD-VC2/VC3, OD-FA1/FA3/FA5, OD-L*, OD-A1/BR-A1, BR-FA1/FA3) — none self-resolved here (deferred to companion open-decisions file + GPT/User).
• No repo/VPS access in this session (/Users/nmhuyen not a git repo; /opt/incomex/dot/iu-cutter absent). code_changed: false, commit_made: false.
• Self-advance PROHIBITED — this is doc 1 of a 5-file planning package; STOP after all 5 uploaded → route GPT/User.

Companion files: command-sequencing-and-gates, verification-and-rollback-master-plan, open-decisions-and-risk-register, command-review-planning-report.