janpeter/Scrum4Me
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(PBI-74): update Story 9 status in implementatieplan (T-884)

Browse source 
- Frontmatter: ready-to-execute → in-progress; revision 1 → 2;
  last_updated 2026-05-09 → 2026-05-10
- Stories-tabel: kolom Status toegevoegd (Stories 1-8 DONE via PR #180,
  Story 9 met T-884 op review)
- §Story 9: per-taak status + acceptatie-checklist voor T-884 manuele
  staging-checks
- Aanbeveling-blokje: noteert dat Story 9 vroeger gestart is dan het
  ontwerpdoc adviseerde
This commit is contained in:
Janpeter Visser 2026-05-10 06:50:11 +02:00
parent d3eb1a193d
commit 66c30fc49c
2 changed files with 32 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/INDEX.md
View file

@ -62,7 +62,7 @@ Auto-generated on 2026-05-10 from front-matter and headings.
| [Tweede Claude Agent — Planning Agent](./plans/tweede-claude-agent-planning.md) | proposal | 2026-05-03 |
| [Scrum4Me — v1.0 readiness](./plans/v1-readiness.md) | active | 2026-05-04 |
| [Zustand store rearchitecture - active context, realtime en resync](./plans/zustand-store-rearchitecture.md) | ready-to-execute | 2026-05-09 |
| [Zustand workspace-store implementatieplan (PBI-74)](./plans/zustand-workspace-store-implementation.md) | ready-to-execute | 2026-05-09 |
| [Zustand workspace-store implementatieplan (PBI-74)](./plans/zustand-workspace-store-implementation.md) | in-progress | 2026-05-10 |
### Archive

48
docs/plans/zustand-workspace-store-implementation.md
View file

