Caddy forwards /wizard/api/* and /wizard/website/* with the prefix stripped, so the server received /ws instead of /api/ws and the website connected to /api/ws on the domain root. - Server routes are now /ws and /health (was /api/ws, /api/health) - Website derives the websocket URL from its own location (../api/ws), giving /wizard/api/ws in production and /api/ws in development - Vite dev proxy strips /api like the production proxy - nginx back to the plain SPA config since Caddy strips the prefix - /internal/ai rejects requests that came through the reverse proxy, in addition to the shared secret - Docs updated for the prefixed deployment Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
wizard_server
FastAPI game server. It manages sessions, lobbies and games, and talks to the AI service.
game_logic/— the standalone rules engine (pip install ./game_logic, see its README).app/main.py— routes:GET /health,WS /ws(browsers),WS /internal/ai(AI service, refused when the request came through the reverse proxy)app/protocol.py— client message schemaapp/service.py— dispatches client messages, reconnects sessions, cleanupapp/lobby.py— lobbies, seats, host actions, running games and AI turnsapp/ai_bridge.py— request/response protocol with the AI service, random-move fallbackapp/sessions.py— sessions (token based, survive reloads) and ordered websocket sending
Configuration (environment): AI_SHARED_SECRET, AI_DECISION_TIMEOUT (5s), AI_MOVE_DELAY (0.8s),
TRICK_PAUSE (1.8s), SESSION_TTL (1800s), MAX_LOBBIES (1000), ALLOWED_ORIGINS, LOG_LEVEL.
pip install -r requirements-dev.txt
uvicorn app.main:app --reload
pytest