Scrum4Me/docs/scrum4me-functional-spec.md

Scrum4Me — Functionele Specificatie

Versie: 0.2 — april 2026 Volgt op: Brainstorm v0.3, Personas v0.1

---

MVP-scopeverklaring

v1 is een desktop-first fullstack webapplicatie waarmee een solo developer of klein Scrum Team meerdere softwareprojecten hiërarchisch kan plannen (product → PBI → story → taak), Sprints kan beheren via gesplitste schermen met drag-and-drop, en Claude Code kan integreren voor geautomatiseerde implementatieflows waarbij elk resultaat wordt vastgelegd in de story. Een Product Owner kan Developers (via gebruikersnaam) aan een product backlog koppelen; zij krijgen dan schrijfrechten op stories, taken en sprints van dat product. De app is deployable op Vercel + Neon én volledig lokaal draaibaar.

Expliciet buiten scope voor v1

• Uitnodigingsflow voor teams — Developers toevoegen via gebruikersnaam is beschikbaar; e-mailuitnodiging of link-gebaseerde onboarding komt in v2
• E-mailverificatie bij registratie — gebruikersnaam/wachtwoord volstaat voor v1
• Daily Scrum, Sprint Review en Sprint Retrospective schermen — v2
• Automatische statusupdate van stories na commit — handmatige update via UI in v1
• Tijdregistratie, urenverantwoording en burndown-charts — buiten positionering
• Integratie met externe tools (GitHub Issues, Linear, Jira) — v2
• Notificaties en reminders — v2
• Native mobiele app — web-first; een toekomstige mobiele variant richt zich uitsluitend op taken afvinken
• Responsive layout voor schermen smaller dan 1024px — desktop-first in v1

---

Feature-specificaties

F-01: Authenticatie

Prioriteit: v1 — Kritiek Persona: Lars, Dina, Remi

Omschrijving: Gebruikers kunnen een account aanmaken en inloggen met gebruikersnaam en wachtwoord. Er is een ingebouwde demo-gebruiker met alleen leesrechten. Geen e-mailverificatie vereist in v1.

Acceptatiecriteria:

• Registratie vereist gebruikersnaam (uniek, min. 3 tekens) en wachtwoord (min. 8 tekens)
• Dubbele gebruikersnaam geeft duidelijke foutmelding bij registratie
• Inloggen met incorrecte combinatie geeft generieke foutmelding (geen onderscheid naam/wachtwoord)
• Na inloggen wordt de gebruiker doorgestuurd naar het dashboard
• Sessie blijft actief totdat de gebruiker uitlogt
• Demo-gebruiker kan inloggen met vaste credentials (zichtbaar op de loginpagina)
• Demo-gebruiker kan niets aanmaken, aanpassen of verwijderen
• Alle schrijfknoppen zijn zichtbaar maar uitgeschakeld voor de demo-gebruiker, met tooltip "Niet beschikbaar in demo-modus"
• Uitlogknop is altijd zichtbaar in de navigatie

Randgevallen:

• Gebruiker probeert beschermde route te bezoeken zonder sessie → redirect naar /login
• Demo-gebruiker probeert via de API te schrijven → 403 Forbidden

Data:

• Opgeslagen: users (id, username, password_hash, role[], is_demo, created_at)
• Sessie: JWT of server-side sessie met user_id en is_demo vlag

---

F-02: Roltoewijzing

Prioriteit: v1 — Fundament voor v2 Persona: Remi (v2), Lars en Dina (impliciet)

Omschrijving: Een gebruiker kan bij registratie of in instellingen één of meerdere Scrum-rollen aannemen: Product Owner, Scrum Master, Developer. De rol Developer is relevant voor teambeheer: alleen gebruikers met de rol Developer kunnen aan een product backlog worden gekoppeld door de eigenaar.

Acceptatiecriteria:

• Gebruiker kan bij registratie of achteraf in instellingen rollen selecteren
• Minimaal één rol is verplicht
• Alle drie de rollen tegelijk zijn toegestaan
• Geselecteerde rollen zijn zichtbaar in de profielbalk
• Alleen gebruikers met de rol Developer kunnen als teamlid aan een product backlog worden gekoppeld
• Demo-gebruiker heeft een vaste rol (Developer) die niet gewijzigd kan worden

Data:

• Opgeslagen: user_roles[] als array op het gebruikersobject (enum: PRODUCT_OWNER, SCRUM_MASTER, DEVELOPER)

---

F-03: Productbeheer

