Embed question verification references

2026-07-13 22:29:20 -05:00
parent 0fe47de423
commit 292f8ff9b4
10 changed files with 203 additions and 4 deletions
@@ -11,6 +11,7 @@ STEP-style question bank service for study games and clients.
 - `GET /api/questions/{id}` Get one question.
 - `POST /api/questions` Create question (SUPER only).
 - `POST /api/questions/bulk` Upsert questions by `externalId` (SUPER only).
+- `POST /api/questions/admin/references/bulk` Update only embedded verification references by `externalId` (SUPER only).
 - `PUT /api/questions/{id}` Update question (SUPER only).
 - `DELETE /api/questions/{id}` Delete question (SUPER only).
 - `POST /api/question-reports` Submit a categorized question report (USER or SUPER).
@@ -39,7 +40,10 @@ extra distractors to existing questions.
 Search clients that set `supportsChoicePools: true` receive each complete
 choice pool. Older clients receive five server-selected choices that always
 include the correct answer. Published questions require 5-20 unique choices,
-an explanation for every choice, and a follow-up for every incorrect choice.
+an explanation for every choice, a follow-up for every incorrect choice, and at
+least one embedded authoritative verification reference. Legacy published
+questions without references remain readable but must add references before a
+future authoring update.

 - `GET /readyz` verifies MongoDB connectivity for readiness checks.
 - `GET /metrics` exposes Prometheus-format service and reconciliation metrics.