janpeter/Scrum4Me
0
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2
Scrum4Me/docs/plans/v1-readiness.md
Madhura68 b225c83ace docs: v1.0 smoke-test checklist + readiness-doc bijgewerkt 
docs/runbooks/v1-smoke-test.md (NIEUW): 11-secties handmatige checklist
voor de v1.0-pre-launch verificatie — auth, mobile UA-redirect, happy-path
flow, mobile shell, edit-flows, demo-policy, rate-limiting steekproef,
realtime, debug-routes 404 in productie, Lighthouse a11y per pagina,
rollback-trigger.

v1-readiness.md: 4 Before-launch items afgevinkt (demo-policy, privacy,
README, CHANGELOG); smoke-test verwijst nu naar de checklist; PWA-test
en v1.0.0-bump zijn de twee resterende handmatige items.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 14:18:25 +02:00

7.7 KiB
Raw Blame History

title status audience language last_updated
Scrum4Me — v1.0 readiness active
maintainer
contributor
nl 2026-05-04

Scrum4Me — v1.0 readiness

Versie: v0.9.0 (zojuist gepusht naar productie via Vercel) Doel: v1.0.0 als eerste stabiele release. Living document — bijwerken na elke sprint of merge naar main.

Summary

De kernfunctionaliteit (auth, producten, PBI/story/task-hiërarchie, sprints, solo-paneel, REST-API, MCP-integratie, QR-pairing, mobile-shell) is af en in productie. Tests, lint, build en doc-link-checker zijn allemaal groen. Wat ontbreekt voor v1 is geen feature-werk maar launch-discipline: een paar UI-gaten dichten, ops-instrumentatie (error monitoring, rate-limiting beredeneren), accessibility-audit, en de stale backlog-index opschonen. Alle "Expliciet buiten scope voor v1"-items uit de functional spec (docs/specs/functional.md:20) blijven bewust uit scope.

What's already done

  • #3 Rate-limiting op alle mutation-endpoints — enforceUserRateLimit(scope, userId) helper in lib/rate-limit.ts met 11 nieuwe scopes; toegepast op create-actions (PBI/Story/Task/Todo/Sprint/Product/Token), enqueueClaudeJob(s), answerQuestion, en API-routes (story log POST, avatar upload). Limits zijn ruim genoeg voor normaal gebruik, eng genoeg om abuse-loops te stoppen
  • #2 Sentry error-monitoring — @sentry/nextjs geconfigureerd via PR #85; SDK is no-op zonder DSN, activatie via Vercel env-vars
  • #1 Edit-icoon op Product (todo cmoq3ox51) — pencil-icoon op dashboard-card via PR #83; product-detail-header behoudt tekst
  • v0.9.0 (release): mobile-shell met landscape-lock (PBI-11, 7 stories, 21 tasks)
  • v0.4.0 t/m v0.8.x: ondermeer sprint-screen filter-popover + edit-iconen, PBI/story/task edit-icons, code-velden verplicht, demo read-only, M11 Claude-vragen-kanaal, M10 QR-pairing
  • CI op main en PR's: lint + typecheck + prisma validate + test + build via .github/workflows/ci.yml
  • 432 unit/integration tests · 60 test-files · doc-link-checker 86/86 valid
  • Drie architectuur-beslissingen voor mobile geformaliseerd in docs/architecture/project-structure.md

Now

Korte lijst (3-5 items) die je vóór de v1.0-tag wil afronden. Deze blokkeren een betekenisvolle launch.

1. Edit-icoon op Product ✅ klaar in PR #83

Verschoven naar What's already done. Pencil-icoon op dashboard-card; product-detail page-header behoudt tekst (matched naast andere text-acties).

2. Error monitoring (Sentry of vergelijkbaar)

CI vangt build-fouten af, maar er is geen runtime-monitoring. Voor een echte v1 wil je productie-fouten zien voordat een gebruiker het meldt. Vercel heeft native Sentry-integratie (Marketplace → Sentry).

