Protokolle

Die Protokollseite bietet eine umfassende Prüfspur aller Systemereignisse in HandyCafe. Jede bedeutsame Aktion -- vom Sitzungsstart bis zur Kassierer-Anmeldung -- wird hier für Rechenschaftspflicht, Fehlerbehebung und Compliance-Zwecke erfasst.

Leistung

Der Protokoll-Viewer verwendet virtuelles Listen-Rendering für gleichbleibend gute Leistung auch bei der Anzeige tausender Einträge. Das bedeutet, dass nur die sichtbaren Zeilen im DOM gerendert werden, sodass das System über 1.000 Protokolleinträge ohne Beeinträchtigung der Oberfläche verarbeiten kann.

Felder eines Protokolleintrags

Jeder Protokolleintrag enthält folgende Felder:

Feld	Beschreibung
Zeitstempel	Datum und Uhrzeit des Ereignisses
Quelle	Die Systemkomponente, die das Ereignis generiert hat
Kategorie	Klassifizierung des Ereignisses (siehe Kategorien unten)
Aktion	Spezifischer Aktionstyp (siehe häufige Aktionen unten)
PC	Der beteiligte Client-PC oder die Konsole, falls zutreffend
IP	Mit dem Ereignis verknüpfte IP-Adresse
Mitglied	Das beteiligte Mitglied, falls zutreffend
Kassierer	Der Kassierer, der das Ereignis ausgelöst hat oder im Dienst war
Nachricht	Lesbare Beschreibung des Geschehens

Protokollkategorien

Ereignisse werden in 8 Kategorien klassifiziert:

Server -- Serverstart, Herunterfahren, Konfigurationsänderungen und Ereignisse auf Systemebene.
Client -- Client-Verbindungen, Trennungen und Statusänderungen.
Kassierer -- Kassierer-Anmeldung, Abmeldung und administrative Aktionen.
Mitglied -- Mitgliederregistrierung, Profilaktualisierungen und Kontoänderungen.
Sitzung -- Sitzungslebenszyklus-Ereignisse (Start, Stopp, Pause, Fortsetzung).
Konsole -- Konsolenbezogene Ereignisse (Hinzufügen, Entfernen, Sitzungszuweisungen).
Bestellung -- Erstellung, Änderung und Abschluss von Bestellungen.
Zahlung -- Zahlungsverarbeitung, Erstattungen und finanzielle Transaktionsereignisse.

Häufig protokollierte Aktionen

Folgende Aktionen erscheinen häufig im Protokoll:

startSession -- Eine neue Sitzung wurde an einem Client oder einer Konsole gestartet.
stopSession -- Eine aktive Sitzung wurde beendet.
pauseSession -- Eine laufende Sitzung wurde pausiert.
resumeSession -- Eine pausierte Sitzung wurde fortgesetzt.
consoleAdded -- Eine neue Spielkonsole wurde im System registriert.
newMemberAdded -- Ein neues Mitgliedskonto wurde erstellt.
orderCreated -- Eine neue Produktbestellung wurde aufgegeben.
orderClosed -- Eine Bestellung wurde abgeschlossen und geschlossen.
cashierLogin -- Ein Kassierer hat sich am System angemeldet.
cashierLogout -- Ein Kassierer hat sich abgemeldet.
serverStarted -- Die HandyCafe Server-Anwendung wurde gestartet.
clientConnected -- Ein Client-PC hat eine Verbindung zum Server hergestellt.
clientDisconnected -- Ein Client-PC hat die Verbindung zum Server getrennt.

Filtern und Suchen

Kategoriefilter

Wählen Sie eine oder mehrere Kategorien, um die Protokollanzeige einzugrenzen. Zeigen Sie beispielsweise nur Sitzungs- und Zahlungsereignisse an, um finanzielle Aktivitäten zu prüfen.

Aktionsfilter

Filtern Sie nach bestimmten Aktionstypen, um bestimmte Ereignisse schnell zu finden.

Zeitraumfilter

Beschränken Sie die Protokollansicht auf einen bestimmten Zeitraum. In Kombination mit anderen Filtern können Sie Vorfälle untersuchen, die in einem bekannten Zeitfenster aufgetreten sind.

Sortieroptionen

Sortieren Sie Protokolleinträge nach jedem Feld in auf- oder absteigender Reihenfolge. Sortierung nach Zeitstempel (neueste zuerst) ist die Standardeinstellung.

Textsuche

Ein Freitextsuchfeld gleicht mit allen Feldern ab und ermöglicht die Suche nach einem bestimmten Hostnamen, einer IP-Adresse, einem Mitgliedsnamen oder einem beliebigen Schlüsselwort in den Protokollnachrichten.

Berechtigungen

Der Zugriff auf die Protokollseite wird durch folgende Berechtigungen gesteuert:

Berechtigung	Beschreibung
`LOG_VIEW`	Erforderlich für den Zugriff auf die Protokollseite
`LOG_DISPLAY_FULL`	Erlaubt die Anzeige des vollständigen Protokollverlaufs
`LOG_DISPLAY_TODAY`	Beschränkt die Ansicht auf die heutigen Einträge
`LOG_DELETE`	Erlaubt das Löschen von Protokolleinträgen

Ein Kassierer mit LOG_VIEW und LOG_DISPLAY_TODAY kann die heutigen Ereignisse einsehen, hat aber keinen Zugriff auf historische Daten. Nur Benutzer mit LOG_DISPLAY_FULL können das gesamte Protokollarchiv durchsuchen.

Echtzeit-Aktualisierungen

Neue Protokollereignisse erscheinen automatisch im Viewer, sobald sie auftreten. Das System lauscht über die TCP-Ereignisverbindung auf Protokollereignisse, sodass kein manuelles Aktualisieren der Seite erforderlich ist. Ein Protokoll-Cache verbessert die Leistung, indem wiederholte Datenbankabfragen beim Scrollen durch aktuelle Einträge reduziert werden.