Quick start

Node.js, Corepack ve Make kurulu bir makinede bağımlılıkları kurun:

make bootstrap

Sample akışı

Exact Birinci Söz sample’ı veritabanı olmadan çalışır:

make sample-dev

Sample API, committed sealed streamleri okur; cümle, paragraf ve chapter metnini token occurrence sırası ile yeniden kurar ve SHA-256 değerlerini kontrol eder. Reader aynı public RPC contract’ını bu yerel API üzerinden kullanır.

Otomatik smoke:

make quick-start-check

Kontrol şu garantileri doğrular:

• 81 paragraf, 221 cümle ve 3.024 token occurrence okunur;
• chapter exact reconstruction hash’i sample seal ile aynıdır;
• Next.js reader chapter’ı render eder;
• yönetilen API ve web süreçleri test sonunda kapanır.

Bu akış Docker, hosted Supabase, .env veya full corpus artifact’ı gerektirmez. Osmanlıca ve diğer annotation boş durumları sample API’de açıkça unavailable olarak döner.

Ürün reader akışı

Full local reader, local Supabase ve reader metadata ile Content API üzerinden çalışır. Kök adres /reader’a yönlenir:

cp .env.example .env
make db-install-data
make reader-dev

make db-install-data local stack’i başlatır ve core, target, annotation, alignment, structure, passage ve reader metadata katmanlarını mevcutsa yeniden yazmadan kurar. Web http://127.0.0.1:3000/reader, local Content API http://127.0.0.1:8788/v1 adresindedir. API ve web’i ayrı başlatmak için make content-api-dev ve make web-dev kullanılabilir. Bu akış için web’de NEXT_PUBLIC_MUNDERECAT_RUNTIME=local ile NEXT_PUBLIC_MUNDERECAT_CONTENT_API_URL=http://127.0.0.1:8788/v1, mobilde ise eşdeğer EXPO_PUBLIC_* değişkenleri gerekir.