pvm/README.md
Mikkel Georgsen 7bd1805b67 Initial commit: project vision and README
Establish PVM (Poker Venue Manager) project with product vision
document covering all feature domains and a clean README with
project overview.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-08 02:39:17 +01:00

49 lines
1.8 KiB
Markdown

<p align="center">
<img src="docs/assets/logo-placeholder.svg" alt="PVM Logo" width="120" />
</p>
<h1 align="center">PVM</h1>
<h3 align="center">Poker Venue Manager</h3>
<p align="center">
<strong>The all-in-one platform for poker venue operations.</strong><br/>
Tournaments. Cash games. Dealers. Players. Displays. All managed. Always on.
</p>
<p align="center">
<code>SaaS</code>&nbsp;&middot;&nbsp;<code>Offline-Capable</code>&nbsp;&middot;&nbsp;<code>Real-Time</code>&nbsp;&middot;&nbsp;<code>Multi-Venue</code>
</p>
---
## 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, credit lines, and game history
- **Dealer Coordination** — Scheduling, availability, shift swaps, and cross-venue mobility
- **Display Streaming** — Push live clocks, seatings, and info to Chromecast screens throughout the venue
- **Local Node Support** — Optional on-premise Raspberry Pi 5 proxy for zero-downtime operation during internet outages
## Architecture
```
PVM Cloud (SaaS) ◄── near-realtime sync ──► Venue Local Nodes (RPi5)
├── Web App (managers, staff, players, dealers)
├── Mobile PWA / Native App (players, dealers)
└── Chromecast Receiver (venue display screens)
```
## Documentation
- **[Vision & Feature Overview](docs/VISION.md)** — The full product vision and feature roadmap
- **Tech Stack** — *Coming soon* — Research and decisions on the technology foundation
---
<p align="center">
<sub>Built for the poker community.</sub>
</p>