diff --git a/docs/INDEX.md b/docs/INDEX.md index 599e83c..17e34ae 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -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 diff --git a/docs/plans/zustand-workspace-store-implementation.md b/docs/plans/zustand-workspace-store-implementation.md index d22a731..78de9e2 100644 --- a/docs/plans/zustand-workspace-store-implementation.md +++ b/docs/plans/zustand-workspace-store-implementation.md @@ -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