Yönetilebilir ortak pasajlar ve atıflar

Kabul edilen çerçeve

4 Ekim yerel ve uzak Supabase yönetim durumu: 709, 183 aile ve 412 yerleşim. R2 okuma yayını da aynı sürümdedir. Uzak kurulum, kimlikler ve karar geçmişi korunarak tamamlandı; otomatik çift yönlü DB senkronizasyonu kurulmadı. Sabit listenin son 14 adayı dört artımlı paketle sonuçlandı; 14 aile ve 33 yerleşim eklendi. Bir kasidenin ve takrizin ayrı bulunan parçaları birleştirildi; mektup/hâşiye ve iki ayrı belgeye taşan eşitlik kesitleri doğru birimlere ayrıldı. 43 adayın 23’ü tek ortak kapsamda, 18’i incelenmiş dış sınırları korunarak, 2’si ayrı karşılıklı birimlerle kapandı. Açık aday yok; bu bütün külliyat için keşif eksiksizliği veya her cümleye birebir atıf aktarımı değildir. Karar dosyaları, sınırlar ve uygulama yolu data/curated/passages/remaining-candidates-v1.md dosyasındadır.

Önceki 705 paketinde Dört Hatve ve Hâtime’nin 77/76 kayıtlık gövdesi tek ailede bağlandı. Giriş ve dört hatvenin açıklaması ile Elhasıl dahil Hâtime, aynı ailede iki tamamlanmış alt kapsam aldı. Üç ifade farkı ve 2:1 cümle bölünmesi korunur; Mektup karşılıkları birebir değil, incelenmiş varyanttır. Karar ve uygulama data/curated/passages/four-steps-v1.md dosyasındadır.

Önceki 703 paketinde İkinci Meselenin Hülâsası’nın üç iç içe adayı, iki 32 kayıtlık ana gövdeyi bağlayan tek ailede toplandı. (aleyhimüsselâm) ilavesi korunur; birebir giriş/temsil ve sonuç ayrıca iki alt kapsam aldı. Karar ve iki aşamalı uygulama data/curated/passages/second-matter-v1.md dosyasındadır.

Önceki 701 paketinde Altıncı Mesele’nin kapanışı beş yerde ortak alt kapsamla bağlandı. İki eski aile birleşmedi; Gençlik ve On Üçüncü Söz’ün yalnız dar alıntıları eklendi. Dört birebir bağ ve bir incelenmiş varyant, eski geniş üyelikleri veya tek cümle kapsamlarını değiştirmedi. Karar ve uygulama data/curated/passages/sixth-matter-conclusion-v1.md dosyasındadır.

Önceki 700 paketinde İfadetü’l-Meram önsözünün İşarat/Tarihçe’deki 22/23 kayıtlık ana gövdeleri yerel varyantlarıyla bağlandı. İcma ve kapanış gerekçesi farkları eşitlenmedi; haşiye işaretleri yerinde, ayrı haşiye gövdeleri kapsam dışında kaldı. Karar ve uygulama data/curated/passages/ifadetul-meram-v1.md dosyasındadır.

Önceki 699 paketinde Sâlisen siyasî tavsiye bölümü, Tarihçe/Emirdağ’daki 12/14 kayıtlık yerel varyantlarıyla bağlandı. İki ek cümle, tekil/çoğul muarız ve reis bulma şartı korunur; farklı şart cümleleri eşit sayılmaz. Karar ve uygulama data/curated/passages/salisen-counsel-v1.md dosyasındadır.

Önceki 698 paketinde Celcelutiye’nin yedi mukaddimesi, sonucu ve tertip örneği, Şuâlar/Sikke’nin mevcut aile ve yerleşimleri korunarak yeni alt kapsamda bağlandı. Takriz’deki 18 kayıtlık varyant yalnız alıntı üyeliği alır; geniş aileyi ve eski tek cümle kapsamlarını devralmaz. Karar ve uygulama data/curated/passages/celcelutiye-premises-v1.md dosyasındadır.

Önceki 697 paketinde şahsî makam yerine hizmete bağlılık anlatımı, açıkça parça olarak aktarılan Emirdağ kesiti ve Kastamonu karşılığıyla bağlandı. 16/16 kayıt sayısı sıra sıra eşitlik değildir: açılışın farklı kuruluşu, şahıs farkı ve yalnız Emirdağ’daki kapanış korunur. Karar ve uygulama data/curated/passages/rank-service-v1.md dosyasındadır.

