first prototype

wizard_server/README.md

@@ -0,0 +1,20 @@
+# 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`.
+
+```bash
+pip install -r requirements-dev.txt
+uvicorn app.main:app --reload
+pytest
+```