Add backend API contract audit

2026-06-17 20:11:36 +02:00
parent 45bbe9725d
commit 32c38423a5
8 changed files with 187 additions and 7 deletions
@@ -4,6 +4,17 @@ Setup-, import-, demo- en maintenance-scripts voor GeoIntel.

 ## Runtime verification

+Audit the active backend route surface against `docs/API_CONTRACTS.md`:
+
+```bash
+python scripts/audit_api_contracts.py
+```
+
+The audit imports the FastAPI app, compares implemented `GET`/`POST`/`PATCH`/
+`DELETE` routes with active API contract headings and tracks the explicit
+non-envelope exceptions (`/health` and export downloads). It fails when a route
+exists without docs or when docs claim an endpoint that is not implemented.
+
 Verify the browser-facing Docker/LAN runtime:

 ```bash