Önceki 696 paketinde Sekizinci Lem’a’nın giriş açıklaması, Fihrist’teki 19/21 kayıtlık karşılığıyla sınırlı bir ailede bağlandı. İki maksat cümlesinin bölünmesi ve yerel ifade farkları korundu; bütün Lem’a ve Fihrist bölümü eşit sayılmadı. Karar ve uygulama data/curated/passages/eighth-lemma-fihrist-v1.md dosyasındadır.

Önceki 694/695 paketinde ihlas mektubunun ana gövdesi ve ayrı sunulan Ramazan bölümü iki ailede bağlandı. Ana gövdeler 23’er kayıt olsa da eksilen yerel talimat ve 1:2 cümle bölünmesi nedeniyle sıra sıra eşit değildir. Dört cümlelik dünyevî neticeler paragrafı ayrıca alt kapsam aldı; yerel talimat bu dar kapsamda yoktur. İki aşamalı karar ve uygulama data/curated/passages/worldly-sincerity-v1.md dosyasındadır.

Önceki 693 paketinde siyasetten uzak durma gerekçeleri ve casusa cevap, üçüncü gerekçe ve kapanış da okunarak iki yerel varyantıyla bir alıntı ailesinde bağlandı. 25/29 cümle farkı, beş esasın bir yerde tek, diğerinde beş kayıt olmasındandır; yerel ifade farkları da korunur. Karar ve uygulama data/curated/passages/politics-compassion-v1.md dosyasındadır.

Önceki 692 paketinde hapishane, ibadet ve terbiye anlatımı üç karşılıklı alt kapsamda bağlandı. Şuâ’daki ve / veya şart farkı korunur; pasaj ortaklığı tek cümle/iddia eşitliği değildir. Şuâ yalnız kısa alıntı üyeliği aldı; eski şart cümlesi kapsamına eklenmedi. Karar ve uygulama data/curated/passages/prison-worship-v1.md dosyasındadır.

Önceki 691 paketinde Yedinci Mesele’nin açılışı ve ilk saltanat delili dört karşılıklı alt kapsamda bağlandı. Üç mevcut geniş yerleşim korundu; Denizli Hayatı’na yalnız altı cümlelik alıntı üyeliği eklendi. Yerel ilaveler korunur; meselenin bütünü eşit sayılmaz. Karar ve uygulama data/curated/passages/seventh-matter-v1.md dosyasındadır.

Önceki 690 paketinde üç icma delili, giriş ve sonuç dahil dört karşılıklı bir alt kapsamda bağlandı. On Dokuzuncu Mektup yalnız bu alıntıya üyelik aldı; aynı ailedeki diğer kısa alıntılar bu kapsama otomatik eklenmedi. Karar ve uygulama data/curated/passages/three-icma-v1.md dosyasındadır.

Önceki 689 paketinde biyografik haşiyedeki cumhuriyet açıklaması ve Tabiat haşiyesi, mevcut aileler içinde üçer karşılıklı iki alt kapsamda bağlandı. Yerel haşiye numaraları ve çevre anlatımı ayrı tutuldu. Karar ve uygulama data/curated/passages/reviewed-footnotes-v1.md dosyasındadır.

Önceki 688 paketinde Konferans ve Emirdağ’daki Sâniyen bölümü iki yerel varyantıyla sınırlı bir pasaj ailesinde bağlandı. Sonraki İkinci Vesilesi ailesinin kapsamı değişmedi. Karar ve uygulama data/curated/passages/saniyen-v1.md dosyasındadır.

Önceki 687 paketinde kelâmın kıymetine dair iki cümlelik açıklama dört yerde, Muhakemât haşir mukaddimesi alıntısı beş yerde mevcut ailelerin alt kapsamlarıyla bağlandı. İki yeni alıntı yalnız excerpt_only üyelik aldı; yedi eski yerleşim korundu. Kararlar data/curated/passages/reviewed-quotations-v1.md dosyasındadır.

Önceki 686 paketinde Hulusi Bey ve üniversite gençliği mektupları, imza/ayraç ve komşu mektupları kapsam dışında tutan iki ailede bağlandı. Sınır kararları ve uygulama data/curated/passages/hulusi-university-v1.md dosyasındadır.

