Scrum Usage in workers: /usage/scrum en Usage-menu (IDEA-248) #158

Merged
janpeter merged 5 commits from claude/usage-workers-plan into main 2026-10-12 19:51:14 +02:00
Owner

Scrum Usage draait nu als pagina in workers: /usage/scrum, bereikbaar via het menu Usage → Scrum Usage (sprint S-2026-10-12-3, T-249 + T-250, IDEA-248). Inbouwplan: docs/superpowers/plans/2026-10-12-scrum-usage-workers-inbouw.md (akkoord JP).

Wat zit erin

  • Rekenkern en queries (lib/usage/scrum/, T-249): read-only via Prisma in een RepeatableRead-snapshot met statement_timeout van 12 s. Prijzen komen uit de gedeelde prijsjoin (@shared/usage-sql, PBI-36: API-lijstprijs, geen prijsrij = geen bedrag, nooit 0). Sessies tellen alleen voor de kijker, zoals Usage v1; jobs tellen allemaal. Alle SQL loopt via Prisma.sql.

  • Pagina en componenten (app/(app)/usage/scrum, components/usage/scrum, T-250):

    • staaf per dag of week, met een tooltip per provider en model;
    • taart per idee of per sprint, met inzoomen op de fases van een idee of op PBI/story/taak van een sprint;
    • eenheid tokens of USD.

    Bij een time-out of een onbereikbare database toont de pagina een eigen melding in plaats van een foutpagina.

  • Menu: Usage wordt een uitklapmenu met Overzicht (/usage) en Scrum Usage (/usage/scrum).

  • Styling: de Vis-grafiektokens staan in app/styles/usage-viz.css. theme.css is niet gewijzigd. Er zijn geen ruwe paletklassen of hex in .ts/.tsx en er is geen ember in de grafieken.

  • Dependency: recharts ^3.10.1.

Verificatie

  • npm run verify is groen: 2722 tests geslaagd, 53 overgeslagen.
  • De real-DB-test draait niet in CI. __tests__/lib/usage/scrum/queries-realdb.test.ts (10 tests) wordt daar overgeslagen, omdat hij USAGE_TEST_DATABASE_URL nodig heeft. Lokaal slaagde hij tegen een wegwerp-postgres:17.
    • Het schema kwam uit prisma migrate diff --from-empty.
    • De test gebruikt een eigen clustercheck, omdat assertUsageTestCluster een _prisma_migrations-tabel vereist.
    • Gedekt worden de Σ-invarianten, de kijkerscope, NULL zonder prijs, de drie niveaus, read-only plus 12 s, het time-outpad, en SQL tegen TS over dezelfde VALUES.
  • Browsercheck lokaal tegen geseede testdata:
    • menu, filters, tooltip, inzoomen op idee- en sprintniveau;
    • USD-sommen kloppen: per story opgeteld is gelijk aan het sprinttotaal, en gekoppeld plus ongekoppeld is gelijk aan het staaftotaal;
    • een onbekende focus en een onbekende eenheid geven een nette melding;
    • op 375 px is er geen horizontale scroll;
    • met de database uit verschijnt "Database niet bereikbaar".

Open na merge

  • Praktijkproef op productie door JP: vergelijk één week met het prototype.
  • Increment 2 (het prototype opruimen) volgt alleen op een nieuwe opdracht.

🤖 Generated with Claude Code

Scrum Usage draait nu als pagina in workers: `/usage/scrum`, bereikbaar via het menu **Usage → Scrum Usage** (sprint S-2026-10-12-3, T-249 + T-250, IDEA-248). Inbouwplan: `docs/superpowers/plans/2026-10-12-scrum-usage-workers-inbouw.md` (akkoord JP). ## Wat zit erin - **Rekenkern en queries** (`lib/usage/scrum/`, T-249): read-only via Prisma in een `RepeatableRead`-snapshot met `statement_timeout` van 12 s. Prijzen komen uit de gedeelde prijsjoin (`@shared/usage-sql`, PBI-36: API-lijstprijs, geen prijsrij = geen bedrag, nooit 0). Sessies tellen alleen voor de kijker, zoals Usage v1; jobs tellen allemaal. Alle SQL loopt via `Prisma.sql`. - **Pagina en componenten** (`app/(app)/usage/scrum`, `components/usage/scrum`, T-250): - staaf per dag of week, met een tooltip per provider en model; - taart per idee of per sprint, met inzoomen op de fases van een idee of op PBI/story/taak van een sprint; - eenheid tokens of USD. Bij een time-out of een onbereikbare database toont de pagina een eigen melding in plaats van een foutpagina. - **Menu:** Usage wordt een uitklapmenu met Overzicht (`/usage`) en Scrum Usage (`/usage/scrum`). - **Styling:** de Vis-grafiektokens staan in `app/styles/usage-viz.css`. `theme.css` is niet gewijzigd. Er zijn geen ruwe paletklassen of hex in .ts/.tsx en er is geen ember in de grafieken. - **Dependency:** `recharts` ^3.10.1. ## Verificatie - `npm run verify` is groen: 2722 tests geslaagd, 53 overgeslagen. - **De real-DB-test draait niet in CI.** `__tests__/lib/usage/scrum/queries-realdb.test.ts` (10 tests) wordt daar overgeslagen, omdat hij `USAGE_TEST_DATABASE_URL` nodig heeft. Lokaal slaagde hij tegen een wegwerp-postgres:17. - Het schema kwam uit `prisma migrate diff --from-empty`. - De test gebruikt een eigen clustercheck, omdat `assertUsageTestCluster` een `_prisma_migrations`-tabel vereist. - Gedekt worden de Σ-invarianten, de kijkerscope, NULL zonder prijs, de drie niveaus, read-only plus 12 s, het time-outpad, en SQL tegen TS over dezelfde VALUES. - **Browsercheck** lokaal tegen geseede testdata: - menu, filters, tooltip, inzoomen op idee- en sprintniveau; - USD-sommen kloppen: per story opgeteld is gelijk aan het sprinttotaal, en gekoppeld plus ongekoppeld is gelijk aan het staaftotaal; - een onbekende focus en een onbekende eenheid geven een nette melding; - op 375 px is er geen horizontale scroll; - met de database uit verschijnt "Database niet bereikbaar". ## Open na merge - Praktijkproef op productie door JP: vergelijk één week met het prototype. - Increment 2 (het prototype opruimen) volgt alleen op een nieuwe opdracht. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
De Scrum Usage-rekenkern uit het prototype staat nu in lib/usage/scrum:
filters, tijd, fases, taart- en staafdata ongewijzigd (zonder theme), de
usage_facts-CTE en de taartqueries als Prisma.sql binnen de read-only
snapshot van Usage v1 met statement_timeout 12s. Prijzen komen uit de
gedeelde listPriceJoinSqlText (runtime-cast naar AgentRuntime); sessies
tellen alleen voor de kijker, zoals Usage v1.

