feat: altyazı otomasyon sistemi MVP'sini ekle

Docker tabanlı mikro servis mimarisi ile altyazı otomasyon sistemi altyapısı kuruldu.

- Core (Node.js): Chokidar dosya izleyici, BullMQ iş kuyrukları, ffprobe medya analizi, MongoDB entegrasyonu ve dosya yazma işlemleri.
- API (Fastify): Mock sağlayıcılar, arşiv güvenliği (zip-slip), altyazı doğrulama, puanlama ve aday seçim motoru.
- UI (React/Vite): İş yönetimi paneli, canlı SSE log akışı, manuel inceleme arayüzü ve sistem ayarları.
- Altyapı: Docker Compose (dev/prod), Redis, Mongo ve çevresel değişken yapılandırmaları.

README.md

@@ -0,0 +1,160 @@
+# subwatcher
+
+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
+- `ui`: React/Vite panel (dashboard, jobs, detail live logs, review, settings, watched paths)
+
+## Mimari
+
+- Mongo koleksiyonlari: `watched_paths`, `settings`, `media_files`, `jobs`, `job_logs`
+- Redis/BullMQ kuyruklari:
+  - `fileEvents`
+  - `mediaAnalysis`
+  - `subtitleFetch`
+  - `finalizeWrite`
+- Core -> API servis cagrisi (docker network): `http://api:3002`
+- UI -> Core API: `http://localhost:3001/api` (CORS acik)
+- Temp alan: `/temp/{jobToken}`
+
+## Mock Provider Notu
+
+Gercek scraping/API cagrilari bu MVP'de yoktur.
+
+- `TurkceAltyaziProvider`: mock + TODO
+- `OpenSubtitlesProvider`: mock + TODO
+
+Deterministik candidate uretimi vardir (aynı input = ayni aday davranisi).
+
+## Gelistirme (Dev)
+
+1. Ortam dosyasi:
+
+```bash
+cp .env.example .env
+```
+
+2. Servisleri kaldir:
+
+```bash
+docker compose -f compose.dev.yml up --build
+```
+
+3. Portlar:
+
+- UI: `http://localhost:5173`
+- Core: `http://localhost:3001`
+- API: `http://localhost:3002`
+- Mongo: `localhost:27017`
+- Redis: `localhost:6379`
+
+4. Media dosyasi yerlestirme:
+
+- TV: `./_media/tv`
+- Movie: `./_media/movie`
+
+Gercek `.mkv` dosyasi ekleyince watcher pipeline'i tetikler.
+
+5. Debug enqueue (dev-only):
+
+```bash
+curl -X POST http://localhost:3001/api/debug/enqueue \
+  -H 'content-type: application/json' \
+  -d '{"path":"/media/movie/example.mkv","kind":"movie"}'
+```
+
+## Production
+
+```bash
+docker compose -f compose.yml up --build -d
+```
+
+Portlar:
+
+- UI: `http://localhost:3000`
+- Core: `http://localhost:3001`
+- API: `http://localhost:3002`
+
+## UI Ozellikleri
+
+- Dashboard: son 24h ozet + son isler
+- Jobs: filtreleme + job detayi
+- Job Detail: metadata, mediaInfo, sonuc dosyalari, canli SSE log paneli
+- Review List: `NEEDS_REVIEW` isler
+- Manual override: metadata ile ara + candidate sec + finalize write
+- Settings: language/overwrite/stability/security ayarlari
+- Watched Paths: ekle/sil/enable/disable
+
+## API Endpointleri
+
+### Core
+
+- `GET /api/health`
+- `GET /api/settings`
+- `POST /api/settings`
+- `GET /api/watched-paths`
+- `POST /api/watched-paths`
+- `GET /api/jobs`
+- `GET /api/jobs/:id`
+- `GET /api/jobs/:id/logs`
+- `GET /api/jobs/:id/stream` (SSE)
+- `GET /api/review`
+- `POST /api/review/:jobId/search`
+- `POST /api/review/:jobId/choose`
+- `POST /api/debug/enqueue` (dev)
+
+### Subtitle API
+
+- `GET /v1/health`
+- `POST /v1/subtitles/search`
+- `POST /v1/subtitles/choose`
+- `POST /v1/subtitles/cleanup`
+
+## Guvenlik ve Dogrulama
+
+- Archive extraction: `7z`
+- Zip slip kontrolu: realpath root disina cikis reddi
+- Limit kontrolleri:
+  - max file count
+  - max total size
+  - max single file size
+- SRT/ASS extension'a gore degil, icerige gore validate edilir
+- Gecersiz altyazilar aninda silinir (`INVALID_SUBTITLE_DELETED`)
+
+## Encoding
+
+Core finalize adiminda:
+
+- BOM kontrol
+- UTF-8 / windows-1254 / latin1 fallback
+- LF newline normalizasyonu
+- hedef adlandirma: `{base}.{lang}.{ext}`
+- overwrite false ise `.2`, `.3`...
+
+## Testler
+
+Core:
+
+```bash
+cd services/core && npm test
+```
+
+API:
+
+```bash
+cd services/api && npm test
+```
+
+Kapsam:
+
+- filename parser
+- SRT/ASS validator
+- scoring + ambiguous karari
+- zip slip helper
+
+## Gelecek (v2)
+
+- Gercek TurkceAltyazi scraping
+- Gercek OpenSubtitles API entegrasyonu
+- ClamAV tarama (feature flag hazir)