wisecolt
0ba0cb1071
- `ARCHITECTURE_AND_FLOW.md`: Mimari, servis sorumlulukları, kuyruklar ve iş akışı. - `HANDOVER_2026-02-16.md`: Tamamlanan kapsam, düzeltmeler ve sonraki adımlar. - `OPERATIONS_RUNBOOK.md`: Dev/prod çalıştırma, test ve sık karşılaşılan sorunlar. - `TURKCEALTYAZI_REAL_STATUS.md`: Gerçek provider entegrasyon durumu ve yapılacaklar. - `README.md`: Dokümantasyon dizini için giriş ve indeks.
2.2 KiB
2.2 KiB
TurkceAltyazi Gercek Entegrasyon Durum Raporu
Guncel durum tarihi: 16 Subat 2026
Hedef
Mock yerine TurkceAltyazi kaynagindan gercek aday bulma ve indirme akisini aktif etmek.
Tamamlananlar
- Feature flags tanimli:
ENABLE_TURKCEALTYAZI_REALTURKCEALTYAZI_ALLOW_MOCK_FALLBACKTURKCEALTYAZI_BASE_URLTURKCEALTYAZI_TIMEOUT_MSTURKCEALTYAZI_MIN_DELAY_MS
- Real helper dosyasi var:
services/api/src/lib/turkcealtyaziReal.ts- Arama URL denemeleri
- HTML parse ile aday cikarimi
- Detail sayfasinda download link cikarimi
- Binary indirme
- Provider real/mok gecisi var:
services/api/src/providers/TurkceAltyaziProvider.ts- Real aciksa once real dener
- Basarisiz olursa fallback policy'e gore mock'a duser
- Trace log adimlari var:
TA_SEARCH_REQUESTTA_SEARCH_PARSEDTA_DETAIL_FETCHEDTA_DOWNLOAD_URL_RESOLVED
Su an nerede kaldik?
- KOD seviyesinde real TA akisi entegre edildi.
- Servisler ayaga kalkiyor.
- Runtime'da real TA davranisinin stabilitesi daha test edilmedi (site response/DOM degiskenligi nedeniyle).
- Yani entegrasyon ilk calisir prototip seviyesinde.
Kalan kritik isler
- HTML parseri fixture testlerle sabitle
- Ornek TA arama/detay HTML snapshotlari ile unit test yaz.
- DOM degisikliklerine karsi fallback selector stratejisi ekle.
- Dayaniklilik katmani
- 403/429/Cloudflare benzeri durumlari ayri hata kodlariyla logla.
- Retry/backoff politikasi daha netlestir.
- Download tipi dogrulama
- Content-Type + dosya signature kontrolu ekle.
- Yanlis mime/redirect durumlarini net hata ile ele al.
- Yasal/etik uyum notu
- Robots/ToS uyumunu projede dokumante et.
Devam ederken kontrol listesi
.env:
ENABLE_TURKCEALTYAZI_REAL=true
TURKCEALTYAZI_ALLOW_MOCK_FALLBACK=true
- Servisleri yeniden baslat:
docker compose -f compose.dev.yml up -d --build api core
- Yeni bir movie job tetikle.
- Job logda TA adimlarini dogrula.
- Mock'a dustuyse sebebi logla ve parseri iyilestir.
Onemli dosyalar
services/api/src/lib/turkcealtyaziReal.tsservices/api/src/providers/TurkceAltyaziProvider.tsservices/api/src/lib/subtitleEngine.ts.env.env.example