Fix Dokploy deploy: support private Gitea repo and document exit 128.

Add GITEA_REPO_URL for authenticated clone, improve startup logging, default FRONTEND_PORT to 8082, and update deployment README.

Co-authored-by: Cursor <cursoragent@cursor.com>

docker-compose-example/.env.example

@@ -3,8 +3,14 @@
 # Never commit .env with real credentials to version control.
 
 # --- Frontend Server ---
+# Uwaga: 8080 może być zajęty (np. agencja-ai). Użyj wolnego portu, np. 8082.
 FRONTEND_PORT=8082
 
+# --- Gitea (opcjonalnie — tylko gdy repo jest prywatne) ---
+# Domyślnie clone używa publicznego URL bez auth.
+# Dla prywatnego repo ustaw URL z tokenem (Deploy Token lub PAT w Gitea):
+# GITEA_REPO_URL=https://oauth2:TWÓJ_TOKEN@gitea.expert-it.agency-ai.dev/tomasz-syn-grzegorza/site-slavic-pulse-com.git
+
 # --- Strona (meta, SEO, PWA) ---
 SITE_TITLE="Slavic Pulse"
 SITE_SHORT_NAME="Slavic Pulse"
@@ -20,10 +26,15 @@ FAVICON_180=/assets/imgs/favico/180x180.png
 FAVICON_512=/assets/imgs/favico/512x512.png
 
 # --- YouTube ---
+# Short FHD 16:9 (landscape / szeroki viewport)
 VIDEO_ID_FHD=kujXXtoHUbc
 POST_VIDEO_REDIRECT_URL_FHD=https://www.youtube.com/watch?v=kujXXtoHUbc
+# Short vertical 9:16 (portrait / wąski viewport)
 VIDEO_ID_VERTICAL=YOUR_VERTICAL_SHORT_ID
 POST_VIDEO_REDIRECT_URL_VERTICAL=https://www.youtube.com/shorts/YOUR_VERTICAL_SHORT_ID
+# Zachowanie po zakończeniu intro:
+# true  = przekieruj na POST_VIDEO_REDIRECT_URL_*
+# false = zostaw miniaturkę YouTube jako tło strony
 POST_VIDEO_REDIRECT_ENABLED=true
 # POST_VIDEO_REDIRECT_ENABLED_FHD=true
 # POST_VIDEO_REDIRECT_ENABLED_VERTICAL=false