janpeter/Scrum4Me
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Scrum4Me/docs/plans/zustand-workspace-store-implementation.md
Janpeter Visser 5df04feb11
feat(PBI-74): Zustand product-workspace rearchitecture (Stories 1-8) (#180) 
* feat(PBI-74): product-workspace store skelet + test-infra (Story 1)

Skelet voor de nieuwe `product-workspace-store` die op termijn de gefragmenteerde
`backlog-store`/`planner-store`/`selection-store`/`product-store` vervangt. Deze
PR levert alleen het skelet + tests; UI-consumers worden in latere stories
omgezet.

- vitest naar jsdom + tests/setup.ts (MemoryStorage, default fetch-stub) — G6/G8
- stores/product-workspace/{types,store,selectors,restore}.ts — immer-middleware,
  alle slices en acties (hydrate, setActive*, ensure*Loaded met activeRequestId-
  guard, applyRealtimeEvent, resyncActiveScopes/loadedScopes, optimistic
  mutations). Restore-wiring in setters volgt in Story 4 (T-857/T-858).
- selectors gebruiken module-level EMPTY refs (G1) en documenteren useShallow-
  vereiste (G2)
- 34 nieuwe unit-tests dekken §Testing setup-checklist uit het ontwerp:
  hydrateSnapshot, selection-cascade, applyRealtimeEvent (I/U/D + parent-move +
  ander-product + unknown-entity → resync), delete-cleanup, race-safe loaders,
  ensureTaskLoaded _detail-flag, resyncActiveScopes ensure-keten, restore-hints
  read/write/clear, optimistic mutation rollback/settle/SSE-echo idempotent
- docs/api/rest-contract.md: audit-sectie met de vier ontbrekende
  ensure*Loaded-endpoints (worden toegevoegd in Story 7 / T-870)

Refs: PBI-74, ST-1318, T-837..T-843
Bron-ontwerp: docs/plans/zustand-store-rearchitecture.md
Implementatieplan: docs/plans/zustand-workspace-store-implementation.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): dual-dispatch hydratie + realtime naar workspace-store (Story 2)

Story 2 — schaduw-fase: BacklogHydrationWrapper en useBacklogRealtime voeden
nu ook de nieuwe product-workspace-store, terwijl de oude useBacklogStore /
useProductStore leidend blijft voor componenten. Story 3 verschuift consumers
één voor één; Story 8 ruimt de oude stores op.

- T-844: BacklogHydrationWrapper roept naast useBacklogStore.setInitialData
  ook useProductWorkspaceStore.hydrateSnapshot aan. Productname-prop optioneel
  toegevoegd voor activeProduct-context.
- T-845: useBacklogRealtime onmessage dispatcht events naar zowel oude store
  (applyChange) als nieuwe store (applyRealtimeEvent). Geen wijziging aan
  reconnect/visibility — Story 5.
- T-846: dev-only logWorkspaceFingerprint helper vergelijkt counts tussen
  oude en nieuwe store na hydrate en na elk realtime-event. console.warn bij
  mismatch; opt-in debug log via NEXT_PUBLIC_DEBUG_WORKSPACE_FINGERPRINT=1.
  Bestand TODO-marked voor verwijdering in Story 8 (T-878).
- T-847: SetCurrentProduct schrijft naast oude useProductStore ook
  useProductWorkspaceStore.setActiveProduct({id, name}); cleanup cleart beide.
  setActiveProduct triggert ensureProductLoaded — fetch-stub tot Story 7
  (T-870) de LIST-endpoints toevoegt.

Verify: lint+typecheck clean, 636/636 tests groen (geen UI-regressie omdat
oude store leidend blijft).

Refs: PBI-74, ST-1319, T-844..T-847

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): migreer backlog-componenten naar workspace-store (Story 3)

Story 3 verplaatst alle UI-consumers van de oude vier stores
(useBacklogStore/usePlannerStore/useSelectionStore/useProductStore) naar de
nieuwe product-workspace-store. De oude stores blijven nog bestaan voor
hydration-wrapper en realtime-hook (dual-dispatch); Story 8 ruimt ze op.

- T-848 backlog-split-pane.tsx: leest activePbiId/activeStoryId uit
  context-slice (primitives, geen useShallow nodig).
