Scrum4Me/docs/INDEX.md
Janpeter Visser ff22196714
Sprint: Stories en taken krijgen één voorspelbare volgorde gekoppeld aan hun code; drag-and-drop herordening voor stories/taken verdwijnt, priority wordt puur label. (#201)
* feat(code): add parseCodeNumber helper to lib/code.ts

Pure helper that extracts the trailing numeric sequence from a code string
(ST-007 → 7, T-42 → 42). Non-conforming codes fall back to Number.MAX_SAFE_INTEGER
so they sort to the end. Includes 5 unit tests.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(tasks): add code field to BacklogTask type and all task selects

Adds `code: string | null` to BacklogTask interface and includes it in
all Prisma task.findMany selects (backlog API, stories tasks API, page
hydration routes). Updates coerceTaskPayload and test fixtures to match.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(sort-order): derive story/task sort_order from parseCodeNumber(code)

All create paths (createStoryAction, saveTask, createTaskAction,
materializeIdeaPlanAction) and code-edit paths (updateStoryAction, saveTask
update) now set sort_order = parseCodeNumber(code) instead of last+1.
Removes stale last-record queries from create paths.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(sort-order): decouple sprint membership actions from sort_order

createSprintAction and addStoryToSprintAction no longer write sort_order
when adding stories to a sprint. sort_order is derived from code via
parseCodeNumber, so membership should only set sprint_id + status.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(ordering): remove priority from all story/task orderBy

Story- en taak-ordering is nu puur sort_order asc (created_at als
tiebreaker). PBI-ordering (priority + sort_order) blijft ongewijzigd.

Gewijzigd: backlog/route, pbis/stories/route, claude-context/route,
next-story/route, workspace/route, tasks/route, sprint-runs (query +
in-memory sort), solo-workspace-server, page.tsx (app + mobile + sprint),
store compareStory, actions/sprints story-query, next-story test.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(dnd): remove drag-and-drop reorder for stories and tasks

- Remove reorderStoriesAction, reorderTasksAction, reorderSprintStoriesAction
- Delete REST route app/api/stories/[id]/tasks/reorder/route.ts
- Remove DnD from backlog story-panel and task-panel (flat list)
- Remove reorder-within-sprint branch from sprint-board-client handleDragEnd
- Switch SortableSprintRow to plain SprintRow using useDraggable (membership drag kept)
- Remove all DnD from task-list (status toggle + edit kept)
- Remove story-order/task-order/sprint-story-order/sprint-task-order mutation types and store handlers
- Remove related tests for deleted reorder route; fix sprint store tests

* feat(backlog): toon code-badge op backlog-taakkaarten

Geeft code={task.code} door aan <BacklogCard> in TaskCard (task-panel.tsx).
BacklogCard rendert de CodeBadge al conditionally — alleen de prop ontbrak.

* feat(migration): backfill story/task sort_order from code numeric suffix

One-time Prisma migration that sets sort_order = trailing numeric part
of code for all existing stories and tasks, consistent with
parseCodeNumber (fallback = Number.MAX_SAFE_INTEGER for non-conforming
codes). PBIs are intentionally excluded.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs+tests(sort-order): update for code-binding order on stories/tasks

- Rewrite docs/patterns/sort-order.md: float-insertion PBI only; story/task
  sort_order = parseCodeNumber(code), never drag/membership mutated
- Update plan-to-pbi-flow.md: sort_order auto, sprint_id param, priority=label
- Update make-plan.md: priority=label, array order = execution order
- Update rest-contract.md: fix sprint-tasks ordering, remove reorder endpoint
- Add ADR-0011: code is bindende volgordesleutel voor stories/taken
- Regenerate docs/INDEX.md via npm run docs
- Remove reorderStoriesAction/reorderTasksAction mocks from backlog tests
- Remove dnd-kit mocks from task-panel test (panel no longer uses dnd)
- Extend materializeIdeaPlanAction test: assert sort_order=parseCodeNumber(code)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-14 19:02:36 +02:00

14 KiB

Documentation Index

Auto-generated on 2026-05-14 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
0010 ADR-0010: Eén product = één repo; cross-product planning vereist (later) een Initiative-laag accepted
0011 ADR-0011: code is de bindende volgordesleutel voor stories en taken; priority is label accepted

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

Title Status Updated
PBI Bulk-Create Spec — Docs-Restructure for AI-Optimized Lookup done 2026-05-03
Plan: model + mode-selectie per ClaudeJob-kind
Verbeterplan load/render Product Backlog, Sprint en Solo draft 2026-05-10
M12 — Idea entity + Grill/Plan Claude jobs planned
Bootstrap-wizard voor nieuwe Product-repo
Plan v3.5 — Bootstrap-wizard voor nieuwe Product-repo (Scrum4Me feature) reviewed
PBI-80 — Demo-gebruiker mag eigen UI-voorkeuren wijzigen
Plan — code wordt bindende volgorde voor stories & taken; drag-and-drop eruit
Queue-loop verplaatsen van Claude naar runner
Sprint MCP-tools — create_sprint & update_sprint draft 2026-05-11
Advies - SprintRun, PR en worktree lifecycle als state machines draft 2026-05-06
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
Plan: wekelijkse sync van model_prices (PBI-66 / ST-1296)
Tweede Claude Agent — Planning Agent proposal 2026-05-03
Zustand store rearchitecture - active context, realtime en resync ready-to-execute 2026-05-09
Zustand workspace-store implementatieplan (PBI-74) in-progress 2026-05-10

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
Demo client-state (UI-prefs zonder DB) active 2026-05-12
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
sort_order — PBI drag-and-drop vs. code-bindende volgorde voor stories/taken active 2026-05-14
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
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 — Glossary glossary.md active 2026-05-08
Onderzoek — AI-gedreven programmeren en Scrum planning Ideas/ai-driven-scrum-planning-research.md draft 2026-05-11
Installatieplan — Beelink Ubuntu Scrum4Me server en worker-aanpassingen Ideas/beelink-scrum4me-server-install-and-worker-plan.md draft 2026-05-10
Advies — Product Backlog en Sprint-pagina workflow Ideas/sprint-page-backlog-relationship-research.md draft 2026-05-11
ST-1114 — Copilot reviews op dashboard Ideas/ST-1114-copilot-reviews.md active 2026-05-03
IDEA_REVIEW_PLAN Implementation Summary implementation-complete/IDEA_REVIEW_PLAN-implementation-summary.md
IDEA_REVIEW_PLAN Implementation — COMPLETE implementation-complete/IMPLEMENTATION-COMPLETE.md
Phase 6: End-to-End Testing & Rollout Plan implementation-complete/PHASE6-END-TO-END-TEST-PLAN.md
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
DevPlanner — User Personas personas.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
Review - Bootstrap-wizard plan recommendations/bootstrap-wizard-plan-review-2026-05-13.md draft 2026-05-13
Review - Bootstrap-wizard plan v2 met webresearch recommendations/bootstrap-wizard-plan-v2-web-research-review-2026-05-13.md draft 2026-05-13
Review - Bootstrap-wizard plan v3.2 recommendations/bootstrap-wizard-plan-v3-2-review-2026-05-14.md draft 2026-05-14
Review - Bootstrap-wizard plan v3.3 recommendations/bootstrap-wizard-plan-v3-3-review-2026-05-14.md draft 2026-05-14
Review — M8 bootstrap-wizard plan v3.4 recommendations/bootstrap-wizard-plan-v3-4-review-2026-05-14.md
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
Review — code als bindende volgorde voor stories en taken reviews/onderzoek-wat-er-gedaan-quirky-mist-review.md
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
Plan → Sprint/PBI/Story/Task workflow runbooks/plan-to-pbi-flow.md active 2026-05-11
Review-Plan Job Orchestration runbooks/review-plan-job.md
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
Scrum4Me — API Test Plan test-plan.md active 2026-05-03