build: create development build and a separate production compose stack

README.md

@@ -19,8 +19,34 @@ Wymagane zmienne środowiskowe (plik `.env`):
 | `POSTGRES_PASSWORD` | Hasło użytkownika bazy; domyślnie `zyrarbot`, zalecana zmiana w `.env`. |
 | `POSTGRES_DB` / `POSTGRES_USER` | Opcjonalna nazwa bazy i użytkownika; domyślnie `zyrarbot`. |
 
-Panel działa pod `http://localhost:8000` podczas uruchomienia lokalnego. W Dockerze
-jest dostępny pod `http://localhost` po wykonaniu `docker compose up --build`.
+Panel działa pod `http://localhost:8000` podczas uruchomienia lokalnego.
+
+### Docker: development i production
+
+Środowisko deweloperskie uruchom poleceniem:
+
+```bash
+docker compose up --build
+```
+
+Kod Pythona jest montowany z katalogu projektu; po zmianach zrestartuj backend
+poleceniem `docker compose restart discord-bot`. Frontend działa w osobnym
+kontenerze i przebudowuje `frontend/dist` w trybie watch. Python serwuje ten sam
+współdzielony katalog pod `http://localhost`. Port PostgreSQL `5432` jest
+dostępny lokalnie. Obraz dev zawiera też Ruff, a kontener frontendu instaluje
+narzędzia z `package-lock.json` (ESLint i `vue-tsc`).
+Sprawdzenia uruchom w kontenerze backendu, np. `docker compose exec discord-bot
+ruff check .` i `docker compose exec discord-bot pytest`; dla frontendu użyj
+`docker compose exec frontend npm run lint` lub `npm run typecheck`.
+
+Production uruchom z pliku `compose.prod.yaml`:
+
+```bash
+docker compose -f compose.prod.yaml up --build -d
+```
+
+W tym wariancie frontend jest budowany podczas tworzenia obrazu, a port PostgreSQL
+nie jest publikowany na hoście.
 
 Panel obsługuje wiele serwerów Discorda. Wybór serwera w nagłówku przełącza jego
 osobną kolejkę, historię, bazę plików i ustawienia odtwarzania. Ustawienia, historia