mikkel/pvm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Poker Venue Manager
5 commits 1 branch 0 tags 222 KiB
Svelte 42.8%
TypeScript 27.1%
Rust 18%
Shell 10%
CSS 1.1%
Other 1%
Find a file
Mikkel Georgsen e25afdcb3a Add auth framework research document 
Comprehensive evaluation of 11 auth frameworks for PVM's
split-brain architecture. Recommends self-hosted Zitadel v3
for its Rust crate, OIDC JWKS for offline JWT validation on
RPi5 nodes, and zero-cost self-hosting on existing Hetzner PVE.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-08 03:24:51 +01:00
docs Add auth framework research document 2026-02-08 03:24:51 +01:00
README.md Update README and VISION with finalized tech stack decisions 2026-02-08 03:12:56 +01:00

README.md

PVM Logo

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

Built for the poker community.