P3D — Birth System B2 Contract Design rev2

Date: 2026-05-12 Rev: 2 (governance operating model PG-native, 5 coverage statuses, owner resolution) Mode: DESIGN ONLY

---

1. Birth contract principles (GPT-locked)

Birth nhẹ nhưng không thiếu. Coverage policy: trigger OR exemption OR deferred. No silent gaps.

---

2. Birth metadata contract (unchanged — 9/10 supported, owner ABSENT)

---

3. Owner resolution design (unchanged — source field → collection policy → UNKNOWN_OWNER)

---

4. Universal birth address = (collection_name, entity_code)

---

5. 8 relation hooks at birth (unchanged)

---

6. Coverage classification framework

5 coverage statuses (1 required + 3 exempt + 1 deferred):

Status	Criteria	Action
BIRTH_REQUIRED	Primary entity, own business identity, governed	Add trigger in B3
BIRTH_EXEMPT_STRUCTURAL_JUNCTION	M2M junction, no own identity	Exempt — document
BIRTH_EXEMPT_SYSTEM_LOG_OR_AUDIT	Log/audit/changelog, append-only	Exempt — document
BIRTH_EXEMPT_DERIVED_CACHE	Computed/cached, not primary source	Exempt — document
BIRTH_DEFERRED_NEEDS_REVIEW	Unclear — needs GPT/User review	Flag

Classification uses weighted evidence (schema shape, FK profile, PK profile, row count, governance_role, migration_state, species mapping, birth row presence, naming pattern). Naming = weak signal only.

---

7. Governance Operating Model — PG-native, PG-driven

Governance không cần external tools. Incomex đã có 5 layers trong PG:

Layer	Purpose	PG artifact (existing)	Status
Metadata catalog	Biết hệ thống có gì	collection_registry, meta_catalog, birth_registry, entity_species, species_collection_map	✅ Working
Policy-as-config	Quy tắc quản trị = metadata rows	dot_config (vocab.*), universal_rule_registry, description_policy (collection_registry), governance_role	✅ Working
Lineage/dependency	Ai dùng ai, ai thuộc ai	entity_dependencies, universal_edges, FK introspection	✅ Tables exist (partially populated)
PG-first enforcement	Enforce tại write time	fn_birth_registry_auto, fn_iu_birth_gate_layer1, fn_description_birth_guard, PG triggers	✅ Working
Audit/coverage dashboard	Biết thiếu gì, sai gì	birth_registry queries, system_health_checks, system_issues	✅ Working

Operating principle: Thêm governance rule = thêm row vào dot_config / universal_rule_registry / collection_registry. KHÔNG thêm code. KHÔNG thêm external service.

External tool evaluation (OpenMetadata, DataHub, OPA, etc.) = separate future evaluation pack khi hệ thống stable. Không thuộc B2 scope. Reference only:

FUTURE_EVAL_PACK: external governance tool evaluation
  candidates: OpenMetadata, DataHub, Atlas (metadata catalog)
              OPA, Kyverno (policy-as-code)
              Bytebase (DB change management)
  prerequisite: PG-native governance operational first
  timing: after B-phase complete + production stable

---

8. Impact on 5C2 (unchanged — IU 100% covered, 137-gap doesn't block pilot)

---

9. Governing rule (unchanged)

---

B2 Contract Design rev2 | PG-native governance | 2026-05-12