- T-849 pbi-list.tsx: selectVisiblePbis(useShallow); DnD via
  applyOptimisticMutation('pbi-order' + optionele 'entity-patch' bij
  cross-priority drag), met settle/rollback per server-result.
- T-850 story-panel.tsx: selectStoriesForActivePbi(useShallow); DnD via
  applyOptimisticMutation('story-order' + entity-patch bij priority change).
- T-851 task-panel.tsx: selectTasksForActiveStory(useShallow); DnD via
  applyOptimisticMutation('task-order'); detail-view (ensureTaskLoaded +
  isDetail) zit in de task-dialog (apart component, niet in deze lijst).
- T-852 start-sprint-button.tsx: selectActivePbi + selectStoriesForActivePbi
  voor free-story count.
- T-853 set-current-product.tsx: alleen workspace-store.setActiveProduct
  (oude useProductStore-import verwijderd).
- T-854 G1/G2-audit: alle nieuwe selectors gebruiken module-level EMPTY
  refs (G1) en useShallow voor lijsten (G2). Geen 'Maximum update depth'-
  warnings tijdens npm test.
- T-855 tests bijgewerkt: backlog-split-pane.test, task-panel.test,
  integration.test gebruiken nu setState op workspace-store (helpers
  resetWorkspace/setActiveStoryAndTasks/selectPbi/selectStory).

Verify: lint+typecheck clean, 636/636 tests groen. UI-consumers van
oude stores zijn nu nul (uitgezonderd dual-dispatch in hydration-wrapper en
realtime-hook + dev-fingerprint-helper, die in Story 8/T-873/T-878 verdwijnen).

Refs: PBI-74, ST-1320, T-848..T-855

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): race-safe loaders + restore-hints + URL-prioriteit (Story 4)

- T-856: activeRequestId-guard zat al in store.ts uit Story 1; bevestigd door
  de race-safety test (in-flight ensurePbiLoaded mag niet overschrijven).
- T-857: restore-hint flow toegevoegd in setActiveProduct/setActivePbi/
  setActiveStory. Async chain: await ensureXxxLoaded → guard check →
  readHints → valideer hint via entities.byId → setActiveYyy(hint).
  Geen setTimeout-trick — chain is alleen await-based.
- T-858: writeProductHint/writePbiHint/writeStoryHint/writeTaskHint
  aangeroepen direct na set(...) zodat de hint-persistentie altijd
  consistent is met de in-store selectie.
- T-859: nieuwe components/backlog/url-task-sync.tsx — leest
  ?editTask=&lt;id&gt; uit useSearchParams, schrijft de hint en roept
  setActiveTask aan zodat de URL wint boven een eerder gepersisteerde
  task-hint. Gemount in beide product-pages (desktop + mobile) binnen
  BacklogHydrationWrapper.
- T-860: 6 nieuwe vitest-cases — 4 voor hint-persist per setter, 2 voor de
  restore-flow chain (hint die niet in entities zit wordt genegeerd; hint
  die wel in entities zit wordt toegepast). Bestaande race-safety test
  blijft groen.

Verify: lint+typecheck clean, 642/642 tests groen.

Refs: PBI-74, ST-1321, T-856..T-860

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): hidden-tab + reconnect resync (Story 5)

Per ontwerp samen in één commit zodat geen vangnet wegvalt zonder vervanging.

- T-861: useBacklogRealtime sluit niet meer op visibilitychange hidden;
  EventSource blijft open zolang browser/netwerk dit toelaten. Reconnect bij
  netwerkfout blijft via backoff. visibilitychange fungeert nog wel als
  re-connect-trigger als de stream tussentijds is gesloten (b.v. 240s
  hard-close server-side).
- T-862: 'ready'-event-handler telt connect-cycles. De eerste 'ready' is de
  initial connect (geen resync). Bij latere 'ready' (post-reconnect) wordt
  resyncActiveScopes('reconnect') aangeroepen om gemiste events op te halen.
- T-863: nieuwe lib/realtime/use-workspace-resync.ts — luistert op
  document.visibilitychange (hidden→visible) en window.online; dispatcht
  resyncActiveScopes('visible') resp. 'reconnect'. Mounted in
  BacklogHydrationWrapper na useBacklogRealtime.
