Scrum4Me/docs/plans/ST-1109-pbi-status.md

Plan — ST-1109 · PBI krijgt een status (Ready / Blocked / Done)

Spiegel van het goedgekeurde plan dat tijdens de sessie is opgesteld in ~/.claude/plans/welke-rioriteiten-heeft-een-mighty-shell.md. Vastgelegd in deze repo per project-conventie (zie MEMORY.md → feedback_plan_location).

Context

PBI's hadden alleen priority en sort_order; Story en Task hebben wél een status. Dit maakte het onmogelijk om in de Product Backlog te zien welke PBI's klaar staan, geblokkeerd zijn of al afgerond. Een derde filter naast prioriteit + sortering zou de bestaande UI te druk maken.

Sprint-goal: "Beter overzicht van openstaande PBI's" Story: als teamlid wil filteren op status van een PBI

Doelen

1. Nieuwe enum PbiStatus { READY BLOCKED DONE }, default READY
2. Status zichtbaar als badge in de Product Backlog cards
3. Status manueel te zetten via PBI-dialog (alle drie de waarden)
4. Auto-cascade: bij sprint-close → als alle stories van een PBI DONE zijn, PBI naar DONE (alleen-promote)
5. Filter-UI consolideren in één shadcn Popover (priority + status + sort)

Stappen (één commit per laag)

ST-code	Laag	Bestand(en)
ST-1109.2	DB	prisma/schema.prisma + migration
ST-1109.3	API mappers	lib/task-status.ts
ST-1109.4	Server actions	actions/pbis.ts
ST-1109.5	Sprint-close cascade	actions/sprints.ts
ST-1109.6	UI primitive	components/ui/popover.tsx (NIEUW)
ST-1109.7	Dialog	components/backlog/pbi-dialog.tsx + components/shared/pbi-status-select.tsx
ST-1109.8	Backlog UI	components/backlog/pbi-list.tsx + app/(app)/products/[id]/page.tsx
ST-1109.9	Tests	__tests__/lib/task-status.test.ts + __tests__/actions/sprints-cascade.test.ts
ST-1109.10	Docs	architecture, styling, plan-mirror

Detail-implementatieplannen staan op de individuele MCP-tasks (mcp__scrum4me__get_claude_context).

Cascade-regel (definitief)

// In completeSprintAction's prisma.$transaction([...])
const candidatePbis = await prisma.pbi.findMany({
  where: { id: { in: affectedPbiIds }, status: { not: 'DONE' } },
  select: { id: true, stories: { select: { id: true, status: true } } },
})
const decisionByStoryId = new Map(entries) // entries = Object.entries(decisions)
const pbiIdsToMarkDone = candidatePbis
  .filter(pbi =>
    pbi.stories.length > 0 &&
    pbi.stories.every(s => (decisionByStoryId.get(s.id) ?? s.status) === 'DONE')
  )
  .map(p => p.id)

Regels:

• Promote-only: een PBI op DONE wordt nooit automatisch teruggezet
• 0-story PBI's blijven READY (ondanks dat [].every(...) === true)
• Stories buiten de Sprint worden meegerekend op hun huidige DB-status — een open PBL-story blokkeert de cascade

Branch + PR

• Branch: feat/M12-pbi-status
• Push + PR pas na handmatige test door gebruiker (per Branch & PR Strategy)
• Verwachte commits: 9× feat/test/docs(ST-1109.x)

Opvolgactie buiten deze repo

madhura68/scrum4me-mcp: de create_pbi tool kan straks optioneel status accepteren. Submodule (vendor/scrum4me) moet gesynced worden na merge zodat de drift-bewaking maandag groen blijft.

Verificatie (end-to-end)

1. npm run lint && npm test && npm run build — alles groen
2. npm run dev (port 3000)
3. Maak nieuwe PBI → status default "Klaar voor sprint" (READY)
4. Edit PBI → wijzig status naar "Geblokkeerd" → save → herlaad → badge toont oranje
5. Sprint met PBI + 2 stories → close met beide DONE → PBI auto-DONE
6. Idem maar 1 story OPEN → PBI blijft READY
7. Filter-popover: open → status=Geblokkeerd → alleen blocked PBIs zichtbaar; (n)-badge klopt; "Wis filters" reset
8. Demo-user: status-velden zijn read-only / save geblokkeerd