Author Matching Question — Backoffice

🔀

Sub-flow: Author Matching Question SUC-CCM-09

This page is a sub-flow invoked from another use case — when finished, control returns to the caller.

Question New Question Matching

Question text *

Matching pairs *

Prompt-answer pairs — each pair has a left-side prompt and its correct right-side answer. Distractor answers (right column only, no matching prompt) are optional, extra items that increase difficulty. All right-column values (matched + distractor) are shuffled when presented to learners.

Prompt (left column)	Answer (right column)




Distractor

Scoring: each correctly matched pair earns an equal share of the total points — floor(correct_pairs / total_pairs × points). Distractor rows are excluded from the pair count.

Answer explanation (optional)

Points *

Total marks this question contributes. Each of the 4 matched pairs earns an equal share.

Cancel Save Question

Prototype — simulate state:

Normal AF 6A: Validation error

Screen Flow (SUC-CCM-09):

→ Save OK → Return to caller (question saved) → Cancel (AF 5A) → Caller (sub_cancelled=1, no save)

Spec notes

Identity

SUC-CCM-09 · Screen: SCR-CCM.07 (Question Editor — Matching)

ReturnUrl context

Current returnUrl: /manage-question-bank/
Fallback: / when returnUrl is empty.
Propagation: Save → returnUrl. Cancel → returnUrl + &sub_cancelled=1.

Sub-flow context

SUC-CCM-09 · Invoked by (Backoffice Portal): SUC-CCM-11 (Build Quiz), UC-CCM.12 (Manage Question Bank).
Question type locked to Matching; cannot change after first save (SCR-CCM.07 AR#2).
New question: form opens blank. Edit mode: pre-filled with the current version's stem, all pairs, distractors, points, and explanation.
Distractor answers (prompt empty) appear only in the right column to increase difficulty.
Partial credit: each correctly matched pair earns an equal share of total points; distractor answers excluded from the pair total (SUC AR#5, SS-CCM.40).
New: Question + QuestionVersion v1 + QuestionMatchPair rows (Active status). Edit: new QuestionVersion vN; prior version preserved for quiz sections already referencing it.
Cancel (AF 5A): unsaved draft discarded; question bank unchanged.

Screen spec: SCR-CCM.07 (match type)

Regions: Question Header · Question Text · Type-Specific Content · Feedback & Explanation · Scoring · Form Actions
question_type: read-only · locked to param type (match) · data_ref: Question.type
question_text: required · 1–5000 chars · data_ref: QuestionVersion.text
match_pairs: dynamic table — prompt (QuestionMatchPair.prompt), answer (QuestionMatchPair.answer), order (drag-drop). At least 2 prompt-answer pairs required, both non-empty; distractor rows have prompt empty, answer non-empty. Controls: "Add pair" (full row), "Add distractor" (row with prompt locked empty), delete row, reorder drag-drop
explanation: optional · max 5000 · shown to all learners post-submit · data_ref: QuestionVersion.config.explanation
points: required · 0.01–1000 · default 1 · data_ref: QuestionVersion.points
SCR AR#1: Type-specific validation — match: at least 2 pairs, both prompt+answer non-empty, distractor values non-empty if added (SS-CCM.09).
SCR AR#2: Question type cannot be changed after first save.
SCR AR#6: Matching partial credit — floor(correct_pairs / total_pairs × points); distractor rows excluded from total_pairs; scoring rule shown below the table.
SUC AR#2: Save is atomic — if saving fails at any step, no partial data is kept (SS-CCM.07).