Ana içeriğe geç

Traceability Model

Strateji'den runtime-kanıtına kadar kesintisiz izlenebilirlik zincirinin kayıt + ilişki standardı.

1. Zincir​

Strategy → Outcome → Capability → Use Case → Business Rule → State/Invariant
→ ADR → Architecture Component → Repository/Module → Test → Commit → Artifact
→ Release → Runtime Evidence → Metric → Improvement

2. İlişki-standardı​

Her Canon-record metadata'sında:

traceability:
  upstream:   [<canon_id>...]   # bu-kaydı-doğuran üst-halkalar
  downstream: [<canon_id>...]   # bu-kayda-bağlı alt-halkalar
evidence_refs: [<commit|run|artifact>...]   # Evidence-düzlemi bağlantısı

🔴 Tek-kaynak ilkesi: upstream canonical (elle-yazılır); downstream generated (upstream'in tersi; registry/lint türetir — iki-yerde elle-tutulmaz). İki-yön elle-tutulursa governance-lint reciprocal-equality zorunlu-kılar: A.downstream ∋ B ⇔ B.upstream ∋ A (Charter ilke-12: bugünün-kolaylığı yarının-mimarisini rehin-almaz). 🔴 Düzlem-ayrımı (Charter §5): zincirin Normative-halkaları (strategy..ADR) ⊥ Execution (brief/release-planı) ⊥ Evidence (commit/test/artifact/runtime) ⊥ Learning (metric/improvement).

3. Kayıt + denetim​

  • 🔴 _registries/traceability-register.json (planlı — foundation-sonrası oluşturulacak, henüz-yok; makine-okunur) zincir-ilişkilerini tutacak; _generated/ (varsa-generator) human-view üretir.
  • Kırık-halka (upstream-eksik, ör. ADR-without-accepted-use-case) = lint/CI-bulgusu (CAN-GOV-HIER-001 §2 ihlali).
  • Evidence-bağı: governance_status=effective (release) için evidence_refs + evidence_status=independently_verified zorunlu.

4. Minimumlar​

İlk-foundation yalnız kayıt+ilişki-standardını tanımlar; tam-zincir-doldurma use-case/ADR-aşamalarında (HOLD-sonrası) artımlı-yapılır.

CAN-TRC-MODEL-001 · traceability/normative · 16-halka · upstream/downstream + evidence_refs · governance_status: proposed · Canon Foundation v2.