classifyUsageDbError volgt een proef tegen Postgres 17 via PrismaPg:
57014 komt binnen als P2010, een verlopen transactie als P2028, een
onbereikbare database als P1001. De real-DB-test zaait een kleine set en
bewijst Σ taart + niet gekoppeld = Σ staaf, het inzoomen, de kijkerscope,
NULL zonder prijs en SQL = TS over VALUES.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(usage-scrum): pagina /usage/scrum en Usage-menu in workers (T-250, IDEA-248)
All checks were successful
CI / Verify (pull_request) Successful in 2m22s
82ed746a95
De Scrum Usage-pagina draait nu in de workers-app op de Prisma-queries uit
T-249: staafdiagram per dag/week, taart per idee of sprint met inzoomen op
fases en op PBI/story/taak, eenheid tokens of USD (API-lijstprijs). Een
time-out of onbereikbare database geeft een eigen melding in plaats van een
foutpagina.

Het menu Usage wordt een uitklapmenu met Overzicht (/usage) en Scrum Usage
(/usage/scrum). De Vis-grafiektokens staan in app/styles/usage-viz.css, zodat
theme.css byte-identiek aan Scrum4Me blijft. Nieuwe dependency: recharts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

APPROVED

Findings:

  • Geen blokkerende of overige concrete findings gevonden.

Plan gekoppeld via pr_refs: T-249, T-250 en docs/superpowers/plans/2026-10-12-scrum-usage-workers-inbouw.md (ST-077). Er zijn geen planonderdelen weggelaten uit de review-invoer. De diff is conform de scope van increment 1: Prisma.sql in read-only snapshots, gedeelde API-lijstprijzen, eigen sessies en alle jobs, admin-guard, URL-filters, grafieken, inzoomen en Usage-menu. Styling volgt de Vis-tokens; theme.css blijft ongewijzigd. De productievergelijking en prototype-opruiming zijn expliciet vervolgwerk.

Verificatie op commit 82ed746a9598837aa95cc7790831593eae08aad3: npm run verify geslaagd (2722 tests geslaagd, 53 overgeslagen). Aanvullend alle 61 Scrum Usage-tests geslaagd, inclusief 10 real-DB-tests tegen een geïsoleerde lokale Postgres 17 met het schema van deze commit. Deze bewijzen totalen, kijkerscope, ongeprijsd/HARNESS, niveaus en statement-time-out. Verbindingsweigering en verlopen Prisma-transactie afzonderlijk bevestigd als P1001 en P2028. Geen eigen browserproef of productievergelijking uitgevoerd; de PR beschrijft lokaal browserbewijs.

# APPROVED Findings: - Geen blokkerende of overige concrete findings gevonden. Plan gekoppeld via pr_refs: T-249, T-250 en `docs/superpowers/plans/2026-10-12-scrum-usage-workers-inbouw.md` (ST-077). Er zijn geen planonderdelen weggelaten uit de review-invoer. De diff is conform de scope van increment 1: Prisma.sql in read-only snapshots, gedeelde API-lijstprijzen, eigen sessies en alle jobs, admin-guard, URL-filters, grafieken, inzoomen en Usage-menu. Styling volgt de Vis-tokens; theme.css blijft ongewijzigd. De productievergelijking en prototype-opruiming zijn expliciet vervolgwerk. Verificatie op commit `82ed746a9598837aa95cc7790831593eae08aad3`: `npm run verify` geslaagd (2722 tests geslaagd, 53 overgeslagen). Aanvullend alle 61 Scrum Usage-tests geslaagd, inclusief 10 real-DB-tests tegen een geïsoleerde lokale Postgres 17 met het schema van deze commit. Deze bewijzen totalen, kijkerscope, ongeprijsd/HARNESS, niveaus en statement-time-out. Verbindingsweigering en verlopen Prisma-transactie afzonderlijk bevestigd als P1001 en P2028. Geen eigen browserproef of productievergelijking uitgevoerd; de PR beschrijft lokaal browserbewijs.
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-workers!158
No description provided.