Poker Venue Manager
Mikkel Georgsen
f5df3e1182
Documents the architecture for PVM's managed digital signage system: Orange Pi 5 as leaf node (local backend, screen management API, video pipeline), Radxa ROCK 4D as thin-client display nodes (kiosk Chromium, CEC control, mDNS auto-discovery). API-first design for web and tablet management clients. libsql on leaf, PostgreSQL on core. 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 | ||
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░ ░░
░░ ██████╗ ██╗ ██╗███╗ ███╗ ♠ ♥ ♣ ♦ ░░
░░ ██╔══██╗██║ ██║████╗ ████║ ░░
░░ ██████╔╝╚██╗ ██╔╝██╔████╔██║ poker venue manager ░░
░░ ██╔═══╝ ╚████╔╝ ██║╚██╔╝██║ -- since 2026 -- ░░
░░ ██║ ╚██╔╝ ██║ ╚═╝ ██║ seat open, table 3! ░░
░░ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ░░
░░ ░░
░░ tournaments · cash games · dealers · players · displays ░░
░░ all managed · always on · no rake required ░░
░░ ░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
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.