feat(api): turkcealtyazi gerçek modunu stabil hale getir ve mock altyapısını kaldır

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
This commit is contained in:
2026-02-16 10:50:59 +03:00
parent 0ba0cb1071
commit d38fc3b390
16 changed files with 374 additions and 298 deletions

View File

@@ -3,7 +3,7 @@
Docker tabanli altyazi otomasyon sistemi.
- `core`: watcher + ffprobe + BullMQ + Mongo job/log API + review akisi
- `api`: mock provider subtitle engine (TurkceAltyazi/OpenSubtitles stub) + archive extraction + security + scoring
- `api`: gercek provider subtitle engine + archive extraction + security + scoring
- `ui`: React/Vite panel (dashboard, jobs, detail live logs, review, settings, watched paths)
## Mimari
@@ -18,30 +18,18 @@ Docker tabanli altyazi otomasyon sistemi.
- UI -> Core API: `http://localhost:3001/api` (CORS acik)
- Temp alan: `/temp/{jobToken}`
## Mock Provider Notu
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)
@@ -171,6 +159,5 @@ Kapsam:
## Gelecek (v2)
- Gercek TurkceAltyazi scraping
- Gercek OpenSubtitles API entegrasyonu
- ClamAV tarama (feature flag hazir)