app: update service orchestration, environment configs, and documentation

.env.example

@@ -13,12 +13,18 @@ ADMIN_USER_IDS=78649634
 REVIEW_CHANNEL_ID=
 
 # =======================================================
-# AI Provider (OrcaRouter / OpenAI / Gemini)
+# AI Provider (OrcaRouter / OpenAI / Gemini / AGY)
 # =======================================================
 AI_PROVIDER=openai
 AI_BASE_URL=https://api.orcarouter.ai/v1
 AI_API_KEY=
 AI_MODEL=google/gemini-3.5-flash
+# Allow AI / automatic routing to directly enqueue posts to target channels (true/false)
+AI_AUTO_POSTING_ENABLED=true
+# Enable second-pass self-verification to fix language mixing and audit format (true/false)
+AI_DOUBLE_CHECK=false
+# Thinking / Reasoning effort for supported models (low / medium / high)
+AI_REASONING_EFFORT=
 
 # =======================================================
 # PostgreSQL (Configured for Docker Compose)
@@ -33,9 +39,21 @@ DATABASE_URL=postgresql://postgres:postgres@postgres:5432/copykar
 # =======================================================
 # Storage & Metrics
 # =======================================================
-METRICS_PORT=8000
+METRICS_PORT=8008
 MEDIA_DIR=/app/data/media
 GRAFANA_USER=admin
 GRAFANA_PASSWORD=admin
+PGADMIN_DEFAULT_EMAIL=admin@copykar.com
+PGADMIN_DEFAULT_PASSWORD=admin
+PGADMIN_PORT=5050
+
 REDIS_URL=redis://copykar_redis:6379/0
 AI_PROCESSING_INTERVAL_SECONDS=120
+
+# Tried in order when the primary AI_MODEL is rate-limited or unavailable
+AI_FALLBACK_MODELS=nvidia/nemotron-3-super-120b-a12b:free,minimax/minimax-m2.7:free,minimax/minimax-m3:free
+AI_MAX_RETRIES=2
+AI_RETRY_BACKOFF_SECONDS=2
+
+# Local wall-clock offset from UTC, used for per-target sleep windows (Iran = 3.5)
+TIMEZONE_OFFSET_HOURS=3.5