Concreet:

  • npm i @sentry/nextjs
  • npx @sentry/wizard@latest -i nextjs
  • DSN als env-var via Vercel project settings (development + production environments)
  • Sample-rate conservatief (10% performance, 100% errors) — Hobby-plan-vriendelijk
  • Bevestig dat Postgres-LISTEN/NOTIFY-fouten in worker-routes (/api/realtime/*) gevangen worden

3. Rate-limiting op alle mutation-endpoints ✅ klaar

Verschoven naar What's already done. Helper enforceUserRateLimit(scope, userId) in lib/rate-limit.ts toegepast op alle high-value create-paths.

4. Accessibility audit op happy-path

@base-ui/react levert WAI-ARIA defaults; we gebruiken semantische HTML; maar er is geen audit-bewijs.

Concreet:

  • DevTools Lighthouse a11y-pass op /login, /dashboard, /products/[id], /products/[id]/sprint, /products/[id]/solo, /m/products/[id], /m/products/[id]/solo
  • Score-doel ≥95 per pagina
  • Fix wat onder de 95 valt — meestal contrast of missende labels
  • Documenteer score in docs/specs/functional.md § Niet-functionele vereisten

Next

Belangrijk maar niet-blokkerend voor v1.

Backlog-index sync

docs/backlog/index.md toont M10 (ST-1001 t/m 1008) en M11 (ST-1101 t/m 1108) als unchecked, terwijl ze allemaal gemerged zijn. Loop één keer door en zet [x]. Is een 5-min-job die de doc weer betrouwbaar maakt voor wie 'm leest.

Solo observaties (todo cmohuu5h8)

"Filters en sortering. blokjes kleiner maken 2 op een rij" — UX-polish op het Solo-paneel. Niet trivial: vereist een filter-popover-pattern (we hebben er net een uitgerold op het sprint-screen — herbruik kan).

Algemene observaties (todo cmohthfyw)

"Dunne border om tekstvlakken (onzichtbaar als niet actief), default active PB kiezen, hover-card voor detail-info, landingpage AI-assisted/AI-driven framing." — verzameling kleinere UI-aanscherpingen, ieder eigen scope.

ToDo prioriteit + AI-suggesties (todos cmohtgdwf, cmohswbb9)

Twee verwante todo's over de todo-feature uitbreiden. Past bij de strategische richting "AI-driven dev-flow" maar geen v1-blokker.

Before launch

Must-do voor publieke aankondiging, maar mag pas vlak vóór v1.0-tag.

  • Smoke-test productie — checklist klaar in docs/runbooks/v1-smoke-test.md, 11 secties, ~15 min
  • PWA-installatie test op echt mobiel (Android + iOS) — bevestig manifest landscape, controleer iOS-fallback via CSS-overlay
  • Demo-policy regression-pass — code-side gefixt: 3 gaps gedicht (toggleTodo, archiveCompletedTodos, leaveProduct). Drielaags-block geverifieerd voor alle mutation-actions
  • Privacy review — Sentry sendDefaultPii=false; geen PII in logs; 4 debug-routes nu NODE_ENV-guarded (404 in productie)
  • README + Quick start verifiëren — test-count 69 → 445 gecorrigeerd, env-vars-tabel uitgebreid (CRON_SECRET, Sentry vars), CHANGELOG-link toegevoegd
  • CHANGELOG.md aangemaakt (Keep a Changelog formaat met [Unreleased] + [0.9.0])
  • Bump naar v1.0.0 + GitHub release met release-notes

Later

Bewust uit scope voor v1 (uit functional spec § Expliciet buiten scope) — of grotere domein-uitbreidingen die hun eigen PBI verdienen.

  • Daily Scrum / Sprint Review / Retrospective-schermen — v2
  • E-mail-uitnodigingsflow voor teams — nu enkel via username
  • Notificaties + reminders — out of scope
  • Native mobile app — web-first; mobile-shell is genoeg
  • Tijdregistratie / burndown-charts — buiten positionering
  • WIA AI agent (todo cmog2gzjb) — eigen project-domein
  • Claude-code-integratie via tabel-trigger (todo cmohn3728) — past bij M12-richting maar geen v1
  • Inspaningsmonitor-import (todo cmohul0ri) — separate product
  • GitHub Issues / Linear / Jira-integratie — v2

Priority order (quick reference)

Now:           ~~1. Edit-icoon op Product~~ ✅
               ~~2. Sentry/error-monitoring~~ ✅
               ~~3. Rate-limiting op mutation-endpoints~~ ✅
               4. Accessibility-audit (Lighthouse a11y ≥95)

Next:          5. Backlog-index.md sync
               6. Solo observaties (filters/sortering)
               7. Algemene UI-observaties
               8. Todo prioriteit + AI-suggesties

Before launch: 9. Smoke-test productie (desktop + mobile)
               10. PWA-installatie test op echte mobiel
               11. Demo-policy regression-pass
               12. Privacy/PII review
               13. README quick-start verificatie
               14. CHANGELOG.md
               15. Bump → v1.0.0 + release

Later:         (zie sectie hierboven — v2-domein of buiten scope)

Updated: 2026-05-04 (na v0.9.0 release). Refresh dit document na elke sprint of major merge.