Önceki 684/685 paketinde Münâzarât’a dair 83 cümlelik mektup ve Hasan Feyzi’nin Güzel oku şiiri iki ortak ailede toplandı; mektubun giriş ve üç hakikati ayrıca dört alt kapsamda bağlandı. Sınırlar, farklar ve iki aşamalı uygulama data/curated/passages/letter-poem-v1.md dosyasındadır.

Önceki 683 paketinde İkinci Nükte’nin dört karşılığı tek ailede, Ahmed Hamdi’ye mektubun iki gövdesi ayrı bir ailede bağlandı; Aziz yeni kardeşlerim mektubunun mevcut ailesine 14. Şuâ eklendi. Karar ve uygulama notu data/curated/passages/nukte-letters-v1.md dosyasındadır.

Önceki 682 paketinde Altıncı Rica ile Hüve için mevcut geniş aileler içinde iki alt kapsam; Medresetü’z-Zehra’nın İkinci Vesilesi için bir dar kimlik eklendi. Kısmi alıntılar excerpt_only üyeliğinde tutuldu, eski kimlik ve sınırlar değiştirilmedi. Karar, koordinatlar, komutlar ve kontroller data/curated/passages/reviewed-subparts-v1.md dosyasındadır. Bu yerel ekleme remote veya R2 yayınının da güncellendiği anlamına gelmez.

27 Eylül 2026 incelemesinde mevcut pasaj haritasındaki ortaklıklar başlangıç envanteri olarak kabul edildi. Bu kabul, haritadaki her tarihsel kaynak yönünün kesinleştirildiği anlamına gelmez. Kaynak yönü ortak atıfların görünürlüğünü belirlemez. Aynı pasajın farklı kitaplarda bulunması, kitapların metinlerini veya yerel cümle kimliklerini birleştirmez.

Bu iş paketi genel amaçlı atıf ağının tamamını değil, o ağın tekrarlar üzerinde tutarlı çalışması için gereken kapsam, karşılık ve yönetim temelini kurar.

Dört ayrı kavram

1. Pasaj kimliği: Aynı metinsel bütünün ortak anlamsal kimliği.
2. Yerleşim: Pasajın belirli bir kitapta, değişmez kaynak koordinatlarında bulunan yerel metni. Yazım farkı, giriş ve bağlam burada korunur.
3. Ortak alt kapsam: Pasaj içindeki belirli bölümün doğrulanmış yerel karşılıkları. Birden fazla cümleye yayılan ve cümle bölünmesi farklı olan karşılıklar da mümkündür.
4. Eser sunumu: Mevcut içerikleri sıralı olarak bir kitap adı ve kalıcı eser adresi altında sunan katalog kaydı. Kaynak corpus hiyerarşisinin yerine geçmez.

Tarihsel kaynak yönü, tercih edilen okuma yeri ve derleme bileşen sırası bu kimliklerin birbirinden bağımsız özellikleridir. Birini düzeltmek diğerlerini yeniden üretmez.

Atıf görünürlüğü

Atıf bir kez saklanır. Kaynak ve hedef uçları açıkça tiplidir. Atıf kayıtlarını her yerleşim için çoğaltmak yerine, okuma sırasında geçerli üyelikler ve kapsam karşılıkları üzerinden görünürlük hesaplanır.

Kapsam	Görünürlük
Pasaj bütünü	Ortak bütünün kabul edilmiş yerleşimleri
Ortak alt parça	Bu kapsam için doğrulanmış karşılığı bulunan yerleşimler
Yerel parça	Yalnız belirtilen yerleşim ve kaynak aralığı

Bir pasajdan alınmış kısa seçkinin aileye bağlanması, onda bulunmayan cümlelere yapılmış atıfları almasına izin vermez. Bir kitap bütününe verilen atıf, otomatik olarak bütün bileşenlerine dağıtılmaz. Aynı atıf birden fazla eşleşmeyle bulunursa kimliği üzerinden tek kez gösterilir; gösterim hangi yerel karşılıktan geldiğini korur. İçerme, tarihsel kaynak ve açıklama/delillendirme ayrı ilişkilerdir.

Atıf yerel metne yazılmışsa sonradan sessizce ortak atfa dönüştürülmez. Ortak karşılığı doğrulanmış bir seçimde ortak kapsam önerilebilir; yerel kapsam kullanıcının açık bir seçeneği olarak kalır. Başlangıçta deneme atıfları yalnız test verisidir; corpus hakkında gerçek editoryal iddia olarak yayımlanmaz.

