HandyCafe Docs
owner cashier it-admin

Häufig gestellte Fragen

Einrichtung und Installation

Welche Geschäftstypen unterstützt HandyCafe?

HandyCafe ist für Internetcafes, Gaming-Center, Esports-Arenen, Cybercafes und PC-Bangs konzipiert. Jedes Unternehmen, das zeitbasierten Zugang zu PCs oder Spielkonsolen anbietet, kann HandyCafe zur Verwaltung von Sitzungen, Abrechnung und Mitgliedschaften nutzen.

Was sind die Systemanforderungen für den HandyCafe Server?

Der Server benötigt Windows 10 oder neuer (64-Bit), mindestens 4 GB RAM, 500 MB Festplattenspeicher und eine lokale Netzwerkverbindung. Client-PCs benötigen Windows 10 oder neuer mit 2 GB RAM. Alle PCs müssen sich im selben LAN befinden. Siehe Systemanforderungen für alle Details.

Wie installiere ich den HandyCafe Server?

Laden Sie das Installationsprogramm von der offiziellen Website herunter, starten Sie es und folgen Sie den Anweisungen. Beim ersten Start erstellt der Ersteinrichtungsassistent Ihr Administratorkonto. Siehe Server-Installation für eine Schritt-für-Schritt-Anleitung.

Wie verbinde ich einen Client-PC mit dem Server?

Installieren Sie den HandyCafe Client auf dem PC. Er verwendet mDNS, um den Server automatisch im lokalen Netzwerk zu finden. Wenn die automatische Erkennung fehlschlägt, geben Sie die IP-Adresse des Servers manuell in den Client-Einstellungen ein. Siehe Client-Installation.

Warum verbindet sich mein Client nicht mit dem Server?

Häufige Ursachen: Der Server läuft nicht, die PCs befinden sich in verschiedenen Subnetzen, die Firewall blockiert Ports (TCP 5001, 5002, 5003 und UDP 5004) oder der Verbindungsschlüssel stimmt nicht überein. Siehe Fehlerbehebung für detaillierte Lösungen.

Welche Ports verwendet HandyCafe?

TCP 5001 (Befehle), TCP 5002 (Dateiübertragungen), TCP 5003 (Fernverwaltung), UDP 5004 (Bildschirmstreaming). Diese sind konfigurierbar unter Netzwerkeinstellungen.

Wie aktiviere ich meine Lizenz?

Geben Sie Ihren Lizenzschlüssel im Lizenzbereich ein. Der Server validiert ihn beim Lizenzierungsserver. Für die Erstaktivierung ist eine aktive Internetverbindung erforderlich. Siehe Lizenzierung.

Was passiert, wenn mein Server länger als 72 Stunden offline ist?

HandyCafe hat eine 72-Stunden-Offline-Kulanzzeit. Während dieser Zeit funktionieren alle Funktionen normal. Nach 72 Stunden ohne Verbindung zum Lizenzierungsserver wechselt der Server in einen gesperrten Zustand, bis der Internetzugang wiederhergestellt wird.


Sitzungen und Preise

Wie starte ich eine Sitzung an einem PC?

Wählen Sie im Admin-Panel einen PC im Leerlauf (Cyan) aus und klicken Sie auf Start auf der Karte. Wählen Sie Nachzahlungs- oder Vorauszahlungsmodus, weisen Sie optional ein Mitglied zu, legen Sie Dauer/Betrag bei Vorauszahlung fest, wählen Sie eine Zahlungsmethode und bestätigen Sie. Siehe Sitzungen.

Was ist der Unterschied zwischen Vorauszahlung und Nachzahlung?

Im Nachzahlungsmodus zahlt der Kunde am Ende basierend auf der tatsächlichen Nutzungsdauer. Im Vorauszahlungsmodus zahlt der Kunde im Voraus für eine feste Dauer oder einen festen Betrag. Vorauszahlung unterstützt zwei Untermodi: Preis beim Kauf fixieren (Kosten beim Start eingefroren) und Live-Preisplan (Kosten passen sich an Zeitslot-Änderungen an). Siehe Sitzungen.