- T-864: 4 nieuwe vitest-cases voor useWorkspaceResync (jsdom): visible→
  visible event, online event, hidden negeren, cleanup-bij-unmount.

Daarnaast lint-cleanup: ongebruikte 'order'-variabelen in pbi-list en
story-panel weggehaald.

Verify: lint+typecheck clean, 646/646 tests groen.

Refs: PBI-74, ST-1322, T-861..T-864

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): unknown-event fallback tests (Story 6)

T-865 (isUnknownEntityEvent filter) en T-866 (resync-trigger in
applyRealtimeEvent) zijn al in Story 1 geïmplementeerd in store.ts;
deze story breidt de test-coverage uit met expliciete negatieve cases
voor het type-veld noise pattern.

T-867 — 5 nieuwe vitest-cases:
- unknown entity met ANDER product_id → geen resync
- claude_job_status (type) → geen resync
- worker_heartbeat (type) → geen resync
- claude_job_enqueued (type) → geen resync
- payload zonder entity en zonder type → genegeerd
- question-entity (entity-veld, geen type, niet pbi/story/task) → resync trigger

Verify: lint+typecheck clean, 651/651 tests groen.

Refs: PBI-74, ST-1323, T-865..T-867

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): cache-headers + LIST endpoints (Story 7)

- T-868: cache: 'no-store' was al ingebouwd in fetchJson helper (Story 1).
  Bevestigd door bestaande ensureProductLoaded test die de fetch-init
  controleert.
- T-869: force-dynamic toegevoegd op alle vier nieuwe LIST-endpoints.
- T-870: vier nieuwe routes voor ensure*Loaded:
  - GET /api/products/:id/backlog → ProductBacklogSnapshot
  - GET /api/pbis/:id/stories → BacklogStory[]
  - GET /api/stories/:id/tasks → BacklogTask[]
  - GET /api/tasks/:id (nieuwe handler naast bestaande PATCH) → TaskDetail
    met _detail: true marker
  Auth via authenticateApiRequest (Bearer of iron-session); access-control
  via productAccessFilter (gebruiker is owner of member van het product).
  Statussen worden via taskStatusToApi/storyStatusToApi/pbiStatusToApi
  vertaald naar lowercase API-vorm.
- T-871: SSE-route /api/realtime/backlog stuurt al ready-event direct na
  LISTEN (regel 106) — geen wijziging nodig.

Verify: lint+typecheck clean, 651/651 tests groen.

Refs: PBI-74, ST-1324, T-868..T-871

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(PBI-74): oude stores opruimen (Story 8)

Workspace-store is nu de enige bron voor product-backlog client-state. De
vier voorgangers en de dual-dispatch-infrastructuur zijn verwijderd.

- T-872: grep over codebase op useBacklogStore/usePlannerStore/
  useSelectionStore/useProductStore is leeg.
- T-873..T-876: stores/{backlog,planner,selection,product}-store.ts deleted.
- T-877: __tests__/realtime/payload-contract.test.ts en
  __tests__/api/backlog-realtime.test.ts deleted — pbi/story/task I|U|D
  payload-handling wordt al gedekt door
  __tests__/stores/product-workspace/store.test.ts (incl. parent-move,
  idempotent inserts, delete-cleanup).
- T-878: lib/realtime/dev-workspace-fingerprint.ts deleted, dual-dispatch
  uit BacklogHydrationWrapper en lib/realtime/use-backlog-realtime.ts
  weggehaald. stores/products-store.ts (lijst van producten ≠ active
  product) blijft ongewijzigd.

Bijwerkingen:
- BacklogPbi en BacklogStory types in components/backlog/story-panel.tsx en
  components/sprint/sprint-backlog.tsx krijgen sort_order zodat ze met de
  workspace-types overeenkomen.
- Server-pages /products/[id]/page.tsx (desktop+mobile) en
  /products/[id]/sprint/[sprintId]/page.tsx selecteren sort_order op story
  en mappen het door in de hydration-payload.

Verify: lint+typecheck clean, 626/626 tests groen (verlies van 25 redundante
oude-store tests; workspace-store tests dekken hetzelfde gedrag).

