Sample quick start

Bu yol, committed exact Birinci Söz sample’ını normal web reader ve güncel public API response sözleşmesi üzerinden açar. Docker, PostgreSQL, .env, private artifact veya legacy repository gerekmez.

Gereksinimler

• Git, POSIX sh ve GNU Make 3.81 veya sonrası;
• Node.js >=22.14.0 <25 ve Corepack;
• Python >=3.13 <3.14 ve uv >=0.10.7 <0.11;
• repository doğrulama scriptleri için Ruby.

Node ve Python bağımlılıklarını kilitli sürümleriyle kurun:

make bootstrap

Reader’ı açın

make sample-dev

Komut sample API’yi yalnız 127.0.0.1:4315 üzerinde, Next.js reader’ı yalnız 127.0.0.1:3000 üzerinde başlatır ve exact chapter URL’sini terminale yazar:

http://127.0.0.1:3000/chapters/71ce1f1c-dcdb-5846-8476-c61927c4b047

Sayfada Birinci Sözün 81 paragraf, 221 cümle ve 3.024 token occurrence ile yeniden kurulmuş Latin metni görünür. İki süreci birlikte durdurmak için komutun çalıştığı terminalde Ctrl+C kullanın.

Otomatik doğrulama

Kurulumdan sonra aynı akışı ayrılmış portlarda ve süre bütçesiyle sınayın:

make quick-start-check

Bu hedef:

1. sample API health bilgisini ve sabit chapter kimliğini okur;
2. API cevabını web reader’ın production parser’ından geçirir;
3. punctuation ve whitespace dahil exact metni production reconstructor ile kurar;
4. sonucu committed chapter root’u dbd2b23227ebc055f56893fe22caf0a94973ec9b92623c513e6108d2ad650895 ile karşılaştırır;
5. gerçek Next.js chapter route’unun sample metniyle cevap verdiğini doğrular;
6. başlattığı iki süreci sonuç ne olursa olsun kapatır.

Kabul bütçesi, gereksinimler ve make bootstrap tamamlandıktan sonraki smoke akışı için 600 saniyedir. 26 Ağustos 2026 tarihli kabul koşusunda bu akış 2,525 saniye sürdü. Ağ indirme süresi makineye göre değiştiği için dependency kurulumu bu ölçüme dahil değildir; temiz makine ve full reproducibility F10-007’nin ayrı kapısıdır.

Sample sınırı

Bu akış sentetik metin üretmez. Core projection şu committed sealed workspace’ten okunur:

data/fixtures/sealer/birinci-soz/logical/core

Sample yalnız exact Latin core publication’ını temsil eder. Osmanlıca, lügat, heading, haşiye, tekrar ve çok dilli companion package’lar bu sample release’in parçası değildir; ilgili API çağrıları bilinçli olarak sample_domain_not_published durumuyla unavailable döner. Bu durum full data release’in eksik veya başarısız olduğu iddiası değildir.

Normal boş uygulama kabuğunu sample API olmadan çalıştırmak için make dev, yerel Supabase yaşam döngüsü için README’deki DB komutları kullanılır. Full corpus build ve legacy kaynaklar olağan quick-start kapsamına girmez.