Wie funktioniert der Preisplan?

Der Preisplan ist ein 7-Tage-mal-24-Stunden-Raster, in dem jedem Zeitblock ein farbcodierter Preisslot zugewiesen wird. Jeder Slot hat einen Multiplikator (z. B. 1,0x Standard, 1,5x Spitzenzeit, 0,5x Nebenzeit). Die Sitzungskosten berechnen sich als: Grundstundensatz multipliziert mit dem Slot-Multiplikator multipliziert mit der Dauer. Siehe Sitzungspreise.

Wie lege ich verschiedene Preise für Wochenenden und Wochentage fest?

Erstellen Sie unter Einstellungen > Preisplan Preisslots mit unterschiedlichen Multiplikatoren (z. B. "Wochentag" bei 1,0x, "Wochenende" bei 1,3x). Markieren Sie die Wochenendspalten mit der Wochenendslot-Farbe und die Wochentag-Spalten mit der Wochentag-Slot-Farbe. Siehe Preisplan-Einstellungen.

Wie pausiere und setze ich eine Sitzung fort?

Klicken Sie auf Pausieren auf der Online-PC-Karte. Die Abrechnung stoppt während der Pause. Zum Fortsetzen klicken Sie auf Fortsetzen auf der pausierten PC-Karte. Beim Fortsetzen beginnt ein neues Preissegment. Siehe Sitzungen.

Wie füge ich einer aktiven Sitzung Zeit hinzu?

Klicken Sie auf Zeit hinzufügen auf der Online-PC-Karte. Geben Sie die Anzahl der Minuten ein (positiv zum Verlängern, negativ zum Verkürzen). Für die Anpassung wird ein Transaktionsdatensatz erstellt.

Was passiert, wenn eine Sitzung mehrere Preisslots überspannt?

Die Sitzung wird automatisch an den Slot-Grenzen in Segmente unterteilt. Jedes Segment verwendet den Multiplikator, der in diesem Zeitraum aktiv ist. Die Gesamtkosten sind die Summe aller Segmentkosten. Siehe Sitzungspreise.

Was ist die Startgebühr?

Die Startgebühr ist ein Mindestbetrag, der bei jeder Sitzung berechnet wird. Selbst bei einer sehr kurzen Sitzung wird dem Kunden mindestens dieser Betrag berechnet. Konfigurieren Sie sie unter Preiseinstellungen.


Mitglieder und Treueprogramm

Wie erstelle ich ein neues Mitglied?

Navigieren Sie zur Mitgliederseite und klicken Sie auf Mitglied hinzufügen. Geben Sie Benutzername, Anzeigename, optionale E-Mail, Telefon und weitere Details ein. Weisen Sie bei Bedarf eine Stufe zu. Siehe Mitglieder.

Wie funktioniert das Guthabensystem?

Jedes Mitglied hat ein Guthaben. Beim Aufladen wird eine Guthabenbuchung mit einem bestimmten Betrag und Kredittyp (bezahlt, Bonus, manuell usw.) erstellt. Während Sitzungen wird das Guthaben automatisch verbraucht. Gutschriften können Ablaufdaten und Gerätebeschränkungen haben. Siehe Mitglieder-Guthaben.

Was ist eine Guthabenbuchung?

Eine Guthabenbuchung ist ein einzelner Guthabeneintrag, der durch eine einzelne Aufladung erstellt wird. Jede Buchung verfolgt ihren eigenen Betrag, Kredittyp (bezahlt, Bonus, manuell), Status (aktiv, abgelaufen, verbraucht) und zulässige Gerätebeschränkung. Gutschriften werden in der Reihenfolge verbraucht (älteste zuerst). Siehe Mitglieder-Guthaben.

Wie funktionieren Treuestufen und Punkte?

Mitglieder sammeln Punkte durch Aktivitäten (Ausgaben, Besuche, Aufladungen, Bestellungen). Jede Stufe hat einen Punkteschwellenwert. Wenn ein Mitglied genug Punkte ansammelt, steigt es zur nächsten Stufe auf. Höhere Stufen können bessere Rabatte bieten. Siehe Treuestufen.

