a0e5867857
* docs(PBI-76): plan for user-settings DB-store Persists view/filter prefs in User.settings (Json) instead of localStorage. SSR-correct hydration, cross-tab sync via LISTEN/NOTIFY + SSE, cross-device persistence. Phased: 0=infra, 1=migrate flicker sources, 2=cookie consolidation. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): User.settings json column + migration Adds JSONB column to users table for persistent user prefs. Idempotent SQL — safe on databases where column already exists. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): user-settings types and merge helpers Zod schema for User.settings shape (views/devTools), deep-merge helper that replaces arrays and merges nested objects, and a safe parser that returns defaults on invalid input. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): updateUserSettingsAction with notify Validates patch via Zod, deep-merges with current settings in a transaction, persists to DB, and emits pg_notify on scrum4me_changes for cross-tab/cross-device sync. Demo accounts get 403, unauthenticated 401, invalid input 422. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): user-settings zustand store with optimistic flow Hydrate from prop (SSR-correct), setPref via path with optimistic update + rollback on server error, applyServerPatch for SSE-driven cross-tab updates. Demo accounts skip server-write entirely. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): SSE route for user-settings User-scoped /api/realtime/user-settings stream that filters scrum4me_changes notifications on kind=user_settings and matching userId. Forwards the patch as a data: event so other tabs can applyServerPatch without re-fetching settings. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * feat(PBI-76): user-settings bridge mounted in app layout Hydrates the zustand store with the user's persisted settings via prop (SSR-correct, no flicker). Opens an EventSource to /api/realtime/user-settings so changes from other tabs/devices flow into the same store. Demo accounts skip the SSE subscription. Layout now selects user.settings alongside the other user fields, no extra DB roundtrip. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * test(PBI-76): user-settings lib/action/store coverage 22 vitest cases covering merge semantics (no mutation, array replace, nested merge), Zod schema strictness, server action auth/demo/validation paths, and the optimistic store flow including rollback and demo-mode skip. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * chore(PBI-76): sync package-lock to v1.3.3 Lockfile drifted after @prisma/client reinstall during the schema regenerate. No dependency changes — just the version field tracking package.json bumped in #184. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
13 KiB
13 KiB
Documentation Index
Auto-generated on 2026-05-10 from front-matter and headings.
Architecture Decision Records
Specifications
| Title | Status | Updated |
|---|---|---|
| AnswerModal Profiel | active | 2026-05-04 |
| BatchEnqueueBlockerDialog Profiel | active | 2026-05-04 |
| IdeaDialog Profiel | active | 2026-05-04 |
| PbiDialog Profiel | active | 2026-05-04 |
| ProductDialog Profiel | active | 2026-05-04 |
| Sprint Dialogs Profiel | active | 2026-05-04 |
| StoryDialog Profiel | active | 2026-05-04 |
| TaskDetailDialog Profiel | active | 2026-05-04 |
| TaskDialog Profiel | active | 2026-05-03 |
| Scrum4Me — Functionele Specificatie | active | 2026-05-08 |
| DevPlanner — User Personas | active | 2026-05-03 |
Plans
Archive
| Title | Updated |
|---|---|
| CLAUDE.md workflow-update na M7 + ST-509/511/512/513 | 2026-05-03 |
| Herbruikbaar scripts/insert-milestone.ts | 2026-05-03 |
| Realtime updates voor Solo Paneel (M8) | 2026-05-03 |
Patterns
| Title | Status | Updated |
|---|---|---|
| Bidirectionele async-comms MCP-agent ↔ user | active | 2026-05-03 |
| Debug-id op component-root | active | 2026-05-09 |
| Debug-labels: BEM data-debug-id patroon | active | 2026-05-09 |
| Entity Dialog | active | 2026-05-08 |
| iron-session | active | 2026-05-03 |
| Prisma Client singleton | active | 2026-05-03 |
| Proxy (route protection) | active | 2026-05-08 |
| QR-pairing via unauth-SSE + pre-auth cookie | active | 2026-05-03 |
| Realtime NOTIFY payload — veldnaam-contract | active | 2026-05-03 |
| Route Handler (REST API) | active | 2026-05-08 |
| Server Action | active | 2026-05-08 |
| Float sort_order (drag-and-drop volgorde) | active | 2026-05-03 |
| Story met UI-component | active | 2026-05-03 |
| Web Push | active | 2026-05-07 |
| Workspace-store + realtime — bounded-context patroon | active | 2026-05-10 |
| Zustand optimistische update + rollback | active | 2026-05-10 |
Other Docs
| Title | Path | Status | Updated |
|---|---|---|---|
| Scrum4Me REST API | api.md |
active | 2026-05-03 |
| Scrum4Me REST API | api/rest-contract.md |
active | 2026-05-03 |
| Scrum4Me — Technische Architectuur (breadcrumb) | architecture.md |
active | 2026-05-03 |
| Authentication, Sessions & Demo Policy | architecture/auth-and-sessions.md |
active | 2026-05-03 |
| Claude ↔ User Question Channel | architecture/claude-question-channel.md |
active | 2026-05-03 |
| Data Model & Prisma Schema | architecture/data-model.md |
active | 2026-05-08 |
| Scrum4Me — Architecture Overview | architecture/overview.md |
active | 2026-05-08 |
| Project Structure, Stores, Realtime & Job Queue | architecture/project-structure.md |
active | 2026-05-08 |
| QR-pairing Login Flow | architecture/qr-pairing.md |
active | 2026-05-03 |
| Sprint execution modes — PER_TASK vs SPRINT_BATCH | architecture/sprint-execution-modes.md |
active | 2026-05-07 |
| Scrum4Me — Implementatie Backlog | backlog.md |
active | 2026-05-03 |
| Scrum4Me — Implementatie Backlog | backlog/index.md |
active | 2026-05-03 |
| DevPlanner — Product Backlog | backlog/product-historical.md |
active | 2026-05-03 |
| Agent Instruction Audit | decisions/agent-instructions-history.md |
active | 2026-05-03 |
| Scrum4Me — Styling & Design System | design/styling.md |
active | 2026-05-03 |
| Docker smoke test — task 1 | docker-smoke/2-mei-task-1.md |
done | 2026-05-03 |
| Docker smoke test — task 2 | docker-smoke/2-mei-task-2.md |
done | 2026-05-03 |
| Scrum4Me — Functionele Specificatie | functional.md |
active | 2026-05-03 |
| Scrum4Me — Glossary | glossary.md |
active | 2026-05-08 |
| Overview | manual/01-overview.md |
active | 2026-05-07 |
| Statuses & Transitions | manual/02-statuses-and-transitions.md |
active | 2026-05-07 |
| Git Workflow | manual/03-git-workflow.md |
active | 2026-05-07 |
| MCP Integration | manual/04-mcp-integration.md |
active | 2026-05-07 |
| Docker | manual/05-docker.md |
active | 2026-05-07 |
| Troubleshooting | manual/06-troubleshooting.md |
active | 2026-05-07 |
| Scrum4Me Developer Manual | manual/index.md |
active | 2026-05-07 |
| Scrum4Me — Styling & Design System | md3-color-scheme.md |
active | 2026-05-03 |
| Obsidian as Personal Authoring Layer | obsidian-authoring.md |
active | 2026-05-02 |
| PbiDialog Profiel | pbi-dialog.md |
active | 2026-05-03 |
| DevPlanner — User Personas | personas.md |
active | 2026-05-03 |
| DevPlanner — Product Backlog | product-backlog.md |
active | 2026-05-03 |
| Scrum4Me — API Test Plan | qa/api-test-plan.md |
active | 2026-05-03 |
| Realtime smoke-checklist — PBI / Story / Task | realtime-smoke.md |
active | 2026-05-03 |
| Caveman plan — Beelink naar Ubuntu Scrum4Me server | recommendations/beelink-ubuntu-scrum4me-server-caveman-plan.md |
draft | 2026-05-09 |
| Aanbeveling — Claude VM jobflow en gitstrategie | recommendations/claude-vm-job-flow-git-strategy.md |
draft | 2026-05-09 |
| Load/render implementatie review | recommendations/load-render-implementation-review-2026-05-10.md |
review | 2026-05-10 |
| Agent-flow: open issues & decision log | runbooks/agent-flow-pitfalls.md |
active | 2026-05-03 |
| Auto-PR flow: van story-DONE naar gemergde PR | runbooks/auto-pr-flow.md |
active | 2026-05-06 |
| Branch, PR & Commit Strategy | runbooks/branch-and-commit.md |
active | 2026-05-03 |
| Deploy-controle: triggers, labels, path-filter | runbooks/deploy-control.md |
active | 2026-05-07 |
| Vercel Deployment | runbooks/deploy-vercel.md |
active | 2026-05-03 |
| Job-model-selectie per ClaudeJob-kind | runbooks/job-model-selection.md |
active | 2026-05-09 (idea-kinds + PLAN_CHAT permission_mode → acceptEdits) |
| MCP Integration — Scrum4Me Tools | runbooks/mcp-integration.md |
active | 2026-05-08 |
| v1.0 Smoke Test Checklist | runbooks/v1-smoke-test.md |
active | 2026-05-04 |
| Worker idempotency & job-status protocol | runbooks/worker-idempotency.md |
active | 2026-05-09 |
| StoryDialog Profiel | story-dialog.md |
active | 2026-05-03 |
| TaskDialog Profiel | task-dialog.md |
active | 2026-05-03 |
| Scrum4Me — API Test Plan | test-plan.md |
active | 2026-05-03 |