Merge S5-6 schema layout/provenance surface (API)

tests/test_exam_templates.py

@@ -255,12 +255,14 @@ def test_get_template_bundles_children():
         "exam_questions": [{"id": "q1", "template_id": "t1", "label": "01", "order": 0}],
         "exam_response_areas": [{"id": "r1", "template_id": "t1", "question_id": "q1", "page": 1}],
         "exam_boundaries": [{"id": "b1", "template_id": "t1", "page_index": 0, "y": 10}],
+        "exam_template_layout": [{"id": "l1", "template_id": "t1", "page_index": 0, "role": "question_page"}],
     }
     client, _ = make_client(store=store)
     body = client.get("/api/exam/templates/t1").json()
     assert len(body["questions"]) == 1
     assert len(body["response_areas"]) == 1
     assert len(body["boundaries"]) == 1
+    assert body["layout"] == [{"id": "l1", "template_id": "t1", "page_index": 0, "role": "question_page"}]
 
 
 def test_get_other_institute_template_is_404():
@@ -315,6 +317,42 @@ def test_put_persists_region_kinds_and_part_geometry():
     assert ras["c1"]["context_type"] == "data_table"
 
 
+
+def test_put_round_trips_s5_layout_and_provenance_fields():
+    store = {"exam_templates": [{"id": "t1", "title": "p", "status": "draft", "institute_id": INST_A, "teacher_id": TEACHER}]}
+    client, store = make_client(store=store)
+    payload = {
+        "questions": [{
+            "id": "q1", "label": "01", "order": 0, "max_marks": 4, "source": "ai",
+            "confirmed": False, "confidence": 0.82, "derivation": "docling:heading",
+        }],
+        "response_areas": [{
+            "id": "m1", "question_id": "q1", "page": 1, "bounds": {"x": 1}, "kind": "mark_area",
+            "mark_subtype": "grader_box", "source": "ai", "confirmed": False, "confidence": 0.71,
+            "derivation": "detected-explicit-grader-box",
+        }],
+        "boundaries": [{
+            "id": "b1", "question_id": "q1", "page_index": 0, "y": 99, "source": "ai",
+            "confirmed": False, "confidence": 0.66, "derivation": "bbox-gap",
+        }],
+        "layout": [{
+            "id": "l1", "page_index": 0, "role": "question_page", "margin_left": 12.5,
+            "margins_enabled": False, "source": "ai", "confirmed": False, "confidence": 0.93,
+            "derivation": "docling-page-layout", "meta": {"columns": 2},
+        }],
+    }
+    resp = client.put("/api/exam/templates/t1", json=payload)
+    assert resp.status_code == 200
+    assert store["exam_questions"][0]["source"] == "ai"
+    assert store["exam_questions"][0]["confidence"] == 0.82
+    assert store["exam_response_areas"][0]["mark_subtype"] == "grader_box"
+    assert store["exam_response_areas"][0]["derivation"] == "detected-explicit-grader-box"
+    assert store["exam_boundaries"][0]["confidence"] == 0.66
+    assert store["exam_template_layout"][0]["meta"] == {"columns": 2}
+    body = resp.json()
+    assert body["layout"][0]["id"] == "l1"
+    assert body["layout"][0]["margins_enabled"] is False
+
 def test_put_replace_clears_previous_children():
     store = {
         "exam_templates": [{"id": "t1", "title": "p", "status": "draft", "institute_id": INST_A, "teacher_id": TEACHER}],