PitchBuddy
Operating System for Small-Sided Football Venues & Hands-Free AI Match Day Companion
Executive Architectural Overview
End-to-end venue management system transforming paper-based 5-a-side pitches with algorithmic team balancing, automated tournament brackets, server-authoritative timers, and voice AI PA announcements.
Core Architectural Accomplishments
Deterministic Guarantees
Integrated System Components
Algorithmic Queue & Draw Balancer
Instantly balances teams based on player profiles and ratings, with smart clustering that keeps friend groups on the same side.
Hands-Free Gemini Live PA Companion
Voice-driven referee assistant that announces match starts, remaining time, next queue calls, and score updates over the venue PA.
Automated Tournament Engine
Procedurally builds and runs knockouts, round-robins, and multi-pitch leagues with server-authoritative timers and live venue TV sync.
Ring-Fenced Bachs Prize Ledger
Collects team entry fees digitally and ring-fences tournament prize pools with automated escrow release upon championship completion.
Server-Authoritative WebSocket Match Clocks
Synchronizes match duration and overtime across mobile devices, pitchside kiosks, and wall-mounted TV scoreboards.
Technology Architecture Matrix
- Next.js
- Tailwind CSS
- TV Scoreboard Display Canvas
- Mobile QR Check-In UI
- Live Standings Table
- Multitenant PostgreSQL (PGlite + Supabase)
- Atomic Queue Mutations
- Server-Authoritative Match Clocks
- Bachs Ring-Fenced Prize Ledgers
- Tenant-Isolation RLS
- Gemini Live Voice Companion
- Automated PA Broadcast Synthesis
- Hands-Free Voice Match Management
- Realtime WebSocket Scoreboards
- Bachs Digital Entries
- Cash-at-Venue Reconciliation
- Automated Escrow Prize Payouts
- Refund & Discipline Ledgers