Wie lade ich das Guthaben eines Mitglieds auf?

Wählen Sie das Mitglied auf der Mitgliederseite, klicken Sie auf die Zahlungs-/Aufladeoption, geben Sie den Betrag ein, wählen Sie Kredittyp und Zahlungsmethode und bestätigen Sie. Eine neue Guthabenbuchung wird erstellt. Siehe Mitglieder-Guthaben.

Kann ein Mitglied sein Guthaben sowohl für PCs als auch für Konsolen verwenden?

Das hängt von der Gerätebeschränkung der Gutschrift ab. Gutschriften können auf "nur PCs", "nur Konsolen" oder "beides" beschränkt sein. Beim Kauf eines Pakets wird die Gerätebeschränkung durch die Paketkonfiguration festgelegt. Siehe Pakete.

Was passiert, wenn eine Guthabenbuchung abläuft?

Wenn eine Gutschrift ihr Ablaufdatum erreicht, ändert sich ihr Status zu "abgelaufen" und der verbleibende Betrag steht nicht mehr zur Nutzung bereit. Der abgelaufene Betrag wird im Transaktionsverlauf des Mitglieds protokolliert.

Wie sehe ich den Transaktionsverlauf eines Mitglieds ein?

Wählen Sie das Mitglied auf der Mitgliederseite. Das Mitglieder-Detailpanel zeigt das Transaktionsbuch mit allen Guthabenaufladungen, Ausgaben, Erstattungen und Anpassungen mit Zeitstempeln und Beträgen.


Produkte, Bestellungen und Inventar

Wie füge ich ein Produkt zum Katalog hinzu?

Navigieren Sie zu Produkte und klicken Sie auf Produkt hinzufügen. Geben Sie Name, Kategorie, Einheit, Barcode, Verkaufspreis, Einkaufspreis und MwSt.-Satz ein. Schalten Sie aktiv/inaktiv um. Siehe Produkte.

Wie erstelle ich eine Bestellung für einen Kunden?

Navigieren Sie zu Bestellungen, klicken Sie auf Neue Bestellung, weisen Sie optional einem PC zu oder fügen Sie eine Notiz hinzu, fügen Sie Artikel aus dem Produktkatalog mit Mengen hinzu und schließen Sie die Bestellung mit einer Zahlungsmethode ab. Siehe Bestellungen.

Wie storniere oder erstatte ich eine Bestellung?

Öffnen Sie die Bestellung auf der Bestellungsseite und klicken Sie auf Stornieren. Die Bestellung wird annulliert und keine Zahlung erfasst. Für Erstattungen bei geschlossenen Bestellungen verwenden Sie den entsprechenden Erstattungsablauf.

Wie funktioniert die Bestandsverfolgung?

Jedes Produkt hat einen Lagerbestand. Das Bestandsprotokoll verfolgt Änderungen mit Gründen: Verkauf (automatisch verringert beim Abschluss einer Bestellung), Einkauf (aus Inventareinträgen), Anpassung, Schwund und Rückgabe. Siehe Produkte und Inventar.


Kampagnen und Pakete

Wie erstelle ich eine Kampagne?

Navigieren Sie zu Kampagnen und klicken Sie auf Kampagne hinzufügen. Geben Sie Name und Beschreibung ein, setzen Sie sie auf aktiv und konfigurieren Sie ggf. ein Ablaufdatum. Fügen Sie dann Pakete zur Kampagne hinzu. Siehe Kampagnen.

Was ist der Unterschied zwischen minuten- und geldbasierten Paketen?

Minutenbasierte Pakete geben dem Mitglied Zeit (Minuten), die für Sitzungen verwendet werden kann. Geldbasierte Pakete fügen dem Guthaben des Mitglieds Geld hinzu. Beide können Bonusbeträge enthalten. Siehe Pakete.

Wie funktioniert das Bonussystem bei Paketen?

