feat: webowa wersja Video & Sound Downloader Pro (NestJS + React)

Odwzorowanie desktopowego v6.5.6: tryby MP3/MP4/PLAYLISTA/FACEBOOK,
jakość/format, napisy, log na żywo (SSE), STOP. Docker + Gitea CI/CD,
deploy na videodownloader.naurecki.pl.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

PROMPT.md

@@ -0,0 +1,66 @@
+# Master-prompt i plan wdrożenia
+
+Dokument zawiera (1) gotowy **prompt** do wygenerowania aplikacji od zera oraz
+(2) **plan** realizacji i wdrożenia na infrastrukturze `naurecki.pl`.
+
+---
+
+## 1. Master-prompt (do odtworzenia aplikacji)
+
+> Zbuduj webową aplikację SPA „Video & Sound Downloader Pro” — webowy odpowiednik
+> desktopowego narzędzia łączącego `yt-dlp` i `FFmpeg`. **Stack: backend NestJS
+> (TypeScript), frontend React + Vite (TypeScript).** Monorepo `apps/api`, `apps/web`.
+>
+> **Backend (NestJS):**
+> - `POST /api/probe` — przyjmuje `{ url }`, uruchamia `yt-dlp -J` i zwraca tytuł,
+>   miniaturę, czas trwania, dostępne jakości oraz listę języków napisów.
+> - `POST /api/jobs` — `{ url, mode, format, subtitles }`, gdzie `mode ∈
+>   {mp3, mp4, playlist, facebook}`. Tworzy job w katalogu tymczasowym, uruchamia
+>   `yt-dlp` (+ `ffmpeg`) z argumentami zależnymi od trybu i zwraca `jobId`.
+> - `GET /api/jobs/:id/events` — strumień **SSE** z liniami logu i procentem postępu
+>   (parsowanie `--newline --progress`); zdarzenia `log`, `progress`, `done`, `error`.
+> - `GET /api/jobs/:id/file` — strumień gotowego pliku do przeglądarki, po wysłaniu
+>   sprzątnięcie katalogu joba (TTL-cleanup dla porzuconych).
+> - `DELETE /api/jobs/:id` — STOP: zabija proces yt-dlp/ffmpeg joba.
+> - Joby w pamięci (EventEmitter) — bez bazy, lekko i „portable”.
+> - Mapowanie trybów: `mp3` → `-x --audio-format mp3 --audio-quality <kbps>`;
+>   `mp4`/`facebook` → `-f "bv*[height<=H]+ba/b" --merge-output-format mp4`;
+>   `playlist` → `--yes-playlist`, wynik pakowany do ZIP. Napisy:
+>   `--write-subs --sub-langs all --embed-subs` (bez auto-napisów: `--no-write-auto-subs`).
+>
+> **Frontend (React) — odwzoruj 1:1 zrzut ekranu desktopu:**
+> ciemny motyw, akcenty niebieskie. Nagłówek z ikoną i wersją; pole **Link** z
+> przyciskiem wklejenia ze schowka; sekcja **„Wybierz opcję”** z 4 kafelkami
+> (MP3 / MP4 / PLAYLISTA / FACEBOOK, ikony i kolory jak na zrzucie, aktywny kafel
+> podświetlony); **„Jakość / Format”** jako dropdown zależny od trybu; w miejscu
+> „Zapisz do” — informacja o pobraniu przez przeglądarkę; duży przycisk
+> **„POBIERZ …”** + **STOP**; **banner trybu testowego**; panel **Log** na żywo
+> (z SSE); stopka **Wsparcie** / **O mnie**.
+>
+> **Wymagania niefunkcjonalne:** obsługa długich procesów (SSE bez buforowania),
+> czytelne komunikaty końcowe i logi, scalanie audio+wideo, brak pozostałości po
+> jobie. Konteneryzacja: obraz API zawiera `python3 + yt-dlp + ffmpeg`; web to
+> nginx serwujący build React i proxujący `/api` (z wyłączonym buforowaniem dla SSE).
+
+---
+
+## 2. Plan realizacji i wdrożenia
+
+| # | Krok | Szczegóły |
+|---|------|-----------|
+| 1 | **Repo** | `gitea.naurecki.pl/dariusz/videodownloader` (push HTTPS-token). |
+| 2 | **Backend** | NestJS: moduły `jobs`, `ytdlp`, `health`; SSE; STOP; ZIP playlist. |
+| 3 | **Frontend** | React+Vite, UI ze zrzutu, klient SSE do panelu Log. |
+| 4 | **Docker** | `apps/api/Dockerfile` (node+yt-dlp+ffmpeg), `apps/web/Dockerfile` (nginx). |
+| 5 | **Compose** | `docker-compose.prod.yml`: `web` → `127.0.0.1:8085`, `api` wewnętrznie. |
+| 6 | **CI/CD** | `.gitea/workflows/deploy.yml`: push `main` → build + `up -d` (docker.sock). |
+| 7 | **Reverse proxy** | vhost Apache `videodownloader.naurecki.pl` → `127.0.0.1:8085`. |
+| 8 | **SSL** | `certbot --apache -d videodownloader.naurecki.pl`. |
+| 9 | **DNS** | Gotowe — `*.naurecki.pl` (wildcard) już wskazuje `212.109.167.206`. |
+| 10 | **Weryfikacja** | `https://videodownloader.naurecki.pl` + test pobrania. |
+
+**Ustalenia infrastrukturalne** (zweryfikowane na serwerze):
+- Serwer `naurecki.pl` (= `mail.naurecki.pl`, `212.109.167.206`): Apache + certbot,
+  aktywny `gitea-runner` z zamontowanym `docker.sock`.
+- Wolny port loopback: **8085**.
+- Wzorzec deployu zgodny z istniejącym projektem `gdziebts`.