Snooker League MVP
A focused mobile app for a UK snooker club's 3-tier league: matchmaking inside divisions, mutual result confirmation, season-end promotion. Built to the brief — nothing more, nothing less.
🧠
Core Technologies
- Flutter — Single codebase for iOS + Android beta
- Node + Fastify — Match state-machine API + JWT auth
- PostgreSQL — Row-level locking on result confirmation
- FCM + Postmark — Push + email for all state transitions
📦
V1 Deliverables
✓
Player profiles + auto Division 2 onboarding
V1✓
Same-division player roster + search
V1✓
Match request with date/time + venue note
V1✓
Counter-offer flow (requested → counter → accepted → confirmed)
V1✓
Push + email notifications on every state change
V1✓
Mutual result logging with dispute handling
V1✓
Season engine (12 weeks, win %, 12-match minimum)
V1✓
Promotion at season end (top ~25%, no relegation)
V1→
Club-admin web console (season reset, manual division moves)
V2→
Match history + head-to-head per player
V2→
Multi-club / multi-league support
V2→
iOS / Android store release (post-beta)
V2🏛
Architecture Layers
MOBILE
Flutter · Riverpod · Hive offline cache · FCM/APNs
STATE ENGINE
Node + Fastify · explicit FSM: requested → counter → accepted → confirmed → completed → result-confirmed
DATA
PostgreSQL · row-level locks on result rows · idempotency keys on every mutation
DELIVERY
Fly.io · GitHub Actions · Postmark email · Sentry monitoring