Fehlerbehebung

Diese Seite bietet Lösungen für häufige Probleme, geordnet nach Kategorien.

Verbindungsprobleme

Client kann den Server nicht finden

Symptome: Client zeigt "Suche nach Server" oder "Kein Server gefunden."

Lösungen:

Überprüfen Sie, ob der HandyCafe Server auf dem Verwaltungs-PC läuft.
Stellen Sie sicher, dass beide PCs im selben Subnetz sind (z.B. beide auf 192.168.1.x).
Prüfen Sie, ob mDNS nicht durch Ihren Netzwerkswitch oder Router blockiert wird.
Versuchen Sie eine manuelle Verbindung: Geben Sie die IP-Adresse des Servers direkt in den Client-Einstellungen ein.
Stellen Sie sicher, dass keine andere Software den TCP-Port des Servers verwendet (Standard: 5001).

Client verbindet sich und trennt sich dann sofort

Symptome: Client zeigt kurz "Verbunden" und wechselt dann zurück zu "Suche".

Lösungen:

Überprüfen Sie, ob der Verbindungsschlüssel auf Server und Client übereinstimmt. Der Schlüssel wird unter Einstellungen > Netzwerk auf dem Server festgelegt.
Prüfen Sie auf Netzwerkinstabilität (Paketverlust, Kabelprobleme).
Stellen Sie sicher, dass der Server sein Lizenz-PC-Limit nicht erreicht hat.
Überprüfen Sie die Serverprotokolle auf Authentifizierungsfehler.

Client wird auf dem Server als "Offline" angezeigt, obwohl der PC läuft

Symptome: Der Client-PC ist eingeschaltet und die Client-Anwendung läuft, aber der Server zeigt ihn als offline an.

Lösungen:

Überprüfen Sie auf dem Client-PC, ob HandyCafe Client tatsächlich läuft (Systemtray prüfen).
Prüfen Sie die Netzwerkverbindung auf dem Client-PC (kann er den Server anpingen?).
Überprüfen Sie die Firewall-Regeln: TCP-Ports 5001-5003 müssen auf Server und Client offen sein.
Starten Sie HandyCafe Client auf dem betroffenen PC neu.
Wenn VLANs verwendet werden, stellen Sie sicher, dass die Server- und Client-VLANs kommunizieren können.

Keine Verbindung nach Änderung der Netzwerkeinstellungen

Symptome: Nach Änderung der Ports oder des Verbindungsschlüssels können sich Clients nicht verbinden.

Lösungen:

Stellen Sie sicher, dass die Clients mit den neuen Portnummern und dem Verbindungsschlüssel aktualisiert werden.
Starten Sie den HandyCafe Server nach Änderung der Netzwerkeinstellungen neu.
Aktualisieren Sie die Firewall-Regeln, um die neuen Ports zuzulassen.
Alle Clients müssen mit den neuen Werten neu konfiguriert werden.

Sitzungsprobleme

Sitzung kann auf einem Client nicht gestartet werden

Symptome: Start-Button ist deaktiviert oder Startaktion schlägt mit einem Fehler fehl.

Lösungen:

Überprüfen Sie den Lizenzstatus. Im Nur-Lese-Modus können keine neuen Sitzungen gestartet werden.
Stellen Sie sicher, dass der Client-Status "Leerlauf" ist. Sitzungen können nur auf inaktiven Clients gestartet werden.
Überprüfen Sie die Berechtigungen des Kassierers. Die Rolle muss die Berechtigung AUTH_CLIENT_LOGIN haben.
Stellen Sie sicher, dass die Preisgestaltung konfiguriert ist (Einstellungen > Preisgestaltung muss einen gültigen Stundensatz haben).

Sitzungs-Timer zeigt falsche Zeit an

Symptome: Die angezeigte Zeit stimmt nicht mit der tatsächlich verstrichenen Zeit überein.

Lösungen:

Überprüfen Sie die Systemuhren auf Server- und Client-PCs. Sie sollten synchronisiert sein (NTP verwenden).
Wenn die Sitzung pausiert wurde, wird die pausierte Dauer nicht gezählt.
Bei Prepaid-Sitzungen zeigt der Timer die verbleibende Zeit, nicht die verstrichene Zeit.

