Veritabanı kataloğu

Bu sayfa application-owned PostgreSQL yüzeylerinin navigasyon kataloğudur. Bir tablonun kolon, constraint, index veya routine imzasını yeniden tarif etmez. Exact fiziksel gerçek sırasıyla migration’larda, doğrulanmış generated pg_catalog kataloglarında ve public API contract çıktılarındadır.

Münderecat’ın veri akışını ilk kez okuyorsanız önce sistem mimarisine bakın. PostgreSQL’in veya Supabase’in kendi auth, storage, realtime, extension ve sistem şemaları bu kataloğun dışındadır.

Otorite sırası

Soru	Canonical kaynak	Ne kanıtlar?
DB’de hangi fiziksel nesne oluşturulur?	db/supabase/migrations/*.sql	Schema, table, view, function, trigger, role, grant ve RLS tanımı
Immutable core’un exact fiziksel yapısı nedir?	Core şema kataloğu	Kabul edilmiş migration’ın PostgreSQL 17 pg_catalog snapshot’ı
Osmanlıca/lexical private routine’in imza ve ACL’i nedir?	Osmanlıca private API kataloğu	Allowlistteki routine’in canlı katalog kimliği ve execution yüzeyi
Public v1 operation, request ve response nedir?	Public API v1, RPC operasyonları ve tipler	Contract ve exposure manifestinin generated projection’ı
Bir projection gerçekten yayında mı?	Kabul edilmiş api_control.deployments, binding ve active_deployment kaydı	Contract’ın hangi release setine fiilen bağlandığı

Generated public API belgesi deployment kanıtı değildir. Exposure manifestinin mevcut durumu contract_projection_not_deployed olduğu sürece sözleşmede görünen bir operation’ın canlı endpoint olduğu varsayılmaz.

Şema haritası

flowchart LR
  accTitle: Münderecat veritabanı şema katmanları
  accDescr: Immutable public core ortak anchor ve provenance katmanlarını besler; domain control şemaları kendi release authority'lerini üretir; api_control kabul edilmiş release'leri deployment'a bağlar ve api_v1 yalnız public RPC projection'ını sunar.
  core[public\nimmutable core]
  migration[migration_control\nbaseline ledger]
  provenance[provenance_control\nlineage + curation]
  anchor[anchor_control\nshared anchors]
  structural[structural_control\nsegments + headings]
  note[note_control\nhaşiyeler]
  ottoman[ottoman_control\nrendering]
  lexical[lexical_control\nlexeme + compound]
  repetition[repetition_control\nrepeat authority]
  alignment[alignment_control\nlanguages]
  reference[reference_control\nreference registry]
  deploy[api_control\nrelease bindings]
  publicApi[api_v1\nPostgREST RPC]

  migration --> core
  core --> anchor
  core --> structural
  core --> note
  core --> ottoman
  anchor --> structural
  anchor --> note
  anchor --> ottoman
  anchor --> lexical
  anchor --> repetition
  anchor --> alignment
  core --> reference
  structural --> reference
  note --> reference
  ottoman --> reference
  lexical --> reference
  repetition --> reference
  alignment --> reference
  provenance -. lineage .-> structural
  provenance -. lineage .-> note
  provenance -. lineage .-> ottoman
  provenance -. lineage .-> lexical
  provenance -. lineage .-> repetition
  provenance -. lineage .-> alignment
  provenance -. lineage .-> reference
  core --> deploy
  note --> deploy
  ottoman --> deploy
  lexical --> deploy
  repetition --> deploy
  alignment --> deploy
  reference --> deploy
  deploy --> publicApi

Oklar tablo sahipliğini değil, release veya projection bağımlılığını gösterir. Annotation domain’leri public core satırlarını değiştiremez; core exact reconstruction hiçbir annotation şemasına bağlı değildir.

Uygulama şemaları

Şema	Authority ve başlıca nesne aileleri	Yazma yolu	Okuma/exposure
public	works -> text_versions -> books -> chapters -> paragraphs -> sentences -> token_occurrences; token form, tokenization ve sealed core release kayıtları	Deterministik package importer ve tek yönlü release publication; publication sonrası immutable	Core reconstruction ve owner-rights API projection’ları; base tablolar public API değildir
migration_control	Baseline freeze, migration üyeliği ve application receipt ledger’ı	Migration/baseline doğrulayıcısı	Audit ve reproducibility; reader verisi değildir
provenance_control	Source system/release/artifact/record, process run, evidence, validation, publication authorization, curation transaction ve legacy crosswalk	Provenance-aware importer, validator ve kabul edilmiş curation transaction’ı	Lineage/audit; yalnız açık public provenance projection’ı dışarı çıkar
anchor_control	Identity release, coordinate profile, anchor entity, text span, text selection ve bootstrap closure	Release-bound anchor publisher	Annotation domain’lerinin ortak hedef omurgası; doğrudan public storage yüzeyi değildir
structural_control	Segment ve heading türleri, occurrences, legacy crosswalk, package/release sözleşmeleri	Structural publisher ve yeni release; core konumlarını değiştirmez	Heading public wrapper’ı ve ileride authored yapı/atıf kullanımı
note_control	Haşiye/yıldızlı not türleri, note, marker, body, coverage gap ve release	Note package publication	Chapter note reader projection’ı üzerinden
ottoman_control	Mapping pattern, orthographic form, pattern output, rendering occurrence, reader unit ve reader/publication release’leri	Deterministik mapping/rendering publication; evidence ile release sealing	Bilingual chapter unit’leri; private routine ayrıntısı generated katalogda
lexical_control	Sözlük source/entry/sense, lexeme/form/root, analysis/selection, compound entry/variant/occurrence/children, curation, supersession, lexical release ve hover binding	Deterministik lexical publication veya accepted append-only curation transaction	Hover ve “geçtiği yerler” projection’ları; base tablolar doğrudan expose edilmez
repetition_control	Passage occurrence, exact class/member, near candidate/diff, canonical choice/curation ve repetition release	Detection çıktısı, review ve accepted canonical-choice publication	Chapter repetition ve member lookup projection’ları
alignment_control	Target source release/book, alignment unit/scope, candidate/group/order ve multilingual release/publication	Ayrı dil source publication, alignment review ve release sealing	Chapter alignment ve target lookup projection’ları
reference_control	Referenceable entity registry projection’ları, registration transaction, resolution policy/release/event ve curation-source binding’leri	Release-bound registry refresh; current resolution yalnız accepted supersession olaylarından yayınlanır	Exact/current entity resolution; authored atıf edge tablosu değildir
api_control	Contract release, operation revision, deployment, domain release binding, release manifest, withdrawal, cursor key ve owner-rights read projection’ları	Ayrı deployment/activation işlemi; domain release’i kendiliğinden public yapmaz	api_v1 wrapper’larının release-bound okuma kaynağı
api_v1	Stable major-v1 PostgREST RPC adları ve response envelope’ları; kalıcı domain storage yok	Yalnız açıkça yetkilendirilmiş curation wrapper’ları; read RPC’leri mutation yapmaz	Dış istemcinin tek DB API şeması; contract allowlist’i dışındaki adlar public değildir

Domain tablolarının semantiği için annotation modeli, Osmanlıca ve lexical mimari, tekrar mimarisi, çok dilli alignment ve reference readiness rehberlerini kullanın.

RPC yüzeyleri

Public PostgREST

Public istemci mantıksal operation key kullanır; fiziksel yol /rest/v1/rpc/<v1-rpc-adı> biçimindedir. Request, response, result state, pagination, sıra, bütçe ve rol bilgisi generated RPC operasyon kataloğundadır. Ortak envelope ve failure davranışı Public API v1 sözleşmesinde, transitive alan closure’ı tip kataloğunda yer alır.

Bir public çağrı şu iki bağ olmadan geçerli veri okuyamaz:

1. operation revision kabul edilmiş contract release içinde bulunmalıdır;
2. istenen domain release, seçilen api_control deployment’ına bağlanmış olmalıdır.

Bu nedenle “function migration’da var” ile “endpoint bu deployment’ta kullanılabilir” aynı iddia değildir. Capability discovery veya active deployment kaydı nihai runtime kararını verir.

Private database routine’leri

Core reconstruction ve domain publication/curation routine’leri maintainer, publisher veya auditor iş akışları içindir. PostgREST allowlist’i değildir. Osmanlıca, lexical, reconstruction ve occurrence lookup yüzeylerinin exact signature, volatility, security mode, owner ve effective EXECUTE değerleri private API kataloğunda doğrulanır.

Diğer domain routine’leri için migration tanımı exact otoritedir. Bir control schema function’ını yalnız adından veya SECURITY DEFINER olmasından dolayı runtime/public kabul etmeyin; rol grant’i, sabit search_path, RLS ve çağıran wrapper birlikte değerlendirilmelidir.

Sık okuma yolları

İhtiyaç	Release-bound yol
Chapter Latin metni	api_v1 chapter core RPC -> api_control core deployment -> public release/text hierarchy
Osmanlıca karşılık	Chapter Ottoman RPC -> Ottoman reader binding -> ottoman_control published reader release -> core token span’ları
Hover, kök, lügat ve geçtiği yerler	Chapter hover/entity occurrence RPC -> Ottoman + lexical binding -> lexical_control selected analysis/compound occurrence -> core occurrence
Haşiye	Chapter notes RPC -> note release binding -> note_control reader projection -> anchor/core coordinate
Tekrar	Chapter repetitions/member lookup -> repetition release binding -> repetition_control accepted class/family membership
Çok dilli cümle	Alignment RPC -> multilingual release binding -> alignment_control accepted group/order -> source/target unit
Exact/current kimlik	Entity RPC -> reference resolution binding -> reference_control registry ve accepted resolution release

Değişiklik kuralları

• Core satırları yerinde düzeltilmez. Yeni source/package gerçeği yeni stable kimlik veya yeni core release gerektirir.
• Annotation ve sözlük düzeltmeleri domain authority’sinde append-only evidence, decision, supersession veya yeni release olarak yapılır.
• Bir domain release’in oluşması public reader davranışını kendiliğinden değiştirmez. api_control deployment binding’i ayrı ve denetlenebilir karardır.
• api_v1 wrapper’ı domain tablosunu genel sorgu yüzeyine dönüştürmez; response şekli ve bütçe contract allowlist’iyle sınırlıdır.
• Public endpoint’e yeni alan veya operation eklemek migration’dan ibaret değildir; compatibility sınıflaması, generated contract ve deployment bağını birlikte gerektirir.

Doğrulama maliyeti

Değişen yüzeye göre tek focused kontrol kullanın:

# Contract veya exposure manifesti değiştiyse; DB açmaz.
make public-api-reference-check

# Core migration/config/catalog generator değiştiyse; disposable PostgreSQL gerekir.
make core-schema-catalog-check

# Osmanlıca private API allowlist/migration/generator değiştiyse; disposable PostgreSQL gerekir.
make ottoman-api-catalog-check

Routine doküman değişikliğinde ikinci ve üçüncü komutları tekrar çalıştırmak gerekmez. DB erişimi ve packet başına izolasyon kuralları için veritabanı erişimi rehberine bakın.