feat: watcher akislarini ve wscraper servis entegrasyonunu ekle

README.md

@@ -16,7 +16,7 @@ q-buffer, qBittorrent üzerinde torrentleri kontrollü şekilde döngüye almay
 2) Geliştirme ortamını başlatın:
 
 ```bash
-docker-compose -f docker-compose.dev.yml up --build
+./scripts/bootstrap.sh --dev-mode
 ```
 
 3) Açın:
@@ -24,6 +24,69 @@ docker-compose -f docker-compose.dev.yml up --build
 - Web: http://localhost:5173
 - API/Socket: http://localhost:3001
 
+## Watcher Notu
+
+`Watcher` akışı `wscraper -> scrapling -> Playwright` zincirini kullanır. Playwright DNS ve browser bağımlılıklarını Docker içine taşımak yerine `wscraper-service` host makinede çalışır; `web` ve `server` ise Docker içinde kalır. `server`, host servisle `http://host.docker.internal:8787` üzerinden konuşur.
+
+`bootstrap.sh` şu işleri tek komutta yapar:
+
+- Docker servislerini `up --build` ile kaldırır
+- host `wscraper-service` için Python venv hazırlar
+- eksik Python paketlerini ve Playwright bağımlılıklarını kurar
+- `wscraper-service`i başlatır
+
+`wscraper-service` kurulumu her çalıştırmada sıfırdan yapılmaz. Kurulum daha önce tamamlandıysa script sadece kontrol eder ve eksik yoksa yeniden kurmaz.
+
+Host makinede Python 3.10+ gerekir. Script sırasıyla `python3.12`, `python3.11`, `python3.10`, `python3` ikililerini dener ve uygun ilk sürümü seçer. Gerekirse `.env` içine `WSCRAPER_SERVICE_PYTHON_BIN=python3.12` benzeri açık bir değer verebilirsiniz.
+
+Kullanılabilir bayraklar:
+
+```bash
+./scripts/bootstrap.sh --dev-mode
+./scripts/bootstrap.sh --prod-mode
+./scripts/bootstrap.sh --dev-mode --skip-wscraper-install
+./scripts/bootstrap.sh --dev-mode --restart-wscraper
+```
+
+Docker tarafında normal ağ erişimi hâlâ gereklidir. DNS problemi yaşarsanız Docker Desktop içinde sabit resolver (`8.8.8.8`, `1.1.1.1`) tanımlayın. Docker DNS doğru ayarlanmamışsa:
+
+- `pnpm install`
+- image pull işlemleri
+- container içi paket kurulumları
+
+kurulum sırasında kırılabilir.
+
+Önerilen Docker Engine ayarı:
+
+```json
+{
+  "builder": {
+    "gc": {
+      "defaultKeepStorage": "20GB",
+      "enabled": true
+    }
+  },
+  "experimental": false,
+  "dns": ["8.8.8.8", "1.1.1.1"]
+}
+```
+
+Docker Desktop yeniden başladıktan sonra şu testler başarılı olmalıdır:
+
+```bash
+docker run --rm alpine nslookup registry-1.docker.io
+docker run --rm alpine nslookup files.pythonhosted.org
+docker run --rm alpine nslookup cdn.playwright.dev
+```
+
+Host servis için kullanılacak ortam değişkenleri:
+
+- `WSCRAPER_SERVICE_BASE_URL` varsayılan: `http://host.docker.internal:8787`
+- `WSCRAPER_SERVICE_TOKEN` varsayılan: boş
+- `WSCRAPER_SERVICE_HOST` varsayılan: `0.0.0.0`
+- `WSCRAPER_SERVICE_PORT` varsayılan: `8787`
+- `WSCRAPER_SERVICE_PYTHON_BIN` örnek: `python3.12`
+
 ## Kullanım (Buffer)
 
 1) qBittorrent’te torrentleri ekleyin (UI listeye düşer).
@@ -41,7 +104,7 @@ docker-compose -f docker-compose.dev.yml up --build
 ## Production
 
 ```bash
-docker-compose up --build
+./scripts/bootstrap.sh --prod-mode
 ```
 
 Ardından http://localhost:3001
@@ -52,6 +115,7 @@ Ardından http://localhost:3001
 - `APP_USERNAME`, `APP_PASSWORD`, `JWT_SECRET`
 - `POLL_INTERVAL_MS`, `ENFORCE_INTERVAL_MS`, `DEFAULT_DELAY_MS`, `MAX_LOOP_LIMIT`
 - `WEB_ALLOWED_HOSTS` (ör: `localhost,qbuffer.bee,qbuffer.panda`)
+- `WSCRAPER_SERVICE_BASE_URL`, `WSCRAPER_SERVICE_TOKEN`
 
 ## Klasör Yapısı