SA-07 – Support & Diagnose
Stand: 12.10.2026 11:23
Branch: main
Status: Abgeschlossen
Änderungshistorie anzeigen
Use Case: UC-SA – Superadmin-Panel
Screen: SA-07
Status: erster Vorschlag
Stand: Mai 2026
Wireframe
Zum Vergrössern auf das Bild klicken; es öffnet sich in voller Grösse.
1. Zweck
SA-07 stellt eine begrenzte, rollenbasierte und protokollierte Support- und Diagnoseansicht bereit.
Der Screen dient dazu, technische und fachliche Zustände eines Tenants zu prüfen, ohne eine freie operative Kundendatenanzeige zu ermöglichen. Supporteinsicht benötigt einen Tenant-Kontext, einen nachvollziehbaren Grund und eine Protokollierung.
SA-07 ist kein Ersatz für Tenant-Module und keine direkte Kundenverwaltung.
2. Primäre Nutzer
| Rolle |
Nutzung |
superadmin |
prüft Tenant-bezogene Diagnoseinformationen |
system |
liefert Status, Logs, Health Checks und Audit-Informationen |
tenant_admin |
kein Zugriff auf SA-07 |
mitarbeiter |
kein Zugriff |
kunde |
kein Zugriff |
3. Einstieg / Auslöser
| Einstieg |
Beschreibung |
| SA-01 |
Supporthinweis oder Diagnosekachel |
| SA-02 |
Tenant mit Supportstatus öffnen |
| SA-03 |
Support aus Tenant-Detail öffnen |
| SA-05 |
Supportprüfung nach Statusaktion |
| SA-08 |
Rücksprung aus Audit- oder Sicherheitsereignis |
4.1 Support-Kontext
| Feld |
Beschreibung |
| Tenant |
Name, Kürzel, Status |
| Supportstatus |
erlaubt, aktiv, nicht erlaubt |
| Supportgrund |
Pflichtgrund für Einsicht |
| Supportstart |
Zeitpunkt der Einsicht |
| Benutzer |
ausführender Superadmin |
| Audit-Referenz |
Bezug zum Support-Log |
4.2 Diagnosebereiche
| Bereich |
Beschreibung |
| Tenant-Konfiguration |
Module, Defaults, Limits, Pflichtfelder |
| UC06 Portal |
Portalstatus, Einladungskonfiguration, Token-Defaults |
| UC07 Benachrichtigung |
Queue-Status, Vorlagenstatus, Versandfehler aggregiert |
| UC05 Fristen |
aggregierte Fristenprobleme, keine Kundendetails |
| Auth / Benutzer |
technische Statushinweise, keine Passwort- oder Geheimnisanzeige |
| Jobs / System |
geplante Jobs, Health Checks, letzte Ausführung |
| Audit |
sicherheitsrelevante Ereignisse und Absprung zu SA-08 |
5. Erlaubte Einsicht V1
| Information |
Erlaubt |
| Tenant-Stammdaten |
Ja |
| Modulstatus |
Ja |
| Konfigurationsfehler |
Ja |
| aggregierte Fehlerzahlen |
Ja |
| Versandfehler aggregiert |
Ja |
| technische Health Checks |
Ja |
| operative Kundendetails |
Nein |
| vollständige Kundendatenlisten |
Nein |
| interne Geheimnisse / Tokens |
Nein |
| Passwörter oder Auth-Secrets |
Nein |
6. Eingaben / Aktionen
| Aktion |
Beschreibung |
| Supportgrund erfassen |
Pflichtgrund für Supporteinsicht |
| Diagnose laden |
lädt begrenzte Diagnoseinformationen |
| Tenant-Detail öffnen |
öffnet SA-03 |
| Statusaktion öffnen |
öffnet SA-05 |
| Audit öffnen |
öffnet SA-08 mit Tenant- und Supportfilter |
| UC06-Konfiguration prüfen |
Absprung zu relevanter Konfigurationsinformation |
| UC07-Konfiguration prüfen |
Absprung zu Vorlagen / Regeln oder Fehlern |
| Support beenden |
schliesst Supportkontext und protokolliert Ende |
7. Validierungen / Regeln
| ID |
Regel |
| SA07-R01 |
SA-07 ist nur für superadmin zugänglich |
| SA07-R02 |
Supporteinsicht benötigt Tenant-Kontext |
| SA07-R03 |
Supporteinsicht benötigt Pflichtgrund |
| SA07-R04 |
Supporteinsicht muss protokolliert werden |
| SA07-R05 |
SA-07 darf keine freie Kundendatenanzeige bieten |
| SA07-R06 |
Tokens, Secrets und Passwörter dürfen nicht angezeigt werden |
| SA07-R07 |
Diagnoseinformationen sind auf notwendige Informationen zu begrenzen |
| SA07-R08 |
Supportende muss protokolliert werden, falls Supportsession geführt wird |
| SA07-R09 |
Absprünge zu sicherheitsrelevanten Bereichen müssen nachvollziehbar bleiben |
| SA07-R10 |
Supporteinsicht darf Tenant-Isolation nicht unkontrolliert umgehen |
8. Status- und Fehlermeldungen
| Situation |
Meldung / Darstellung |
| Supportgrund fehlt |
„Bitte gib einen Grund für die Supporteinsicht an." |
| Support nicht erlaubt |
„Supporteinsicht ist für diesen Tenant nicht freigegeben." |
| Diagnose geladen |
„Diagnoseinformationen wurden geladen." |
| Diagnose eingeschränkt |
„Einige Informationen sind aus Datenschutzgründen ausgeblendet." |
| Secret ausgeblendet |
„Sensible technische Werte werden nicht angezeigt." |
| Support beendet |
„Supporteinsicht wurde beendet und protokolliert." |
| keine Berechtigung |
„Zugriff verweigert." |
9. Bezug zu Datenmodell
| Bereich |
Bezug |
| Tenants |
tenants |
| Tenant-Konfiguration |
tenant_settings, tenant_modules |
| Supportzugriffe |
support_access_log |
| Portalstatus |
UC06 / customer_portal_accounts, aggregiert |
| Benachrichtigung |
UC07 / notification_queue, notification_log, aggregiert |
| Fristen |
UC05 / aggregierte Fristenstatuswerte |
| Systemstatus |
technische Health Checks / Jobs |
| Audit |
audit_log |
10. Sicherheits- und Datenschutzbezug
| Thema |
Umsetzung |
| Zugriff |
nur superadmin |
| Pflichtgrund |
Supporteinsicht begründen |
| Protokollierung |
Beginn, Grund, Benutzer, Tenant und Ende speichern |
| Datenminimierung |
aggregierte Diagnose statt operativer Detaildaten |
| Geheimnisschutz |
keine Tokens, Secrets oder Passwörter anzeigen |
| Tenant-Kontext |
jede Einsicht an Tenant binden |
| Audit |
Supportzugriff in SA-08 nachvollziehbar machen |
11. Akzeptanzkriterien
| ID |
Kriterium |
| SA07-AC01 |
superadmin kann SA-07 aus SA-01, SA-02 oder SA-03 öffnen |
| SA07-AC02 |
nicht berechtigte Rollen können SA-07 nicht öffnen |
| SA07-AC03 |
System verlangt Tenant-Kontext und Supportgrund |
| SA07-AC04 |
System protokolliert Supporteinsicht |
| SA07-AC05 |
System zeigt begrenzte Diagnosebereiche |
| SA07-AC06 |
System zeigt keine freien Kundendetaildaten |
| SA07-AC07 |
System zeigt keine Tokens, Secrets oder Passwörter |
| SA07-AC08 |
Benutzer kann SA-08 mit Supportfilter öffnen |
| SA07-AC09 |
Benutzer kann Supporteinsicht beenden |
| SA07-AC10 |
Supportende wird protokolliert |
12. Offene Punkte
| ID |
Frage |
Status |
| SA07-O01 |
Muss Tenant Supportzugriff aktiv freigeben? |
sinnvoll, rechtlich prüfen |
| SA07-O02 |
Wird Supportsession mit Start und Ende geführt? |
Empfehlung: ja |
| SA07-O03 |
Welche Diagnosewerte sind V1 Pflicht? |
Modulstatus, Queue-Status, Health Checks |
| SA07-O04 |
Werden technische Logs angezeigt oder nur Kennzahlen? |
Empfehlung: V1 nur Kennzahlen / gekürzte Hinweise |
| SA07-O05 |
Wird Supporteinsicht tenantseitig sichtbar gemacht? |
später prüfen |
Änderungshistorie
| Datum, Uhrzeit |
Version |
Änderung |
Autor |
| 12.10.2026 11:23 |
1.3 |
Abschnitt «Wireframe» mit klickbarem Bild des Screens ergänzt |
Claude |
| 12.10.2026 09:58 |
1.2 |
Änderungshistorie ans Dokumentende verschoben und Sprunglink «Änderungshistorie anzeigen» unter dem Kopf ergänzt (einheitlicher Dokumentaufbau gemäss AGENTS.md) |
Claude |
| 12.10.2026 09:08 |
1.1 |
Kopfbereich auf das Format Stand: TT.MM.JJJJ hh:mm umgestellt |
Claude |
| 01.08.2026 11:12 |
1.0 |
Kopfbereich ergänzt |
David |