Madhura68
4ff50cb87e
Reframe the landing page around what makes Scrum4Me unique: code execution stays on the developer's own hardware (laptop, NAS or VM). The Vercel UI and Neon DB are a metadata coordination layer; source code never leaves the local worker. Adds a mermaid-rendered architecture diagram (two-zone: Scrum4Me-stack vs Jouw kant) with light/dark variants generated via mmdc. Page changes (app/page.tsx): - Hero: H1 "Plannen in de cloud. Uitvoeren op je eigen machine." + new subhead; CTA "Hoe het werkt" replaces "Demo bekijken" (anchors to #architectuur). - New section §3 "Architectuur" with light/dark SVG and 4 callout-cards (Vercel · Neon · Lokale worker · GitHub) honestly describing what each component stores or runs. - Feature grid: 6 cards (set C) — combines Sprint Board + Solo Paneel, adds Lokale Claude-agents, Realtime updates, Async vraagkanaal, Todo's. LIVE callout removed (folded into Realtime card). - "Twee manieren"-section replaced by a Quickstart with concrete git-clone snippet for the MCP-server. - Handleiding: 9 → 10 steps; MCP recommended in step 8; new step 9 "Story laten uitvoeren" describing the Voer-uit / job-queue flow; step 1 mentions QR-pairing as alternative login. - Footer: adds link to madhura68/scrum4me-mcp alongside the app repo. Tooling: - New docs/diagrams/architecture.mmd (mermaid source). - New npm script "diagrams" generates light + dark SVG via mmdc; output committed to public/diagrams/. No prebuild hook (manual regenerate, like prisma generate / docs:index). - Plan + grilling outcomes captured in docs/plans/landing-local-first.md. Tracked under Scrum4Me story cmoq2qoik0001qa175iynfnaa (PBI Marketing & Landingspagina, cmoq2q50s0000qa174rmrjove). Verified: npm run lint (0 new errors), npm test (379/379), npm run build OK. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
7.9 KiB
7.9 KiB
Documentation Index
Auto-generated on 2026-05-03 from front-matter and headings.
Architecture Decision Records
| # | Title | Status |
|---|---|---|
| 0000 | ADR-0000: Record architecture decisions | accepted |
| 0001 | ADR-0001: Use @base-ui/react instead of Radix UI | accepted |
| 0002 | ADR-0002: Use float sort_order for drag-and-drop ordering | accepted |
| 0003 | ADR-0003: One branch per milestone, push only after user test | accepted |
| 0004 | ADR-0004: DB enums UPPER_SNAKE, API enums lowercase, mapped exclusively via lib/task-status.ts | accepted |
| 0005 | ADR-0005: Use iron-session for authentication instead of NextAuth/Clerk/Supabase Auth | accepted |
| 0006 | ADR-0006: Demo-user write protection enforced in three layers | accepted |
| 0007 | ADR-0007: Agent ↔ user question channel via persistent table + LISTEN/NOTIFY | accepted |
| 0008 | ADR-0008: Agent instructions in CLAUDE.md + topical runbooks | accepted |
Specifications
| Title | Status | Updated |
|---|---|---|
| PbiDialog Profiel | active | 2026-05-03 |
| StoryDialog Profiel | active | 2026-05-03 |
| TaskDialog Profiel | active | 2026-05-03 |
| Scrum4Me — Functionele Specificatie | active | 2026-05-03 |
| DevPlanner — User Personas | active | 2026-05-03 |
Plans
| Title | Status | Updated |
|---|---|---|
| Docs-restructuur — geoptimaliseerd voor AI-lookup | proposal | 2026-05-02 |
| PBI Bulk-Create Spec — Docs-Restructure for AI-Optimized Lookup | done | 2026-05-03 |
| Landing v2 — lokaal & veilig + architectuurdiagram | active | 2026-05-03 |
| M10 — Password-loze inlog via QR-pairing | active | 2026-05-03 |
| M11 — Claude vraagt, gebruiker antwoordt | active | 2026-05-03 |
| M9 — Actief Product Backlog | active | 2026-05-03 |
| ST-1109 — PBI krijgt een status (Ready / Blocked / Done) | active | 2026-05-03 |
| ST-1110 — Demo gebruiker read-only | active | 2026-05-03 |
| ST-1111 — Voer uit-knop met Claude Code job queue | active | 2026-05-03 |
| ST-1114 — Copilot reviews op dashboard | active | 2026-05-03 |
| Tweede Claude Agent — Planning Agent | proposal | 2026-05-03 |
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 |
| Entity Dialog | active | 2026-05-03 |
| iron-session | active | 2026-05-03 |
| Prisma Client singleton | active | 2026-05-03 |
| Proxy (route protection) | active | 2026-05-03 |
| 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-03 |
| Server Action | active | 2026-05-03 |
| Float sort_order (drag-and-drop volgorde) | active | 2026-05-03 |
| Story met UI-component | active | 2026-05-03 |
| Zustand optimistische update + rollback | active | 2026-05-03 |
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-03 |
| Scrum4Me — Architecture Overview | architecture/overview.md |
active | 2026-05-03 |
| Project Structure, Stores, Realtime & Job Queue | architecture/project-structure.md |
active | 2026-05-03 |
| QR-pairing Login Flow | architecture/qr-pairing.md |
active | 2026-05-03 |
| 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-03 |
| 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 |
| Branch, PR & Commit Strategy | runbooks/branch-and-commit.md |
active | 2026-05-03 |
| Vercel Deployment | runbooks/deploy-vercel.md |
active | 2026-05-03 |
| MCP Integration — Scrum4Me Tools | runbooks/mcp-integration.md |
active | 2026-05-03 |
| 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 |