- `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.
1.4 KiB
1.4 KiB
Operations Runbook
Dev calistirma
docker compose -f compose.dev.yml up --build
Not:
- Dev compose servisleri startup'ta otomatik
npm installyapar. - Bu sayede yeni dependency eklendiginde
node_modulesvolume drift sorunu azalir.
Ortam guvenligi
.envdosyasinda gizli anahtarlar bulunabilir.- Bu dosyayi git'e commit etme.
- Baska cihaza geciste guvenli sekilde tasiyip sadece lokalde kullan.
Health check
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)
curl -X POST http://localhost:3001/api/debug/enqueue \
-H 'content-type: application/json' \
-d '{"path":"/media/movie/test.mkv","kind":"movie"}'
Log izleme
docker compose -f compose.dev.yml logs -f api core ui
UI:
http://localhost:5173- Job Detail -> Canli Loglar paneli
SIk sorunlar
ERR_MODULE_NOT_FOUND(yeni paket)
- Neden: node_modules volume eski.
- Cozum:
docker compose -f compose.dev.yml up -d --build api core ui
- Cok sayida
PENDINGjob
- Neden: watcher coklu event (add/change) uretebilir.
- Cozum (kisa vade): dosya transfer tamamlandiktan sonra tek tetikleme.
- Orta vade: core tarafina de-dup logic eklenmeli.
- ffprobe hata veriyor
- Pipeline fallback metadata ile devam eder.
- Log adimi:
FFPROBE_DONE - ffprobe failed, fallback metadata used