Start autonomous Belgium and North Sea RC

docs/HEALTHCHECK_CONTRACTS.md

@@ -5,8 +5,15 @@ Elke runtime-component moet een eenvoudige en machineleesbare healthcheck hebben
 
 ## Backend
 
-### Endpoint
-`GET /health`
+### Liveness
+
+`GET /health/live` returns HTTP 200 while the FastAPI process can serve a
+request. It has no database or storage dependency.
+
+### Readiness
+
+`GET /health/ready` is the Docker healthcheck. `GET /health` is the
+backward-compatible alias.
 
 ### Response 200
 ```json
@@ -15,8 +22,15 @@ Elke runtime-component moet een eenvoudige en machineleesbare healthcheck hebben
   "service": "geointel-backend",
   "version": "0.1.0",
   "database": "ok",
-  "redis": "ok",
-  "storage": "ok"
+  "postgis": "ok:3.x",
+  "migration": "ok:202607160001",
+  "storage": "ok",
+  "checks": {
+    "database": "ok",
+    "postgis": "ok:3.x",
+    "migration": "ok:202607160001",
+    "storage": "ok"
+  }
 }
 ```
 
@@ -25,10 +39,10 @@ Elke runtime-component moet een eenvoudige en machineleesbare healthcheck hebben
 {
   "status": "degraded",
   "service": "geointel-backend",
-  "database": "unavailable",
-  "redis": "ok",
-  "storage": "ok",
-  "errors": ["database connection failed"]
+  "database": "degraded",
+  "postgis": "degraded",
+  "migration": "degraded",
+  "storage": "ok"
 }
 ```
 
@@ -51,7 +65,8 @@ Codex mag kiezen tussen een internal endpoint of CLI-command, maar het contract
 Frontend moet een `/status` of settings/statuspanel hebben dat toont: backend bereikbaar, API version, auth status, feature flags en laatste healthchecktijd.
 
 ## Storage
-Storage healthcheck controleert of upload, originals, derived en exports writable zijn.
+De readinesscheck maakt en verwijdert een tijdelijk bestand in `STORAGE_ROOT`.
 
 ## Database
-Database healthcheck controleert connectie, PostGIS extension en migrationstatus.
+De readinesscheck controleert `SELECT 1`, `PostGIS_Version()` en dat de
+databaseversie exact overeenkomt met de enige Alembic-head in de image.