feat(usage): hele ideeproces per idee — sprintkoppeling, fasefilter, overhead (IDEA-260) #167

Merged
janpeter merged 10 commits from claude/usage-per-idea-eb5fe0 into main 2026-10-14 20:26:55 +02:00
Owner

Wat

Het hele ideeproces per idee in de idee-focus van /usage/scrum (IDEA-260, PBI-45, sprint S-2026-10-14-1).

  • Afgeleide sprintkoppeling in de leeslaag (idea_sprint_links, sprint_owner, idea_facts). Bronnen: build_sprint_id, pbi_id → taken, en sprint_id/pbi_id uit de metadata van de idee-logs.
    • De rang gaat vóór de leeftijd: een kolomkoppeling vóór een logkoppeling, daarna het oudste idee.
    • De hele sprint telt mee voor het idee. Een expliciete idea_id wint.
  • Fasefilter: een klik op een segment (ook Overig) zet ?phase=, en nogmaals klikken of de chip-× wist hem.
    • De niet-gekozen segmenten worden gedimd.
    • Een ander idee of de schakelaar Ideeën/Sprints of Status wist de fase.
  • Feitentabel (IdeaFactsTable, vervangt de jobtabel): één rij per job of sessiesegment, "≥ $x" bij een deels geprijsde rij, maximaal 200.
    • Zonder fase: alle fases behalve Sprint, met de Takentabel eronder.
    • Fase Sprint: alleen de Takentabel.
  • Regels "Sprints: …" en "Overhead: X (y % van dit idee) · Sprintoverhead · Overig", met de ondergrenzen van PBI-36 in USD.
  • Handleiding: MANUAL page-usage-scrum rev 5 en docs/pages/usage.md.

Plan: docs/superpowers/plans/2026-10-14-idea-260-usage-per-idee.md. Review-record: docs/reviews/2026-10-14-idea-260-plan-review-record.md (GO na 2 rondes).

Verificatie

  • npm run verify is lokaal groen: lint, typecheck en 2767 tests.
  • De real-DB-suite wordt in CI overgeslagen (USAGE_TEST_DATABASE_URL ontbreekt daar). Lokaal draaide hij 23/23 tegen Postgres 17 (web-provision --stage chain), met de IDEA-260-fixtures:
    • pbi- en logkoppeling, gedeelde sprint en rang;
    • Takentabel, de Σ-invarianten, overhead en de feitentabel.
  • Browserproef lokaal op geseede data in de vorm van IDEA-257, niet op productie. De proef op het echte IDEA-257 volgt na de deploy.
    • Zonder fase: Σ feiten 9,29M + Σ taken 36,7M = idee 45,99M. Overhead 8,0M (17,4 %).
    • Klik op Plan: 2 rijen = het segment (4,28M), met "≥ US$ 20,50" bij de deels geprijsde sessie.
    • Klik op Sprint: alleen de Takentabel.
    • De chip-× wist de fase. In USD staat er "(…, ondergrenzen)".
    • Op 1440 en 375 px geen horizontale paginascroll en geen consolefouten.
  • Productiemeting (scrum4me-ro): fetchItemShares 194 ms, fetchIdeaPhases 107 ms, fetchIdeaFacts 65 ms, fetchIdeaTasks 106 ms.

Afwijking van het plan

De bij review-bevinding CL-m3 aanvaarde fixture "expliciet idee ≠ eigenaar" kan niet in het schema:

  • usage_segments_scope_check: een sessie met idea_id heeft geen sprint.
  • claude_jobs_kind_id_consistency: een SYSTEM-job heeft óf een taak óf een idee.

Het C-M1-pad (idea_sprint bij een expliciete idea_id) kan dus niet optreden. De reparatie blijft staan als verdediging. Dit staat vastgelegd in het review-record.

Screenshots (lokale proefdata)

1-geen-fase

1-geen-fase

2-fase-plan

2-fase-plan

3-fase-sprint

3-fase-sprint

4-mobiel-sprint

4-mobiel-sprint

Upstream: ISS-17 (MCP create_pbi/create_sprint leggen idea_id vast) loopt apart. Tot dan voeden de ceremonie-logs de koppeling.

Geen migraties. JP merget; deploy alleen op aparte opdracht.

🤖 Generated with Claude Code

