first commit

doc/ops.md

@@ -0,0 +1,291 @@
+# Netflix Scraper API - Operasyon Dokümantasyonu
+
+## Hızlı Başlangıç
+
+### Gereksinimler
+
+- Docker & Docker Compose
+- Node.js 20+ (local development için)
+
+### Tek Komut ile Başlatma (Development)
+
+```bash
+# .env dosyasını oluştur
+cp .env.example .env
+
+# .env dosyasını düzenle
+nano .env
+
+# Başlat
+docker compose -f docker-compose.dev.yml up --build
+```
+
+**Hepsi bu kadar!** Uygulama şu adreste çalışacak: `http://localhost:3000`
+
+---
+
+## Ortamlar
+
+### Development
+
+```bash
+docker compose -f docker-compose.dev.yml up --build
+```
+
+Özellikler:
+- Hot reload aktif
+- Tüm loglar görünür
+- Debug modu
+
+### Production
+
+```bash
+docker compose up --build -d
+```
+
+Özellikler:
+- Multi-stage build
+- Non-root user
+- Minimal image
+- Production optimizations
+
+---
+
+## Environment Değişkenleri
+
+### .env Dosyası
+
+```env
+# === Server ===
+PORT=3000
+NODE_ENV=development
+
+# === PostgreSQL ===
+POSTGRES_HOST=postgres
+POSTGRES_PORT=5432
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=your-secure-password
+POSTGRES_DB=netflix_scraper
+
+# === Redis ===
+REDIS_HOST=redis
+REDIS_PORT=6379
+REDIS_TTL_SECONDS=604800
+
+# === Rate Limiting ===
+RATE_LIMIT_WINDOW_MS=60000
+RATE_LIMIT_MAX_REQUESTS=30
+
+# === API Keys ===
+API_KEY_WEB=web-key-change-me
+API_KEY_MOBILE=mobile-key-change-me
+API_KEY_ADMIN=admin-key-secret
+```
+
+### Değişken Açıklamaları
+
+| Değişken | Açıklama | Varsayılan |
+|----------|----------|------------|
+| `PORT` | Sunucu portu | 3000 |
+| `NODE_ENV` | Ortam (development/production) | development |
+| `REDIS_TTL_SECONDS` | Cache süresi (saniye) | 604800 (7 gün) |
+| `RATE_LIMIT_WINDOW_MS` | Rate limit penceresi (ms) | 60000 (1 dk) |
+| `RATE_LIMIT_MAX_REQUESTS` | Max istek sayısı | 30 |
+
+---
+
+## Migration
+
+Migration'lar otomatik olarak container başlatılırken çalışır. Manuel çalıştırmak için:
+
+```bash
+# Container içinde
+docker compose exec app npx prisma migrate deploy
+
+# Local
+npx prisma migrate deploy
+```
+
+### Yeni Migration Oluşturma
+
+```bash
+npx prisma migrate dev --name description_of_change
+```
+
+---
+
+## Loglama
+
+Tüm loglar JSON formatında structured logging ile yazılır.
+
+### Log Seviyeleri
+
+| Seviye | Açıklama |
+|--------|----------|
+| `debug` | Detaylı debug bilgisi |
+| `info` | Genel bilgi |
+| `warn` | Uyarı |
+| `error` | Hata |
+
+### Log Formatı
+
+```json
+{
+  "timestamp": "2025-02-27T10:00:00.000Z",
+  "level": "info",
+  "message": "Server started",
+  "service": "netflix-scraper-api",
+  "port": 3000
+}
+```
+
+### Log Seviyesi Ayarlama
+
+```env
+LOG_LEVEL=debug
+```
+
+---
+
+## Health Check
+
+### Endpoints
+
+- `GET /health` - Basit sağlık kontrolü
+- `GET /ready` - Bağımlılık kontrolü (DB + Redis)
+
+### Docker Health Check
+
+Container'lar otomatik health check ile izlenir:
+
+```yaml
+healthcheck:
+  test: ["CMD", "wget", "--spider", "http://localhost:3000/health"]
+  interval: 30s
+  timeout: 10s
+  retries: 3
+```
+
+---
+
+## Troubleshooting
+
+### Database Bağlantı Hatası
+
+```
+Error: Can't reach database server
+```
+
+**Çözüm:**
+1. PostgreSQL container'ın çalıştığını kontrol et
+2. `POSTGRES_HOST` değerini kontrol et (docker'da `postgres` olmalı)
+3. Health check'i bekle: `docker compose logs postgres`
+
+### Redis Bağlantı Hatası
+
+```
+Error: Redis connection failed
+```
+
+**Çözüm:**
+1. Redis container'ın çalıştığını kontrol et
+2. `REDIS_HOST` değerini kontrol et
+
+### Migration Hatası
+
+```
+Error: P3005: The database schema is not empty
+```
+
+**Çözüm:**
+```bash
+# Veritabanını sıfırla
+docker compose down -v
+docker compose up --build
+```
+
+### Port Kullanımda Hatası
+
+```
+Error: port is already allocated
+```
+
+**Çözüm:**
+```bash
+# Hangi process kullanıyor
+lsof -i :3000
+
+# Process'i durdur
+kill -9 <PID>
+```
+
+---
+
+## Yararlı Komutlar
+
+### Container Yönetimi
+
+```bash
+# Container'ları durdur
+docker compose down
+
+# Container'ları sil (volumes dahil)
+docker compose down -v
+
+# Logları görüntüle
+docker compose logs -f app
+
+# Container içine gir
+docker compose exec app sh
+```
+
+### Database İşlemleri
+
+```bash
+# Prisma studio aç
+docker compose exec app npx prisma studio
+
+# Database schema görüntüle
+docker compose exec app npx prisma db pull
+
+# Seed çalıştır
+docker compose exec app npm run prisma:seed
+```
+
+### Redis İşlemleri
+
+```bash
+# Redis CLI
+docker compose exec redis redis-cli
+
+# Tüm cache'i temizle
+docker compose exec redis redis-cli FLUSHALL
+```
+
+---
+
+## Backup & Restore
+
+### PostgreSQL Backup
+
+```bash
+docker compose exec postgres pg_dump -U postgres netflix_scraper > backup.sql
+```
+
+### PostgreSQL Restore
+
+```bash
+cat backup.sql | docker compose exec -T postgres psql -U postgres netflix_scraper
+```
+
+---
+
+## Monitoring (Opsiyonel)
+
+### Metrics Endpoint (Yakında)
+
+```
+GET /metrics
+```
+
+Prometheus uyumlu metrics döndürür.