Wizard/wizard_server/README.md

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 /api/health, WS /api/ws (browsers), WS /internal/ai (AI service)
• 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