RackTracker is a specialized scoring system designed for pool tournament directors (TDs) to quickly and efficiently record match data during live tournaments. The system prioritizes speed and simplicity for data entry while capturing the essential nuances of pool matches that are valuable for reporting and player statistics. RackTracker facilitates easy export of match data to external platforms like FargoRate and Challonge, serving as a bridge between live match scoring and comprehensive tournament management.

1. Speed First: Every interaction is optimized for rapid data entry during fast-paced tournaments.
2. Focused Nuance: Only capture objective, high-value data points that require minimal effort.
3. Mobile Optimized: Primary interface designed for smartphones and tablets used by TDs at the table.
4. Export Ready: All data structured for easy extraction to external systems.
5. Offline Capable: Functions without constant internet connection in venue environments.

• Rack winner (Player A or Player B)
• Current score/progression toward race

• Break and Run (BR): Player breaks and clears the table without opponent shooting
• Rack Runout (RO): Player clears the table after the break (but didn't break)
• Safety Exchange Winner: Simplified tracking of tactical play (optional toggle)

• Opponent scratch on break
• Opponent foul during play
• Missed shot on the money ball (8, 9, or 10 depending on game)

• Game format (8-ball, 9-ball, 10-ball)
• Table size (7', 8', 9')
• Race length (race to X)
• Tournament name
• Player information (names, IDs if available)

• Header: Tournament name, match identifier, game format
• Player Cards: Two prominent sections showing:
  • Player names
  • Current score
  • Race target

• Primary Actions: Two large buttons (60% of screen width each)

  • "[Player A Name] Wins Rack"
  • "[Player B Name] Wins Rack"

• Quick Toggles: Small icons that can be tapped before or after recording the rack win

  • Break and Run (BR) icon
  • Rack Runout (RO) icon
  • Foul icon
  • Scratch on Break icon
  • Money Ball Miss icon

• Control Actions:

  • Undo Last Rack button
  • Edit Match Details button
  • End Match button

1. TD selects active match from dashboard
2. As each rack completes, TD taps the winner button
3. If special events occurred (BR, RO, Foul), TD taps the relevant icon before or after recording the win
4. System automatically updates score and progresses toward race completion
5. When race is complete, system prompts for confirmation and finalizes match

• Large touch targets (minimum 48x48px)
• High contrast for visibility in varying lighting conditions
• Minimal scrolling required during active scoring
• Portrait orientation optimized for one-handed operation
• Haptic feedback for successful actions

• Technology: React-based SPA with offline support via service workers
• Key Components:
  • Match Dashboard: Overview of active and completed matches
  • Scoring Interface: Fast data entry during matches
  • Player Profiles: Stats and history view
  • Export Center: Data extraction tools

• API Layer: RESTful endpoints for data processing
• Authentication: Simple user management for TDs
• Business Logic: Match progression, statistics calculation
• Sync Management: Handles offline data reconciliation

• Core Tables:
  • Users (Tournament Directors)
  • Players
  • Tournaments
  • Matches
  • Racks (with associated events)
  • Statistics (calculated from rack data)

• Win/Loss record
• Performance metrics:
  • Break and Runs per 100 games
  • Rack Runouts per 100 games
  • Foul differential (opponent fouls minus player fouls)
  • Money ball conversion rate

• Simple Elo-based system using match outcomes
• Performance adjustments based on captured nuance (BR/RO rates)
• Not intended to replace FargoRate but to provide internal seeding options

• CSV: Tabular data for spreadsheet import

  • Match results summary
  • Detailed rack-by-rack breakdown
  • Player statistics

• JSON: Structured data for programmatic use

  • Complete match data
  • Tournament summaries
  • Player profiles

• Copyable text format for quick sharing
• PDF generation for official records
• QR code linking to online match record

• FargoRate: Export match results in compatible format

  • Investigation needed for direct API integration
  • Fallback to formatted export for manual entry

• Challonge: Update bracket progress

  • Explore API options for automatic updates
  • Provide formatted data for manual entry

• Public view-only match tracker for spectators
• Embeddable live score widgets for tournament websites

1. Core Functionality (MVP):

   • User management
   • Match setup and basic scoring
   • Simple export options

2. Enhanced Scoring:

   • Add BR/RO tracking
   • Implement foul tracking
   • Develop basic player profiles

3. Reporting Expansion:

   • Comprehensive export options
   • Integration research and development
   • Advanced statistics

4. Advanced Features:

   • Offline mode with sync
   • Public sharing options
   • Tournament management tools

• Early testing with tournament directors
• Usability sessions focused on scoring speed
• Data collection on most used features
• Continuous refinement of the interface based on real-world use

• Time per rack entry (target: <3 seconds)
• Match setup time (target: <30 seconds)
• Export completion time (target: <10 seconds)
• Sync reliability after offline use (target: 100%)

The system will be built using:

• TypeScript for type safety
• React for the frontend interface
• SQLite for data storage
• RESTful API for data access
• Service workers for offline capability

RackTracker is designed with a singular focus: to make the TD's job easier during tournaments while capturing valuable match data. By prioritizing speed and simplicity in the interface while ensuring comprehensive data export capabilities, the system bridges the gap between efficient tournament operation and detailed match reporting for external platforms.