wisecolt
0ba0cb1071
- `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.
66 lines
1.4 KiB
Markdown
66 lines
1.4 KiB
Markdown
# 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`
|