Start autonomous Belgium and North Sea RC

docs/API_CONTRACTS.md

@@ -41,48 +41,68 @@ Any valid GeoJSON geometry object. V1 primarily expects `Polygon` and `MultiPoly
 
 ## Health
 
-### GET `/health`
+### GET `/health/live`
 
-Returns service status.
+Returns process liveness only. It never queries PostgreSQL.
 
 ```json
 {
   "status": "ok",
   "service": "geointel-backend",
-  "version": "0.1.0"
+  "version": "0.1.0",
+  "build_sha": null,
+  "build_time": null
+}
+```
+
+### GET `/health`
+
+Backward-compatible alias for dependency readiness.
+
+### GET `/health/ready`
+
+Returns dependency readiness. Both readiness routes return HTTP 503 when the
+database, PostGIS, single migration head or writable storage check is
+degraded. Docker uses `/health/ready`.
+
+```json
+{
+  "status": "ok",
+  "service": "geointel-backend",
+  "version": "0.1.0",
+  "database": "ok",
+  "postgis": "ok:3.x",
+  "migration": "ok:202607160001",
+  "storage": "ok",
+  "checks": {
+    "database": "ok",
+    "postgis": "ok:3.x",
+    "migration": "ok:202607160001",
+    "storage": "ok"
+  }
 }
 ```
 
 ### GET `/api/v1/system/capabilities`
 
-Returns enabled feature flags and tool availability.
+Returns enabled feature flags and tool availability in the canonical data
+envelope. PostGIS and configured YOLO state are derived at runtime.
 
 ```json
 {
-  "postgis": true,
-  "rasterio": true,
-  "geopandas": true,
-  "yolo": false,
-  "sam": false,
-  "grb": "bounded",
-  "sentinel": "planned",
-  "providers": [
-    {
-      "provider_name": "grb",
-      "display_name": "GRB",
-      "authority_level": "authoritative",
-      "supported_layers": ["buildings", "roads", "water", "parcels"],
-      "supported_geometry_types": ["Polygon", "MultiPolygon", "LineString", "MultiLineString"],
-      "supported_query_modes": ["bbox", "persisted_area"],
-      "fetch_signature": "POST /api/v1/projects/{project_id}/datasets/grb/acquire",
-      "configured": true,
-      "status": "configured",
-      "limitation_message": "Alleen expliciet begrensde selecties tot 20 km per zijde worden opgehaald.",
-      "attribution": "Bron: Grootschalig Referentie Bestand Vlaanderen, Digitaal Vlaanderen",
-      "license_note": "Hergebruik volgens de open-datavoorwaarden en bronvermelding van Digitaal Vlaanderen.",
-      "not_configured_reason": null
-    }
-  ]
+  "data": {
+    "postgis": true,
+    "rasterio": true,
+    "geopandas": true,
+    "yolo": true,
+    "yolo_status": "configured",
+    "sam": false,
+    "grb": "bounded",
+    "sentinel": "planned",
+    "version": "0.1.0",
+    "build_sha": null,
+    "providers": []
+  }
 }
 ```