## Wat Het hele ideeproces per idee in de idee-focus van `/usage/scrum` (IDEA-260, PBI-45, sprint S-2026-10-14-1). - **Afgeleide sprintkoppeling** in de leeslaag (`idea_sprint_links`, `sprint_owner`, `idea_facts`). Bronnen: `build_sprint_id`, `pbi_id` → taken, en `sprint_id`/`pbi_id` uit de metadata van de idee-logs. - De rang gaat vóór de leeftijd: een kolomkoppeling vóór een logkoppeling, daarna het oudste idee. - De hele sprint telt mee voor het idee. Een expliciete `idea_id` wint. - **Fasefilter:** een klik op een segment (ook Overig) zet `?phase=`, en nogmaals klikken of de chip-× wist hem. - De niet-gekozen segmenten worden gedimd. - Een ander idee of de schakelaar Ideeën/Sprints of Status wist de fase. - **Feitentabel** (`IdeaFactsTable`, vervangt de jobtabel): één rij per job of sessiesegment, "≥ $x" bij een deels geprijsde rij, maximaal 200. - Zonder fase: alle fases behalve Sprint, met de Takentabel eronder. - Fase Sprint: alleen de Takentabel. - **Regels** "Sprints: …" en "Overhead: X (y % van dit idee) · Sprintoverhead · Overig", met de ondergrenzen van PBI-36 in USD. - **Handleiding:** MANUAL `page-usage-scrum` rev 5 en `docs/pages/usage.md`. Plan: `docs/superpowers/plans/2026-10-14-idea-260-usage-per-idee.md`. Review-record: `docs/reviews/2026-10-14-idea-260-plan-review-record.md` (GO na 2 rondes). ## Verificatie - `npm run verify` is lokaal groen: lint, typecheck en 2767 tests. - **De real-DB-suite wordt in CI overgeslagen** (`USAGE_TEST_DATABASE_URL` ontbreekt daar). Lokaal draaide hij 23/23 tegen Postgres 17 (web-provision `--stage chain`), met de IDEA-260-fixtures: - pbi- en logkoppeling, gedeelde sprint en rang; - Takentabel, de Σ-invarianten, overhead en de feitentabel. - **Browserproef lokaal op *geseede* data in de vorm van IDEA-257, niet op productie.** De proef op het echte IDEA-257 volgt na de deploy. - Zonder fase: Σ feiten 9,29M + Σ taken 36,7M = idee 45,99M. Overhead 8,0M (17,4 %). - Klik op Plan: 2 rijen = het segment (4,28M), met "≥ US$ 20,50" bij de deels geprijsde sessie. - Klik op Sprint: alleen de Takentabel. - De chip-× wist de fase. In USD staat er "(…, ondergrenzen)". - Op 1440 en 375 px geen horizontale paginascroll en geen consolefouten. - **Productiemeting** (`scrum4me-ro`): fetchItemShares 194 ms, fetchIdeaPhases 107 ms, fetchIdeaFacts 65 ms, fetchIdeaTasks 106 ms. ## Afwijking van het plan De bij review-bevinding CL-m3 aanvaarde fixture "expliciet idee ≠ eigenaar" kan niet in het schema: - `usage_segments_scope_check`: een sessie met `idea_id` heeft geen sprint. - `claude_jobs_kind_id_consistency`: een SYSTEM-job heeft óf een taak óf een idee. Het C-M1-pad (`idea_sprint` bij een expliciete `idea_id`) kan dus niet optreden. De reparatie blijft staan als verdediging. Dit staat vastgelegd in het review-record. ## Screenshots (lokale proefdata) **1-geen-fase** ![1-geen-fase](https://git.jp-visser.nl/attachments/7e3c67d2-1380-43c6-b720-26483c8c0f6b) **2-fase-plan** ![2-fase-plan](https://git.jp-visser.nl/attachments/30f51998-b824-4e25-84ff-01712ddcd9eb) **3-fase-sprint** ![3-fase-sprint](https://git.jp-visser.nl/attachments/6a770ce2-a6b4-4dc9-a713-932e012cddb2) **4-mobiel-sprint** ![4-mobiel-sprint](https://git.jp-visser.nl/attachments/6285f651-802c-4b42-8898-43fb028dc120) Upstream: ISS-17 (MCP `create_pbi`/`create_sprint` leggen `idea_id` vast) loopt apart. Tot dan voeden de ceremonie-logs de koppeling. Geen migraties. JP merget; deploy alleen op aparte opdracht. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Afgeleide sprintkoppeling, fasefilter met feitentabel, Takentabel bij het
idee en overheadaandeel; concept ter beslissing JP.

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>
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>
Een idee telt nu ook het verbruik van zijn sprint(s) mee zonder build_sprint_id:
de koppeling komt uit build_sprint_id, pbi_id → taken en sprint_id/pbi_id in de
idee-log-metadata. Per sprint één eigenaar (kolomkoppeling vóór log, dan oudste
idee); een expliciete idea_id wint. fetchIdeaPhases levert overhead en sprints,
fetchIdeaFacts de sessies (per segment) en jobs per fase, fetchIdeaTasks de taken
van de eigen sprints. fetchIdeaJobs blijft tot T-264.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- phase in Filters/URL; alleen bij entity=ideas met focus, anders genegeerd met waarschuwing
- fasetaart: elk segment (ook Overig) zet/wist de fase, overige segmenten gedimd; chip "Fase: X ×"
- IdeaFactsTable vervangt IdeaJobsTable: sessies + jobs, "≥ $x" bij deels geprijsd, 200 van N
- zonder fase feiten buiten de sprint + Takentabel; fase Sprint alleen de Takentabel
- regels "Sprints: …" en "Overhead: … (x % van dit idee)" met PBI-36-ondergrenzen
- fetchIdeaJobs/IdeaJobRow weg; IDEA-251 real-DB-tests omgezet naar fetchIdeaFacts (bron job)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(review): IDEA-260 constraint-bevinding bij CL-m3 vastgelegd
All checks were successful
CI / Verify (pull_request) Successful in 4m44s
c7ad095d89
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

