Files
subwatcher/doc/OPERATIONS_RUNBOOK.md
wisecolt 0ba0cb1071 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.
2026-02-16 09:32:41 +03:00

1.4 KiB

Operations Runbook

Dev calistirma

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

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

  1. ERR_MODULE_NOT_FOUND (yeni paket)
  • Neden: node_modules volume eski.
  • Cozum:
    docker compose -f compose.dev.yml up -d --build api core ui
    
  1. 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.
  1. ffprobe hata veriyor
  • Pipeline fallback metadata ile devam eder.
  • Log adimi: FFPROBE_DONE - ffprobe failed, fallback metadata used