Skip to main content

CAN-GOV-UCSTD-001 — Use-Case Authoring, Packaging ve Detail-Projection Standardı

Statü: PROPOSED. Bu standart EventInn Canon'un tüm Use-Case sisteminin kalıcı authoring/packaging/detail kuralını tanımlar (yalnız UCG-012 değil). Normatif-sahip BURASIDIR; use-case-member-v2-template.md bu standardın uygulama-örneğidir (kuralların sahibi değil). Yaşam-döngüsü: PROPOSED→ACCEPTED (Human-CEO) · CAN-GOV-UCDEP-001'e kontrollü-amendment alternatifi CEO-kararıdır.

1. Kapsam​

Tüm UC-grup-paketleri (CAN-REQ-UCG-*) ve içindeki atomik use-case'ler (üye-UC'ler). CAN-GOV-UCDEP-001 (bağımlılık/readiness/sequencing) ile eş-düzey/tamamlayıcı (biri diğerinden türemez — ayrı sorumluluk-alanları, hard-dependency değil; related, upstream değil); bu standart authoring-formatı + paket-üyelik-semantiği + governance-inheritance + detail-projeksiyonu tanımlar.

2. Paket ⊥ Üye ⊥ Detail semantiği​

  • UCG paketi = governance-kaynağı (accepted olan paket-belgesidir).
  • Üye-UC (ör. UC-ECC-001) = atomik, okunabilir davranış-sözleşmesi (paket gövdesinde yaşayan yapılı-blok).
  • Detail-sayfası = GENERATED PROJECTION (parser paketten üretir; ayrı-authoritative-kayıt değil).

