Sistem mimarisi

Münderecat dört ana katmandan oluşur:

1. Core corpus: Eser, metin sürümü, kitap, chapter, paragraf, cümle, token form ve token occurrence kayıtları.
2. Shared geometry: Cümle içindeki immutable span ve ordered selection kimlikleri.
3. Domain annotation’ları: Osmanlıca, lexical, terkip, heading, haşiye, tekrar, alignment ve atıf kayıtları.
4. Projection: Release-bound public RPC’ler, generated TypeScript client ve Next.js reader.

flowchart LR
  package[Corpus package] --> core[Immutable core]
  core --> anchors[Stable spans]
  anchors --> annotations[Domain releases]
  core --> api[Public API deployment]
  annotations --> api
  api --> reader[Reader]

Core ve annotation ayrımı temel güvenlik sınırıdır. Annotation importu başarısız olduğunda Latin metin yine reconstruct edilebilir. Bir terkip veya lügat düzeltmesi token sırasını, punctuation’ı veya stable core ID’lerini değiştiremez.

Public API base tabloları doğrudan sunmaz. Her response kullanılan deployment, contract, schema ve data release bağlamını taşır. Optional katman yoksa sonuç başka bir veriye sessizce fallback yapmak yerine açık unavailable durumudur.

Yayın sonrası semantic düzeltmeler immutable geçmişi koruyan curation, successor ve supersession kayıtlarıyla yapılır. Aynı kimliğin anlamını yerinde değiştirmek yasaktır.