@ -1,10 +1,10 @@
---
title: "Zustand workspace-store implementatieplan (PBI-74)"
status: ready-to-execute
status: in-progress
audience: [maintainer, contributor, ai-agent]
language: nl
last_updated: 2026-05-09
revision: 1
last_updated: 2026-05-10
revision: 2
---
# Zustand workspace-store implementatieplan
@ -13,7 +13,9 @@ PBI in Scrum4Me-MCP: **PBI-74** — _Zustand store rearchitecture — product- e
Bron-ontwerp (architectuur en gotchas): [zustand-store-rearchitecture.md](./zustand-store-rearchitecture.md) revisie 3.
Dit document koppelt de stories en taken in MCP aan de implementatie. Per story acceptatiecriteria; per taak een concrete deliverable. Alle items staan in MCP op `OPEN`/`TO_DO`. Geen executie tot expliciete trigger ("voer Story 1 uit").
Dit document koppelt de stories en taken in MCP aan de implementatie. Per story acceptatiecriteria; per taak een concrete deliverable.
**Status (2026-05-10):** Stories 1-8 merged via PR #180 (product-workspace-store productie). Story 9 (sprint-workspace-store) uitgevoerd op `feat/sprint-workspace-store` — automatische verify+build groen, manuele E2E-staging-checks van T-884 nog te doen voor merge.
## Context
@ -38,17 +40,17 @@ De rearchitecture lost dit op via één `product-workspace-store` (en analoog `s
## Stories en taken
| # | Story | MCP | Taken |
|---|---|---|---|
| 1 | Skelet + test-infrastructuur | [ST-1318](./zustand-store-rearchitecture.md) | T-837 … T-843 (7) |
| 2 | Hydratie overstappen (parallel-running) | ST-1319 | T-844 … T-847 (4) |
| 3 | Componenten omzetten naar workspace-store | ST-1320 | T-848 … T-855 (8) |
| 4 | Race-safe loaders en restore-hints | ST-1321 | T-856 … T-860 (5) |
| 5 | Hidden-tab + reconnect resync (één PR) | ST-1322 | T-861 … T-864 (4) |
| 6 | Unknown-event fallback | ST-1323 | T-865 … T-867 (3) |
| 7 | Cache-headers en read-routes | ST-1324 | T-868 … T-871 (4) |
| 8 | Oude stores opruimen | ST-1325 | T-872 … T-878 (7) |
| 9 | Sprint-workspace-store | ST-1326 | T-879 … T-884 (6) |
| # | Story | MCP | Taken | Status |
|---|---|---|---|---|
| 1 | Skelet + test-infrastructuur | ST-1318 | T-837 … T-843 (7) | DONE (PR #180) |
| 2 | Hydratie overstappen (parallel-running) | ST-1319 | T-844 … T-847 (4) | DONE (PR #180) |
| 3 | Componenten omzetten naar workspace-store | ST-1320 | T-848 … T-855 (8) | DONE (PR #180) |
| 4 | Race-safe loaders en restore-hints | ST-1321 | T-856 … T-860 (5) | DONE (PR #180) |
| 5 | Hidden-tab + reconnect resync (één PR) | ST-1322 | T-861 … T-864 (4) | DONE (PR #180) |
| 6 | Unknown-event fallback | ST-1323 | T-865 … T-867 (3) | DONE (PR #180) |
| 7 | Cache-headers en read-routes | ST-1324 | T-868 … T-871 (4) | DONE (PR #180) |
| 8 | Oude stores opruimen | ST-1325 | T-872 … T-878 (7) | DONE (PR #180) |
| 9 | Sprint-workspace-store | ST-1326 | T-879 … T-884 (6) | T-879…T-883 DONE; T-884 review |
Totaal: 48 taken.
@ -124,9 +126,21 @@ Totaal: 48 taken.
**Doel:** zelfde patroon op sprint-workflow toegepast.
**Taken:** T-879 (skelet), T-880 (hydratie+realtime), T-881 (componenten), T-882 (race-safe + restore + resync + unknown-event in één keer), T-883 (cleanup oude sprint-state), T-884 (E2E sprint-board verificatie).
**Taken:**
- **T-879 — Skelet** (DONE): `stores/sprint-workspace/{types,store,selectors,restore}.ts` + 45 unit-tests groen. Mirrort product-workspace blueprint met sprint-specifieke aanpassingen (sprintIdsByProduct, storyIdsBySprint, sprint-story-membership semantiek).
- **T-880 — Hydratie + realtime** (DONE): `app/api/realtime/sprint/route.ts` SSE-endpoint, `lib/realtime/use-sprint-realtime.ts`, `lib/realtime/use-sprint-workspace-resync.ts`, `components/sprint/sprint-hydration-wrapper.tsx`. Wrapper hydreert via fingerprint-check; SSE blijft open op hidden, ready-cycle triggert reconnect-resync.
- **T-881 — Componenten** (DONE): TaskList, SprintBacklogLeft, SprintBoardClient lezen via selectors uit `useSprintWorkspaceStore` met `useShallow`. DnD via `applyOptimisticMutation('sprint-story-order' | 'sprint-task-order')` met settle/rollback; add/remove via direct setState met manuele snapshot-rollback.
- **T-882 — Race-safe + restore + resync + unknown-event + read-routes** (DONE): `GET /api/products/[id]/sprints` en `GET /api/sprints/[id]/workspace` toegevoegd; activeRequestId-guard + restore-flow + useSprintWorkspaceResync + isUnknownEntityEvent waren al geïmplementeerd in T-879/T-880.
- **T-883 — Cleanup** (DONE): `stores/sprint-store.ts` verwijderd. Grep `useSprintStore` = 0. Verify (671 tests) + build groen.
- **T-884 — E2E sprint-board verificatie** (REVIEW — manuele staging-checks):
- [ ] Cold reload → laatste sprint hersteld
- [ ] Tab hidden > 30s + terug → resync
- [ ] Netwerk uit/aan → reconnect + resync
- [ ] DnD reorder → optimistic UI; SSE-echo idempotent
- [ ] DB UPDATE story zonder delta → unknown-event resync binnen 1 cycle
- [ ] Twee tabs open → mutatie zichtbaar in beide binnen ~2s
> **Aanbeveling per ontwerpdoc:** start Story 9 pas nadat product-workspace enkele weken stabiel in productie staat. PBI-74 sluit pas wanneer Story 9 ook merged is.
> **Aanbeveling per ontwerpdoc:** Story 9 was bedoeld om pas te starten nadat product-workspace enkele weken stabiel in productie staat. PR #180 merged 2026-05-10; Story 9 vervolgens diezelfde dag uitgevoerd op gebruikersverzoek. Stabiliteit van product-workspace + impact van Story 9 op sprint-workflow nog te observeren in staging/productie.
## Critical files