Sitzungsgebühr scheint falsch

Symptome: Der berechnete Betrag entspricht nicht den Erwartungen.

Lösungen:

Überprüfen Sie den Preiskalender. Wenn aktiviert, kann die Sitzung durch mehrere Preisslots mit unterschiedlichen Multiplikatoren gegangen sein.
Überprüfen Sie die Preiseinstellungen: Basisstundensatz, MwSt., Startgebühr, Rundung.
Überprüfen Sie die Preisabschnitte der Sitzung in den Transaktionsdetails für eine Aufschlüsselung.
Überprüfen Sie die Provision und festen Gebühren der Zahlungsmethode.
Bei Prepaid-Sitzungen prüfen Sie, ob "Bei Kauf sperren" oder "Live-Zeitplan" Modus aktiv ist.

Pausierte Sitzung kann nicht fortgesetzt werden

Symptome: Fortsetzungsaktion schlägt fehl oder ist nicht verfügbar.

Lösungen:

Stellen Sie sicher, dass der Client-PC noch mit dem Server verbunden ist.
Überprüfen Sie, dass der Client-Status "Pausiert" (orange) anzeigt.
Wenn der Client während der Pause getrennt wurde, muss er sich möglicherweise zuerst wieder verbinden.

Zahlungsprobleme

Zahlungsmethode fehlt im Dropdown-Menü

Symptome: Erwartete Zahlungsmethode erscheint nicht beim Schließen einer Sitzung oder Bestellung.

Lösungen:

Überprüfen Sie, ob die Zahlungsmethode unter Verwaltung > Zahlungsmethoden existiert.
Stellen Sie sicher, dass die Zahlungsmethode aktiv ist (nicht gelöscht oder deaktiviert).
Überprüfen Sie die Berechtigungen des Kassierers. PAYMENT_MANAGE muss gewährt werden, um alle Methoden zu sehen.

Provisionsberechnung scheint falsch

Symptome: Die abgezogene Provision entspricht nicht dem erwarteten Satz.

Lösungen:

Überprüfen Sie den Provisionssatz (als Prozentsatz) und die festen Gebühren der Zahlungsmethode.
Provisionsformel: Provision = (berechneter Betrag * Provisionssatz / 100) + feste Gebühr.
Prüfen Sie, ob der Kassierer eine manuelle Anpassung des berechneten Betrags vorgenommen hat.

Client-Anzeigeprobleme

Client-Leerlaufbildschirm ist leer

Symptome: Der Leerlaufbildschirm zeigt nichts anstelle der konfigurierten Diashow.

Lösungen:

Überprüfen Sie, ob der Leerlaufbildschirm in Einstellungen > Clients > Leerlaufbildschirm aktiviert ist.
Stellen Sie sicher, dass mindestens ein Medienelement (Bild oder Video) hinzugefügt wurde.
Überprüfen Sie, ob die Mediendateien gültig und nicht beschädigt sind.
Lösen Sie eine Synchronisierung aus, um die neuesten Einstellungen an den Client zu übertragen.

Client-Menü zeigt keine Apps

Symptome: Der App-Launcher ist leer oder es fehlen Kategorien.

Lösungen:

Überprüfen Sie, ob Apps und Kategorien in Einstellungen > Clients > Inhalt konfiguriert sind.
Stellen Sie sicher, dass Kategorien und Apps auf sichtbar geschaltet sind.
Überprüfen Sie, ob der Client die neuesten Menüdaten erhalten hat (Änderungen werden automatisch über TCP übertragen).
Starten Sie den Client neu, wenn die Echtzeitsynchronisierung nicht angewendet wurde.

Client-Erscheinungsthema wird nicht angewendet

Symptome: Der Client zeigt das Standarderscheinungsbild anstelle des konfigurierten Themas.

Lösungen:

Überprüfen Sie, ob die Theme-Einstellungen in Einstellungen > Clients > Erscheinungsbild gespeichert sind.
Lösen Sie einen Einstellungs-Push an die Clients aus.
Starten Sie die Client-Anwendung neu.

