szbk
d38fc3b390
Mock fallback mantığını ve determinantik mock üretim kodlarını kaldırarak TurkceAltyazi sağlayıcısını tamamen gerçek moda geçirdi. İyileştirilmiş arama, indirme ve çerez yönetimi ile sağlam bir entegrasyon sağlandı. - MockArtifact ve deterministic modüllerini kaldır - TurkceAltyaziProvider'da mock fallback mantığını tamamen kaldır - HTTP çerez yönetimi, retry mantığı ve hata işleme iyileştirmeleri - ENABLE_TA_STEP_LOGS yapılandırması ile adım adım loglama - TURKCEALTYAZI_ALLOW_MOCK_FALLBACK ortam değişkenini kaldır - Dokümantasyonu gerçek mod reflektif olarak güncelle - OpenSubtitles sağlayıcını gerçek entegrasyon tamamlanana kadar pasif yap - Varsayılan kaynak etiketini 'mock' yerine 'unknown' olarak güncelle
79 lines
2.1 KiB
Markdown
79 lines
2.1 KiB
Markdown
# TurkceAltyazi Gercek Entegrasyon Durum Raporu
|
|
|
|
Guncel durum tarihi: **16 Subat 2026**
|
|
|
|
## Hedef
|
|
|
|
TurkceAltyazi kaynagindan gercek aday bulma ve indirme akisini stabil hale getirmek.
|
|
|
|
## Tamamlananlar
|
|
|
|
1. Feature flags tanimli:
|
|
- `ENABLE_TURKCEALTYAZI_REAL`
|
|
- `TURKCEALTYAZI_BASE_URL`
|
|
- `TURKCEALTYAZI_TIMEOUT_MS`
|
|
- `TURKCEALTYAZI_MIN_DELAY_MS`
|
|
|
|
2. 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
|
|
|
|
3. Provider real akisla calisiyor:
|
|
- `services/api/src/providers/TurkceAltyaziProvider.ts`
|
|
- Real aciksa search/download adimlari gercek kaynakta calisir
|
|
|
|
4. Trace log adimlari var:
|
|
- `TA_SEARCH_REQUEST`
|
|
- `TA_SEARCH_PARSED`
|
|
- `TA_DETAIL_FETCHED`
|
|
- `TA_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
|
|
|
|
1. HTML parseri fixture testlerle sabitle
|
|
- Ornek TA arama/detay HTML snapshotlari ile unit test yaz.
|
|
- DOM degisikliklerine karsi fallback selector stratejisi ekle.
|
|
|
|
2. Dayaniklilik katmani
|
|
- 403/429/Cloudflare benzeri durumlari ayri hata kodlariyla logla.
|
|
- Retry/backoff politikasi daha netlestir.
|
|
|
|
3. Download tipi dogrulama
|
|
- Content-Type + dosya signature kontrolu ekle.
|
|
- Yanlis mime/redirect durumlarini net hata ile ele al.
|
|
|
|
4. Yasal/etik uyum notu
|
|
- Robots/ToS uyumunu projede dokumante et.
|
|
|
|
## Devam ederken kontrol listesi
|
|
|
|
1. `.env`:
|
|
```env
|
|
ENABLE_TURKCEALTYAZI_REAL=true
|
|
```
|
|
2. Servisleri yeniden baslat:
|
|
```bash
|
|
docker compose -f compose.dev.yml up -d --build api core
|
|
```
|
|
3. Yeni bir movie job tetikle.
|
|
4. Job logda TA adimlarini dogrula.
|
|
5. Hata varsa sebebi logla ve parseri iyilestir.
|
|
|
|
## Onemli dosyalar
|
|
|
|
- `services/api/src/lib/turkcealtyaziReal.ts`
|
|
- `services/api/src/providers/TurkceAltyaziProvider.ts`
|
|
- `services/api/src/lib/subtitleEngine.ts`
|
|
- `.env`
|
|
- `.env.example`
|