Playoffs
Purpose
This page defines playoff data structure and entry rules that are currently enforced by league models and stats workflows.
Policy
- A playoff belongs to one
Seasonand can reference dedicatedquarterfinals,semifinals, andfinalsround records. - Round type choices are restricted to configured values:
Play-In TournamentQuarterfinalsSemifinalsFinals- Each playoff round stores
wins_to_advance; default is 5 unless explicitly set otherwise. - Play-In rounds created through playoff entry flow default to
wins_to_advance = 1. - A playoff series stores
team_a,team_b, both seed values, and an optional series winner. - Playoff games must include both a series and a game number.
- Game number must be unique within a series (
series,game_numberunique constraint). - Home/away assignment for playoff entry is seed-driven by game number:
- higher seed hosts games 1, 2, and 5
- lower seed hosts games 3 and 4
- for single-win rounds (
wins_to_advance = 1), higher seed hosts
Operational Notes
- Finals outcomes are consumed by league-history/season-summary views.
- Playoff bracket rendering is ordered by seed values stored on each series.
Known Gaps (TBD)
- Qualification policy (how teams enter playoffs and seeding source of truth).
- Conference/division constraints and bracket size policy.
- Tie-break policy for seeding.
- Deadline and rescheduling policy for playoff submissions.
- Finals MVP governance policy beyond existing summary fields.
Change Log
- 2026-03-15: Initial scaffold created.
- 2026-03-18: Replaced scaffold with repository-backed playoff policy baseline.