Scoring Engine¶
What it does¶
The Scoring Engine is the single engine that turns hole-by-hole scores into everything else — net scores, points, standings, match results, skins, and pair and team totals — across every supported format. You enter gross scores; the engine derives the rest. Because every screen reads its results from the same engine, live scoring, the scorecard, the live leaderboard, and the round summary always agree with each other.
How it works¶
- During a round, the scorer enters a gross score for each player on each hole.
- The engine applies handicaps and the chosen format's rules to work out net scores, points, and results.
- The live leaderboard, scorecard, and round summary all read those same computed results, so no two screens ever disagree.
- If groups, pairings, or teams change, results recompute automatically — there is no separate step to refresh them.
- When a league round is finalised, each player's league points are recorded into the season standings.
Key details¶
- Powers all 27 golf formats — individual, pairs, and team play, including match play, stableford, stroke, Nassau, skins, banker, scramble, foursomes, and team match play.
- Supports both 18-hole and 9-hole rounds, with a configurable starting hole. Nassau is not available on 9-hole rounds.
- Points distribution and tie-breaking are configurable in the Rulebook.
- The same engine drives both league rounds and casual rounds.
- Scoring is handicap-aware, using each tee's stroke index.
Technical notes¶
Built with Flutter/Dart. Every scoring screen — live scoring, scorecard, leaderboard, and summary — shows the same numbers, so you never see one total on one screen and a different total on another, and nothing goes stale as a round progresses. Round data is stored in Firestore.
Related features¶
- Golf — the sport and formats the engine scores.
- Leagues — where points roll into season standings.
- Matches — match-play scoring within a round.
Last updated: 2026-05-16