Mimari kararlar ve veri modelleri

Bu sayfa, Münderecat’ın kabul edilmiş mimari kararları ve mantıksal veri modelleri için başlangıç noktasıdır. Bağlantı verilen belgeler doğrudan canonical kaynaklarından yayımlanır; ikinci bir doküman kopyası tutulmaz.

Sistemi source-to-release ve runtime akışlarıyla önce topluca görmek için geliştirici sistem mimarisi rehberinden başlayın. Bu sayfa ise normatif karar ve veri modeli kayıtlarının okuma indeksidir.

Schema, API ve pipeline isimlerinde bu kayıtların ortak canonical domain sözlüğü kullanılır.

Önerilen okuma sırası

1. Core ve annotation sınırı hangi verinin kaynak metni kurduğunu, hangisinin ayrı yorum katmanı olduğunu belirler.
2. Stable identity, paket formatı, token modeli ve span koordinatları kalıcı kimlik ve exact reconstruction temelini kurar.
3. Provenance ile production curation verinin nereden geldiğini ve kabul edilmiş kaydın nasıl düzeltileceğini; migration ve release safety ise bu durumun veritabanına ve yayına nasıl güvenle taşındığını tanımlar.
4. Core ER ve annotation ER bu kararları mantıksal ilişkilere dönüştürür.
5. Referenceable entity kataloğu gelecekteki atıf ağının doğrudan endpoint’lerini kapatır.
6. Tablo kalıcılığı matrisi hangi ilişkinin immutable, curated, derived veya cache olduğunu; compatibility ve onay matrisi değişikliğin etkisini ve gereken bağımsız onayı belirler.
7. Ortak provenance veri sözleşmesi source/release/run/evidence/curation kayıtlarını fiziksel alan, FK, endpoint ve canonical serialization düzeyinde kesinleştirir.
8. Public API ve client state sözleşmesi v1 operation/RPC adlarını, release-bound response envelope’unu, pagination, generated type, UI state ve query budget kurallarını kapatır.

Alan kararları

• Çok dilli alignment
• Tekrarların kanonikleştirilmesi
• API sürümleme ve RLS

Platform ve yürütme kararları

ADR-011 ile ADR-023 arasındaki kayıtlar task packet’ları, migration güvenliği, monorepo, araç zinciri, yerel veritabanı, secret yönetimi, lisans, dokümantasyon ve agent izolasyonu sözleşmelerini tanımlar. Tam liste sol navigasyondaki Kararlar ve modeller grubunda dosya kimliğine göre sıralanır.

Durum ve değişiklik

Sayfadaki verified metadata’sı belgenin dokümantasyon build’ine kabul edildiğini gösterir. Mimari kararın kabul geçmişi kendi Status alanı ve execution registry kabul kaydıyla belirlenir. Semantik bir karar değiştirilirken eski kayıt sessizce yeniden yazılmaz; ilgili ADR’nin supersession kuralı izlenir.