docs: stage J round 1 — release polish audit + README stats section

a11y/responsive/i18n audit over A-F passed clean (no code fixes); added a
Stats section to the README; restructured TODO so G/H/I + a second polish
(J round 2) are queued for the future.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Lucas Kalil 2026-06-17 11:10:18 -03:00
parent 95f9d48706
commit 992d2d1c26
4 changed files with 33 additions and 16 deletions

View file

@ -72,24 +72,29 @@ Use checkboxes to track progress. Items marked **🔴 BLOCKER** prevent release;
---
## 7. Stats final screen — `feature/stats-final-screen` (post-Cup release)
## 7. Stats final screen — `feature/stats-final-screen`
Full build of `.agents/stats-screen-plan.md` on a feature branch, merged to `master` at the end of
the Cup. One approval gate before each stage. AF are buildable from today's data; G/H/I are
data-blocked (graceful-degradation shell lets the UI land dark until JSON arrives).
Build of `.agents/stats-screen-plan.md`, stage by stage with an approval gate each. The **pure-UI
build (AF, minus skipped E) + a release polish (J round 1)** was **merged to `master` on 2026-06-17**
and is live. The screen renders fully with today's data and auto-lights the post-Cup sections (verdict,
champion path, debuts champion) once the final lands. The **data-layer stages (G/H/I) + a second polish
(J round 2)** remain for when their data arrives near/after the Cup.
### 🟢 OPTIONAL (release feature)
### ✅ Shipped to `master` (2026-06-17)
- [x] ~~Stage 0 — branch `feature/stats-final-screen` off `master`~~
- [x] ~~Stage A — degradation engine + fault-tolerant `loadData` + sticky scrollspy sub-nav + media fallback~~ (2026-06-16)
- [x] ~~Stage B — verdict hero (gated on FINAL finished; aggregate-hero fallback) + goals-by-round chart~~ (2026-06-16)
- [x] ~~Stage C — final ranking 148 (phase-reached chain), favorite-row highlight, team record cards~~ (2026-06-17)
- [x] ~~Stage D — auto record-cards + "format-48 debuts" band~~ (2026-06-17)
- [x] ~~Stage E — 104-match results archive (accordion by phase, row → modal)~~**SKIPPED (2026-06-17, Option B):** kept the "See all matches → Matches" link; the Matches tab already covers browsing. No archive built.
- [x] ~~Stage F — team comparator (diverging bars)~~ (2026-06-17; teams only — players side deferred to Stage H per graceful degradation)
- [ ] Stage G — Layer 2 cheap data (attendance, `cards`→{y,r} migration, decidedIn, coords) — **SCHEDULE LATE**
- [ ] Stage H — Layer 3 players (`players.json` + `player-events.json` + `awards.json`)
- [ ] Stage I — Layer 4 editorial (`curiosities.json` + `all-time-baselines.json`)
- [ ] Stage J — polish (responsive/a11y audit, perf, Lighthouse, `DATA_VERSION` bump, README/i18n)
- [x] ~~Stage A — degradation engine + fault-tolerant `loadData` + sticky scrollspy sub-nav + media fallback~~
- [x] ~~Stage B — verdict hero (gated on FINAL finished; aggregate-hero fallback) + goals-by-round chart~~
- [x] ~~Stage C — final ranking 148 (phase-reached chain), favorite-row highlight, team record cards~~
- [x] ~~Stage D — auto record-cards + "format-48 debuts" band~~
- [x] ~~Stage E — in-tab results archive~~**SKIPPED (Option B):** kept the "See all matches → Matches" link; the Matches tab already covers browsing.
- [x] ~~Stage F — team comparator (diverging bars)~~ — teams only; the Teams/Players toggle is deferred to Stage H per graceful degradation.
- [x] ~~Stage J (round 1, release polish) — a11y/responsive/i18n/README audit on AF~~ — passed clean (no code fixes). **Lighthouse + final `DATA_VERSION` bump still pending an actual deploy.**
### 🔭 Future (data layers + 2nd polish — near/after the Cup)
- [ ] **Stage G — Layer 2 cheap data.** Extend `results.json` (attendance, **`cards`→{y,r} migration** — breaking for `modal.js` + `stats.js` `aggregateTeams`, add a backward-compatible reader; `decidedIn`; backfill `stats`), `teams.json` (`ranking`/`wcDebut`/`confederation`), `stadiums.json` (`lat`/`lng`). Light up records: attendance, discipline/fair-play, ranking upsets, confederation performance, distance. **SCHEDULE LATE — conflicts with master's daily `results.json` refreshes.** Bump `DATA_VERSION`.
- [ ] **Stage H — Layer 3 players.** `players.json` + `player-events.json` + `awards.json` (+ optional `keeper-stats.json`). Top-scorers podium, assists/cards/saves chips, awards block, Squad of the Tournament, **Teams/Players toggle in the comparator** (the deferred half of Stage F), goal-time records. Relative photo paths (gotcha #7).
- [ ] **Stage I — Layer 4 editorial.** `curiosities.json` (bilingual EN+PT) + `all-time-baselines.json`; editorial record-cards + "this Cup vs history" panel.
- [ ] **Stage J (round 2) — polish over the NEW G/H/I features.** Repeat the audit on the added sections (a11y/responsive/perf, Lighthouse, EN/PT review) + bump `DATA_VERSION` for the new data files + README refresh.
---