Veri düzeltmesi katkısı

Katılımcı production veritabanında satır değiştirmez ve SQL göndermez. Bir veri düzeltmesi, küçük bir deklaratif proposal dosyasıyla problemi, stable hedefi, gözlenen revision’ı, kaynak kanıtını ve beklenen sonucu tarif eder. Proposal review girdisidir; kabul kararı veya doğrudan DB yazma yetkisi değildir.

İlk çalıştırılabilir sözleşme tek bir compound_boundary / single_occurrence düzeltmesini kapsar. Osmanlıca imla, lexeme/root, lügat, heading, haşiye ve alignment proposal’ları aynı yaşam döngüsüne bağlanacak, fakat kendi domain sözleşmeleri eklenmeden bu dosya biçimiyle taklit edilmeyecektir.

Akış

1. Data correction issue formuyla en küçük hatalı birimi ve bilinen stable ID’leri bildirin.
2. data/corrections/ altında versioned schema’ya uyan tek proposal ekleyin.
3. Mevcut ve önerilen span’ı exact token occurrence ID’leriyle dondurun. Korunacak dış annotation için occurrence, variant, revision ve exact member envanterini ekleyin.
4. Kaynak locator’ı, minimal excerpt hash’i, gerekçe ve rights basis’i yazın.
5. Yalnız ilgili düzeltme kapısını çalıştırın:

make data-correction-check

6. PR’da annotation, core reconstruction, downstream lookup ve dokümantasyon etkisini açıklayın. Semantik reviewer exact proposal’ı değerlendirir.
7. Maintainer proposal’ı trusted contract ile yeniden yükler; exact content SHA-256’yı reviewed evidence inventory’ye bağlar ve güncel target ile surrounding annotation revision’larını karşılaştırır. Semantic entry/variant, evidence assertion ve yeni UUIDv7 kimliği private authority’den çözülür.
8. Eski kayıt silinmez veya yerinde değiştirilmez; typed supersession ile tarihçede kalır. Sonraki curation release yeni transaction’ı yayımlar.

Proposal değişirse content SHA-256 değişir ve aynı reviewed byte’lar sayılmaz. Yeni revision veya successor proposal gerekir. Başka bir düzeltme target’ı ya da korunacağı bildirilen annotation’ı değiştirdiyse review context stale olur; curator resolution DB application oluşturmaz. Private transaction yazılan target revision’ını ayrıca atomik olarak doğrular.

Örnek

data/corrections/examples/compound-boundary-tail-v1.json içindeki compound boundary örneği şu sentence fixture’ı üzerinde çalışır:

Emr-i kün feyekûn ve hamele-i arş ve yer.

Fixture’ın kabul edilmiş semantik varsayımında dış occurrence hamele-i arş ve yer korunur. Düzeltilecek ek iç occurrence hamele-i arş ve, hamele-i arş successor’ıyla değiştirilir. Son ve tokenı core sentence içinde ve doğru dış terkipte kalır. Bu ayrım, bir annotation düzeltmesinin kaynak metni veya başka geçerli annotation’ı değiştiremeyeceğini somut olarak gösterir. Bu sınıflandırma executable fixture’ın review varsayımıdır; fixture, production kataloğunda bu hatanın bulunduğu veya global hamele-i arş ve entry/variant kaydının geçersiz olduğu iddiası değildir. Gerçek curation yaşam döngüsünü accepted sample authority üzerinde çalıştırır.

Validator şu kontrolleri DB olmadan yapar:

• schema dışı veya eksik alan yoktur;
• proposal key ve aktif target başka bir proposal ile çakışmaz;
• tüm metin NFC’dir;
• current surface exact ordered member’lardan yeniden kurulur;
• retained ve excluded position’lar occurrence’ı eksiksiz ve çakışmasız böler;
• retained span contiguous’dir ve proposed surface ile aynıdır;
• surrounding occurrence’ın exact member yüzeyi, variant kimliği ve revision witness’ı review context içinde korunur ve mevcut span’ı gerçekten içerir;
• minimal evidence excerpt’i ilan edilen SHA-256 ile aynıdır;
• core veya reconstruction değişikliği talep edilmemiştir.

CI pull request head’indeki proposal ve SQL/config blob’larını authoritative Git tree envanterinden doğrudan materialize eder; .gitattributes archive dönüşümleri devreye girmez. Validator, schema, Make target ve test harness trusted base commit’ten çalışır. Non-regular mode, hidden/symlink veya JSON dışı proposal ve sınır dışı/büyük artifact yolları fail-closed reddedilir.

Disposable test bunun ardından curator’ın çözdüğü action’ı mevcut private curation API’siyle uygular. Resolver proposal’ı trusted contract’tan yeniden yükler. Exact proposal content SHA-256, curation proposal’ın evidence_inventory_root alanına; çözülen action ise aynı proposal’ın action/payload root’larına girer. Review kararı bu proposal payload root’una bağlıdır. Test, predecessor’ın superseded, successor ve dış occurrence’ın active kaldığını, çıkarılan tokenın hâlâ core’da olduğunu ve exact sentence reconstruction’ın byte düzeyinde değişmediğini doğrular. Full corpus, release, backup/restore veya legacy DB bu günlük PR kapısının parçası değildir.

Surrounding annotation envanteri semantik review context’idir ve bu düzeltmenin ona yazmamasını görünür kılar. Mevcut curation API yalnız yazılan target’ı atomik stale-state kontrolüne alır; aynı anda yürüyen bağımsız bir curator işlemini surrounding annotation için read-set olarak kilitlediği iddia edilmez. Bir düzeltme birden fazla authoritative nesnenin birlikte değişmez kalmasını gerektirirse ayrı çoklu-nesne transaction sözleşmesi gerekir.

Yetki Sınırı

Contributor dosyası successor_variant_id, evidence_assertion_id, successor occurrence UUID’si, review kararı veya executable SQL taşımaz. Validator yalnız curator intake için proposal digest’ine bağlı açık bir action intent özeti üretir. Maintainer şu değerleri review sonrasında güncel DB authority’sinden çözer:

• target’ın hâlâ active olan exact revision’ı,
• korunacak surrounding annotation’ların exact revision’ları,
• önerilen yüzeyin doğru semantic entry altındaki variant kimliği,
• kabul edilmiş provenance evidence endpoint’i,
• yeni UUIDv7 successor kimliği,
• reviewer/quorum kararı,
• curation release’e girecek transaction ve state root’ları.

Bu sınır katılımcının düşük maliyetli bir PR hazırlamasını sağlar; production kimliği, stale-state kontrolü ve semantik kabul yetkisini repository dosyasına veya otomatik skora bırakmaz.