Remote-Desktop-Probleme

Remote-Desktop ist verzögert oder ruckelt

Symptome: Videofeed ist verzögert, ruckelt oder hat eine niedrige Bildrate.

Lösungen:

Verringern Sie die Bitrate (versuchen Sie 1000-2000 kbps für den Standard-LAN-Gebrauch).
Reduzieren Sie die FPS-Einstellung.
Verwenden Sie verkabeltes Ethernet anstelle von WLAN.
Prüfen Sie auf Netzwerküberlastung oder hohe Bandbreitennutzung durch andere Anwendungen.
Stellen Sie sicher, dass UDP-Port 5004 nicht blockiert oder rate-limitiert ist.

Remote-Desktop zeigt schwarzen Bildschirm

Symptome: Das Remote-Desktop-Fenster öffnet sich, zeigt aber nur Schwarz.

Lösungen:

Überprüfen Sie, ob der Client online und ansprechbar ist (versuchen Sie zuerst, einen Screenshot zu machen).
Prüfen Sie, ob UDP-Port 5004 bidirektional offen ist.
Der Grafiktreiber des Clients muss möglicherweise aktualisiert werden.
Versuchen Sie, eine Keyframe-Aktualisierung anzufordern.

Maus oder Tastatur können nicht fernbedient werden

Symptome: Sie können den Remote-Bildschirm sehen, aber Klicks und Tastenanschläge haben keine Wirkung.

Lösungen:

Überprüfen Sie, ob der Remote-Management-Port (TCP 5003) offen ist.
Stellen Sie sicher, dass die Client-Anwendung die entsprechenden Systemberechtigungen hat.
Einige Vollbildspiele können die Fernsteuerung blockieren.

Lizenzprobleme

Lizenz zeigt "offline_grace"

Symptome: Lizenzstatus zeigt offline_grace mit einem Countdown.

Lösungen:

Stellen Sie die Internetverbindung auf dem Server-PC wieder her.
Überprüfen Sie die DNS-Auflösung. Der Server muss den Lizenzserver erreichen.
Prüfen Sie, ob Proxy oder Firewall ausgehende HTTPS-Verbindungen blockieren.
Sie haben 72 Stunden, um die Verbindung wiederherzustellen, bevor der Server gesperrt wird.

Lizenz zeigt "over_limit"

Symptome: Mehr Clients sind verbunden, als die Lizenz erlaubt.

Lösungen:

Trennen Sie inaktive Clients, die nicht in Gebrauch sind.
Überprüfen Sie die aktuelle Client-Anzahl im Vergleich zu Ihrem Lizenzlimit.
Erweitern Sie Ihre Lizenz für mehr PC-Kapazität.
Hinweis: Konsolen zählen zum gesamten PC-Limit.

Lizenz zeigt "expired" oder "revoked"

Symptome: Server wechselt in den eingeschränkten Modus.

Lösungen:

Überprüfen Sie das Ablaufdatum Ihrer Lizenz.
Erneuern Sie Ihre Lizenz über die HandyCafe-Website.
Bei widerrufenen Lizenzen kontaktieren Sie den HandyCafe-Support.

Allgemeine Probleme

Einstellungsänderungen werden nicht gespeichert

Symptome: Änderungen werden nach dem Verlassen der Einstellungen zurückgesetzt.

Lösungen:

Stellen Sie sicher, dass Sie nach Änderungen auf den Speichern-Button klicken.
Überprüfen Sie auf Validierungsfehler (hervorgehobene Felder mit Fehlermeldungen).
Stellen Sie sicher, dass Sie Administratorrechte haben.

Audit-Logs fehlen Einträge

Symptome: Erwartete Aktionen erscheinen nicht auf der Log-Seite.

Lösungen:

Überprüfen Sie die Log-Filter. Stellen Sie sicher, dass die richtige Kategorie und der richtige Datumsbereich ausgewählt sind.
Stellen Sie sicher, dass die Berechtigung LOG_DISPLAY_FULL gewährt ist (ansonsten werden nur die heutigen Logs angezeigt).
Verwenden Sie das Textsuchfeld, um nach der spezifischen Aktion zu suchen.