docs: mimari ve operasyon dokümantasyonlarını ekle

- `ARCHITECTURE_AND_FLOW.md`: Mimari, servis sorumlulukları, kuyruklar ve iş akışı.
- `HANDOVER_2026-02-16.md`: Tamamlanan kapsam, düzeltmeler ve sonraki adımlar.
- `OPERATIONS_RUNBOOK.md`: Dev/prod çalıştırma, test ve sık karşılaşılan sorunlar.
- `TURKCEALTYAZI_REAL_STATUS.md`: Gerçek provider entegrasyon durumu ve yapılacaklar.
- `README.md`: Dokümantasyon dizini için giriş ve indeks.

doc/OPERATIONS_RUNBOOK.md

@@ -0,0 +1,65 @@
+# Operations Runbook
+
+## Dev calistirma
+
+```bash
+docker compose -f compose.dev.yml up --build
+```
+
+Not:
+- Dev compose servisleri startup'ta otomatik `npm install` yapar.
+- Bu sayede yeni dependency eklendiginde `node_modules` volume drift sorunu azalir.
+
+## Ortam guvenligi
+
+- `.env` dosyasinda gizli anahtarlar bulunabilir.
+- Bu dosyayi git'e commit etme.
+- Baska cihaza geciste guvenli sekilde tasiyip sadece lokalde kullan.
+
+## Health check
+
+```bash
+curl http://localhost:3001/api/health
+curl http://localhost:3002/v1/health
+```
+
+## Test media yerlestirme
+
+- Film: `./_media/movie`
+- Dizi: `./_media/tv`
+
+## Job tetikleme (dev endpoint)
+
+```bash
+curl -X POST http://localhost:3001/api/debug/enqueue \
+  -H 'content-type: application/json' \
+  -d '{"path":"/media/movie/test.mkv","kind":"movie"}'
+```
+
+## Log izleme
+
+```bash
+docker compose -f compose.dev.yml logs -f api core ui
+```
+
+UI:
+- `http://localhost:5173`
+- Job Detail -> Canli Loglar paneli
+
+## SIk sorunlar
+
+1. `ERR_MODULE_NOT_FOUND` (yeni paket)
+- Neden: node_modules volume eski.
+- Cozum:
+  ```bash
+  docker compose -f compose.dev.yml up -d --build api core ui
+  ```
+
+2. Cok sayida `PENDING` job
+- Neden: watcher coklu event (add/change) uretebilir.
+- Cozum (kisa vade): dosya transfer tamamlandiktan sonra tek tetikleme.
+- Orta vade: core tarafina de-dup logic eklenmeli.
+
+3. ffprobe hata veriyor
+- Pipeline fallback metadata ile devam eder.
+- Log adimi: `FFPROBE_DONE - ffprobe failed, fallback metadata used`