Web okuyucu performans bütçesi

Bütçe sınırı

config/web/reader-performance-budget.json, chapter reader’ın API işlemlerini nasıl birleştireceğini tanımlar. Her işlemin DB statement, yanıt, p95 ve timeout limiti bu dosyada tekrarlanmaz; bunların tek otoritesi config/governance/api-contract.yml içindeki budget_profiles bölümüdür.

İlk Türkçe chapter görünümü iki bağımlılık dalgasından oluşur:

1. Release context’i kuran chapter_core_get çağrısı.
2. Core sonucu geldikten sonra paralel başlayan Osmanlıca, hover, headings, not ve tekrar çağrıları.

Toplam sınır altı RPC’dir. Bu değer büyürse N+1 veya istemeden eklenmiş eager yük riski kabul edilir. Latin/Osmanlı geçişi ile önceden yüklenmiş terkip, not ve tekrar panellerinin açılması ek istek üretmez. “Geçtiği yerler” ve tekrar konumları kullanıcı isteğiyle yalnız ilk sayfayı yükler.

İngilizce sayfalama

İngilizce reader 100 kayıtlık sayfaları sıralı olarak alır; eşzamanlı bir istek döngüsü açmaz. Kabul edilmiş 171 chapter kataloğunda reader kayıt sayısı, accepted_groups + unresolved_candidates + target_unresolved_units toplamıdır. Mevcut dağılım şöyledir:

Ölçü	Kayıt	100’lük sayfa
p95	750	8
En yüksek	3.174	32

İlk sayfa tamamlandığında ilk okunabilir İngilizce birimler gösterilir; kalan sayfalar aynı reader içinde sıralı yüklenir. İki sayfalı gecikmeli fixture bu davranışı browser’da doğrular. 8/32 dağılımı ise kabul edilmiş catalog üzerinden hesaplanır; bunu kanıtlamak için çeviri pipeline’ı yeniden çalıştırılmaz.

Loopback benchmark

Playwright paketi mevcut sentetik fixture API’sini kullanarak şunları ölçer:

• kısa ve uzun chapter için RPC sayısı ve JSON response body byte toplamı,
• kısa fixture için beş reader-ready örneğinin en yüksek süresi,
• preloaded etkileşimlerde sıfır ek istek,
• kullanıcı tetiklemeli listelerde birer ilk sayfa isteği.

Bu ölçüm yalnız 127.0.0.1 üzerindeki production build ile fixture arasındaki regresyon kapısıdır. İnternet latency SLA’sı, Core Web Vitals, Lighthouse veya gerçek DB p95 sertifikası değildir. Fixture sayaç endpoint’i yalnız test sunucusunda bulunur, bearer kontrollüdür, CORS başlığı sunmaz ve production uygulama koduna dahil edilmez.

Çalıştırma

Statik bütçe ve katalog tutarlılığı:

make reader-performance-budget-check

Runtime istek ve payload senaryoları dahil bütün reader browser paketi:

make web-browser-check

Yeni bir performans kontrolü yalnız belirgin reader riski için eklenmelidir. Web sunumu değişiklikleri full corpus, DB publication, çeviri veya Osmanlıca pipeline replay’i gerektirmez.