.env.sample

# ── Required ──────────────────────────────────────────────────────────────────

# OpenRouter API key — get one at https://openrouter.ai/keys
OPENROUTER_API_KEY=sk-or-v1-...

# Admin panel password (choose something strong)
ADMIN_SECRET=change-me-please

# ── Optional ──────────────────────────────────────────────────────────────────

# Server port (default: 5109)
PORT=5109

# Path to the SQLite database file
# When using Docker, this is handled via the volume mount (/data/argumentes.sqlite)
DATABASE_PATH=argumentes.sqlite

# Rate limits (requests per minute)
HISTORY_LIMIT_PER_MIN=120
ADMIN_LIMIT_PER_MIN=10

# WebSocket limits
MAX_WS_GLOBAL=100000
MAX_WS_PER_IP=8
MAX_WS_NEW_PER_SEC=50

# Viewer vote broadcast debounce in ms (default: 250)
VIEWER_VOTE_BROADCAST_DEBOUNCE_MS=250

# Auto-pause: seconds of inactivity before pausing when no viewers are connected (default: 60000 ms)
AUTOPAUSE_DELAY_MS=60000

# ── Redsys (optional — enables paid user question submissions at /pregunta) ────

# Public base URL of this server (used for Redsys redirect/notification URLs)
# Example: https://argument.es
PUBLIC_URL=https://argument.es

# Redsys merchant credentials (get these from your bank / Redsys portal)
REDSYS_MERCHANT_CODE=
REDSYS_TERMINAL=1
# Base64-encoded Redsys secret key (SHA-256 key from the merchant portal)
REDSYS_SECRET_KEY=

# Set to "false" to use the live Redsys gateway (default: test environment)
REDSYS_TEST=true
feat: convert to argument.es — Spanish, vote buttons, Docker - Translate all ~430 prompts to Spanish with cultural adaptations - Translate all UI strings (frontend, admin, history, broadcast) - Translate AI system prompts; models now respond in Spanish - Replace Twitch/Fossabot viewer voting with in-site vote buttons - Add POST /api/vote endpoint (IP-based, supports vote switching) - Vote buttons appear during voting phase with active state highlight - Rename project to argument.es throughout (package.json, cookie, DB) - Add docker-compose.yml with SQLite volume mount - Add .env.sample documenting all required and optional vars Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-02-27 13:09:00 +01:00			`# ── Required ──────────────────────────────────────────────────────────────────`

			`# OpenRouter API key — get one at https://openrouter.ai/keys`
			`OPENROUTER_API_KEY=sk-or-v1-...`

			`# Admin panel password (choose something strong)`
			`ADMIN_SECRET=change-me-please`

			`# ── Optional ──────────────────────────────────────────────────────────────────`

			`# Server port (default: 5109)`
			`PORT=5109`

			`# Path to the SQLite database file`
			`# When using Docker, this is handled via the volume mount (/data/argumentes.sqlite)`
			`DATABASE_PATH=argumentes.sqlite`

			`# Rate limits (requests per minute)`
			`HISTORY_LIMIT_PER_MIN=120`
			`ADMIN_LIMIT_PER_MIN=10`

			`# WebSocket limits`
			`MAX_WS_GLOBAL=100000`
			`MAX_WS_PER_IP=8`
			`MAX_WS_NEW_PER_SEC=50`

			`# Viewer vote broadcast debounce in ms (default: 250)`
			`VIEWER_VOTE_BROADCAST_DEBOUNCE_MS=250`
feat: footer, auto-pause on no viewers, and Redsys question submissions - Footer: add site-footer with one-liner + Cloud Host branding linking to cloudhost.es (mobile only, hidden on desktop) - Auto-pause: game pauses automatically after AUTOPAUSE_DELAY_MS (default 60s) with no viewers connected; auto-resumes when first viewer connects; shows "Esperando espectadores…" in the UI - Redsys: new /pregunta page lets viewers pay 1€ via Redsys to submit a fill-in question; submitted questions are used as prompts in the next round instead of AI generation; new redsys.ts implements HMAC_SHA256_V1 signing (3DES key derivation + HMAC-SHA256); notification endpoint at /api/redsys/notificacion handles server-to-server confirmation - db.ts: questions table with createPendingQuestion / markQuestionPaid / getNextPendingQuestion / markQuestionUsed - .env.sample: added AUTOPAUSE_DELAY_MS, PUBLIC_URL, REDSYS_* vars Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> 2026-02-27 14:03:30 +01:00
			`# Auto-pause: seconds of inactivity before pausing when no viewers are connected (default: 60000 ms)`
			`AUTOPAUSE_DELAY_MS=60000`

			`# ── Redsys (optional — enables paid user question submissions at /pregunta) ────`

			`# Public base URL of this server (used for Redsys redirect/notification URLs)`
			`# Example: https://argument.es`
			`PUBLIC_URL=https://argument.es`

			`# Redsys merchant credentials (get these from your bank / Redsys portal)`
			`REDSYS_MERCHANT_CODE=`
			`REDSYS_TERMINAL=1`
			`# Base64-encoded Redsys secret key (SHA-256 key from the merchant portal)`
			`REDSYS_SECRET_KEY=`

			`# Set to "false" to use the live Redsys gateway (default: test environment)`
			`REDSYS_TEST=true`