Refs: PBI-74, ST-1325, T-872..T-878

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs(PBI-74): richtlijn workspace-store + realtime patroon

Documenteert het patroon dat in Stories 1-8 is opgeleverd, zodat een
volgende workspace-store (sprint, of een nieuwe bounded context) hetzelfde
recept volgt.

- docs/patterns/workspace-store.md (nieuw): wanneer een workspace-store, de
  vijf state-slices, selectors-regels (G1/G2), race-safe ensure*Loaded met
  activeRequestId-guard (G4), SSE-hook + applyRealtimeEvent met
  unknown-event filter, hidden-tab + reconnect resync via
  useWorkspaceResync, restore-hint flow met await-chain en URL-prioriteit,
  optimistic mutations (applyOptimisticMutation/rollback/settle), API
  endpoint-vereisten (force-dynamic, cache: no-store), test-setup met
  MemoryStorage + originalActions snapshot + mockImplementation, gotchas
  G1-G8 als comment-template, en het 8-staps migratiepad.
- docs/patterns/zustand-optimistic.md: bijgewerkt voor de nieuwe
  workspace-store API; verwijst voor het bredere patroon naar
  workspace-store.md. Voorbeelden voor pbi-order + entity-patch.
- CLAUDE.md: patterns quickref aangevuld met workspace-store-rij.

Verify: typecheck clean.

Refs: PBI-74

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(PBI-74): solo + notifications hooks volgen ook hidden-tab/resync patroon

Het uitgangspunt van PBI-74 (robuust tegen gemiste SSE-events, hidden tabs
en onbekende notify-vormen) gold universeel — niet alleen voor
product-workspace. use-solo-realtime en use-notifications-realtime hadden
nog dezelfde bug die use-backlog-realtime in Story 5 al opgelost kreeg:
sluit stream op hidden, geen resync.

Reproductie (zoals gemeld): solo-screen open in tab A, product-backlog
open in tab B; bewerk task-title in tab B → tab A's solo-SSE was gesloten
(hidden) en kreeg het NOTIFY-event nooit. Tab terug naar solo →
EventSource reconnect maar geen resync → oude title persisteert. Postgres
NOTIFY heeft geen replay, dus zonder resync zijn die events permanent
verloren.

Fix in beide hooks (zelfde patroon als Story 5 voor backlog):
- Stream blijft open op visibilitychange hidden — geen close() meer.
- Bij hidden→visible én bij window 'online': router.refresh() zodat de
  server-component opnieuw fetcht en de initial-state-prop ververst (wat
  voor solo de tasks-record reset via initTasks; voor notifications de
  questions-bel-state).
- Bij latere 'ready'-events na reconnect (use-solo-realtime): zelfde
  router.refresh() trigger zodat we niet vertrouwen op alleen het
  visibility-pad.

Verify: lint + typecheck clean, 626/626 tests groen.

Refs: PBI-74

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: fix broken links in research-repo plan

docs/plans/lees-de-readme-md-validated-book.md beschrijft een research-
repo migratiepad. De links waren geschreven vanuit het research-repo-
perspectief (paden als stores/data-store.ts, ../Scrum4Me/CLAUDE.md,
docs/plans/zustand-store-rearchitecture.md zonder relative-prefix), wat
de doc-link-checker hier laat falen.

- Header-note toegevoegd dat het document voor de research-repo is.
- Interne refs (zustand-store-rearchitecture.md, CLAUDE.md) → relatieve
  paden die in deze repo wél resolven (./zustand-..., ../../CLAUDE.md).
