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>
This commit is contained in:
Janpeter Visser
GitHub
parent
b6249a41c0
commit
ff22196714
43 changed files with 296 additions and 951 deletions
|
|
@ -1,15 +1,22 @@
|
|||
---
|
||||
title: "Float sort_order (drag-and-drop volgorde)"
|
||||
title: "sort_order — PBI drag-and-drop vs. code-bindende volgorde voor stories/taken"
|
||||
status: active
|
||||
audience: [ai-agent, contributor]
|
||||
language: nl
|
||||
last_updated: 2026-05-03
|
||||
when_to_read: "When implementing drag-and-drop reordering or inserting between items."
|
||||
last_updated: 2026-05-14
|
||||
when_to_read: "When implementing ordering for PBIs (drag-and-drop) or stories/tasks (code-binding)."
|
||||
---
|
||||
|
||||
# Patroon: Float sort_order (drag-and-drop volgorde)
|
||||
# Patroon: sort_order — PBI vs. Story/Taak
|
||||
|
||||
## Berekening bij tussenvoeging
|
||||
`sort_order` heeft voor PBI's een andere betekenis dan voor stories en taken.
|
||||
|
||||
---
|
||||
|
||||
## PBI — float-insertion (drag-and-drop)
|
||||
|
||||
PBI's ondersteunen drag-and-drop herordening. `sort_order` is een `Float` die via de
|
||||
midpoint-formule wordt berekend bij tussenvoeging:
|
||||
|
||||
```ts
|
||||
function getSortOrder(before: number | null, after: number | null): number {
|
||||
|
|
@ -20,9 +27,9 @@ function getSortOrder(before: number | null, after: number | null): number {
|
|||
}
|
||||
```
|
||||
|
||||
## Herindexeer als precisie opraakt
|
||||
### Herindexeer als precisie opraakt
|
||||
|
||||
Trigger wanneer het kleinste verschil tussen twee opeenvolgende items < 0.001 is.
|
||||
Trigger wanneer het kleinste verschil tussen twee opeenvolgende PBI's < 0.001 is:
|
||||
|
||||
```ts
|
||||
async function reindexIfNeeded(items: { id: string; sort_order: number }[]) {
|
||||
|
|
@ -37,12 +44,62 @@ async function reindexIfNeeded(items: { id: string; sort_order: number }[]) {
|
|||
}
|
||||
```
|
||||
|
||||
## Reorder Server Actions
|
||||
### Reorder Server Action (PBI-only)
|
||||
|
||||
Een drag-and-drop reorder stuurt altijd client-controlled ID-lijsten naar de server. Behandel die lijst als onbetrouwbaar.
|
||||
Een drag-and-drop reorder stuurt client-controlled ID-lijsten naar de server.
|
||||
Behandel die lijst als onbetrouwbaar:
|
||||
|
||||
- Weiger dubbele IDs.
|
||||
- Haal alle IDs op met de parent-scope, bijvoorbeeld `product_id`, `pbi_id`, `sprint_id` of `story_id`.
|
||||
- Haal alle IDs op met de parent-scope (`product_id`).
|
||||
- Weiger de operatie als het aantal gevonden records niet exact gelijk is aan het aantal aangeleverde IDs.
|
||||
- Update pas daarna `sort_order` in een transactie.
|
||||
- Gebruik bij priority changes dezelfde parent uit de database, niet een los meegegeven `productId`.
|
||||
|
||||
---
|
||||
|
||||
## Story / Taak — code-bindende volgorde (geen drag-and-drop)
|
||||
|
||||
Voor stories en taken is `sort_order` een **numerieke spiegel van `code`**, berekend via
|
||||
`parseCodeNumber(code)` uit `lib/code.ts`. Drag-and-drop herordening bestaat niet voor
|
||||
stories en taken.
|
||||
|
||||
### Wanneer `sort_order` wordt gezet
|
||||
|
||||
| Moment | Wat er gebeurt |
|
||||
|---|---|
|
||||
| `story.create` / `task.create` | `sort_order = parseCodeNumber(code)` |
|
||||
| Idea-materialisatie (`materializeIdeaPlanAction`) | idem — stories en taken krijgen `sort_order = parseCodeNumber(storyCode / taskCode)` |
|
||||
| Code-edit (PATCH met nieuw `code`) | `sort_order = parseCodeNumber(newCode)` wordt bijgewerkt |
|
||||
| Sprint-membership-acties | `sort_order` wordt **niet** aangeraakt |
|
||||
|
||||
### `parseCodeNumber`
|
||||
|
||||
Extraheert het trailertal uit een code-string:
|
||||
|
||||
```ts
|
||||
// lib/code.ts
|
||||
export function parseCodeNumber(code: string): number {
|
||||
const match = code.match(/(\d+)$/)
|
||||
return match ? parseInt(match[1], 10) : 0
|
||||
}
|
||||
```
|
||||
|
||||
Voorbeelden: `"ST-042"` → `42`, `"T-7"` → `7`, `"CUSTOM-FOO"` → `0`.
|
||||
|
||||
### Ordering queries
|
||||
|
||||
Stories en taken worden **uitsluitend** op `sort_order` geordend — nooit op `priority`:
|
||||
|
||||
```ts
|
||||
// stories binnen een sprint
|
||||
orderBy: [{ sort_order: 'asc' }]
|
||||
|
||||
// taken binnen een story
|
||||
orderBy: { sort_order: 'asc' }
|
||||
|
||||
// taken binnen een sprint (story-volgorde eerst)
|
||||
orderBy: [{ story: { sort_order: 'asc' } }, { sort_order: 'asc' }]
|
||||
```
|
||||
|
||||
`priority` is een **label** (urgentie-aanduiding voor de gebruiker), geen
|
||||
sorteerkriteria voor stories of taken.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue