Scrum4Me/docs/specs/dialogs/answer-modal.md

title	status	audience	language	last_updated
AnswerModal Profiel	active	ai-agent contributor	nl	2026-05-15

AnswerModal Profiel

Volgt docs/patterns/dialog.md. Beschrijft alleen de Q&A-specifieke afwijkingen.

Doel

Een Claude-agent vraagt tijdens een lopende job een verduidelijking aan de gebruiker. De vraag verschijnt als notification (bell + SSE event). Klik op de notification opent deze dialog waarin de gebruiker antwoordt — vrij tekst (max ANSWER_MAX_CHARS) of een keuze uit options als die meegegeven is.

Velden

Veld	Type	Mode	Validatie
answer	string	both	min 1, max ANSWER_MAX_CHARS (4000), trim

questionId komt uit de prop question.id, niet uit het formulier.

Schema

lib/schemas/question-answer.ts:

• answerQuestionSchema — gedeeld door form + answerQuestion action
• ANSWER_MAX_CHARS constant — gebruikt door textarea + char-counter

URL- of state-pattern

• Gekozen: state-based — question: NotificationQuestion | null-prop uit notifications-sheet.

Server action

• answerQuestion(questionId, answer) in actions/questions.ts
• Result-shape: { ok: true } | { ok: false; error: string }
• Demo-policy: session.isDemo-check in actie blokkeert demo-writes (laag 2). Laag 3 wordt verzorgd door <DemoTooltip> rond submit-knop en disabled-state op de textarea.
• Atomic transition met updateMany voorkomt double-submit races.

Layout

Gebruikt entityDialogContentClasses (§4 spec). Body bevat naast de textarea ook de gestelde vraag (read-only block) en een link naar de bijbehorende sprint. Geen klassieke form-tag — de Textarea is een controlled component.

Speciale gedragingen

Multiple-choice mode

Als question.options niet leeg is, worden de opties getoond als een lijst van knoppen. Klikken op een knop submit direct met die waarde. Het vrije tekstveld en de Verstuur-knop blijven altijd zichtbaar — ook in multiple-choice mode. Zo kan de gebruiker naast de vaste opties ook een eigen antwoord typen en versturen.

Optimistic remove

Na succesvolle submit wordt de vraag direct uit useNotificationsStore verwijderd. De SSE-event komt later met dezelfde verwijdering — voorkomt extra render.

Dirty-tracking

Single-field form: dirty = answer.trim().length > 0. Esc/backdrop/Cancel met dirty-state opent de standaard guard.

Foutcodes

Action geeft alleen { ok, error: string } terug — geen 422-fieldErrors omdat het een single-field form is. Errors worden via toast getoond. Validatie (min 1, max 4000) wordt UI-side voorkomen via maxLength + submit-disable.

Bewust NIET in v1

• ❌ Markdown rendering — antwoord wordt als plain text doorgegeven; Claude leest 'm direct als context.
• ✅ Cmd/Ctrl+Enter shortcut — werkt via useDialogSubmitShortcut in zowel textarea-mode als multiple-choice mode (het vrije tekstveld is altijd aanwezig).
• ❌ Bulk-answer — één vraag tegelijk per dialog.