From 93b9c03419c716a1dbb8e951869205b822163e64 Mon Sep 17 00:00:00 2001 From: Scrum4Me Agent <30029041+madhura68@users.noreply.github.com> Date: Sun, 3 May 2026 12:30:58 +0200 Subject: [PATCH] docs(taxonomy): move design/api/qa/backlog/assets into folders MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/scrum4me-styling.md → docs/design/styling.md - docs/MD3_Color_Scheme_Documentation.md → docs/design/md3-color-scheme.md - docs/API.md → docs/api/rest-contract.md - docs/scrum4me-test-plan.md → docs/qa/api-test-plan.md - docs/scrum4me-backlog.md → docs/backlog/index.md - docs/scrum4me-product-backlog.md → docs/backlog/product-historical.md - docs/erd.svg → docs/assets/erd.svg - docs/icons.html → docs/assets/icons.html Internal links updated across CLAUDE.md, README.md, docs/, prisma/, and scripts/. prisma/schema.prisma erd output path also updated. --- CLAUDE.md | 22 +++++++++---------- README.md | 12 +++++----- docs/agent-instruction-audit.md | 22 +++++++++---------- docs/{API.md => api/rest-contract.md} | 0 docs/{ => assets}/erd.svg | 0 docs/{ => assets}/icons.html | 0 .../{scrum4me-backlog.md => backlog/index.md} | 14 ++++++------ .../product-historical.md} | 0 .../md3-color-scheme.md} | 0 .../styling.md} | 0 docs/patterns/claude-question-channel.md | 2 +- docs/patterns/dialog.md | 4 ++-- docs/patterns/prisma-client.md | 6 ++--- docs/patterns/qr-login.md | 2 +- docs/plans/M10-qr-pairing-login.md | 10 ++++----- docs/plans/M11-claude-questions.md | 10 ++++----- docs/plans/M9-active-product-backlog.md | 2 +- .../Tweede Claude Agent — Planning Agent.md | 2 +- .../api-test-plan.md} | 0 docs/scrum4me-architecture.md | 2 +- docs/solo-paneel-spec.md | 2 +- docs/specs/dialogs/pbi.md | 2 +- docs/specs/dialogs/story.md | 2 +- docs/specs/dialogs/task.md | 2 +- prisma/schema.prisma | 2 +- prisma/seed-data/parse-backlog.ts | 2 +- prisma/seed.ts | 2 +- scripts/insert-milestone.ts | 4 ++-- 28 files changed, 64 insertions(+), 64 deletions(-) rename docs/{API.md => api/rest-contract.md} (100%) rename docs/{ => assets}/erd.svg (100%) rename docs/{ => assets}/icons.html (100%) rename docs/{scrum4me-backlog.md => backlog/index.md} (98%) rename docs/{scrum4me-product-backlog.md => backlog/product-historical.md} (100%) rename docs/{MD3_Color_Scheme_Documentation.md => design/md3-color-scheme.md} (100%) rename docs/{scrum4me-styling.md => design/styling.md} (100%) rename docs/{scrum4me-test-plan.md => qa/api-test-plan.md} (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 9726c82..6ffa1f0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,11 +18,11 @@ Lees het relevante document voordat je aan een feature begint. Nooit gokken over |---|---| | `docs/scrum4me-functional-spec.md` | Acceptatiecriteria, randgevallen, user flows | | `docs/scrum4me-architecture.md` | Stack, datamodel, Prisma schema, Zustand stores | -| `docs/scrum4me-backlog.md` | Welke task bouwen, volgorde, "done when"-criteria | +| `docs/backlog/index.md` | Welke task bouwen, volgorde, "done when"-criteria | | `docs/scrum4me-personas.md` | Lars (primair), Dina, Remi — gebruik bij UI-beslissingen | -| `docs/scrum4me-product-backlog.md` | Historische domein-backlog (referentie); seed wordt sinds ST-004 gegenereerd uit `scrum4me-backlog.md` via `prisma/seed-data/parse-backlog.ts` | -| `docs/API.md` | REST-API contract voor Claude Code — endpoints, status-enums, foutcodes, voorbeeld-curls | -| `docs/scrum4me-styling.md` | **Lees dit voor elk component** — MD3-kleuren, shadcn patronen | +| `docs/backlog/product-historical.md` | Historische domein-backlog (referentie); seed wordt sinds ST-004 gegenereerd uit `docs/backlog/index.md` via `prisma/seed-data/parse-backlog.ts` | +| `docs/api/rest-contract.md` | REST-API contract voor Claude Code — endpoints, status-enums, foutcodes, voorbeeld-curls | +| `docs/design/styling.md` | **Lees dit voor elk component** — MD3-kleuren, shadcn patronen | | `docs/agent-instruction-audit.md` | Waarom de agent-instructies zijn aangescherpt; checklist voor toekomstige wijzigingen | | `docs/plans/-*.md` | Implementatieplan per milestone — Bestanden, Stappen, Aandachtspunten, Verificatie. Lees vóór je aan een ST begint. Milestone-key matcht backlog-header (`M9`, `M3.5`, `PBI-9`, …). | | [`madhura68/scrum4me-mcp`](https://github.com/madhura68/scrum4me-mcp) | MCP-server repo: native tools voor Claude Code, schema-sync via git submodule | @@ -51,9 +51,9 @@ Werken aan een task kan via twee tracks. Track A heeft de voorkeur als je in Cla ### Track B — manueel (Codex of zonder MCP) -1. Lees de task in `scrum4me-backlog.md` +1. Lees de task in `docs/backlog/index.md` 2. Zoek de bijbehorende feature-spec in `scrum4me-functional-spec.md` -3. Lees het relevante patroon in `docs/patterns/` en styling in `docs/scrum4me-styling.md` als dat van toepassing is +3. Lees het relevante patroon in `docs/patterns/` en styling in `docs/design/styling.md` als dat van toepassing is 4. Bouw — test — verifieer de "Done when"-criteria 5. Vraag of de code correct is 6. Commit (zie Commit Strategy hieronder) @@ -79,7 +79,7 @@ Vercel Analytics (@vercel/analytics/next) > ⚠️ **Stylingregel:** Gebruik **nooit** `bg-blue-500` of willekeurige Tailwind-kleuren. > Gebruik altijd semantische MD3-tokens: `bg-primary`, `bg-status-done`, `bg-priority-critical`. -> Zie `scrum4me-styling.md` voor alle patronen. +> Zie `docs/design/styling.md` voor alle patronen. > ⚠️ **Next.js-versie:** Lees `node_modules/next/dist/docs/` bij twijfel — API's kunnen afwijken van trainingsdata. @@ -176,7 +176,7 @@ Volledige Zod-schema in `lib/env.ts`. `.env.example` is de canonieke lijst voor - **Docs-sync:** elke gedrags-, dependency-, API- of deploymentwijziging werkt README, relevante docs en patterns bij in dezelfde change - **Entity codes:** gebruik product/PBI/story-codes in commit-titles wanneer aanwezig (`feat(ST-356.2): ...`); branchnaam blijft `feat/ST-XXX-slug` - **Status-enums op API:** lowercase (`todo|in_progress|review|done`, `open|in_sprint|done`); DB houdt UPPER_SNAKE; conversie uitsluitend via `lib/task-status.ts`-mappers — nooit ad-hoc `.toLowerCase()` elders -- **Foutcodes API:** `400` alleen voor malformed JSON-body (parse-fout via `request.json()`); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteer per endpoint in `docs/API.md` +- **Foutcodes API:** `400` alleen voor malformed JSON-body (parse-fout via `request.json()`); `422` voor zod-validatie en well-formed-maar-niet-acceptabel; `403` voor demo-tokens. Documenteer per endpoint in `docs/api/rest-contract.md` - **Tests volgen contract:** bij een API-contract-wijziging (status, foutcode, response-shape) MOET in dezelfde commit ook `__tests__/api/` mee — een test die rood gaat omdat de oude waarde wordt verwacht is een onvolledige wijziging, niet een "kapotte test" - **Dev port:** `npm run dev` draait altijd op **3000**. Een `predev`-hook killt vooraf elk proces op 3000 (stale Next.js dev-server, vorige sessie) zodat sessies, cookies en MCP-config consistent op één poort werken. Wijk hier niet van af — geen `-p 3001` o.i.d. tenzij je expliciet twee dev-servers naast elkaar wil draaien @@ -352,7 +352,7 @@ Wekelijks (maandag 08:00 Amsterdam) draait de remote agent `trig_015FFUnxjz9WMuh - **Sharp** moet Linux-binaries hebben voor de Vercel-runtime: `npm i --include=optional sharp` of platform-specifieke deps configureren in `package.json` - **Externe image hostnames** in `next.config.js` `images.remotePatterns` configureren *vóór* `next/image` op die hosts wijst — anders 500 in productie -- **Vercel cron**: Hobby-plan staat alleen daily crons toe (max 1×/dag); Pro ondersteunt fijnmaziger. Bij wijziging van `vercel.json` `crons` ook `docs/API.md` + relevante pattern-docs updaten +- **Vercel cron**: Hobby-plan staat alleen daily crons toe (max 1×/dag); Pro ondersteunt fijnmaziger. Bij wijziging van `vercel.json` `crons` ook `docs/api/rest-contract.md` + relevante pattern-docs updaten - **`CRON_SECRET`** moet als env-var op de Vercel-project-omgeving staan vóór de eerste cron-run, anders 401 op `/api/cron/*`-endpoints - **Preflight** vóór deploy: `npm run lint && npm test && npm run build` — falende build laat een PR niet door (CI blokkeert merge per ST-610) @@ -360,11 +360,11 @@ Wekelijks (maandag 08:00 Amsterdam) draait de remote agent `trig_015FFUnxjz9WMuh ## Definition of Done (MVP) -M7 (MCP-server) is post-MVP en heeft eigen acceptatie in `docs/scrum4me-backlog.md`. +M7 (MCP-server) is post-MVP en heeft eigen acceptatie in `docs/backlog/index.md`. - [ ] Alle 62 tasks (ST-001 t/m ST-612) afgerond - [ ] Volledige Lars-flow zonder fouten (ST-612) -- [ ] Alle gedocumenteerde API-endpoints werken via curl (zie `docs/API.md`) +- [ ] Alle gedocumenteerde API-endpoints werken via curl (zie `docs/api/rest-contract.md`) - [ ] Demo-gebruiker heeft geen schrijfrechten - [ ] App opzetbaar via README zonder extra hulp - [ ] CI/CD actief — falende build blokkeert merge diff --git a/README.md b/README.md index 9f86591..628ab24 100644 --- a/README.md +++ b/README.md @@ -122,7 +122,7 @@ npx prisma db push npm run db:erd ``` -Deze command voert lokaal `prisma generate` uit. Daardoor worden zowel de Prisma Client als `docs/erd.svg` opnieuw opgebouwd. +Deze command voert lokaal `prisma generate` uit. Daardoor worden zowel de Prisma Client als `docs/assets/erd.svg` opnieuw opgebouwd. In CI en deployment wordt bewust alleen de Prisma Client gegenereerd met `prisma generate --generator client`. Het ERD-diagram gebruikt Mermaid/Puppeteer en wordt daarom niet in GitHub Actions of Vercel gegenereerd. @@ -155,11 +155,11 @@ Verwacht: alle 69 tests slagen, 0 failures. bash scripts/test-api.sh ``` -De curl-tests dekken alle 7 API-endpoints: auth (401), demo-blokkering (403), inputvalidatie (400) en happy paths. Zie `docs/scrum4me-test-plan.md` voor het volledige testplan. +De curl-tests dekken alle 7 API-endpoints: auth (401), demo-blokkering (403), inputvalidatie (400) en happy paths. Zie `docs/qa/api-test-plan.md` voor het volledige testplan. ## Database -![ERD](./docs/erd.svg) +![ERD](./docs/assets/erd.svg) De databasevisualisatie wordt lokaal gegenereerd uit `prisma/schema.prisma` via `prisma-erd-generator`. @@ -169,7 +169,7 @@ Handmatige generatie: npm run db:erd ``` -Tijdens lokale development draait `npm run dev` naast Next.js ook `npm run db:erd:watch`. Bij wijzigingen in `prisma/schema.prisma` wordt `docs/erd.svg` automatisch opnieuw gegenereerd. +Tijdens lokale development draait `npm run dev` naast Next.js ook `npm run db:erd:watch`. Bij wijzigingen in `prisma/schema.prisma` wordt `docs/assets/erd.svg` automatisch opnieuw gegenereerd. Gebruik `npx prisma db push` alleen om het schema naar de database te synchroniseren. Gebruik `npm run db:erd` om lokaal Prisma Client en de ERD te genereren. Gebruik in CI uitsluitend `npx prisma generate --generator client`. @@ -182,7 +182,7 @@ npm run dev # lokale development server npm run lint # ESLint npm test # Vitest test suite npm run build # productiebuild zoals Vercel die verwacht -npm run db:erd # Prisma Client + docs/erd.svg genereren +npm run db:erd # Prisma Client + docs/assets/erd.svg genereren ``` ### Environment variables @@ -281,5 +281,5 @@ De productieomgeving is gericht op Vercel + Neon. - [Functionele specificatie](docs/scrum4me-functional-spec.md) - [Technische architectuur](docs/scrum4me-architecture.md) -- [Backlog](docs/scrum4me-backlog.md) +- [Backlog](docs/backlog/index.md) - [Agent-instructie audit](docs/agent-instruction-audit.md) diff --git a/docs/agent-instruction-audit.md b/docs/agent-instruction-audit.md index 1cd185f..f93baf3 100644 --- a/docs/agent-instruction-audit.md +++ b/docs/agent-instruction-audit.md @@ -18,7 +18,7 @@ Dit document legt vast welke wijzigingen zijn gecontroleerd, welke documentatie | Reorder-acties valideren alle IDs binnen de juiste parent-scope | `actions/stories.ts`, `actions/sprints.ts` | `docs/scrum4me-architecture.md`, `docs/patterns/server-action.md`, `docs/patterns/sort-order.md`, `CLAUDE.md`, `AGENTS.md` | | Sprint afronden accepteert alleen stories uit de actieve sprint | `actions/sprints.ts` | `docs/scrum4me-architecture.md`, `docs/patterns/server-action.md`, `AGENTS.md` | | Todo-promotie gebruikt scoped todo lookup en `pbi.product_id` als bron van waarheid | `actions/todos.ts` | `docs/scrum4me-architecture.md`, `docs/patterns/server-action.md`, `CLAUDE.md`, `AGENTS.md` | -| `GET /api/products` retourneert ook gedeelde producten via `product_members` | `app/api/products/route.ts` | `README.md`, `docs/scrum4me-functional-spec.md`, `docs/scrum4me-backlog.md`, `docs/patterns/route-handler.md` | +| `GET /api/products` retourneert ook gedeelde producten via `product_members` | `app/api/products/route.ts` | `README.md`, `docs/scrum4me-functional-spec.md`, `docs/backlog/index.md`, `docs/patterns/route-handler.md` | | `sharp` is directe runtime dependency | `package.json`, `package-lock.json` | `README.md`, `docs/scrum4me-architecture.md`, `CLAUDE.md` | | Vercel Analytics is toegevoegd aan de root layout | `app/layout.tsx`, `package.json`, `package-lock.json` | `README.md`, `docs/scrum4me-architecture.md`, `CLAUDE.md` | | `.env.example` ontbrak ondanks verwijzingen in architectuurdocs | `.env.example` | `README.md`, `docs/scrum4me-architecture.md` | @@ -46,7 +46,7 @@ Een codewijziging is niet klaar als de documentatie een oud contract beschrijft. - `README.md`: setup, scripts, dependencies, deployment, API-overzicht. - `docs/scrum4me-functional-spec.md`: functionele eisen en API-contracten. - `docs/scrum4me-architecture.md`: stack, datamodel, securitymodel, env vars, deployment. -- `docs/scrum4me-backlog.md`: "done when"-criteria en scope van backlog-items. +- `docs/backlog/index.md`: "done when"-criteria en scope van backlog-items. - `docs/patterns/`: herbruikbare implementatiepatronen. - `CLAUDE.md` en `AGENTS.md`: agent-regels die de fout in de toekomst voorkomen. @@ -100,7 +100,7 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow - **ST-509** Todo description (max 2000) - **ST-511** Entity codes voor Product/PBI/Story (auto-default + manual override + retry op race condition) - **ST-512** REST API uitgebreid met `code`, `description`, `implementation_plan` in alle endpoints -- **ST-513** API hardening voor Claude Code: `GET /api/health`, `GET /api/products/:id/claude-context`, lowercase status-enums op de API-grens, `StoryLog.metadata` JSONB, validatie-fouten van `400` → `422`, nieuwe `docs/API.md` +- **ST-513** API hardening voor Claude Code: `GET /api/health`, `GET /api/products/:id/claude-context`, lowercase status-enums op de API-grens, `StoryLog.metadata` JSONB, validatie-fouten van `400` → `422`, nieuwe `docs/api/rest-contract.md` - **PR #2 Codex-review-saga** — 8 testbestanden faalden bij de contract-flip; tests werden niet meebijgewerkt. Twee P2-issues van Codex: malformed JSON moet `400` blijven (P2.1), en `status: review` werd geaccepteerd terwijl de sprint-UI er niet mee om kan gaan (P2.2) - **M7: scrum4me-mcp** — aparte MCP-server repo (`madhura68/scrum4me-mcp`) met 9 tools en 1 prompt voor Claude Code, schema gedeeld via git submodule - **lib/code.ts vs lib/code-server.ts** — gesplitst om client-bundle vrij te houden van `pg` (gaf eerst `Module not found: 'dns'` build-error) @@ -110,13 +110,13 @@ Sinds ronde 1 (2026-04-25) is er substantieel werk geland dat de agent-workflow | Wijziging | Code-locatie | Documentatie bijgewerkt | |---|---|---| -| Lowercase status-enums op REST-grens, mappers naar DB-enum | `lib/task-status.ts`, `app/api/tasks/[id]/route.ts`, `app/api/sprints/[id]/tasks/route.ts`, `app/api/products/[id]/next-story/route.ts` | `docs/API.md`, `CLAUDE.md` | -| 400 (malformed JSON) gescheiden van 422 (zod-validatie) | `app/api/tasks/[id]/route.ts`, `app/api/stories/[id]/tasks/reorder/route.ts`, `app/api/todos/route.ts`, `app/api/stories/[id]/log/route.ts` | `docs/API.md`, `CLAUDE.md` | -| `status: review` geweigerd door PATCH `/api/tasks/:id` zolang sprint-UI geen REVIEW rendert | `app/api/tasks/[id]/route.ts` | `docs/API.md` | -| Entity codes (Product/PBI/Story) met auto-default + retry-on-P2002 | `actions/products.ts`, `actions/pbis.ts`, `actions/stories.ts`, `lib/code.ts`, `lib/code-server.ts` | `docs/scrum4me-backlog.md` (ST-511) | -| `StoryLog.metadata` JSONB | `prisma/schema.prisma`, `prisma/migrations/20260426214905_add_story_log_metadata/`, `app/api/stories/[id]/log/route.ts` | `docs/API.md` | -| Health- en bundled-context endpoints voor Claude Code | `app/api/health/route.ts`, `app/api/products/[id]/claude-context/route.ts` | `docs/API.md`, `CLAUDE.md` | -| MCP-server gepubliceerd als aparte repo | `madhura68/scrum4me-mcp` (extern) | `CLAUDE.md` (sectie MCP-integratie), `docs/scrum4me-backlog.md` (M7) | +| Lowercase status-enums op REST-grens, mappers naar DB-enum | `lib/task-status.ts`, `app/api/tasks/[id]/route.ts`, `app/api/sprints/[id]/tasks/route.ts`, `app/api/products/[id]/next-story/route.ts` | `docs/api/rest-contract.md`, `CLAUDE.md` | +| 400 (malformed JSON) gescheiden van 422 (zod-validatie) | `app/api/tasks/[id]/route.ts`, `app/api/stories/[id]/tasks/reorder/route.ts`, `app/api/todos/route.ts`, `app/api/stories/[id]/log/route.ts` | `docs/api/rest-contract.md`, `CLAUDE.md` | +| `status: review` geweigerd door PATCH `/api/tasks/:id` zolang sprint-UI geen REVIEW rendert | `app/api/tasks/[id]/route.ts` | `docs/api/rest-contract.md` | +| Entity codes (Product/PBI/Story) met auto-default + retry-on-P2002 | `actions/products.ts`, `actions/pbis.ts`, `actions/stories.ts`, `lib/code.ts`, `lib/code-server.ts` | `docs/backlog/index.md` (ST-511) | +| `StoryLog.metadata` JSONB | `prisma/schema.prisma`, `prisma/migrations/20260426214905_add_story_log_metadata/`, `app/api/stories/[id]/log/route.ts` | `docs/api/rest-contract.md` | +| Health- en bundled-context endpoints voor Claude Code | `app/api/health/route.ts`, `app/api/products/[id]/claude-context/route.ts` | `docs/api/rest-contract.md`, `CLAUDE.md` | +| MCP-server gepubliceerd als aparte repo | `madhura68/scrum4me-mcp` (extern) | `CLAUDE.md` (sectie MCP-integratie), `docs/backlog/index.md` (M7) | ## Nieuwe preventieve regels @@ -140,7 +140,7 @@ API exposeert lowercase, DB houdt UPPER_SNAKE. Conversie uitsluitend via `lib/ta - `400`: parse-fout op `request.json()` — wikkel altijd in `try/catch` - `422`: zod-validatie of well-formed-maar-niet-acceptabel (bv. `task_id` van andere story) - `403`: demo-token op write -- Documenteer per endpoint in `docs/API.md` +- Documenteer per endpoint in `docs/api/rest-contract.md` ### Client/server module-boundary diff --git a/docs/API.md b/docs/api/rest-contract.md similarity index 100% rename from docs/API.md rename to docs/api/rest-contract.md diff --git a/docs/erd.svg b/docs/assets/erd.svg similarity index 100% rename from docs/erd.svg rename to docs/assets/erd.svg diff --git a/docs/icons.html b/docs/assets/icons.html similarity index 100% rename from docs/icons.html rename to docs/assets/icons.html diff --git a/docs/scrum4me-backlog.md b/docs/backlog/index.md similarity index 98% rename from docs/scrum4me-backlog.md rename to docs/backlog/index.md index 689063a..7159516 100644 --- a/docs/scrum4me-backlog.md +++ b/docs/backlog/index.md @@ -409,8 +409,8 @@ De MVP is klaar wanneer Lars — de primaire persona — de volledige cyclus kan - **`PATCH /api/tasks/:id`:** accepteert lowercase `status` via mapper; retourneert lowercase - **Story-log metadata:** nieuwe optionele `metadata Json?` kolom op `StoryLog`; `POST /api/stories/:id/log` accepteert per type een optioneel `metadata`-veld (bv. `{ branch: 'feat/x' }`); bestaande velden ongewijzigd → backwards-compatible - **Foutcodes:** Zod-validatie geeft `422` (was `400`); `400` blijft voor malformed body; `401`/`403`/`404`/`500` ongewijzigd - - **API-documentatie:** nieuwe `docs/API.md` met endpoints, request/response, foutcodes, status-enums en curl-voorbeelden; `CLAUDE.md` verwijst ernaar - - Done when: `curl /api/health` werkt zonder auth; `curl /api/products/:id/claude-context` retourneert bundled JSON; PATCH/PUT routes accepteren lowercase status en geven 422 bij ongeldige body; story-log POST bewaart `metadata`; `docs/API.md` is gepubliceerd + - **API-documentatie:** nieuwe `docs/api/rest-contract.md` met endpoints, request/response, foutcodes, status-enums en curl-voorbeelden; `CLAUDE.md` verwijst ernaar + - Done when: `curl /api/health` werkt zonder auth; `curl /api/products/:id/claude-context` retourneert bundled JSON; PATCH/PUT routes accepteren lowercase status en geven 422 bij ongeldige body; story-log POST bewaart `metadata`; `docs/api/rest-contract.md` is gepubliceerd - **`GET /api/products`:** voeg `code` toe (naast `id`, `name`, `repo_url`); optioneel `description` en `definition_of_done` - **`GET /api/products/:id/next-story`:** voeg `code` toe op story; voeg per task `code` (derived `${story.code}.${index_in_story}`) en `implementation_plan` toe - **`GET /api/sprints/:id/tasks`:** voeg `description`, `implementation_plan` en `story_code` toe per task; voeg een derived `code`-veld per task toe (`${story.code}.${index_in_story}`) @@ -547,7 +547,7 @@ Filtering server-side: alleen events binnen de actieve sprint van een product wa - Done when: twee tabs van Solo Paneel — mutatie in tab A komt binnen 1–2s in tab B zonder refresh - [x] **ST-806** Documentatie + acceptatietest - - Sectie "Realtime updates" in `docs/scrum4me-architecture.md` met diagram en filtering-regels; vermelding in `CLAUDE.md`; korte note over `/api/realtime/solo` in `docs/API.md`; handmatig E2E-scenario's gedraaid (zelfde gebruiker twee tabs, MCP-write, REST-write, story-claim, network-flap) + - Sectie "Realtime updates" in `docs/scrum4me-architecture.md` met diagram en filtering-regels; vermelding in `CLAUDE.md`; korte note over `/api/realtime/solo` in `docs/api/rest-contract.md`; handmatig E2E-scenario's gedraaid (zelfde gebruiker twee tabs, MCP-write, REST-write, story-claim, network-flap) - Done when: alle scenario's lopen door zonder onverwachte gedragingen Volledig plan in `.Plans/2026-04-27-m8-realtime-solo.md` (lokaal, niet gecommit). @@ -641,12 +641,12 @@ Volledige flow + threat-model: `docs/patterns/qr-login.md` (op te leveren in ST- - [ ] **ST-1007** Desktop UI: QR-render + SSE-listener op `/login` - **Dependency:** `qrcode.react` (client SVG; mobileSecret blijft op desktop in JS-geheugen) - **`app/login/qr-login-button.tsx`:** Client Component; klik → POST `pair/start` (`credentials: 'same-origin'` zodat `s4m_pair`-cookie wordt geaccepteerd) → render QR met `qrUrl` (fragment-URL) → open `EventSource('/api/auth/pair/stream/', { withCredentials: true })` → bij `approved` event POST `pair/claim` (cookie-only) → bij succes `router.push('/dashboard')`; aftellende timer (2 min); bij timeout "Vernieuwen"-knop; cleanup bij unmount/redirect - - **`app/login/page.tsx`:** knop "Inloggen via mobiel" naast bestaande wachtwoord-form (MD3-tokens uit `docs/scrum4me-styling.md`) + - **`app/login/page.tsx`:** knop "Inloggen via mobiel" naast bestaande wachtwoord-form (MD3-tokens uit `docs/design/styling.md`) - A11y: QR heeft alt-tekst met de URL voor screenreaders/copy-paste (de hash-suffix is onderdeel van die alt-tekst, niet van de page-URL die in browsergeschiedenis komt) - Done when: end-to-end happy path werkt op localhost (twee browsers): A toont QR → B scant + bevestigt → A redirect naar `/dashboard` met `session.paired === true`; QR vernieuwt na expiry; geen secret zichtbaar in DevTools Network-tab onder URL-kolommen - [ ] **ST-1008** Documentatie + acceptatietest - - **`docs/API.md`:** drie nieuwe endpoints (start/stream/claim) met request/response, cookie-mechaniek, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar` + - **`docs/api/rest-contract.md`:** drie nieuwe endpoints (start/stream/claim) met request/response, cookie-mechaniek, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar` - **`docs/scrum4me-architecture.md`:** sectie "QR-pairing flow" met sequence-diagram + threat-model; expliciete subsectie *"Waarom geen secret in URL"* — fragments worden niet naar server gestuurd; SSE/claim authenticeren via HttpOnly cookie zodat secret-materiaal niet in access logs / reverse-proxy logs / observability-tools / browsergeschiedenis kan belanden - **`docs/patterns/qr-login.md`:** nieuw pattern-doc voor toekomstige features die hetzelfde unauth-SSE-via-pre-auth-cookie-patroon willen hergebruiken - **`CLAUDE.md`:** verwijzing naar het nieuwe pattern-doc in de patterns-tabel @@ -694,7 +694,7 @@ Persistent vraag-antwoord-kanaal tussen Claude Code (via MCP) en de actieve Scru - **`stores/notifications-store.ts`** — Zustand store volgens `solo-store.ts`-patroon: `init`, `add`, `update`, `remove`, `optimisticAnswer`, `rollbackAnswer`; selectors `openCount`, `forYouCount` - **`lib/realtime/use-notifications-realtime.ts`** — analoog aan `useSoloRealtime`; EventSource op `/api/realtime/notifications` met reconnect-backoff - **`components/notifications/notifications-bridge.tsx`** — Server Component die initial-data fetcht en aan store geeft; mount in `app/(app)/layout.tsx` naast `` - - **`components/shared/notifications-bell.tsx`** — Bell-icon (Lucide) met badge in NavBar (links van avatar); MD3-tokens uit `docs/scrum4me-styling.md` + - **`components/shared/notifications-bell.tsx`** — Bell-icon (Lucide) met badge in NavBar (links van avatar); MD3-tokens uit `docs/design/styling.md` - **`components/notifications/notifications-sheet.tsx`** — shadcn Sheet van rechts; lijst gegroepeerd per product; story-assignee krijgt visuele *"wacht op jou"*-emphase - **`components/notifications/answer-modal.tsx`** — shadcn Dialog; story-context-link, vraag-tekst, RadioGroup (als options) of Textarea (free-text), submit via `useTransition` + Server Action; demo-blok met tooltip - Done when: bell + badge zichtbaar; klik opent Sheet met items; submit verwijdert item optimistisch; tweede tab van zelfde user ziet nieuwe vraag binnen 1-2s; demo-modus rendert maar Verstuur disabled @@ -713,7 +713,7 @@ Persistent vraag-antwoord-kanaal tussen Claude Code (via MCP) en de actieve Scru - Done when: handmatige `curl -X POST` met secret expireert oude rijen; Vercel-dashboard toont cron-config na deploy; onbevoegde call → 401 - [ ] **ST-1108** Documentatie + acceptatietest - - **`docs/API.md`:** secties "SSE — Notifications" + "Cron — Expire questions" met curl-voorbeelden + - **`docs/api/rest-contract.md`:** secties "SSE — Notifications" + "Cron — Expire questions" met curl-voorbeelden - **`docs/scrum4me-architecture.md`:** sectie "Vraag-antwoord-kanaal Claude ↔ user" met Mermaid sequence-diagram + threat-model + "Waarom hergebruik scrum4me_changes-kanaal" - **`docs/patterns/claude-question-channel.md`:** nieuw herbruikbaar pattern-doc voor toekomstige bidirectionele async-communicatie tussen MCP-agents en interactieve users - **`CLAUDE.md`:** rij in Implementatiepatronen-tabel voor het nieuwe pattern diff --git a/docs/scrum4me-product-backlog.md b/docs/backlog/product-historical.md similarity index 100% rename from docs/scrum4me-product-backlog.md rename to docs/backlog/product-historical.md diff --git a/docs/MD3_Color_Scheme_Documentation.md b/docs/design/md3-color-scheme.md similarity index 100% rename from docs/MD3_Color_Scheme_Documentation.md rename to docs/design/md3-color-scheme.md diff --git a/docs/scrum4me-styling.md b/docs/design/styling.md similarity index 100% rename from docs/scrum4me-styling.md rename to docs/design/styling.md diff --git a/docs/patterns/claude-question-channel.md b/docs/patterns/claude-question-channel.md index d451e41..491c2b7 100644 --- a/docs/patterns/claude-question-channel.md +++ b/docs/patterns/claude-question-channel.md @@ -139,7 +139,7 @@ Specifiek voor M11. Kopieer en pas aan: - Volledige flow + threat-model: `docs/scrum4me-architecture.md` § Vraag- antwoord-kanaal Claude ↔ user -- Endpoint-contract: `docs/API.md` § Notifications + Cron +- Endpoint-contract: `docs/api/rest-contract.md` § Notifications + Cron - LISTEN/NOTIFY-pattern: `app/api/realtime/solo/route.ts` (M8 ST-802) — zelfde ReadableStream + heartbeat + hard-close + abort-cleanup - M10 vs M11 keuze tussen eigen/gedeeld kanaal: zie threat-model-tabel diff --git a/docs/patterns/dialog.md b/docs/patterns/dialog.md index 9bf4682..e217d6f 100644 --- a/docs/patterns/dialog.md +++ b/docs/patterns/dialog.md @@ -19,7 +19,7 @@ Voor entity-specifieke afwijkingen of velden: schrijf één begeleidende doc per | 1.5 | **Drielaagse demo-policy** (verplicht — zie § 6) op elke write-actie. | `CLAUDE.md` "Demo-check" + `docs/scrum4me-architecture.md#demo-user-policy` | | 1.6 | Validatie via één gedeeld zod-schema (`lib/schemas/.ts`) — gebruikt door zowel form als server action. | `CLAUDE.md` "Validatie" | | 1.7 | Foutcodes volgen de project-conventie (§ 5). | `CLAUDE.md` "Foutcodes API" | -| 1.8 | Geen willekeurige Tailwind-kleuren (`bg-blue-500` etc.). Alleen MD3-tokens uit `app/styles/theme.css`. | `docs/scrum4me-styling.md` | +| 1.8 | Geen willekeurige Tailwind-kleuren (`bg-blue-500` etc.). Alleen MD3-tokens uit `app/styles/theme.css`. | `docs/design/styling.md` | --- @@ -380,7 +380,7 @@ Reviewer en bouwer lopen deze door vóór merge: ## 15 — Referenties - `CLAUDE.md` — UI Library Conventions, Demo-check, Foutcodes API, Validatie -- `docs/scrum4me-styling.md` — MD3-tokens, kleurklassen +- `docs/design/styling.md` — MD3-tokens, kleurklassen - `docs/scrum4me-architecture.md` — Demo user policy, scope-helpers - `docs/patterns/server-action.md` — Server Action template (auth + Zod) - `docs/patterns/zustand-optimistic.md` — voor lijst-views die de dialog aanroepen diff --git a/docs/patterns/prisma-client.md b/docs/patterns/prisma-client.md index d1ef232..3873bda 100644 --- a/docs/patterns/prisma-client.md +++ b/docs/patterns/prisma-client.md @@ -51,14 +51,14 @@ generator client { generator erd { provider = "prisma-erd-generator" - output = "../docs/erd.svg" + output = "../docs/assets/erd.svg" } ``` `prisma generate` bouwt dus twee artifacts: - Prisma Client in `node_modules/@prisma/client` -- het ERD-diagram in `docs/erd.svg` +- het ERD-diagram in `docs/assets/erd.svg` Gebruik volledige `prisma generate` alleen lokaal. De ERD-generator gebruikt Mermaid/Puppeteer en mag niet in CI of Vercel draaien. @@ -69,7 +69,7 @@ Gebruik volledige `prisma generate` alleen lokaal. De ERD-generator gebruikt Mer | `npx prisma db push` | Schema synchroniseren naar de database | | `npx prisma db seed` | Seeddata laden | | `npx prisma generate --generator client` | Alleen Prisma Client genereren; gebruiken in CI/deployment | -| `npm run db:erd` | `prisma generate`: Prisma Client en `docs/erd.svg` genereren | +| `npm run db:erd` | `prisma generate`: Prisma Client en `docs/assets/erd.svg` genereren | | `npm run db:erd:watch` | `prisma/schema.prisma` watchen en ERD opnieuw genereren | | `npm run dev` | Next.js dev server plus ERD watcher starten | diff --git a/docs/patterns/qr-login.md b/docs/patterns/qr-login.md index 183c749..dd22b86 100644 --- a/docs/patterns/qr-login.md +++ b/docs/patterns/qr-login.md @@ -90,6 +90,6 @@ Drie tijden in escalerende volgorde, alle korter dan de reguliere sessie: ## Referenties - Volledige flow + threat-model: `docs/scrum4me-architecture.md` § QR-pairing flow -- Endpoint-contract: `docs/API.md` § Auth — QR-pairing +- Endpoint-contract: `docs/api/rest-contract.md` § Auth — QR-pairing - LISTEN/NOTIFY-pattern: `app/api/realtime/solo/route.ts` (M8 ST-802) — zelfde ReadableStream + heartbeat + hard-close + abort-cleanup, alleen ander channel diff --git a/docs/plans/M10-qr-pairing-login.md b/docs/plans/M10-qr-pairing-login.md index eef1dcc..1d04988 100644 --- a/docs/plans/M10-qr-pairing-login.md +++ b/docs/plans/M10-qr-pairing-login.md @@ -7,7 +7,7 @@ Inloggen op een (publieke) desktop zonder wachtwoord: desktop toont QR, telefoon - `desktopToken` reist alleen via HttpOnly cookie `s4m_pair` met `Path=/api/auth/pair`, `Max-Age=120`, `SameSite=Lax` - Twee gescheiden hashes in DB scheiden mobiel-bewijs (`secret_hash`) van desktop-bewijs (`desktop_token_hash`) -Backlog-entries: zie [scrum4me-backlog.md § M10](../scrum4me-backlog.md#m10-password-loze-inlog-via-qr-pairing). +Backlog-entries: zie [docs/backlog/index.md § M10](../backlog/index.md#m10-password-loze-inlog-via-qr-pairing). Functional spec: zie [scrum4me-functional-spec.md § F-01b](../scrum4me-functional-spec.md#f-01b-inloggen-via-mobiel-qr-pairing). **Implementatie-volgorde** (commit-strategy uit CLAUDE.md): @@ -767,7 +767,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 ``` - MD3-tokens uit `docs/scrum4me-styling.md`; geen willekeurige Tailwind-kleuren. + MD3-tokens uit `docs/design/styling.md`; geen willekeurige Tailwind-kleuren. 4. **A11y**: QR-component krijgt `aria-label="QR-code voor mobiel inloggen"` en de URL wordt visueel als kopieer-bare tekst onder de QR getoond zodat screenreaders en gebruikers met cameraproblemen de URL handmatig kunnen openen. @@ -788,7 +788,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 ## ST-1008 — Documentatie + acceptatietest **Bestanden** -- `docs/API.md` — drie nieuwe endpoints +- `docs/api/rest-contract.md` — drie nieuwe endpoints - `docs/scrum4me-architecture.md` — sectie "QR-pairing flow" + threat-model - `docs/patterns/qr-login.md` — nieuw pattern-doc - `CLAUDE.md` — verwijzing naar het pattern-doc in de patterns-tabel @@ -796,7 +796,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 **Stappen** -1. **`docs/API.md`** — drie endpoints documenteren met request/response, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar`. Voeg een sectie *"Cookie-mechaniek"* toe die uitlegt dat `s4m_pair` een tijdelijke pre-auth cookie is, anders dan de iron-session cookie. +1. **`docs/api/rest-contract.md`** — drie endpoints documenteren met request/response, foutcodes (400/401/403/404/410/422/429), curl-voorbeelden inclusief `--cookie-jar`. Voeg een sectie *"Cookie-mechaniek"* toe die uitlegt dat `s4m_pair` een tijdelijke pre-auth cookie is, anders dan de iron-session cookie. 2. **`docs/scrum4me-architecture.md`** — sectie *"QR-pairing flow"* met: - Sequence-diagram (mermaid of ASCII analoog aan M8) @@ -826,7 +826,7 @@ ST-1006 staat bij de API-laag (niet bij UI) omdat het een Route Handler is; ST-1 7. **Secret niet in access logs** — controleer Vercel runtime-logs (via `mcp__a1fa0fcf-…__get_runtime_logs`) en lokale dev-logs; zoek op de secret-string en op `s=`-substrings; verwacht: 0 hits **Aandachtspunten** -- Zorg dat de runtime-logs MCP-controle in `docs/scrum4me-test-plan.md` belandt zodat hij bij elke release herhaalbaar is. +- Zorg dat de runtime-logs MCP-controle in `docs/qa/api-test-plan.md` belandt zodat hij bij elke release herhaalbaar is. - `docs/patterns/qr-login.md` mag refereren naar bestaande pattern-docs (iron-session, route-handler) zonder ze te dupliceren. **Verificatie** diff --git a/docs/plans/M11-claude-questions.md b/docs/plans/M11-claude-questions.md index ce5ce90..2837ff5 100644 --- a/docs/plans/M11-claude-questions.md +++ b/docs/plans/M11-claude-questions.md @@ -4,7 +4,7 @@ Persistent vraag-antwoord-kanaal tussen Claude Code (via MCP) en de actieve Scru Eerste concrete uitwerking van strategische **richting B** (verdiepen van de unieke AI-driven dev-flow). -Backlog-entries: zie [scrum4me-backlog.md § M11](../scrum4me-backlog.md#m11-claude-vraagt-gebruiker-antwoordt) (op te leveren in ST-1108). +Backlog-entries: zie [docs/backlog/index.md § M11](../backlog/index.md#m11-claude-vraagt-gebruiker-antwoordt) (op te leveren in ST-1108). **Beveiligingsuitgangspunten:** - Atomic answer via `updateMany WHERE status='open'` — concurrent dubbele submit kan niet @@ -279,7 +279,7 @@ Backlog-entries: zie [scrum4me-backlog.md § M11](../scrum4me-backlog.md#m11-cla **Aandachtspunten** - Bell-icon en avatar moeten visueel balanceren — hoogte/padding gelijktrekken -- MD3-tokens uit `docs/scrum4me-styling.md`: badge `bg-error text-error-foreground` voor critical-count, `bg-primary` voor neutraal. Geen willekeurige Tailwind-kleuren +- MD3-tokens uit `docs/design/styling.md`: badge `bg-error text-error-foreground` voor critical-count, `bg-primary` voor neutraal. Geen willekeurige Tailwind-kleuren - Optimistic-answer in store: voor het Server Action-resultaat zet item op pending; bij error rollback met sonner-error-toast - Sheet-content blijft open zodat de user meerdere vragen achter elkaar kan beantwoorden (zelfde patroon als ST-358 openstaande-stories-sheet) - ARIA: bell-icon heeft `aria-label="Notificaties — N open vragen"`, badge `role="status"` @@ -369,16 +369,16 @@ Backlog-entries: zie [scrum4me-backlog.md § M11](../scrum4me-backlog.md#m11-cla ## ST-1108 — Documentatie + acceptatietest **Bestanden** -- `docs/API.md` — secties "SSE — Notifications" + "Cron — Expire questions" +- `docs/api/rest-contract.md` — secties "SSE — Notifications" + "Cron — Expire questions" - `docs/scrum4me-architecture.md` — sectie "Vraag-antwoord-kanaal" met sequence-diagram - `docs/patterns/claude-question-channel.md` — herbruikbaar pattern-doc -- `docs/scrum4me-backlog.md` — M11-tabel-rij + M11-sectie +- `docs/backlog/index.md` — M11-tabel-rij + M11-sectie - `prisma/seed-data/parse-backlog.ts` — `M11: 'ACTIVE'`, `M10: 'COMPLETED'`, `M3.5: 'COMPLETED'` - `CLAUDE.md` — pattern-doc verwijzing in Implementatiepatronen-tabel **Stappen** -1. Backlog-tabel-rij + M11-sectie in `docs/scrum4me-backlog.md` (mirror M10-format met **Implementatieplan:** verwijzing naar dit doc) +1. Backlog-tabel-rij + M11-sectie in `docs/backlog/index.md` (mirror M10-format met **Implementatieplan:** verwijzing naar dit doc) 2. `docs/scrum4me-architecture.md` § "Vraag-antwoord-kanaal": - Mermaid sequence-diagram: Claude → MCP → DB → trigger → SSE → user → Server Action → DB → trigger → polling-tool diff --git a/docs/plans/M9-active-product-backlog.md b/docs/plans/M9-active-product-backlog.md index 9a79a80..58d78b8 100644 --- a/docs/plans/M9-active-product-backlog.md +++ b/docs/plans/M9-active-product-backlog.md @@ -2,7 +2,7 @@ Eén "actief Product Backlog" per gebruiker, persistent op `User.active_product_id`. NavBar wordt: Producten | Product Backlog | Sprint | Solo | Todo's. Zonder actief PB zijn Backlog/Sprint/Solo disabled. Sprint is alleen klikbaar als er een sprint met status `ACTIVE` bestaat. Vervangt de bestaande `last_product`-cookieflow. -Backlog-entries: zie [scrum4me-backlog.md § M9](../scrum4me-backlog.md#m9-actief-product-backlog). +Backlog-entries: zie [docs/backlog/index.md § M9](../backlog/index.md#m9-actief-product-backlog). --- diff --git a/docs/plans/Tweede Claude Agent — Planning Agent.md b/docs/plans/Tweede Claude Agent — Planning Agent.md index 7775d60..e7946ee 100644 --- a/docs/plans/Tweede Claude Agent — Planning Agent.md +++ b/docs/plans/Tweede Claude Agent — Planning Agent.md @@ -205,7 +205,7 @@ Korte prompt-flow: - `docs/scrum4me-functional-spec.md` (functioneel kader) - `docs/scrum4me-architecture.md` (technisch kader) - `docs/patterns/*.md` (relevante patterns op basis van target-titel/-beschrijving) - - `docs/scrum4me-styling.md` als target UI-werk betreft + - `docs/design/styling.md` als target UI-werk betreft 4. Bedenk children: - Voor `STORY`-target: 3-7 taken met titel, korte beschrijving, `implementation_plan` (verwijst naar relevante patterns + bestanden), priority - Voor `PBI`-target: 2-5 stories met titel, beschrijving in user-story-format, acceptance_criteria, priority diff --git a/docs/scrum4me-test-plan.md b/docs/qa/api-test-plan.md similarity index 100% rename from docs/scrum4me-test-plan.md rename to docs/qa/api-test-plan.md diff --git a/docs/scrum4me-architecture.md b/docs/scrum4me-architecture.md index 12085c9..ba08681 100644 --- a/docs/scrum4me-architecture.md +++ b/docs/scrum4me-architecture.md @@ -1218,7 +1218,7 @@ NODE_ENV="development" **CI/CD:** GitHub Actions → lint + typecheck + `prisma validate` op elke PR; Vercel deploy automatisch bij merge naar `main` **Database (cloud):** Neon — migraties via `prisma migrate deploy` in de Vercel build-stap **Database (lokaal):** Neon (gratis tier) — `npx prisma db push` synchroniseert schema -**Prisma generatie:** CI/deployment gebruikt `prisma generate --generator client`; `npm run db:erd` is alleen lokaal en bouwt ook `docs/erd.svg` +**Prisma generatie:** CI/deployment gebruikt `prisma generate --generator client`; `npm run db:erd` is alleen lokaal en bouwt ook `docs/assets/erd.svg` **Seeding:** `npx prisma db seed` laadt de testdata uit het Product Backlog document ### Deployment checklist (pre-launch) diff --git a/docs/solo-paneel-spec.md b/docs/solo-paneel-spec.md index 949776c..3777db5 100644 --- a/docs/solo-paneel-spec.md +++ b/docs/solo-paneel-spec.md @@ -4,7 +4,7 @@ > > **Scope v1:** geen REVIEW-status, geen multi-product aggregatie, geen taak-level overrides. Story-level assignment volstaat. Desktop-first conform ST-606 — onder 1024px tonen we dezelfde "te smal scherm"-melding als de rest van de app. > -> **Versie:** v2 — verwerkt antwoorden uit `scrum4me-backlog.md` over sessie-flag, bestaande Server Actions en desktop-first scope. +> **Versie:** v2 — verwerkt antwoorden uit `docs/backlog/index.md` over sessie-flag, bestaande Server Actions en desktop-first scope. --- diff --git a/docs/specs/dialogs/pbi.md b/docs/specs/dialogs/pbi.md index 79fb5ae..ec6b4f1 100644 --- a/docs/specs/dialogs/pbi.md +++ b/docs/specs/dialogs/pbi.md @@ -117,4 +117,4 @@ Specifiek voor PbiDialog (boven op de algemene out-of-scope-lijst in `docs/patte - `lib/task-status.ts` — `PbiStatusApi`-mapper - `docs/patterns/dialog.md` — generieke spec (bron-of-truth) - `docs/scrum4me-architecture.md` — datamodel `Pbi` -- `docs/scrum4me-styling.md` — MD3-tokens, status- en priority-kleuren +- `docs/design/styling.md` — MD3-tokens, status- en priority-kleuren diff --git a/docs/specs/dialogs/story.md b/docs/specs/dialogs/story.md index 250dec0..30715dc 100644 --- a/docs/specs/dialogs/story.md +++ b/docs/specs/dialogs/story.md @@ -160,4 +160,4 @@ Specifiek voor StoryDialog (boven op de algemene out-of-scope-lijst in `docs/pat - `lib/task-status.ts` — status-enum-mapper - `docs/patterns/dialog.md` — generieke spec (bron-of-truth) - `docs/scrum4me-architecture.md` — datamodel `Story` -- `docs/scrum4me-styling.md` — MD3-tokens, status- en priority-kleuren +- `docs/design/styling.md` — MD3-tokens, status- en priority-kleuren diff --git a/docs/specs/dialogs/task.md b/docs/specs/dialogs/task.md index c2ecca1..3c4efe4 100644 --- a/docs/specs/dialogs/task.md +++ b/docs/specs/dialogs/task.md @@ -123,5 +123,5 @@ Specifiek voor TaskDialog (boven op de algemene out-of-scope-lijst in `docs/patt - `docs/patterns/dialog.md` — generieke spec (bron-of-truth voor alles wat hier niet beschreven is) - `docs/scrum4me-architecture.md` — datamodel `Task` -- `docs/scrum4me-styling.md` — MD3-tokens, status- en priority-kleuren +- `docs/design/styling.md` — MD3-tokens, status- en priority-kleuren - `lib/task-status.ts` — enum-mapper DB ↔ API diff --git a/prisma/schema.prisma b/prisma/schema.prisma index 599cdc2..0e8a19f 100644 --- a/prisma/schema.prisma +++ b/prisma/schema.prisma @@ -4,7 +4,7 @@ generator client { generator erd { provider = "prisma-erd-generator" - output = "../docs/erd.svg" + output = "../docs/assets/erd.svg" } datasource db { diff --git a/prisma/seed-data/parse-backlog.ts b/prisma/seed-data/parse-backlog.ts index c8e5390..b8d7390 100644 --- a/prisma/seed-data/parse-backlog.ts +++ b/prisma/seed-data/parse-backlog.ts @@ -116,7 +116,7 @@ export async function loadBacklog( options: { strict?: boolean } = {}, ): Promise { const { strict = true } = options - const file = path.join(repoRoot, 'docs/scrum4me-backlog.md') + const file = path.join(repoRoot, 'docs/backlog/index.md') const md = await readFile(file, 'utf8') const milestones: ParsedMilestone[] = [] diff --git a/prisma/seed.ts b/prisma/seed.ts index 53b645a..956c93a 100644 --- a/prisma/seed.ts +++ b/prisma/seed.ts @@ -1,4 +1,4 @@ -// Seed bron: docs/scrum4me-backlog.md → prisma/seed-data/parse-backlog.ts. +// Seed bron: docs/backlog/index.md → prisma/seed-data/parse-backlog.ts. // Pas alléén de backlog-markdown aan als je seed-data wilt wijzigen, niet deze file. import { PrismaClient } from '@prisma/client' import * as dotenv from 'dotenv' diff --git a/scripts/insert-milestone.ts b/scripts/insert-milestone.ts index 97a0457..d20afbb 100644 --- a/scripts/insert-milestone.ts +++ b/scripts/insert-milestone.ts @@ -5,7 +5,7 @@ // npm run db:insert-milestone -- M8 --product SCRUM4ME # idem // npm run db:insert-milestone -- M8 --dry-run # niets schrijven, alleen tonen // -// Bron: docs/scrum4me-backlog.md (gecommit, single source of truth). +// Bron: docs/backlog/index.md (gecommit, single source of truth). // Tweede keer draaien is veilig: bestaande PBIs/stories/tasks worden niet // gedupliceerd. Sprint-toewijzing doe je apart via Sprint Planning in de UI. @@ -65,7 +65,7 @@ async function main() { const ms = milestones.find((m) => m.key === args.milestoneKey) if (!ms) { throw new Error( - `Milestone ${args.milestoneKey} not found in docs/scrum4me-backlog.md (parsed: ${milestones.map((m) => m.key).join(', ')})`, + `Milestone ${args.milestoneKey} not found in docs/backlog/index.md (parsed: ${milestones.map((m) => m.key).join(', ')})`, ) }