Initial STEP 3 study game and questions API

2026-07-09 20:50:33 -05:00
commit 277076a245
51 changed files with 2671 additions and 0 deletions
@@ -0,0 +1,16 @@
+# QuestionsApi
+
+STEP-style question bank service for study games and clients.
+
+## Endpoints
+
+- `GET /healthz` Health check.
+- `GET /api/questions/systems` List available systems.
+- `POST /api/questions/search` Search or build a block of questions.
+- `GET /api/questions/{id}` Get one question.
+- `POST /api/questions` Create question (SUPER only).
+- `POST /api/questions/bulk` Upsert questions by `externalId` (SUPER only).
+- `PUT /api/questions/{id}` Update question (SUPER only).
+- `DELETE /api/questions/{id}` Delete question (SUPER only).
+
+Player reads require `USER` or `SUPER` JWT auth. Authoring endpoints require `SUPER`.