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. After the match, enter the final score in game edit.
4. If cancelled/stopped, mark the game as abandoned.
5. 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 for a game.
• /admin/players – manage players and attendance stats.
• /leaderboard – wins/draws/losses and attendance leaderboard.
• /stickers – upload player photos and open a six-card sticker packet.
• /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.
• 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.