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,34 @@
+# Observability Plan
+
+## Required Logs
+- request start/end with trace id;
+- dataset upload registration;
+- metadata extraction status;
+- job lifecycle transitions;
+- model adapter selection;
+- inference start/end;
+- QA/QC matching summary;
+- export creation.
+
+## Required Health Checks
+- API health;
+- database connection;
+- PostGIS extension availability;
+- storage write check;
+- optional Redis check;
+- optional model registry check.
+
+## Diagnostics Endpoint
+`GET /system/diagnostics`
+
+Should return safe non-secret status:
+```json
+{
+  "api": "ok",
+  "database": "ok",
+  "postgis": "ok",
+  "storage": "ok",
+  "redis": "unconfigured",
+  "models": "unconfigured"
+}
+```