Poker Venue Manager
Mikkel Georgsen
c972926d31
Backend (Rust/Axum): - pvm-api: Axum server with health and user profile endpoints, OpenAPI/Swagger UI, CORS, tracing, graceful shutdown - pvm-auth: JWT validation middleware with JWKS cache for offline-capable Zitadel token verification - pvm-core: Shared error types with IntoResponse impl - pvm-types: Shared domain types (UserProfile) Frontend (SvelteKit): - Dashboard app with Svelte 5 + TypeScript + Tailwind CSS v4 - Zitadel OIDC auth via @auth/sveltekit (PKCE flow) - Pages: landing, sign-in, dashboard, account settings - Responsive sidebar layout with dark mode support - Typed API client for backend communication Infrastructure: - Docker Compose dev environment with Zitadel v3, PostgreSQL 16, and DragonflyDB - Environment variable examples and setup documentation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| apps/dashboard | ||
| crates | ||
| docker | ||
| docs | ||
| .gitignore | ||
| Cargo.toml | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
PVM
Poker Venue Manager
The all-in-one platform for poker venue operations.
Tournaments. Cash games. Dealers. Players. Displays. All managed. Always on.
SaaS · Offline-Capable · Real-Time · Multi-Venue
What is PVM?
PVM is a comprehensive management system for poker venues of any size. It handles the full lifecycle of venue operations:
- Tournament Management — Planning, live clocks, seating, registration, results, and recurring series
- Cash Game Operations — Table tracking, waiting lists, game types, and session history
- Player Accounts — One account across all venues, memberships, and game history. Players sign up for PVM first, then join venues.
- Dealer Coordination — Scheduling, availability, shift swaps, and cross-venue mobility
- Venue Display System — Push live clocks, seatings, waitlists, and info to any TV via Android display clients with mDNS auto-discovery
- Local Node Support — Optional on-premise Raspberry Pi 5 proxy (Docker-based) for zero-downtime operation during internet outages (up to 72h offline)
Architecture
Hetzner PVE (LXC + Docker)
├── Rust API (Axum) + WebSocket Gateway
├── PostgreSQL 16 + DragonflyDB
├── NATS + JetStream
└── SvelteKit Web Apps
│
├── near-realtime event sync (NATS) ──► Venue RPi5 Nodes (Docker)
├── Web App / PWA (managers, staff, players, dealers)
└── Venue TVs (Android display client, cloud fallback)
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Rust + Axum |
| Frontend | SvelteKit (Svelte 5) + shadcn-svelte + Tailwind v4 |
| Cloud DB | PostgreSQL 16+ |
| Local DB | libSQL (embedded) |
| Cache | DragonflyDB |
| Messaging | NATS + JetStream |
| Auth | Custom JWT + RBAC |
| API | REST + OpenAPI 3.1 |
| Infra | Hetzner PVE, Docker, Forgejo Actions |
Documentation
- Vision & Feature Overview — The full product vision and feature roadmap
- Tech Stack Research — Comprehensive technology decisions and reasoning
Built for the poker community.