Prioriteit: v1 — Kritiek Persona: Lars (meerdere eigen projecten), Dina (per klant), Remi (per team-product)

Omschrijving: Gebruikers kunnen producten aanmaken, bewerken en archiveren. Een product is het hoogste niveau in de hiërarchie en bevat een naam, beschrijving, git-repo URL en de Definition of Done. Alle andere entiteiten (PBI's, stories, taken) horen bij een product.

Acceptatiecriteria:

• Product aanmaken vereist een naam (uniek per gebruiker, verplicht)
• Beschrijving is optioneel (vrije tekst, max. 1000 tekens)
• Git-repo URL is optioneel; wordt gevalideerd als geldige URL bij invullen
• Definition of Done is een vaste tekst, instelbaar per product (verplicht bij aanmaken, max. 500 tekens)
• Product verschijnt direct in de productenlijst na aanmaken
• Naam en alle andere velden zijn bewerkbaar na aanmaken
• Archiveren is omkeerbaar; gearchiveerde producten zijn standaard verborgen
• Productenlijst toont: naam, beschrijving (ingekort tot 80 tekens), git-repo link (indien aanwezig)
• Klikken op een product opent de Product Backlog van dat product
• Lege staat toont een duidelijke prompt om een eerste product aan te maken

Randgevallen:

• Gebruiker probeert naam leeg te maken bij bewerken → validatiefout, opslaan geblokkeerd
• Git-repo URL zonder https:// → validatiefout met suggestie

Data:

• Opgeslagen: products (id, user_id, name, description, repo_url, definition_of_done, archived, created_at, updated_at)

---

F-04: Product Backlog — gesplitst scherm

Prioriteit: v1 — Kritiek Persona: Lars, Dina, Remi

Omschrijving: De Product Backlog wordt weergegeven als een gesplitst scherm: links de PBI's gerangschikt op prioriteit en volgorde, rechts de stories van het geselecteerde PBI. De splitter is horizontaal versleepbaar. Elk paneel heeft een eigen navigatiebar met acties (aanmaken, filteren, verwijderen).

Acceptatiecriteria:

• Standaard splitverhouding is 40/60 (PBI's / stories)
• Splitter is versleepbaar; positie wordt lokaal opgeslagen (localStorage)
• Selecteren van een PBI links toont de bijbehorende stories rechts
• Geselecteerd PBI is visueel gemarkeerd (achtergrondkleur of rand)
• Linkerpaneel navigatiebar bevat: [+ PBI aanmaken], [filter], [verwijderen]
• Rechterpaneel navigatiebar bevat: [+ Story aanmaken], [filter], [verwijderen]
• Lege staat links: prompt om eerste PBI aan te maken
• Lege staat rechts (geen PBI geselecteerd): instructie om een PBI te selecteren
• Lege staat rechts (PBI geselecteerd, geen stories): prompt om eerste story aan te maken

Randgevallen:

• Scherm smaller dan 768px → gesplitst scherm schakelt over naar tabbladen (PBI's / Stories)

---

F-05: PBI-beheer

Prioriteit: v1 — Kritiek Persona: Lars, Dina, Remi

Omschrijving: Product Backlog Items kunnen worden aangemaakt, bewerkt, geprioriteerd (1–4) en gerangschikt via drag-and-drop binnen dezelfde prioriteitsgroep. PBI's worden gegroepeerd per prioriteit met een visuele scheiding.

Acceptatiecriteria:

• PBI aanmaken vereist een titel (verplicht, max. 200 tekens)
• Omschrijving is optioneel (vrije tekst, max. 2000 tekens)
• Prioriteit is verplicht (1 = Kritiek, 2 = Hoog, 3 = Middel, 4 = Laag)
• PBI's worden gegroepeerd per prioriteit; elke groep heeft een visueel label en scheidingslijn
• Binnen een prioriteitsgroep is de volgorde instelbaar via drag-and-drop (dnd-kit)
• Slepen over een prioriteitsgrens wijzigt de prioriteit van het PBI
• Volgorde en prioriteit worden direct opgeslagen na loslaten
• PBI bewerken (titel, omschrijving, prioriteit) via inline bewerkingsmodus
• PBI verwijderen vereist bevestiging; cascade-verwijdering van gekoppelde stories en taken
• Bevestigingsdialoog vermeldt expliciet dat stories en taken ook verwijderd worden
• Filter op prioriteit werkt realtime; actief filter is visueel zichtbaar en eenvoudig te wissen
• Drag-and-drop placeholder toont de doelpositie tijdens het slepen

Randgevallen:

• Prioriteitsgroep is leeg na verplaatsing → groep verdwijnt uit de weergave
• PBI met stories verwijderen → bevestigingsdialoog toont het aantal gekoppelde stories

Data:

• Opgeslagen: pbis (id, product_id, title, description, priority (1–4), sort_order, created_at, updated_at)

---

F-06: Story-beheer

Prioriteit: v1 — Kritiek Persona: Lars, Dina, Remi

Omschrijving: Stories worden weergegeven als compacte blokken (~10% schermbreedte) in het rechterpaneel van de Product Backlog, gerangschikt op prioriteit. Ze kunnen worden aangemaakt, bewerkt, geprioriteerd en gerangschikt via drag-and-drop.

Acceptatiecriteria:

• Story aanmaken vereist een titel (verplicht, max. 200 tekens)
• Omschrijving is optioneel (vrije tekst, max. 2000 tekens)
• Acceptatiecriteria zijn optioneel (vrije tekst, max. 2000 tekens)
• Prioriteit is verplicht (1–4, zelfde schaal als PBI's)
• Stories worden weergegeven als blokken van ~10% schermbreedte, horizontaal gerangschikt
• Blokken tonen: storytitel (ingekort), prioriteit-badge, status-badge
• Elke prioriteitsgroep heeft een visuele scheiding (gekleurde band of scheidingslijn)
• Volgorde binnen een prioriteitsgroep is instelbaar via drag-and-drop (dnd-kit)
• Slepen over een prioriteitsgrens wijzigt de prioriteit van de story
• Klikken op een storyblok opent de story-detailweergave (slide-over of modal)
• Story verwijderen vereist bevestiging; cascade-verwijdering van gekoppelde taken
• Stories die aan een Sprint gekoppeld zijn tonen een badge "In Sprint [naam]"

Randgevallen:

• Storytitel is langer dan past in het blok → afgekapt met ellipsis, volledige titel zichtbaar bij hover

Data:

• Opgeslagen: stories (id, pbi_id, product_id, title, description, acceptance_criteria, priority (1–4), sort_order, status (OPEN | IN_SPRINT | DONE), sprint_id?, created_at, updated_at)

---

F-07: Story-activiteitenlog

Prioriteit: v1 — Kern van Claude Code-integratie Persona: Lars

Omschrijving: Elke story heeft een activiteitenlog die alle door Claude Code vastgelegde stappen toont: implementatieplannen, testresultaten en commits. De log is zichtbaar in de story-detailweergave en is read-only vanuit de UI.

Acceptatiecriteria:

• Log toont alle entries in chronologische volgorde (oudste eerst)
• Elk entry-type heeft een eigen visuele stijl:
  • implementation_plan: blauw, icoon document
  • test_result (passed): groen, icoon vinkje
  • test_result (failed): rood, icoon kruis
  • commit: paars, icoon git-branch
• Commit-entries tonen de hash (ingekort, bijv. a1b2c3d) en commit-bericht
• Commit-hash is klikbaar als de git-repo URL is ingesteld op het product; opent in nieuw tabblad
• Log is leeg bij nieuwe stories → lege staat toont "Nog geen activiteit vastgelegd"
• Log is niet bewerkbaar via de UI

Data:

• Opgeslagen: story_logs (id, story_id, type (IMPLEMENTATION_PLAN | TEST_RESULT | COMMIT), content, status? (PASSED | FAILED), commit_hash?, commit_message?, created_at)

---

F-08: Todo-lijst

Prioriteit: v1 — Hoog Persona: Lars (snelle vastlegging), Dina (losse klantnotities)

Omschrijving: Een snelle todo-lijst voor taken die aan een specifiek product zijn gekoppeld. Todo-items kunnen worden afgevinkt en gepromoveerd naar een PBI of story in dat product. Zowel de UI als de REST API vereisen een product_id bij aanmaken — zodat Claude Code altijd werkt binnen de context van de actieve product backlog.

Acceptatiecriteria:

• Todo aanmaken via snel-invoerveld (Enter om op te slaan); product (dropdown) en titel verplicht
• Todo aanmaken ook mogelijk via REST API: POST /api/todos (body: { "title": string, "product_id": string }) — zodat Claude Code bevindingen kan vastleggen binnen de actieve product backlog
• Todo-lijst is zichtbaar als apart scherm of persistent zijpaneel
• Todo afvinken markeert het als afgerond (visueel doorgestreept)
• Afgevinkte todo's blijven zichtbaar; kunnen worden gearchiveerd via "Archiveer afgeronde items"
• Todo promoveren naar PBI: dialoog pre-selecteert het gekoppelde product (bewerkbaar), vraagt prioriteit; todo verdwijnt na promotie
• Todo promoveren naar story: dialoog pre-selecteert het gekoppelde product (bewerkbaar), vraagt PBI en prioriteit; todo verdwijnt na promotie
• Titel van het todo-item is vooringevuld in de promotiedialoog (bewerkbaar)
• Promotie is niet ongedaan te maken; dialoog waarschuwt hiervoor

Randgevallen:

• Geen producten aangemaakt → promotie-dialoog toont melding "Maak eerst een product aan"
• Promoveren naar story zonder PBI's in het product → dialoog toont melding "Maak eerst een PBI aan"

Data:

• Opgeslagen: todos (id, user_id, product_id, title, done, archived, created_at, updated_at)

---

F-09: Sprint aanmaken en beheren

Prioriteit: v1 — Hoog Persona: Lars, Dina, Remi

Omschrijving: Het Scrum Team kan een Sprint aanmaken met een Sprint Goal. Per product kan er één actieve Sprint zijn. Stories worden via een gesplitst scherm vanuit de Product Backlog naar de Sprint Backlog gesleept.

Acceptatiecriteria:

• Sprint aanmaken vereist een Sprint Goal (verplicht, max. 500 tekens)
• Sprint is gekoppeld aan een product
• Er kan maar één actieve Sprint per product tegelijk zijn
• Sprint Backlog scherm is gesplitst: Sprint Backlog links, stories per PBI rechts
• Rechterpaneel toont alle PBI's inklapbaar, met hun stories eronder
• Stories die al in de Sprint zitten zijn visueel gemarkeerd en niet opnieuw sleepbaar
• Story naar Sprint slepen via drag-and-drop (dnd-kit) van rechts naar links
• Story in de Sprint Backlog is herrangschikbaar via drag-and-drop
• Story uit Sprint verwijderen via contextmenu of verwijderknop → story keert terug in Product Backlog
• Sprint Goal is bewerkbaar na aanmaken
• Sprint afronden zet alle stories op DONE of terug op OPEN (keuze per story in afronden-dialoog)

Randgevallen:

• Gebruiker probeert tweede Sprint aan te maken terwijl er al een actieve Sprint is → foutmelding met link naar actieve Sprint
• Story wordt uit Sprint verwijderd terwijl er taken aan hangen → taken blijven bestaan maar worden losgekoppeld van de Sprint

Data:

• Opgeslagen: sprints (id, product_id, sprint_goal, status (ACTIVE | COMPLETED), created_at, completed_at?)

---

F-10: Sprint Planning — taken aanmaken

Prioriteit: v1 — Hoog Persona: Lars, Remi

Omschrijving: In het Sprint Planning scherm worden stories uit de Sprint Backlog opgedeeld in taken. Het scherm is gesplitst: stories links, taken van de geselecteerde story rechts. Taken kunnen worden geprioriteerd en gerangschikt via drag-and-drop.

Acceptatiecriteria:

• Sprint Planning scherm toont Sprint Backlog stories links in volgorde
• Selecteren van een story links toont de bijbehorende taken rechts
• Taak aanmaken vereist een titel (verplicht, max. 200 tekens)
• Omschrijving is optioneel (max. 1000 tekens)
• Prioriteit is verplicht (1–4)
• Taken zijn gerangschikt op prioriteit en volgorde; volgorde instelbaar via drag-and-drop (dnd-kit)
• Taakstatus is instelbaar via de UI: TO_DO | IN_PROGRESS | DONE
• Story toont een voortgangsindicator (bijv. "2/5 taken Done")
• Taak verwijderen vereist bevestiging

Randgevallen:

• Story heeft geen taken → lege staat rechts met prompt om eerste taak aan te maken
• Alle taken van een story zijn Done → story-voortgang toont 100% maar story-status wijzigt niet automatisch

Data:

• Opgeslagen: tasks (id, story_id, sprint_id, title, description, priority (1–4), sort_order, status (TO_DO | IN_PROGRESS | DONE), created_at, updated_at)

---

F-11: Claude Code REST API

Prioriteit: v1 — Kern-differentiator Persona: Lars

Omschrijving: Een REST API waarmee Claude Code stories en taken kan ophalen, de taakvolgorde kan beoordelen en aanpassen, en implementatieplannen, testresultaten en commits kan vastleggen. Alle endpoints zijn beveiligd via een API-token.

Acceptatiecriteria:

Endpoints:

• GET /api/products — lijst van actieve producten
• GET /api/products/:id/next-story — hoogst geprioriteerde open story van de actieve Sprint
• GET /api/sprints/:id/tasks?limit=10 — eerste N taken in huidige volgorde
• PATCH /api/stories/:id/tasks/reorder — accepteert geordende lijst van taak-id's
• POST /api/stories/:id/log — vastleggen van implementatieplan, testresultaat of commit
• PATCH /api/tasks/:id — status bijwerken (TO_DO → IN_PROGRESS → DONE) en/of implementation_plan opslaan
• POST /api/todos — todo aanmaken vanuit Claude Code (body: { "title": string, "product_id": string })

Authenticatie:

• Alle endpoints vereisen Authorization: Bearer <token> header
• Ontbrekend of ongeldig token geeft 401 Unauthorized
• Demo-gebruiker API-token geeft 403 op alle schrijf-endpoints

Responsformaat:

• Alle responses zijn JSON
• Foutresponses bevatten { "error": "omschrijving" }
• GET /api/products/:id/next-story geeft 404 als er geen open stories zijn

Data:

• Opgeslagen: api_tokens (id, user_id, token_hash, label, created_at, revoked_at?)

---

F-12: API-tokenbeheer

Prioriteit: v1 — Vereiste voor Claude Code-integratie Persona: Lars

Omschrijving: Gebruikers kunnen API-tokens aanmaken, labelen en intrekken via de instellingenpagina. Een token wordt eenmalig in klare tekst getoond en daarna niet meer.

Acceptatiecriteria:

• Gebruiker kan een token aanmaken met een optioneel label (bijv. "Claude Code — laptop")
• Token wordt eenmalig getoond na aanmaken in een kopieerbaar veld
• Na sluiten van het dialoog is de tokennwaarde niet meer opvraagbaar
• Tokenoverzicht toont: label, aanmaakdatum, status (actief / ingetrokken)
• Gebruiker kan een token intrekken; ingetrokken tokens werken direct niet meer
• Maximaal 10 actieve tokens per gebruiker

Randgevallen:

• Gebruiker sluit aanmaakmeldingsdialoog per ongeluk → token bestaat al, maar waarde is verloren; gebruiker moet een nieuw token aanmaken

---

F-13: Lokale en cloud deployment

Prioriteit: v1 — Kritiek Persona: Lars (lokaal, geen vendor lock-in), Dina (cloud)

Omschrijving: De app is deployable op Vercel + Neon PostgreSQL en lokaal draaibaar met een Neon-database. Eén codebase, PostgreSQL via Prisma.

Acceptatiecriteria:

• npm run dev start de app lokaal met Neon-database
• DATABASE_URL in .env.local verwijst naar Neon connection string
• npx prisma db push initialiseert het schema
• next build slaagt voor Vercel-deployment zonder aanpassingen
• .env.example documenteert alle vereiste en optionele environment variables
• README bevat stap-voor-stap instructies voor zowel lokale als cloud setup

---

Navigatiestructuur

/ (landingspagina — app-uitleg, Scrum-samenvatting, gebruikershandleiding, API-overzicht)
/login
/register

/dashboard                          (productenlijst)
/products/new                       (product aanmaken)
/products/:id                       (Product Backlog — gesplitst scherm)
/products/:id/sprint                (Sprint Backlog — gesplitst scherm)
/products/:id/sprint/planning       (Sprint Planning — gesplitst scherm)
/todos                              (todo-lijst)
/settings                           (profiel, rollen, mijn teams, API-tokens)
/settings/tokens                    (API-tokenbeheer)

---

Datamodel (schets)

Entiteit	Sleutelvelden	Relaties / opmerkingen
users	id, username, password_hash, is_demo, created_at	Basis authenticatie-entiteit
user_roles	id, user_id, role (enum)	Meervoudige rollen per gebruiker
api_tokens	id, user_id, token_hash, label, revoked_at	Max. 10 actief per gebruiker
products	id, user_id, name, description, repo_url, definition_of_done, archived	Hoogste niveau in de hiërarchie
pbis	id, product_id, title, description, priority (1–4), sort_order	Geordend binnen prioriteitsgroep
stories	id, pbi_id, product_id, title, description, acceptance_criteria, priority, sort_order, status, sprint_id?	Status: OPEN / IN_SPRINT / DONE
story_logs	id, story_id, type, content, status?, commit_hash?, commit_message?, created_at	Aangemaakt via API; read-only in UI
sprints	id, product_id, sprint_goal, status (ACTIVE / COMPLETED), created_at, completed_at?	Max. 1 actieve Sprint per product
tasks	id, story_id, sprint_id, title, description, implementation_plan?, priority, sort_order, status	Status: TO_DO / IN_PROGRESS / DONE; implementation_plan door MCP
todos	id, user_id, product_id, title, done, archived, created_at	Gekoppeld aan product backlog; verplicht in UI en API
product_members	id, product_id, user_id, created_at	Many-to-many; alleen Developers; eigenaar via products.user_id

---

Niet-functionele vereisten

Vereiste	Waarde
Platform	Desktop-first web (minimale breedte 1024px); toekomstige mobiele variant beperkt tot taken afvinken
Authenticatie	Gebruikersnaam + wachtwoord; geen e-mailverificatie in v1
Drag-and-drop	dnd-kit (useDraggable / useDroppable); 60fps vereist bij lijsten tot 100 items
API-beveiliging	Bearer token op alle /api/* routes
Offline support	Niet vereist voor v1
Taal	Nederlands voor UI-teksten; Engels voor code, API en technische documentatie
Toegankelijkheid	Keyboard-navigatie voor alle primaire acties; WCAG AA voor de sprint planning flow
Database	Prisma ORM; PostgreSQL via Neon
Deployment	Vercel (cloud) of lokaal via npm run dev
Sessiebeheer	Server-side sessie of JWT; geen opslag van gevoelige data in localStorage

---

Sleutel-user-flows

Flow 1: Lars start zijn avond

Startpunt: Dashboard (na inloggen)

1. Lars ziet zijn productenlijst — vier producten, elk met naam en beschrijving
2. Hij klikt op "Factuur-tool"
3. Product Backlog opent — PBI's links, stories rechts
4. Hij ziet drie open PBI's; klikt op "Betalingsverwerking"
5. Vijf stories verschijnen rechts als blokken; twee hebben badge "In Sprint"
6. Hij navigeert naar Sprint Planning
7. Selecteert een story links, ziet de bijbehorende taken rechts
8. Maakt een nieuwe taak aan: "Stripe webhook valideren" → prioriteit 1
9. Opent terminal, start Claude Code
10. Claude haalt de taak op via API, stelt implementatieplan op
11. Plan verschijnt direct in de story-activiteitenlog in de app

Resultaat: Lars heeft in minder dan vijf minuten overzicht en Claude Code is aan het werk.

---

Flow 2: Claude Code volledige cyclus

Startpunt: Claude Code in terminal

1. claude devplanner next — haalt hoogst geprioriteerde open story op via GET /api/products/:id/next-story
2. Claude toont storytitel en acceptatiecriteria
3. Claude haalt eerste 10 taken op via GET /api/sprints/:id/tasks?limit=10
4. Claude beoordeelt volgorde en past aan via PATCH /api/stories/:id/tasks/reorder
5. Claude stelt implementatieplan op → POST /api/stories/:id/log (type: IMPLEMENTATION_PLAN)
6. Claude voert implementatie uit
7. Claude draait tests → POST /api/stories/:id/log (type: TEST_RESULT, status: PASSED)
8. Claude maakt commit → POST /api/stories/:id/log (type: COMMIT, hash, message)
9. Lars opent de story in de app — ziet plan, testresultaat en commit-hash in de activiteitenlog
10. Lars zet de story handmatig op DONE via de UI

Resultaat: Volledige traceerbaarheid van beslissing tot commit, zonder extra handmatige invoer.

---

Flow 3: Todo promoveren naar story

Startpunt: Todo-lijst

1. Lars heeft een todo: "Voeg rate limiting toe aan de API"
2. Hij klikt op "Promoveren → Story"
3. Dialoog opent: product (vooringevuld met laatste product), PBI (dropdown), prioriteit
4. Hij kiest product "Factuur-tool", PBI "Beveiliging", prioriteit 2
5. Bevestigen → todo verdwijnt, story is aangemaakt
6. Lars navigeert naar de Product Backlog → story staat in de juiste prioriteitsgroep

Resultaat: Losse gedachte is in drie stappen onderdeel van de formele Product Backlog.