Handbuch

Auditberichte

Auditberichte fassen ausgewählte Betriebsdaten mit KI-Unterstützung zusammen. Sie sind Super-Admins vorbehalten und dienen der Systemprüfung, nicht dem Lesen privater Chats.

· Stand: Oktober 2026

1. Zweck

Auditberichte helfen, Runtime- und Sitzungszustände strukturiert zu überblicken. Statt Rohdaten manuell zu durchsuchen, erzeugt Ephraim eine zusammenfassende Markdown-Auswertung. Der Sitzungszugang liefert begrenzte Metadaten und redigierte Vorschauen administrativer SSH-Terminals, einschließlich Zeitinformationen und verfügbarer rotierter Aufzeichnungen. Er liefert keinen vollständigen Mitschnitt des gesamten Archivs. Neue getrennte Einzelkommandoprotokolle werden im aktuellen Betrieb nicht aufgenommen. Der Fokus liegt auf Betrieb, Risiken, Auffälligkeiten und nächsten Prüfschritten.

Auditberichte-Adminseite mit Berichtsliste und Berichtserstellung
Auditberichte werden als Super-Admin-Funktion verwaltet. Die Oberfläche trennt Berichtserstellung, Status und spätere Verwaltung.

2. Zugriff und Berechtigung

Die Funktion ist Super-Admins vorbehalten. Das ist angemessen, weil Auditberichte aggregierte technische Daten und Betriebsrisiken enthalten können. Normale Adminaufgaben wie Klassen oder Benutzerverwaltung brauchen keinen Zugriff auf diese Berichte.

3. Preflight vor dem Bericht

Vor dem Start prüft Ephraim Umfang, ungefähre Dauer, Datenarten und mögliche Risiken. Dieser Preflight hilft, große Berichte bewusst einzuplanen. Berichte können sofort oder zeitversetzt, etwa nachts, eingeplant werden.

4. Verarbeitung

Der Worker holt die freigegebenen Auditdaten serverseitig, entfernt oder maskiert Geheimnisse, zerlegt große Datenmengen in verarbeitbare Stücke und lässt die Spark daraus Zusammenfassungen erzeugen. Das Ergebnis wird als Bericht abgelegt, nicht als Rohdump in der Oberfläche angezeigt. Der Abruf ist geschützt und bleibt serverseitig. Umfangsgrenzen, fehlende Archivteile oder Warnungen begrenzen, welche Aussagen ein Bericht treffen kann. Ein erfolgreicher Export belegt nicht, dass jede Sitzung und jede Zeile des gewählten Zeitraums vollständig enthalten ist.

5. Verwalten von Berichten

Die Adminseite kann Berichte listen, herunterladen, archivieren, abbrechen oder löschen. Abgebrochene oder fehlerhafte Berichte werden mit Jobstatus und Logs eingeordnet. Ein Bericht ist ein Prüfwerkzeug und ersetzt keine eigene Bewertung durch den Super-Admin.

Archivieren blendet einen Bericht aus der normalen Liste aus und kann rückgängig gemacht werden. Dauerhaft löschen lassen sich nur bereits archivierte Berichte, die nicht mehr aktiv verarbeitet werden. Eine automatische Löschung fertiger Auditberichte findet nicht statt. Die zuständigen Super-Admins prüfen deshalb regelmäßig, welche Berichte noch benötigt werden.

6. Datenschutzgrenze

Auditberichte sind nicht dafür gedacht, private Chatverläufe zu öffnen. Sie arbeiten mit technischen Exporten, Redaktionen und Zusammenfassungen. Wenn ein Bericht Hinweise auf ein Problem liefert, erfolgt die weitere Untersuchung mit minimalem Datenzugriff.

Damit unterscheiden sie sich klar von den Nutzer-Zusammenfassungen in Mein Ephraim und vom Chatkopf im persönlichen Chat. Diese Nutzer-Synopsen verdichten private Chats für das jeweilige Konto; Auditberichte verdichten Betriebs- und Sicherheitsdaten für Super-Admins.