Initial public release

docs/API_CONTRACT_FREEZE_M2.md

@@ -0,0 +1,90 @@
+# API Contract Freeze M2
+
+## Required V1 endpoints
+
+### Health
+
+`GET /health`
+
+Response:
+
+```json
+{"status":"ok","service":"geointel-backend"}
+```
+
+### Projects
+
+`POST /projects`
+
+Request:
+
+```json
+{"name":"Geel Building Detection","description":"Demo project","region":"Kempen"}
+```
+
+Response: project object.
+
+`GET /projects`
+
+Response: paginated projects.
+
+### Areas
+
+`POST /projects/{project_id}/areas`
+
+Request must contain GeoJSON polygon.
+
+### Datasets
+
+`POST /projects/{project_id}/datasets/upload`
+
+Multipart upload. Returns dataset object and metadata status.
+
+`GET /projects/{project_id}/datasets`
+
+Returns datasets.
+
+### Analysis runs
+
+`POST /analysis/object-detection`
+
+Request:
+
+```json
+{
+  "project_id": "uuid",
+  "dataset_id": "uuid",
+  "area_id": "uuid",
+  "model_id": "yolov8n-building-demo",
+  "confidence_threshold": 0.5
+}
+```
+
+Response: job envelope.
+
+`GET /analysis-runs/{id}`
+
+Returns run status, metrics, outputs.
+
+### QA/QC
+
+`POST /analysis/qaqc/building-detection-vs-reference`
+
+Request:
+
+```json
+{
+  "project_id": "uuid",
+  "prediction_run_id": "uuid",
+  "reference_dataset_id": "uuid",
+  "iou_threshold": 0.5
+}
+```
+
+Response: job envelope.
+
+### Exports
+
+`POST /exports/geojson`
+
+Exports detections, segmentations, QA findings, or vector layers.