aza/AzA march 2026/deploy/TELEMETRY.md

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