Ein Paket kann einen Bonus zusätzlich zum Grundanspruch enthalten. Zum Beispiel könnte ein Paket "60 Minuten + 15 Bonusminuten" oder "10 EUR + 2 EUR Bonus" bieten. Der Bonus erstellt einen separaten Guthabeneintrag mit dem Kredittyp "Bonus".

Wie funktionieren Gerätebeschränkungen bei Paketen?

Jedes Paket definiert eine Gerätebeschränkung: Client (PCs), Konsole (Konsolen), beides, nur PCs oder nur Konsolen. Beim Kauf des Pakets erben die erstellten Guthaben-/Zeitgutschriften diese Beschränkung und können nur auf passenden Gerätetypen verwendet werden.


Kassiererverwaltung

Wie erstelle ich ein Kassierer-Konto?

Navigieren Sie zu Verwaltung > Kassierer. Klicken Sie auf Kassierer hinzufügen, geben Sie Benutzername und Passwort ein und weisen Sie eine Rolle zu. Der Kassierer kann sich dann mit diesen Zugangsdaten anmelden. Siehe Kassierer-Rollen.

Wie lege ich Berechtigungen für eine Kassierer-Rolle fest?

Navigieren Sie zu Verwaltung > Kassierer-Rollen. Erstellen Sie eine neue Rolle oder bearbeiten Sie eine bestehende. Aktivieren oder deaktivieren Sie einzelne Berechtigungsflags in jeder der 6 Kategorien (Authentifizierung, Mitglieder, Konsolen, Protokolle, Berichte, Zahlungsmethoden). Siehe Kassierer-Rollen.

Was sind die 6 Berechtigungskategorien?

Authentifizierung (1 Flag), Mitglieder (6 Flags: Anzeigen, Hinzufügen, Löschen, Bearbeiten, E-Mail anzeigen, Telefon anzeigen), Konsolen (4 Flags: Anzeigen, Hinzufügen, Löschen, Bearbeiten), Protokolle (4 Flags: Anzeigen, Vollständiger Verlauf, Nur heute, Löschen), Berichte (3 Flags: Anzeigen, Vollständiger Verlauf, Nur heute), Zahlungsmethoden (4 Flags: Verwalten, Hinzufügen, Löschen, Bearbeiten). Gesamt: 22 einzelne Berechtigungsflags.

Wie funktioniert der Brute-Force-Schutz bei der Kassierer-Anmeldung?

Nach 5 fehlgeschlagenen Anmeldeversuchen innerhalb von 10 Minuten wird das Konto für 15 Minuten gesperrt. Alle fehlgeschlagenen Versuche werden in der Prüfspur mit einer Sicherheitswarnung protokolliert.

Wie sehe ich Kassierer-Schichtberichte ein?

Öffnen Sie die Kassenberichtseite. Filtern Sie nach Kassierer-Name, um die von einem bestimmten Kassierer während seiner Schicht verarbeiteten Transaktionen zu sehen. Die Schichtübersicht zeigt Gesamtwerte und Aufschlüsselung nach Zahlungsmethode.


Einstellungen und Konfiguration

Wie ändere ich die Sprache?

Navigieren Sie zu Einstellungen > Allgemein und wählen Sie Ihre Sprache aus dem Dropdown-Menü. HandyCafe unterstützt 24 Sprachen. Die Oberfläche wird sofort aktualisiert. Siehe Allgemeine Einstellungen.

Wie richte ich die Google OAuth-Anmeldung ein?

Navigieren Sie zu Einstellungen > OAuth. Aktivieren Sie OAuth global und dann Google. Geben Sie Ihre Google Client-ID und Ihr Client-Secret ein (aus der Google Cloud Console). Optional können Sie die JSON-Zugangsdatendatei importieren. Testen Sie, indem Sie eine OAuth-Anmeldung von einem Client-PC initiieren. Siehe OAuth-Einstellungen.

Wie konfiguriere ich das Preisplan-Raster?

Navigieren Sie zu Einstellungen > Preisplan. Aktivieren Sie den Plan, erstellen Sie farbcodierte Slots mit Multiplikatoren und klicken/ziehen Sie im 7x24-Stunden-Raster, um Zeitblöcke mit dem gewünschten Slot zu markieren. Siehe Preisplan-Einstellungen.