- Research-repo-only refs (stores/data-store.ts,
  hooks/use-event-stream.ts, components/*-select.tsx, etc.) → inline
  code-tags met "(research-repo)" suffix; de link-checker slaat ze over
  en de leesbaarheid blijft.

Verify: npm run docs:check-links → ✓ All doc links valid (118 files).

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 02:25:19 +02:00

9.2 KiB
Raw Blame History

title status audience language last_updated revision
Zustand workspace-store implementatieplan (PBI-74) ready-to-execute
maintainer
contributor
ai-agent
nl 2026-05-09 1

Zustand workspace-store implementatieplan

PBI in Scrum4Me-MCP: PBI-74 — Zustand store rearchitecture — product- en sprint-workspace.

Bron-ontwerp (architectuur en gotchas): 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").

Context

De client-state ligt over vier los gegroeide stores: backlog-store, planner-store, selection-store, product-store. Vier zwakheden:

  • SSE sluit op tab hidden zonder resync bij visible — gemiste events blijven gemist.
  • Geen reconcile bij reconnect (Postgres NOTIFY heeft geen replay).
  • Onbekende entity-events worden stil genegeerd.
  • LocalStorage soms behandeld als waarheid i.p.v. restore-hint.
  • Geen race-safe loaders — trage fetch van oude selectie kan nieuwste overschrijven.

De rearchitecture lost dit op via één product-workspace-store (en analoog sprint-workspace-store) met genormaliseerde entity-maps, race-safe ensure*Loaded met activeRequestId-guard, expliciete resync-laag (visible/reconnect/unknown-event), idempotente SSE-application en localStorage als pure restore-hint.

Aanpak

  • Eén PBI (PBI-74).
  • Negen stories die mappen op de stappen 1-9 in het bron-ontwerp.
  • Granulariteit Story 3 = één story met taken per component.
  • Story 5 in één PR (visibility-handling + resync horen samen).
  • Per story: PR, npm run verify && npm run build groen, status DONE pas na merge.
  • Branch: feat/zustand-workspace-store (één branch voor alle stories).

Stories en taken

# Story MCP Taken
1 Skelet + test-infrastructuur ST-1318 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)

Totaal: 48 taken.

Story 1 — Skelet + test-infrastructuur

Doel: nieuwe store + selectors + restore-utils met volledige unit-test-suite, nog zonder UI-consumenten.

Belangrijkste taken:

  • T-837 — Vitest naar jsdom + tests/setup.ts met MemoryStorage (G6).
  • T-838/839/840/841 — stores/product-workspace/{types,store,selectors,restore}.ts.
  • T-842 — Volledige test-suite per §Testing setup-checklist (G5/G7/G8).
  • T-843 — API endpoint-audit voor ensure*Loaded URLs.

Acceptatie: alle test-cases groen, geen UI-impact.

Story 2 — Hydratie overstappen

Doel: BacklogHydrationWrapper en useBacklogRealtime voeden zowel oude store als nieuwe store. Componenten lezen nog uit oude.

Taken: T-844 (wrapper dual-dispatch), T-845 (realtime dual-dispatch), T-846 (dev-only fingerprint verifyer), T-847 (productpicker → setActiveProduct).

Acceptatie: schaduw-store inhoud matcht oude store na elk SSE-event.

Story 3 — Componenten omzetten

Doel: componenten lezen uit nieuwe workspace-store; oude stores hebben geen UI-consumenten meer.

Taken per component: T-848 (split-pane), T-849 (pbi-list), T-850 (story-panel), T-851 (task-panel), T-852 (start-sprint-button), T-853 (set-current-product). Plus T-854 (G1/G2-audit) en T-855 (integration-tests bijwerken).

Acceptatie: geen "Maximum update depth" warnings; oude store-imports alleen nog in tests die in Story 8 verdwijnen.

Story 4 — Race-safe loaders en restore-hints

Doel: ensure*Loaded met activeRequestId-guard; localStorage hints met validatie.

Taken: T-856 (guard), T-857 (restore-flow met await ensure-chain), T-858 (hint-persistentie), T-859 (URL-prioriteit), T-860 (race-safety tests).

Acceptatie: trage fetch + her-selectie corrumpeert nooit; cold reload restoret zonder fout.

Story 5 — Hidden-tab + reconnect resync (één PR)

Doel: SSE blijft open op hidden; resync via expliciete laag.

Taken: T-861 (geen close op hidden), T-862 (ready-event triggert resync na reconnect), T-863 (useWorkspaceResync hook), T-864 (tests).

Acceptatie: hidden→visible en reconnect herstellen gemiste wijzigingen in één cyclus.

Story 6 — Unknown-event fallback

Doel: onbekende entity-events triggeren resync; job/worker noise wordt genegeerd.

Taken: T-865 (isUnknownEntityEvent filter), T-866 (resync-trigger), T-867 (negatieve filter-tests).

Acceptatie: directe DB UPDATE zonder herkenbare delta-event wordt zichtbaar binnen één resync; job-events triggeren geen resync.

Story 7 — Cache-headers en read-routes

Doel: geen stale data uit Next/browser cache.

Taken: T-868 (cache: 'no-store'), T-869 (force-dynamic audit), T-870 (LIST-endpoints toevoegen waar nodig), T-871 (SSE-route ready-event coverage).

Acceptatie: response headers in productie tonen cache-control: no-store; LIST-endpoints bestaan voor alle ensure*Loaded.

Story 8 — Oude stores opruimen

Doel: vier oude stores verwijderd.

Taken: T-872 (grep), T-873/874/875/876 (delete vier files), T-877 (oude tests migreren), T-878 (stores/products-store.ts blijft + dev-fingerprint cleanup).

Acceptatie: grep useBacklogStore|usePlannerStore|useSelectionStore|useProductStore = 0; npm run verify && npm run build groen.

Story 9 — Sprint-workspace-store

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).

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.

Critical files

Te wijzigen:

  • vitest.config.ts — env naar jsdom, setupFiles
  • nieuw: tests/setup.ts — MemoryStorage, restoreAllMocks
  • nieuw: stores/product-workspace/{types,store,selectors,restore}.ts
  • nieuw: stores/sprint-workspace/{types,store,selectors,restore}.ts
  • nieuw: lib/realtime/use-workspace-resync.ts
  • components/backlog/backlog-hydration-wrapper.tsx
  • lib/realtime/use-backlog-realtime.ts
  • components/backlog/backlog-split-pane.tsx, pbi-list.tsx, story-panel.tsx, task-panel.tsx
  • components/.../start-sprint-button.tsx, set-current-product.tsx
  • read-routes onder app/api/... voor PBI/story/task LIST + detail
  • te verwijderen in Story 8: stores/{backlog,planner,selection,product}-store.ts

Te hergebruiken (geen wijziging):

  • lib/product-access.ts — getAccessibleProduct, blijft auth/access-bron
  • app/api/realtime/backlog/route.ts — ready-event al aanwezig
  • docs/patterns/realtime-notify-payload.md — payload-contract
  • docs/patterns/route-handler.md — REST patroon
  • stores/products-store.ts, stores/solo-store.ts, stores/notifications-store.ts, stores/idea-store.ts, stores/jobs-store.ts — blijven ongewijzigd

Verificatie per story

  • Story 1: Vitest groen voor alle test-cases (hydrate, cascade, realtime, ensureLoaded race, resync, restore-hints, optimistic mutation).
  • Story 2: dev-server, productpagina, fingerprint match in console.
  • Story 3: klik door 3 panels, DnD test, geen "Maximum update depth"-warnings.
  • Story 4: staging — cold reload, throttle fetch + her-selecteer.
  • Story 5: tab hidden > 30s + terug → resync zichtbaar; netwerk uit/aan → reconnect+resync.
  • Story 6: DB UPDATE op story zonder delta-event → zichtbaar binnen 1 resync; job-events negeren resync.
  • Story 7: response headers cache-control: no-store; tweede pageload toont verse data.
  • Story 8: grep oude store-imports = 0; npm run verify && npm run build groen.
  • Story 9: sprint-board flow analoog Story 1-8 verifications.

Eind-acceptatie PBI-74: alle items uit §Acceptatiecriteria van zustand-store-rearchitecture.md (regels 727-746) behaald.

Workflow per story

  1. git checkout -b feat/zustand-workspace-store (eerste story); blijf op deze branch tot expliciete cut.
  2. mcp__scrum4me__get_claude_context → pak next story uit PBI-74.
  3. Voer taken uit in sort_order; update status per taak via mcp__scrum4me__update_task_status.
  4. Lees relevante bestanden + patronen vóór begin (zie §Critical files).
  5. npm run verify && npm run build per laag.
  6. Commit per laag (git add -A && git commit); geen push tussendoor.
  7. Story-status sluit zodra alle taken DONE.
  8. Lege story-queue → git push -u origin feat/zustand-workspace-store + gh pr create.
  9. Per story een eigen PR; merge één voor één.