# 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`