# 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`