Registries-Pivot Layer Definition — Dynamic Drilldown Canon

Date: 2026-06-03 Status: Canon checkpoint for Registries-Pivot / OS Agency surface Purpose: Provide a short searchable definition of “Layer” for future Agent/GPT work.

Definition

Layer là một cấp danh sách sinh ra từ một node cha khi node cha có count > 1.

Layer không phải cấp cố định 1/2/3/4/5. Layer là kết quả của một phép phân nhóm tiếp theo do PG/pivot quyết định.

Mỗi layer gồm các node con. Mỗi node con có count, trạng thái, cảnh báo, quan hệ và khả năng drill tiếp.

Nếu node count > 1 và còn grouping_dimension hợp lệ → có layer con. Nếu node count = 1 hoặc không còn grouping_dimension → đi vào final substrate.

Final substrate là DB/table/registry/birth/IU/KG/DOT/events/governance/audit của chính object đó.

Design consequences

1. UI có thể hiển thị Layer 1/2/3 theo cách con người dễ hiểu, nhưng backend không được hardcode depth.
2. Nuxt/UI chỉ render contract; không tự tính count, status, depth, grouping, orphan, phantom, drift.
3. PG/pivot quyết định has_children, child_layer_kind, next_pivot_code, drilldown_query_ref, final_substrate_ref.
4. count > 1 là điều kiện sinh layer, nhưng layer sinh ra theo grouping_dimension hợp lệ, không theo naming convention.
5. Nếu thiếu grouping pivot hoặc parent graph thì phải báo PIVOT_MISSING, không được fallback hardcode âm thầm.
6. Layer cuối cùng không phải UI page; nó là substrate thật của object: table/row/registry/birth/IU/KG/DOT/events/governance/audit.

Canonical mission

Registries-Pivot là màn hình phản chiếu PG ra ngoài một cách tự động theo pivot counting. Nó phải cho phép kiểm chứng độc lập hệ thống, không phụ thuộc vào báo cáo Agent.