Karşılık üretme sınırı

• Otomatik eşleştirme yalnız kabul edilmiş bir ailenin yerleşimleri içinde yapılır.
• Başlangıç kanıtı özgün metindir; normalizasyon, benzerlik veya kaynak yönü anlamsal eşitlik yerine geçmez.
• Kesin ve sıralı birebir aralıklar otomatik bağlanabilir. Cümle bölünmesi değişmiş ama aynı metin korunmuşsa çoklu cümle karşılığı desteklenir.
• Yinelenen kısa ifadelerin belirsiz eşleşmeleri ve değişmiş parçalar ayrı raporlanır; metin benzerliğinden otomatik anlamsal kabul üretilmez.
• Yazımı farklı fakat aynı anlamda olduğu kabul edilen karşılık, ayrı gerekçeli inceleme kararıyla eklenebilir. Bu işlem özgün metni değiştirmez.
• Unicode scalar koordinatları, kaynak sırası ve cümle/paragraf ayırıcıları korunur.

Düzenleme ilkeleri

İlk kabul edilmiş yayın değişmez başlangıçtır. Sonraki işlemler kimlikleri yeniden hesaplayan corpus rebuild’leri değil, gerekçesi ve etki alanı kayıtlı düzenlemelerdir.

• Aileye ekleme, çıkarma veya başka aileye taşıma metni ve yerleşim kimliğini değiştirmez.
• Pasaj sınırı değişiyorsa yeni yerleşim eski yerleşimin halefi olarak kaydedilir. Eski adresler ve eski atıflar silinmez veya başka metne sessizce yönlendirilmez.
• Kapsam bağı kaldırılırsa ilgili ortak atfın o konumdaki görünürlüğü kalkar; atfın kendisi ve diğer yerlerdeki görünürlüğü korunur.
• Önizleme, etkilenecek üyelikleri ve atıfları gösterir. Uygulama beklenen sürüme karşı tek transaction içinde yapılır. Eski önizlemeyle yeni duruma yazılamaz.
• Aynı işlem anahtarı ve aynı içerikle tekrar çağrı aynı sonucu verir; aynı anahtarla farklı içerik reddedilir.
• Yazma işlemleri bakım araçlarına aittir. Public okuma API’sine anonim yazma yetkisi verilmez. Geri alma geçmişi silmek değil, telafi işlemi eklemektir.

Eser sunumu ve yeni kaynak ayrımı

Mevcut bir küçük eseri bağımsız kitap olarak sunmak, mevcut chapter kimliğini, paragrafları veya cümleleri taşımayı gerektirmez. Katalogdaki kalıcı eser kaydı mevcut kaynak kapsamına bağlanır; kitap adresi, başlığı ve sıralı içindekileri bu katmanda bulunur. Eski chapter adresi geçerli kalır. Başlangıç sürümü tam chapter üyelerini destekler; keyfi kesitlerden kitap oluşturma desteklenmiş gibi sunulmaz.

Yeni bir Zülfikar/Tılsımlar baskısı ise kendi kaynak metniyle içeri alınır. Mevcut pasajların metinleri, o baskının özgün girişleri veya farkları yerine kullanılmaz. Yeni kaynak yerleşimleri sonrasında mevcut ortak kimliklere bağlanır. Bu iki işlem aynı import komutu veya aynı otorite iddiası değildir.

Uygulama Takibi

• Ortak/yerel kapsamı ve kaynak yönünden bağımsızlığı sabitle.
• Kabul edilmiş pasajlardan kesin alt karşılıkları çıkar ve kapsam raporunu üret.
• Kalıcı atıf kapsamları ve düzenleme geçmişi için ek DB katmanını kur.
• Önizleme/uygulama araçlarını ve tekrar çağrı güvenliğini doğrula.
• Ortak/yerel atıf görünürlüğünü okuma API’sine ve arayüze bağla.
• Bir küçük eserin bağımsız katalog sunumunu web ve mobilde doğrula.
• Hedefli test sonuçlarını ve kalan sınırları bu belgeye kaydet.

Kabul Senaryosu

Birinci Söz ve On Dördüncü Lem’a içindeki ortak İkinci Makam örneğinde:

