What problem does it solve? It documents where each championship's data lives and how the soon→active→closed lifecycle works in the Primitivão app (apostas-app.jsx), so opening, closing, or awarding a championship (FIFA, MK, Golf, etc.) no longer requires rediscovering the data model every time. ## Core Features & Use Cases - Lifecycle management: Explains the status flip from soon to active, how 'closed' is computed via computeChampStandings, and how to transition between bettable championships in one operation. - Data model map: Details where each game stores results (cs.rounds for FIFA, json.mk for Mario Kart, interests.<id> for signups) and which fields are top-level Firestore fields. - Titles and trophies: Describes the predicate-based achievement system (ACH/ACHIEVEMENTS, earnedTitles latch) used to award champion, runner-up, last-place, and REI DAS APOSTAS titles without minting PC. - Use Case: When asked to close the Mario Kart championship and award trophies, follow the documented mkStatsFor/mkKoPodiumOrder path to derive winners and latch titles instead of hardcoding nicknames. ## Quick Start Ask the assistant to close the current championship and award the champion, runner-up, and REI DAS APOSTAS titles following this lifecycle guide.