plan gekoppeld via pbi — IDEA-260 / PBI-45.

Findings

  • LOW (niet blokkerend) — app/(app)/usage/scrum/page.tsx:246: na het kiezen van een fase en wisselen naar een periode of bron zonder verbruik wordt missing waar en verdwijnt de fasechip, terwijl phase in de URL blijft. Daardoor ontbreekt de × om het filter te wissen en wordt het filter bij terugwisselen ongemerkt weer actief. Het plan en MANUAL page-usage-scrum verlangen dat de chip bij een ontbrekend segment zichtbaar blijft. Laat de chip bij een bestaand idee onafhankelijk van lege slices zien en dek deze overgang met een paginatest af.

De vier koppelroutes, rangorde, expliciete ideevoorrang, gedeelde query-/fasepatronen, read-only begrenzing, tabellen en handleiding sluiten verder aan op het plan en de productstandaarden. Geen blokkerende bevindingen. De PR beschrijft de schema-beperking rond de fixture expliciet idee ≠ eigenaar en stelt de proef op het echte IDEA-257 expliciet uit tot na deployment.

Verificatie op head c7ad095d895b4a154e5fe7e4344249e95bf6aa34: npm run verify geslaagd; lint zonder fouten (één bestaande waarschuwing buiten de diff), typecheck geslaagd, 217 testbestanden geslaagd; 2767 tests geslaagd en 66 overgeslagen. Daaronder zijn de 23 Scrum Usage-real-DB-tests: USAGE_TEST_DATABASE_URL is hier niet ingesteld. Het in de PR genoemde lokale database-/browserbewijs is niet zelfstandig herhaald.

# COMMENT plan gekoppeld via pbi — IDEA-260 / PBI-45. ## Findings - **LOW (niet blokkerend)** — `app/(app)/usage/scrum/page.tsx:246`: na het kiezen van een fase en wisselen naar een periode of bron zonder verbruik wordt `missing` waar en verdwijnt de fasechip, terwijl `phase` in de URL blijft. Daardoor ontbreekt de × om het filter te wissen en wordt het filter bij terugwisselen ongemerkt weer actief. Het plan en MANUAL `page-usage-scrum` verlangen dat de chip bij een ontbrekend segment zichtbaar blijft. Laat de chip bij een bestaand idee onafhankelijk van lege slices zien en dek deze overgang met een paginatest af. De vier koppelroutes, rangorde, expliciete ideevoorrang, gedeelde query-/fasepatronen, read-only begrenzing, tabellen en handleiding sluiten verder aan op het plan en de productstandaarden. Geen blokkerende bevindingen. De PR beschrijft de schema-beperking rond de fixture expliciet idee ≠ eigenaar en stelt de proef op het echte IDEA-257 expliciet uit tot na deployment. Verificatie op head `c7ad095d895b4a154e5fe7e4344249e95bf6aa34`: `npm run verify` geslaagd; lint zonder fouten (één bestaande waarschuwing buiten de diff), typecheck geslaagd, 217 testbestanden geslaagd; 2767 tests geslaagd en 66 overgeslagen. Daaronder zijn de 23 Scrum Usage-real-DB-tests: `USAGE_TEST_DATABASE_URL` is hier niet ingesteld. Het in de PR genoemde lokale database-/browserbewijs is niet zelfstandig herhaald.
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!167
No description provided.