Wie passe ich den Client-Leerlaufbildschirm an?

Navigieren Sie zu Einstellungen > Clients > Leerlaufbildschirm-Reiter. Aktivieren Sie die Diashow, fügen Sie Bilder oder Videos hinzu, legen Sie Dauern und Übergänge fest. Optional aktivieren Sie Uhr- und Cafe-Namensüberlagerungen. Siehe Client-Leerlaufbildschirm.

Wie ändere ich das Client-Erscheinungsbild?

Navigieren Sie zu Einstellungen > Clients > Erscheinungsbild-Reiter. Wählen Sie ein Design (Neon Arena, Crimson Pulse, Emerald Depth), wählen Sie ein Layout-Preset und konfigurieren Sie Hintergrund, Kartendichte und Effekte. Siehe Client-Erscheinungsbild.

Wie richte ich Soundbenachrichtigungen ein?

Navigieren Sie zu Einstellungen > Sounds. Aktivieren Sie den Master-Sound-Schalter und wählen Sie dann für jedes Ereignis (Kassierer rufen, Neue Bestellung, Sitzungsende, Anmeldeanfrage) einen Sound aus den 15 integrierten Optionen. Siehe Sound-Einstellungen.

Was ist der Verbindungsschlüssel und warum ist er wichtig?

Der Verbindungsschlüssel ist ein gemeinsames Geheimnis für die kryptografische Authentifizierung zwischen Server und Clients. Er verhindert, dass unbefugte Geräte sich mit Ihrem Server verbinden. Alle Clients müssen denselben Schlüssel wie der Server verwenden. Konfigurieren Sie ihn unter Netzwerkeinstellungen.


Fernverwaltung

Wie erstelle ich einen Remote-Screenshot eines Client-PCs?

Wählen Sie den Client im Admin-Panel aus und klicken Sie auf Screenshot auf der Karte. Der Screenshot-Viewer zeigt das aufgenommene Bild an. Sie können für eine neue Aufnahme aktualisieren oder das Bild herunterladen. Siehe Screenshots.

Wie verwende ich Remote-Desktop zur Steuerung eines Client-PCs?

Wählen Sie die Client-Karte aus und klicken Sie auf Remote-Desktop. Ein Fenster öffnet sich mit Live-H.264-Videostreaming. Sie können Maus und Tastatur fernsteuern und die Zwischenablage-Synchronisierung funktioniert zwischen Server und Client. Siehe Remote-Desktop.

Wie funktioniert das Dateisynchronisierungssystem?

Konfigurieren Sie zu synchronisierende Verzeichnisse unter Einstellungen > Sync Explorer. Beim Auslösen erstellt der Server ein Dateimanifest. Clients vergleichen das Manifest mit lokalen Dateien und laden nur geänderte oder neue Dateien über blockbasierte Übertragung herunter. Siehe Dateisynchronisierung.

Wie sehe ich, welche Apps auf einem Client-PC laufen?

Wählen Sie den Client im Admin-Panel aus und klicken Sie auf Laufende Apps auf der Karte. Ein Panel zeigt alle aktuell laufenden Prozesse mit Namen und Details. Sie können auch Autostart-Apps, Installierte Apps und Fenster-Apps über dieselben Aktionsschaltflächen anzeigen.

Wie sende ich eine Nachricht an einen Client-PC?

Wählen Sie die Client-Karte aus und klicken Sie auf Nachricht senden. Geben Sie Ihre Nachricht ein und bestätigen Sie. Die Nachricht erscheint auf dem Kundenbildschirm.

Wie fahre ich einen Client-PC remote herunter oder starte ihn neu?

Wählen Sie die Client-Karte aus und klicken Sie auf Herunterfahren oder Neustart. Sie können auch mehrere Clients für Massenoperationen auswählen. Wake on LAN steht zum Einschalten von Offline-PCs zur Verfügung, die dies unterstützen.


Berichte und Analysen

