Files
Wizard/wizard_server
marvinandClaude Opus 5.5 90176e1cca Serve API and website behind Caddy path prefixes
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>
2026-09-27 10:00:29 +02:00
..
2026-09-27 09:52:00 +02:00
2026-09-27 09:52:00 +02:00
2026-09-27 09:52:00 +02:00
2026-09-27 09:52:00 +02:00
2026-09-27 09:52:00 +02:00
2026-09-27 09:52:00 +02:00

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 schema
  • app/service.py — dispatches client messages, reconnects sessions, cleanup
  • app/lobby.py — lobbies, seats, host actions, running games and AI turns
  • app/ai_bridge.py — request/response protocol with the AI service, random-move fallback
  • app/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