3. Governance inheritance (16-ayrı-onay YASAK)​

  • Üye-UC, parent-UCG'nin governance_status'ünü miras alır. Ayrı approved_by/approved_at/effective_at YOK; ayrı Human-CEO-acceptance-event YOK.
  • Terfi-kapısı: bir UC ayrı owner / ayrı lifecycle / ayrı risk_class / bağımsız acceptance / bağımsız supersession gerektirirse → bağımsız Canon-kaydına terfi eder (kendi UCG'si/kaydı + canon-record-template.md; o zaman inheritance biter).

4. Tek Source-of-Truth (drift-yasağı)​

  • UC-içeriği YALNIZ parent-UCG paketinde yaşar. Ayrı UC-ECC-001.md kopyası YAZILMAZ (zamanla ayrışır = knowing-drift).
  • Detail-sayfası kopyalamaz; parser üretir: SOURCE UCG → PARSER → CLICKABLE DETAIL PROJECTION.

5. Authoring-formatı (12-bölüm v2)​

Her üye-UC bloğu 12-bölüm v2-yapısını taşır: Nedir · Aktörler/Uygulanabilirlik · Amaç · Tetikleyici · Ön-Koşul · Beklenen-Davranış · İstisna/Red · Son-Koşul · Kabul-Kriterleri · Kapsam-Dışı · İzlenebilirlik · Governance. Uygulama-örneği: canon/_templates/use-case-member-v2-template.md (bu standardın örneği, sahibi değil). Legacy V1-şablon (use-case-template.md) = DO-NOT-USE.

6. UC Class (üç sınıf; yapı korunur, yapay-içerik zorlanmaz)​

Her üye-UC bir sınıf taşır: BEHAVIORAL (davranışsal/operasyonel) · SYSTEM_INTEGRITY (güvenlik/doğruluk-invariant'ı) · GOVERNANCE (build-öncesi karar-kapısı, runtime-değil). Kural: 12-bölüm yapısı KORUNUR; uygulanmayan bölüm atlanmaz → N/A — gerekçe ile açıklanır (parser-stabil kalır, sahte-içerik üretilmez).

7. Genel-invariant inheritance (per-UC KOPYALAMA yasağı — R2-redline)​

Ortak acceptance-invariant'ları (server-side-authz · SoT-bypass-yok · fake-capability-yok · context-karışmaz · test-edilebilirlik …) parent-UCG'nin §Genel Acceptance Prensipleri bloğunda TEK KEZ yaşar. Üye-UC §9-Kabul-Kriterleri yalnız UC-specific + Pozitif/Negatif GIVEN/WHEN/THEN taşır; genel-invariant'lar referans/projeksiyon edilir (Inherited Package Invariants → CAN-REQ-UCG-XXX §Genel Acceptance Prensipleri), her UC-bloğuna kopyalanmaz.

8. Parser-contract (stable machine-key + format-version — P1)​

  • Blok-sınırı: <!-- uc-member:start id="UC-XXX-XXX" class="BEHAVIORAL|SYSTEM_INTEGRITY|GOVERNANCE" version="2" --> … <!-- uc-member:end -->.
  • Bölüm-anahtarı: <!-- section:KEY --> (KEY sabit: definition·actors·purpose·trigger·preconditions·behavior·exceptions·postcondition·acceptance·out_of_scope·traceability·governance).
  • İnsan-başlığı (**1. Nedir?**) bunun YANINDA yaşar. Kural: MACHINE-CONTRACT = stable · HUMAN-LABEL = evolvable (başlık değişse parser bozulmaz).
  • Format-version (P1, parser-kodundan ÖNCE): parser-contract açıkça versiyonlanır — v3 geldiğinde parser guess-yapmasın. Her üye-blok version="N" taşır; parent-UCG paket-metadata'sı extensions.use_case_authoring: { standard: CAN-GOV-UCSTD-001, format_version: 2 } taşır. Bu standart format_version: 2'yi tanımlar; version-bump ayrı governance-değişikliğidir.
  • Package-invariants marker (P1 hardening): parent-UCG'nin ortak-invariant bloğu (## Genel Acceptance Prensipleri) stable machine-marker <!-- uc-package:invariants --> ile işaretlenir → generated-detail bunları referansla-projekte eder (R2; member'a kopyalanmaz).

9. Detail-projection modeli​

Generated atomik detail-sayfası: tıklanabilir · parent-governance referansla gösterilir (Governance: inherited from CAN-REQ-UCG-XXX) · package-invariant'lar miras-gösterilir · implementation/verification-stage AYRI (sidecar/verification-mapping) gösterilir. Paket-görünüm → tıkla → detail; prev/next-nav + pakete-dön.

10. İzlenebilirlik zinciri​

SCENARIO → UCG-PACKAGE → CLICKABLE-ATOMIC-UC-DETAIL → RULE/POLICY → ADR → FEATURE-TRAIN → IMPLEMENTATION → UC-BASED-VERIFY.

11. Legacy Adoption / Migration Boundary (ratchet — geriye-dönük-kırmama)​

Bu standart kabul edildiğinde mevcut CAN-REQ-UCG-001..011 (eski-format) bir anda non-compliant OLMAZ. Ratchet-sınırı:

  1. Geriye-dönük geçerlilik korunur: mevcut accepted-UCG kayıtları bu standardın kabulüyle geçersiz-olmaz; accepted-statüleri düşmez.
  2. İleriye-dönük uygulama: v2-format yeni UCG'lerde zorunludur.
  3. Fırsat-temelli normalizasyon: mevcut bir UCG anlamlı biçimde revize edildiğinde v2'ye normalize edilir (revizyon-anında ratchet ilerler; toplu-zorlama gerekmez).
  4. Format ≠ governance: yalnız format-normalizasyonu (semantik-değişmeden) governance_status'ü DEĞİŞTİRMEZ (accepted → accepted kalır; yeni-acceptance-töreni gerekmez).
  5. Semantik-değişim → normal governance: UC'nin anlamı/davranışı değişirse normal governance-süreci (proposed→accepted + künye) gerekir; "normalizasyon" kılıfında sessiz-semantik-değişim YASAK.
  6. Coexistence: migration tamamlanana dek parser legacy + v2 birlikte çalışmayı destekler (version-tespit ile; §8 format_version).
  7. Detail-garantisi: generated atomik-detail yalnız v2-normalize edilmiş üye-bloklarında tam-garantilidir; legacy-UCG'ler normalize-edilene dek paket-düzey-görünümde kalır (kısmi/degrade-detail sahte-tamlık iddia etmez).

12. Non-Normative Reference Projections​

Bu standardın UX + projection-davranışını gösteren non-normative referans-mockup'ları (Canon-truth ÜRETMEZ, normatif-kural KOYMAZ):

  1. UC ↔ ADR Coverage & Navigation — strategy/proposals/use-case-system/uc_adr_coverage_navigation_mockup_v1.html
  2. Atomic Use-Case Detail View — strategy/proposals/use-case-system/uc_detail_view_mockup_v1.html

Canlı-implementasyon authoritative UCG + v2 parser + generated projection/index'ten türetilir (ONE SOURCE → TWO PROJECTIONS). Coverage-görünümündeki atomik-ilişkiler member section:traceability'den; Detail-içeriği parent-UCG member-block'undan gelir. İki görünüm ayrı hard-coded dataset TAŞIMAZ.

CAN-GOV-UCSTD-001 · governance/normative · Use-Case Authoring/Packaging/Detail-Projection Standardı · format_version 2 · legacy-ratchet-boundary · non-normative-projections · proposed · Canon Foundation v2.