1. Ortak parçaya tek atıf yazıldığında karşılığında görünmeli.
2. Yalnız yerel ekteki atıf diğer yerleşime taşmamalı.
3. Yeni doğrulanmış yerleşim eklendiğinde mevcut uygun atıflar görünmeli.
4. Yanlış üyelik kaldırıldığında yalnız oradaki yansıtılmış görünürlük kalkmalı.
5. Sınır düzeltmesinde eski ID, kaynak metin ve atıf geçmişi korunmalı.
6. Bağımsız kitap sunumunda eski chapter adresi ve exact metni değişmemeli.

Tam corpus yeniden üretimi bu iş paketinin gereği değildir. Kaynak yazma yetkisi vermeden ek katmanları test etmek, değişen aralıkların bağlarını ve örnek chapter metinlerini doğrulamak esastır. Yeni kaynak importu yapılırsa onun kaynak sadakati ayrıca kendi import sözleşmesine göre doğrulanır.

İlk Kesin Karşılık Çıktısı

Yerel DB’deki kabul edilmiş tr-passage-1 envanteri salt okunur olarak incelendi:

• 142 aile ve 309 yerleşimde 31.369 kaynak cümle aralığı.
• 12.638 ortak alt kapsam ve 28.502 yerel karşılık.
• Otomatik kesin karşılık verilmeyen 2.867 aralık; bunların 534’ünde tekrarlanan ifade veya sıralama bakımından belirsizlik tespit edildi.
• 18 ailenin bütün aralıkları bu kesin eşleştirme politikasıyla kapsandı.

Bu sayımlar aile-yerleşim içindeki aralıkları sayar; külliyattaki tekil cümle sayısı değildir. Açık aralık sayısı hata oranı veya anlamsal farklılık oranı değildir. Yerel ekler, yazım farkları ve otomatik karar verilmeyen karşılıklar da bu gruptadır. Ortak aile kabulü bu raporla geri alınmaz.

node scripts/passages/compile-correspondences.mjs
# Aynı kaynak okumasını yinelemeden geliştirme:
node scripts/passages/compile-correspondences.mjs \
  --source reports/passage-references/source.json

Araç varsayılan olarak reports/passage-references/ altında kaynak, tam aday çıktısı ve özet üretir; hiçbir DB kaydı yazmaz. Derleyiciyi yeniden çalıştırmak mevcut kapsamları silmez veya ID’lerini değiştirmez. İlk benimseme hazırlığı yalnız yönetim sürümü 0 üzerinde çalışır; daha sonraki değişiklikler açık düzenleme işlemleridir.

Yerel Kurulum ve Bakım

İlk kurulumda iki ek migration yerel Supabase’e uygulandı. Başlangıç kabulü 142 bütün kapsamı ve 309 bütün karşılığını korur. Kesin alt karşılıkların benimsenmesi 680 küçük transaction ile tamamlandı; bu ilk aşamada yönetim sürümü 680 oldu. Alt kapsamlarla birlikte toplam 12.780 kapsam ve 28.811 bağ vardır. Yeni yönetim tabloları, indeksleri ve işlem geçmişi yaklaşık 35 MB yer tutar. Ana corpus ve eski pasaj yayını yeniden üretilmedi. Kaynak sahibi rolüne yalnız okuma izni verildi; çekirdek token tablolarına yazma yetkisi verilmedi.

Yeni bir yerel kurulumda, kabul edilmiş tr-passage-1 kurulduktan sonra:

node scripts/passages/install-management.mjs
node scripts/passages/manage.mjs --mode init --actor maintainer --reason 'Accepted passage map'
node scripts/passages/manage.mjs --mode snapshot --output reports/passage-references/management-baseline.json
node scripts/passages/compile-correspondences.mjs
node scripts/passages/prepare-adoption.mjs --snapshot reports/passage-references/management-baseline.json --actor maintainer --reason 'Exact shared subparts'
node scripts/passages/adopt-correspondences.mjs

Başlangıç benimsemesi mevcut kapsamları değiştiren bakım komutu değildir. Kesintide aynı plan dosyalarıyla devam edilir; tamamlanmış işlem anahtarları ikinci kez yazılmaz. Elle düzenleme başladıktan sonra başlangıç hazırlığı tekrarlanmaz. Kaynak raporları ve planlar reports/ altında yerel çıktıdır; yayımlanmış corpus artifact’ının parçası oldukları varsayılmaz.