Wie sehe ich den Kassenbericht ein?

Navigieren Sie zu Kassenbericht in der Seitenleiste. Der Bericht zeigt Übersichtskarten, Transaktionsverlauf, Geräteeinnahmen und Diagramme. Verwenden Sie Datumsfilter zum Eingrenzen des Zeitraums. Siehe Kassenbericht.

Wie exportiere ich Berichtsdaten?

Verwenden Sie im Kassenbericht die Export-/Kopierfunktion, um Transaktionsdaten im CSV-Format in Ihre Zwischenablage zu kopieren. Sie können diese dann in Excel oder jede andere Tabellenkalkulationsanwendung einfügen.

Welche Analysen sind auf der Statistikseite verfügbar?

Neun Analyse-Reiter: Einnahmentrends, Verkaufsanalysen, Ausgabenverfolgung, Sitzungsstatistiken, Konsolenauslastung, Anwendungsnutzung, Computerauslastungsraten, Mitgliederaktivität und Kassiererleistung. Siehe Statistiken.

Wie prüfe ich die Computerauslastungsraten?

Navigieren Sie zu Statistiken > Computernutzung-Reiter. Dieser zeigt PC-bezogene Auslastungsprozentsätze, Betriebszeiten und Einnahmen pro Gerät. Er identifiziert auch Ihre am stärksten genutzten PCs. Siehe Sitzungs- und Computerstatistiken.


Fehlerbehebung

Client zeigt "offline" an, aber der PC ist eingeschaltet. Was kann ich tun?

Prüfen Sie: 1) HandyCafe Client läuft auf dem PC, 2) Beide PCs befinden sich im selben Netzwerk/Subnetz, 3) Firewall erlaubt TCP-Ports 5001-5003, 4) Der Verbindungsschlüssel stimmt zwischen Server und Client überein. Siehe Fehlerbehebung.

Sitzungspreise erscheinen falsch. Wie überprüfe ich das?

Prüfen Sie die Preiseinstellungen (Einstellungen > Preise) für den Grundstundensatz und die MwSt. Prüfen Sie den Preisplan (Einstellungen > Preisplan) auf aktive Multiplikatoren zum Zeitpunkt der Sitzung. Überprüfen Sie die Preissegmente der Sitzung in den Transaktionsdetails, um zu sehen, wie jedes Segment berechnet wurde.

OAuth-Anmeldung bleibt bei "ausstehend" hängen. Wie löse ich das?

Stellen Sie sicher, dass der Administrator die Anfrage auf der Anfragenseite genehmigt hat. Wenn die Anfrage hängt, prüfen Sie: 1) OAuth-Provider-Zugangsdaten sind unter Einstellungen > OAuth korrekt, 2) Der Server hat Internetzugang zum Erreichen der Provider-API, 3) Der Gerätecode ist nicht abgelaufen (diese laufen typischerweise in 15-30 Minuten ab).

Remote-Desktop ist verzögert. Wie verbessere ich die Leistung?

Senken Sie die Bitrate in den Stream-Einstellungen (versuchen Sie 1000-2000 kbps für LAN). Prüfen Sie die Netzwerkbandbreite zwischen Server und Client. Stellen Sie sicher, dass UDP-Port 5004 nicht blockiert ist. Verwenden Sie kabelgebundenes Ethernet anstelle von WLAN für beste Ergebnisse.

Meine Lizenz zeigt "over_limit". Was bedeutet das?

Mehr Client-PCs sind verbunden, als Ihre Lizenz erlaubt. Trennen Sie ungenutzte Clients oder erweitern Sie Ihre Lizenz. Der Server startet keine neuen Sitzungen, bis die Anzahl verbundener Clients das Limit erreicht oder unterschreitet.

Ein Kassierer ist nach zu vielen fehlgeschlagenen Anmeldeversuchen gesperrt. Wie entsperre ich ihn?

Warten Sie 15 Minuten auf das automatische Ablaufen der Sperrung. Im dringenden Fall kann ein Administrator das Kassiererkonto über die Verwaltungsoberfläche verwalten.