How This App Works

Quick guide so you can run weekly games without getting lost.

Weekly Routine (Best Order)

1. Go to Admin Games and open this week’s game.
2. Record attendance: bulk paste names or set individual statuses.
3. Generate teams (auto balanced) or use manual teams.
4. After the match, enter the final score in game edit.
5. If cancelled/stopped, mark the game as abandoned.
6. Check leaderboard to confirm wins and attendance updated.

What Each Page Is For

• / – games list (also auto-creates next Wednesday game if missing).
• /admin/games – main game management.
• /games/<id> – attendance and team actions for a game.
• /games/<id>/teams – view/generate balanced teams.
• /games/<id>/teams/manual – manual team split.
• /admin/players – manage players and attendance stats.
• /leaderboard – wins/draws/losses and attendance leaderboard.
• /import – import attendance from CSV.

Important Rules

• Abandoned games are excluded from stats and have no final scores.
• Only playing counts for attendance percentage.
• Attendance denominator is all past, non-abandoned games.
• Leaderboard is based on saved team assignments + final scores for the current year.

Attendance Formula

attendance % = (player playing count / total past non-abandoned games) × 100

Quick Troubleshooting

• Can’t open admin pages: log in at /login.
• Can’t generate teams: need at least 2 players marked playing.
• Stats look off: check whether a game was marked abandoned.
• Import name mismatch: make sure player aliases are consistent.

Full written guide is also in the repo: HOW_IT_WORKS.md.