Add QA evidence map overlay

2026-06-25 03:17:49 +02:00
parent 7a54d01993
commit b9674a0e42
16 changed files with 778 additions and 4 deletions
@@ -1060,6 +1060,58 @@ Response:
 }
 ```

+### GET `/api/v1/projects/{project_id}/quality-checks/{quality_check_id}/evidence/geojson`
+
+Returns a canonical envelope containing a read-only QA/QC evidence overlay for a
+persisted quality check. The endpoint reads feature ids from
+`quality_checks.findings_json.match_evidence`,
+`false_positive_evidence` and `false_negative_evidence`, resolves them against
+persisted candidate/reference geometries and returns a GeoJSON FeatureCollection.
+
+Supported resolution paths:
+
+- dataset QA candidate/reference geometries from `vector_features`;
+- detection QA candidate geometries from persisted `detections`;
+- segmentation QA candidate geometries from persisted `segmentations`;
+- reference geometries from persisted `vector_features`.
+
+Response:
+
+```json
+{
+  "data": {
+    "quality_check_id": "uuid",
+    "project_id": "uuid",
+    "candidate_dataset_id": "uuid-or-null",
+    "reference_dataset_id": "uuid",
+    "analysis_run_id": "uuid-or-null",
+    "feature_count": 4,
+    "warnings": [],
+    "geojson": {
+      "type": "FeatureCollection",
+      "features": [
+        {
+          "type": "Feature",
+          "id": "match_candidate:feature-id",
+          "geometry": {},
+          "properties": {
+            "qa_evidence_role": "match_candidate",
+            "quality_check_id": "uuid",
+            "candidate_feature_id": "candidate-feature-id",
+            "reference_feature_id": "reference-feature-id",
+            "iou": 0.83
+          }
+        }
+      ]
+    }
+  }
+}
+```
+
+`qa_evidence_role` is one of `match_candidate`, `match_reference`,
+`false_positive` or `false_negative`. Missing persisted feature ids are reported
+in `warnings`; no fake geometries are produced.
+
 ## Exports

 ### POST `/api/v1/exports/geojson`