HandyCafe Docs
owner cashier it-admin

Dashboard

Das HandyCafe Server Dashboard ist die zentrale Anlaufstelle zur Verwaltung Ihres Internetcafes oder Gaming-Centers. Nach der Anmeldung landen Sie auf der Hauptseite, die als Router fungiert und jede andere Seite im System lädt. Alle Navigations-, Überwachungs- und Verwaltungsaufgaben beginnen hier.

Layout-Übersicht

Das Dashboard ist in vier Bereiche unterteilt:

  1. Obere Leiste. Eine horizontale Kopfleiste über dem gesamten Fenster. Sie zeigt den HandyCafe-Markennamen und den Titel der aktuell aktiven Seite an.
  2. Seitenleiste. Eine vertikale Navigationsleiste auf der linken Seite. Jeder Eintrag ist eine Symbolschaltfläche, die zu einer anderen Seite wechselt. Die aktive Seite wird visuell hervorgehoben.
  3. Inhaltsbereich. Der Hauptarbeitsbereich rechts neben der Seitenleiste. Dieser Bereich rendert die aktuell ausgewählte Seite (Admin-Panel, Mitglieder, Berichte usw.).
  4. Statusleiste. Eine optionale Fußleiste am unteren Rand des Fensters. Sie kann über die Ansichtseinstellungen ein- oder ausgeblendet werden.

Seitenleisten-Navigation

Die Seitenleiste bietet schnellen Zugriff auf jede Seite im System. Jeder Eintrag zeigt ein Symbol und beim Hovern den Seitennamen. Folgende Seiten sind verfügbar:

Seite Symbol Beschreibung
Computer (Admin-Panel) Monitor Alle Client-PCs überwachen und verwalten
Konsolen Gamepad Spielkonsolen-Sitzungen verwalten
Lizenzen Zertifikat Softwarelizenzen anzeigen und verwalten
Mitglieder Konten Mitgliedskonten erstellen und verwalten
Anfragen Kontofrage Ausstehende Anmelde- und OAuth-Anfragen prüfen
Bestellungen Warenkorb Speisen-, Getränke- und Produktbestellungen verwalten
Ausgaben Geld minus Geschäftsausgaben erfassen und verfolgen
Protokolle Dokument System- und Audit-Protokolle durchsuchen
Berichte Liniendiagramm Kassen- und Schichtberichte anzeigen
Statistiken Diagrammbox Einnahmen-, Sitzungs- und Mitgliederstatistiken analysieren
Einstellungen Zahnrad Alle Systemeinstellungen konfigurieren

Die Seite Einstellungen wird über ein separates Zahnradsymbol am unteren Rand der Seitenleiste aufgerufen, getrennt von den Hauptnavigationselementen.

Offene-Bestellungen-Badge

Der Navigationseintrag Bestellungen zeigt ein Badge mit der Anzahl der aktuell offenen (nicht abgeschlossenen) Bestellungen an. Dieser Zähler aktualisiert sich in Echtzeit bei jeder Erstellung oder Schließung einer Bestellung, sodass Kassierer sofort sehen können, ob es ausstehende Arbeit gibt.

Rollenbasierter Seitenzugriff

Nicht jeder Benutzer sieht dieselbe Seitenleiste. Die Seitensichtbarkeit hängt von der Rolle und den Berechtigungen des angemeldeten Kassierers ab:

  • Admin-Konten (während des Ersteinrichtungsassistenten erstellt) haben uneingeschränkten Zugriff auf alle Seiten.
  • Kassierer-Konten erhalten eine Rolle mit bestimmten Berechtigungsflags. Wenn die Rolle eines Kassierers keinen Zugriff auf eine bestimmte Seite gewährt, wird diese Seite in der Seitenleiste ausgeblendet.
  • Bei der Anmeldung eines Kassierers prüft das System seine Rollenberechtigungen und leitet ihn automatisch zur ersten zugänglichen Seite weiter, falls er sich gerade auf einer eingeschränkten Seite befindet.

Weitere Informationen zu Rollen und Berechtigungen finden Sie unter Kassierer-Rollen und Berechtigungen.

Automatische Update-Prüfung

Beim Start prüft das Dashboard auf verfügbare Software-Updates. Wenn eine neuere Version des HandyCafe Servers verfügbar ist, erscheint eine dauerhafte Benachrichtigung in der oberen rechten Ecke des Bildschirms. Die Benachrichtigung zeigt die neue Versionsnummer an und bietet die Möglichkeit, das Update herunterzuladen und zu installieren.

Diese Prüfung erfolgt im Hintergrund. Wenn kein Update verfügbar ist oder der Update-Endpunkt nicht erreichbar ist, wird keine Benachrichtigung angezeigt.

Lizenz-Heartbeat

Nach dem Laden des Dashboards startet ein Lizenz-Heartbeat-Prozess im Hintergrund. Dieser Prozess validiert Ihre HandyCafe-Lizenz regelmäßig beim Lizenzierungsserver. Wenn die Lizenz abläuft oder ein Problem auftritt, kann ein Beta-Lizenz-Overlay über dem Dashboard erscheinen, das die Anwendung auf den Nur-Lese-Modus beschränkt, bis das Lizenzproblem gelöst ist.

Siehe Lizenzierung für Details zur Lizenzverwaltung.

Statusleiste

Die Statusleiste ist ein schmaler horizontaler Balken am unteren Rand des Dashboards. Sie zeigt kontextbezogene Informationen über den aktuellen Zustand der Anwendung an. Ihre Sichtbarkeit wird über eine Einstellung gesteuert:

  • Statusleiste ein-/ausblenden: Gehen Sie zu Einstellungen und schalten Sie die Option Statusleiste im Bereich Ansicht um.

Im ausgeblendeten Zustand dehnt sich der Inhaltsbereich auf die volle Höhe des Fensters aus.

Startsequenz

Beim Laden des Dashboards nach einer erfolgreichen Anmeldung finden automatisch mehrere Initialisierungsschritte statt:

  1. Systemeinstellungen werden aus der Datenbank geladen.
  2. Gespeicherte Sitzungen werden wiederhergestellt (falls vor einem Neustart welche liefen).
  3. Der Server-Socket beginnt auf Client-Verbindungen zu lauschen.
  4. Eine Netzwerk-Ping-Anfrage wird gesendet, um verbundene Clients zu erkennen.
  5. Die Rollenberechtigungen des Kassierers werden geladen und eingeschränkte Seiten werden ausgeblendet.
  6. Der Beta-Lizenzstatus wird geprüft.
  7. Der Lizenz-Heartbeat-Timer beginnt.
  8. Die Anzahl offener Bestellungen wird für das Symbolleisten-Badge initialisiert.
  9. Eine automatische Update-Prüfung läuft im Hintergrund.

Alle diese Schritte sind nicht-blockierend. Wenn ein einzelner Schritt fehlschlägt, funktioniert das Dashboard weiterhin. Der Fehler wird in der Konsole protokolliert, verhindert aber nicht die Nutzung des Systems.

Systemschriftart

Das Dashboard berücksichtigt die Systemschriftart-Einstellung, die unter Einstellungen > Allgemein konfiguriert wird. Der gesamte Text in der Oberfläche verwendet die ausgewählte Schriftfamilie.

Nächste Schritte