Initial public release

2026-08-31 21:56:53 +02:00
commit faeb58ef6d
1386 changed files with 263203 additions and 0 deletions
@@ -0,0 +1,110 @@
+# M9 Detailed Data Contracts
+
+## Project
+
+```json
+{
+  "id": "uuid",
+  "name": "Geel Building Detection Demo",
+  "description": "Building detection and QA against reference features.",
+  "region": "Kempen",
+  "created_at": "2026-06-11T12:00:00Z",
+  "updated_at": "2026-06-11T12:00:00Z"
+}
+```
+
+Validation:
+
+- name is required,
+- region defaults to Kempen,
+- description optional.
+
+## Area
+
+```json
+{
+  "id": "uuid",
+  "project_id": "uuid",
+  "name": "Geel center test area",
+  "geometry": { "type": "Polygon", "coordinates": [] },
+  "crs": "EPSG:4326",
+  "area_m2": 12345.67,
+  "bounds": [4.98, 51.15, 5.02, 51.18]
+}
+```
+
+Validation:
+
+- geometry must be Polygon or MultiPolygon,
+- geometry must be valid,
+- geometry must not be empty,
+- area_m2 must be computed server-side,
+- CRS is EPSG:4326 for API IO unless explicitly documented.
+
+## Dataset
+
+```json
+{
+  "id": "uuid",
+  "project_id": "uuid",
+  "name": "reference_buildings.geojson",
+  "dataset_type": "vector",
+  "source_mode": "demo",
+  "source_name": "fixture",
+  "storage_path": "storage/projects/.../raw/reference_buildings.geojson",
+  "status": "uploaded|processing|ready|failed",
+  "crs": "EPSG:4326",
+  "bounds": [4.98, 51.15, 5.02, 51.18],
+  "feature_count": 100,
+  "metadata": {}
+}
+```
+
+## Analysis Run
+
+```json
+{
+  "id": "uuid",
+  "project_id": "uuid",
+  "area_id": "uuid",
+  "analysis_type": "object_detection|segmentation|qaqc|raster_metadata|vector_metadata",
+  "status": "queued|running|completed|failed|cancelled",
+  "parameters": {},
+  "started_at": null,
+  "finished_at": null,
+  "error": null
+}
+```
+
+## Detection Feature
+
+```json
+{
+  "id": "uuid",
+  "analysis_run_id": "uuid",
+  "class_name": "building",
+  "confidence": 0.91,
+  "geometry": { "type": "Polygon", "coordinates": [] },
+  "bbox": [4.99, 51.16, 4.991, 51.161],
+  "source_tile": "tile_001.tif",
+  "metadata": {}
+}
+```
+
+## QA/QC Result
+
+```json
+{
+  "analysis_run_id": "uuid",
+  "reference_dataset_id": "uuid",
+  "predicted_dataset_id": "uuid",
+  "match_threshold_iou": 0.5,
+  "precision": 0.94,
+  "recall": 0.91,
+  "f1": 0.925,
+  "true_positives": 94,
+  "false_positives": 6,
+  "false_negatives": 9,
+  "findings": []
+}
+```