feat(api): turkcealtyazi gerçek modu desteği ekle

TurkceAltyazi sağlayıcısı için gerçek HTTP istekleri ve HTML
parsing özelliği eklendi. Özellik bayrak ile açılıp kapatılabilir
ve hata durumunda mock moduna dönüş yapabilir.

Yapılan değişiklikler:
- Yeni ortam değişkenleri eklendi (ENABLE_TURKCEALTYAZI_REAL, vb.)
- axios ve cheerio bağımlılıkları eklendi
- Gerçek indirme ve arama işlemleri için turkcealtyaziReal.ts modülü eklendi
- Dokümantasyon güncellendi
- Detaylı trace logging desteği eklendi

README.md

@@ -20,13 +20,29 @@ Docker tabanli altyazi otomasyon sistemi.
 
 ## Mock Provider Notu
 
-Gercek scraping/API cagrilari bu MVP'de yoktur.
+Gercek scraping/API cagrilari varsayilan olarak kapali gelir.
 
 - `TurkceAltyaziProvider`: mock + TODO
 - `OpenSubtitlesProvider`: mock + TODO
 
 Deterministik candidate uretimi vardir (aynı input = ayni aday davranisi).
 
+## TurkceAltyazi Gercek Modu (v2)
+
+Gercek entegrasyon feature flag ile acilabilir:
+
+```env
+ENABLE_TURKCEALTYAZI_REAL=true
+TURKCEALTYAZI_ALLOW_MOCK_FALLBACK=true
+TURKCEALTYAZI_BASE_URL=https://turkcealtyazi.org
+TURKCEALTYAZI_TIMEOUT_MS=12000
+TURKCEALTYAZI_MIN_DELAY_MS=300
+```
+
+- `ENABLE_TURKCEALTYAZI_REAL=true`: `TurkceAltyaziProvider` gercek HTTP+HTML parse dener.
+- `TURKCEALTYAZI_ALLOW_MOCK_FALLBACK=true`: real akista hata olursa mock adaptere doner.
+- `false` yaparsan real hata durumunda job tarafina hata/not found olarak yansir.
+
 ## Gelistirme (Dev)
 
 1. Ortam dosyasi: