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>
22 lines
1.0 KiB
Markdown
22 lines
1.0 KiB
Markdown
# 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`.
|
|
|
|
```bash
|
|
pip install -r requirements-dev.txt
|
|
uvicorn app.main:app --reload
|
|
pytest
|
|
```
|