update

AzA march 2026/deploy/TELEMETRY.md

@@ -0,0 +1,67 @@
+# AZA Minimal Telemetry
+
+## Ziel
+
+Diese Telemetry dient ausschließlich der technischen Betriebsbeobachtung.
+
+Es dürfen keine medizinischen Inhalte, keine Patientendaten und keine sonstigen sensiblen Nutzerdaten übertragen werden.
+
+---
+
+## Endpoint
+
+POST /telemetry/ping
+
+---
+
+## Erlaubte Events
+
+- app_start
+- update_check
+- download_click
+- crash
+
+---
+
+## Erlaubte Felder
+
+- event
+- version
+- platform
+- app
+- crash_type (nur bei event = crash)
+- target_version (nur bei event = update_check)
+
+---
+
+## Erlaubte crash_type Werte
+
+- startup_error
+- update_error
+- ui_error
+- network_error
+- unknown
+
+---
+
+## Verboten
+
+- Patientendaten
+- medizinische Inhalte
+- Freitext-Logs
+- Stacktraces
+- Namen
+- E-Mail-Adressen
+- Lizenzschlüssel
+- Suchanfragen
+- Diktatinhalte
+
+---
+
+## Verhalten
+
+- Eingaben werden validiert
+- ungültige Events werden mit HTTP 400 abgelehnt
+- ungültige crash_type Werte werden mit HTTP 400 abgelehnt
+- target_version ist nur für update_check erlaubt
+- aktuell keine Persistenz, nur Log-Ausgabe