Sonraki tekil düzeltmenin yolu:

node scripts/passages/manage.mjs --mode snapshot --output reports/passage-state.json
node scripts/passages/manage.mjs --mode preview --plan reports/change.json --output reports/change-preview.json
node scripts/passages/manage.mjs --mode apply --plan reports/change.json --preview reports/change-preview.json

change.json alanları: expectedRevision, idempotencyKey, actor, reason, ops. Yeni nesnelere bir kez UUID atanır ve planla birlikte saklanır. Mevcut nesnelerin kimliği snapshot’tan alınır; metinden yeniden türetilmez. Önizlemedeki changed_ids, added_endpoints, removed_endpoints ve etkilenen atıf/konum listeleri incelenir. Plan, kişi, gerekçe veya DB değişirse önizleme yenilenir. Yazma için ikinci bir onay sistemi veya corpus rebuild gerekli değildir.

Düzenleme	Açık işlemler
Yeni yerleşim	add_selection, add_placement, attach_membership, gerekli add_binding kayıtları
Yanlış üyeliği çıkarma	detach_membership; ortak görünürlük kalkar, yerel atıf korunur
Aile değiştirme	change_membership; yeni ailenin karşılıkları ayrıca eklenir
Sınırı düzeltme	Yeni seçim ve replace_placement; yeni üyelik ve karşılıklar açıkça tanımlanır
Ortak alt kapsam	create_scope, her doğrulanmış yerleşim için add_binding
Tek atıf	create_reference; iki uç identity, scope, placement, selection veya chapter
Bağı/atfı kaldırma	retire_binding, retire_scope, retire_reference; geçmiş silinmez

Üyelik tek başına yeni bir alt karşılığı ispatlamaz. Yeni bütün karşılığı da açık add_binding ister. exact kanıtı özgün metin eşitliğiyle kontrol edilir; reviewed_variant inceleme gerekçesi ister. accepted_family yalnız bütün kapsam içindir; değişik alt cümleleri otomatik eşitleme izni değildir.

Sınırı değişen yerleşimin eski kimliği eski sınırı ifade etmeye devam eder. Yeni sınır halef kimliği alır; eski yerel atıflar kendiliğinden taşınmaz. Aile bölme/birleştirme de yeni kimlik ve açık üyelik işlemleriyle ifade edilir; atıf yeniden sınıflaması ayrıca bir editoryal karardır.

Uzak Yönetim Kurulumu

4 Ekim’de uzak Supabase’e yönetim, okuma ve katalog migration’ları uygulandı; yerel 709 verisi 12 tablo ve 710 geçmiş kaydıyla taşındı. Kaynak corpus, ilk tr-passage-1 ve özgün kimlikler yeniden üretilmedi. R2 paketi public okuma projeksiyonudur; bu özel yönetim kopyasının veya DB yedeğinin yerine geçmez. Uygulama, yedekler, yaşanan kesinti ve doğrulama kaydı data/curated/passages/remote-management-709.md dosyasındadır.

scripts/passages/transfer-management.mjs yalnız aynı değişmez başlangıcı olan boş yönetim hedefini kurar; init/benimseme yolunun ardından çalıştırılmaz. COPY ile bağımlılık sırasını korur, FK/trigger kapatmaz, commit öncesinde bütün yönetim satırlarını karşılaştırır. Aynı teslim yazısız sonuç verir; dolu ve farklı hedef reddedilir. Remote aktarım açık teslim özeti ve --allow-remote ister; özel kopyalar yayımlanmaz.

Sonraki değişiklikler yukarıdaki snapshot/preview/apply yoluyla, hedefe özgü güncel sürüm ve önizlemeyle yapılır. Veriyi silip tekrar aktarma veya yerel/uzak geçmişlerden birini diğerinin üstüne yazma bakım yöntemi değildir. Okuyucuya yansıması ayrıca R2 okuma yayını gerektirir. Public rollere yönetim tablolarını doğrudan yazma yetkisi verilmez.

İncelenmiş Nur’un İlk Kapısı Eklemeleri

29 Eylül’de, data/curated/passages/nurun-ilk-kapisi-v1.json kararı mevcut yönetim yoluyla yerelde uygulandı: sürüm 681, 10 yeni aile ve 21 yeni yerleşim. Bir mevcut aileye yeni karşılık eklendi; eski kimlik ve sınırlar değişmedi. Nur’un İlk Kapısı’ndaki yerleşim sayısı 2’den 13’e çıktı. Karşılıkların hepsi seçilmiş pasaj bütünü için reviewed_variant kanıtı taşır; cümle farklılıkları eşitlenmedi, yeni alt kapsam veya gerçek atıf eklenmedi. Kaynak yönü ve derleme sınıflandırması bu karardan bağımsızdır.

Sınırlar, farklılık gerekçeleri, uygulama komutları ve kontroller data/curated/passages/README.md dosyasında açıklanır. Hazırlık aracı scripts/passages/prepare-reviewed-change.mjs mevcut aile kapsamını, kaynak sınırlarını ve sürümü kontrol eder; yalnız artımlı ekleme üretir. Canlı okuma yayını ayrı yayımlanır; yereldeki bu kabul production pinini değiştirmez.

Okuma ve Sınırlar

Güncel atıf API’si bağımsız revision taşır. tr-passage-1 haritası geçmişte kabul edilmiş sabit yayındır; güncel üyelik değişikliği bu yayını sessizce değiştirmez. Okuyucuda bu iki bölüm ayrı adlandırılır. Public çıktı yalnız okuma alanlarını içerir; işlem yapan kişi, özel inceleme notları ve bütün işlem günlüğü public API’ye verilmez.

İlk teslimat yereldi. Sonraki okuma yayını, yönetim verisinin public projeksiyonlarını bağımsız R2 paketinden sunar; remote DB’ye yazma servisi eklenmez. Güncel pasaj dizini ve yayın akışı sonradan eklenen yerleşimleri, sınır düzeltmelerini ve üyelik kaldırmayı da web/mobil okuyucuya taşır. Gerçek editoryal atıf eklenmedi; örnek atıflar geri alınan DB ve arayüz testlerinde kullanıldı. Genel atıf sistemi ayrı fazdır.

Eser kataloğu mevcut Gençlik Rehberi’ni bağımsız sunar; henüz reading_work türünde bir atıf ucu yoktur. Mevcut bölüm/yerleşim atıfları aynı kaynak kimliğiyle çalışır. Yeni kaynak baskı importu ve başka core sürümüne yönetim tabanını taşıma bu başlangıç kurulumunun kapsamı değildir.

Doğrulama

• Kaynak/derleyici/yönetim araçlarında 58 test geçti; önbellekli gerçek kaynak testi isteğe bağlıdır, gerçek kaynak ayrıca derlenip DB’ye uygulandı.
• Başlangıç DB fixture’ı boş yönetim alanında çalışır; kurulu alanı silerek yeniden test etmek için kullanılmaz.
• node scripts/passages/test-management-db.mjs --reader dolu yerel DB’de çalışır; ortak/yerel görünürlük, tek atıf kimliği, emekliye ayrılan karşı uç, anonim okuma/yazma sınırı geri alınan transaction içinde doğrulanır.
• Web pasaj/atıf panelinin 19 tarayıcı testi geçti: masaüstü, dar RTL görünüm, hata/yeniden deneme ve kaynak DOM’unun birebir korunması dahil.
• Mobil tarayıcı kontrolü fiziksel iOS/Android cihaz doğrulaması değildir.
• Mobil atıf görünümü için 8 birim ve 3 tarayıcı testi; eser sunumu için web/mobil toplam 5 tarayıcı testi geçti. Yeni arayüz mesajları 19 sözlükte mevcuttur.
• API sözleşmesinde 97, API çalışma katmanında 99, reader-core’da 68, web’de 102 test geçti. İlgili tip kontrolleri ve dokümantasyonun 50 sayfalık içerik kontrolü geçti. Yeni API işlemleri önceki işlem sürümlerini değiştirmedi.
• Gerçek yerel API ve web kontrolünde Birinci Söz 2 bütün/200 alt kapsam, On Dördüncü Lem’a 1 bütün/138 alt kapsam döndürdü. İki okuma yaklaşık 0,2–0,3 saniyede tamamlandı; bu bir yük testi değildir.
• Masaüstü ve 390px ekranda canlı yerel panel kontrol edildi; kaynak DOM’u aynı kaldı ve yatay taşma olmadı. Gençlik Rehberi eser adresi doğrulandı.