HandyCafe Docs
owner cashier

Mitgliederverwaltung

Mitglieder sind registrierte Kunden in Ihrem Internetcafe oder Gaming-Center. Ein Mitgliederprofil speichert die Identität, Kontaktinformationen, Anmeldedaten und Abrechnungspräferenzen des Kunden. Mitglieder können sich an Client-PCs anmelden, Guthaben ansammeln, Zeitpakete kaufen, Treuepunkte sammeln und stufenbasierte Rabatte auf Sitzungen und Bestellungen erhalten.

Mitgliederprofilfelder

Jeder Mitgliederdatensatz enthält folgende Informationen:

  • Benutzername: Ein eindeutiger, nicht zwischen Groß- und Kleinschreibung unterscheidender Bezeichner, den das Mitglied zur Anmeldung an Client-PCs verwendet. Ein einmal vergebener Benutzername kann nicht im System dupliziert werden.
  • Anzeigename: Der Name, der im Admin-Panel, in Sitzungslisten und in der clientseitigen Begrüßung angezeigt wird. Dies ist ein Pflichtfeld.
  • Passwort: Mitglieder können ein Passwort für die Self-Service-Anmeldung an Client-PCs festlegen. Das Passwort wird als Hash gespeichert und kann anfänglich leer gelassen werden (das Mitglied legt es bei der ersten Anmeldung fest).
  • E-Mail: Optionale E-Mail-Adresse. Die Sichtbarkeit wird durch die DISPLAY_EMAIL-Berechtigung gesteuert.
  • Mobilnummer: Optionale Telefonnummer. Die Sichtbarkeit wird durch die DISPLAY_GSM-Berechtigung gesteuert.
  • Avatar: Eine Profilbild-URL, die auf dem Client-Sperrbildschirm und in Mitgliederlisten angezeigt wird.
  • Geschlecht: Standardmäßig "unbekannt". Kann für die demografische Filterung auf männlich, weiblich oder andere gesetzt werden.
  • Notiz: Ein Freitext-Notizfeld für den internen Gebrauch. Nur für Mitarbeiter sichtbar, nicht für das Mitglied.

Mitgliederstatus

Jedes Mitglied hat zwei unabhängige Status-Flags:

Aktiv / Inaktiv

Der Aktiv/Inaktiv-Schalter steuert, ob das Mitglied in Standard-Suchergebnissen erscheint und mit dem System interagieren kann. Das Deaktivieren eines Mitglieds ist ein Soft-Delete. Das Profil und alle zugehörigen Daten (Guthabenbuchungen, Zeitgutschriften, Sitzungsverlauf) bleiben erhalten, aber das Mitglied wird im Tagesbetrieb ausgeblendet.

Anmeldeberechtigung

Das can_login-Flag steuert, ob das Mitglied sich an Client-PCs anmelden darf. Ein Mitglied kann aktiv (im System sichtbar) sein, aber die Anmeldung deaktiviert haben. Dies ist nützlich für Mitglieder mit ausstehenden Schulden oder Regelverstößen.

Stufenzuweisung

Jedem Mitglied kann eine Treuestufe zugewiesen werden. Die Stufe bestimmt:

  • Rabatt in BPS: Ein Basispunkt-Rabatt auf Sitzungspreise. Zum Beispiel gibt eine Stufe mit discount_bps = 500 dem Mitglied 5% Rabatt auf den Stundensatz.
  • Rollenbezeichnung: Eine beschreibende Bezeichnung (wie Silber, Gold, VIP), die im Profil des Mitglieds und in Sitzungspanels angezeigt wird.

Die Stufenzuweisung kann manuell oder automatisch basierend auf dem Treuepunktesystem erfolgen. Siehe Treuestufen für Details zur Stufenkonfiguration und zum Aufstieg.

Restzeit und Gerätebereich

Die Restzeit eines Mitglieds ist keine einzelne Zahl. Zeit wird in Posten gehalten. Jeder Posten ist nur an PCs, nur an Konsolen oder an beidem nutzbar. Die Töpfe überschneiden sich nicht. Das Gesamtguthaben ist ihre schlichte Summe.

Was ein Mitglied tatsächlich ausgeben kann, hängt davon ab, wo es sitzt:

Platz Nutzbare Zeit
An einem PC Die reinen PC-Posten plus die Posten für beide Gerätearten
An einer Konsole Die reinen Konsolenposten plus die Posten für beide Gerätearten

Das Mitgliedschaftspanel zeigt das Gesamtguthaben und getrennt davon, wie viel davon an PCs und an Konsolen nutzbar ist. Sitzt das Mitglied gerade, zeigt es zusätzlich, wie viel an diesem Platz nutzbar ist, berechnet mit der Preisgruppe und dem Gerätebereich des Geräts, an dem es sitzt. Das Abzeichen verschwindet, sobald das Mitglied den Platz verlässt.

Deshalb kann ein Mitglied insgesamt 480 Minuten halten, während am Rechner vor ihm nur wenige Minuten verfügbar sind. Ein auf Konsolen beschränktes Paket ist an einem PC nichts wert.

Wird eine Sitzung an einem Gerät geöffnet, das von keiner Zeit des Mitglieds abgedeckt ist, zeigt das Panel Mitgliedszeit auf diesem Gerät nicht nutzbar.

Ablaufende Zeit

Das Panel benennt den nächsten Ablauf als Gruppe statt als einzelnen Posten. Alle Posten, die zum selben Zeitpunkt ablaufen, werden zusammengezählt und nach Gerätebereich aufgeschlüsselt. Die Warnung spiegelt damit den gesamten Betrag wider, der verfallen wird.

Mitgliederkarten

Einem Mitglied kann eine NFC- oder RFID-Karte gegeben werden, die eine Sitzung mit einem Auflegen öffnet, statt mit Benutzername und Passwort. Karten werden im Panel des Mitglieds zugewiesen, zurückgenommen und gesperrt. Siehe Mitgliederkarten.

Gleichzeitige Verbindungsgrenze

Das Feld max_connection legt die maximale Anzahl gleichzeitiger aktiver Sitzungen fest, die ein Mitglied über alle Client-PCs haben kann. Der Standardwert ist 1, d. h. das Mitglied kann nur an einem PC gleichzeitig angemeldet sein. Versucht ein Mitglied sich an einem zweiten PC anzumelden, während bereits eine aktive Sitzung läuft, wird die Anmeldung abgewiesen.

Eine Erhöhung dieses Werts ist nützlich für Mitglieder, die mehrere Rechner verwalten (z. B. Personalkonten) oder für spezielle Mitgliedschaftsstufen mit Multi-Geräte-Nutzung.

Mitglieder suchen und filtern

Die Mitgliederseite bietet eine virtuell scrollende Liste, die auch große Mitgliederdatenbanken effizient verarbeitet. Sie können:

  • Suchen: Geben Sie in der Suchleiste ein, um nach Benutzername, Anzeigename, E-Mail oder Mobilnummer zu filtern. Die Suche berücksichtigt nicht die Groß-/Kleinschreibung und aktualisiert die Ergebnisse in Echtzeit.
  • Nach Status filtern: Zwischen allen Mitgliedern, nur aktiven oder nur inaktiven umschalten.
  • Sortieren: Auf Spaltenüberschriften klicken, um nach Name, letztem Zugriffsdatum oder Erstellungsdatum zu sortieren.

Die virtuelle Scroll-Implementierung lädt nur den sichtbaren Teil der Mitgliederliste in den Speicher, sodass die Leistung auch bei Zehntausenden registrierten Mitgliedern reibungslos bleibt.

Online-Statusanzeige

Wenn ein Mitglied aktuell an einem Client-PC angemeldet ist oder eine aktive Konsolensitzung hat, zeigt sein Profil eine grüne Online-Anzeige in der Mitgliederliste. Die Anzeige zeigt auch, welchen spezifischen Client oder welche Konsole das Mitglied gerade nutzt, damit Mitarbeiter einen Kunden schnell finden können.

Neues Mitglied erstellen

So erstellen Sie ein neues Mitglied:

  1. Navigieren Sie zur Seite Mitglieder in der Seitenleiste.
  2. Klicken Sie auf die Schaltfläche Mitglied hinzufügen in der Symbolleiste.
  3. Füllen Sie mindestens den Anzeigenamen (Pflichtfeld) und optional einen Benutzernamen zur Anmeldung aus.
  4. Weisen Sie eine Stufe zu, sofern zutreffend. Andernfalls belassen Sie die Standardeinstellung.
  5. Passen Sie den Wert Maximale Verbindungen an, falls der Standard von 1 nicht passend ist.
  6. Klicken Sie auf Speichern, um das Mitglied zu erstellen.

Das System generiert automatisch eine eindeutige ID für das Mitglied und erfasst die Identität des erstellenden Kassierers.

Mitglied bearbeiten

Wählen Sie ein Mitglied aus der Liste, um die Profildetailansicht zu öffnen. Von hier aus können Sie:

  • Beliebige Profilfelder aktualisieren (Anzeigename, E-Mail, Mobilnummer, Geschlecht, Notiz).
  • Die Stufenzuweisung des Mitglieds ändern.
  • Die Flags aktiv und can_login umschalten.
  • Das Passwort des Mitglieds zurücksetzen oder ändern.
  • Die gleichzeitige Verbindungsgrenze anpassen.

Alle Änderungen werden sofort gespeichert und ein Audit-Protokolleintrag wird erstellt.

Mitglied löschen

Das Löschen eines Mitglieds entfernt sein Profil aus dem aktiven System. Diese Aktion erfordert die MEMBER_DELETE-Berechtigung. Ein Mitglied kann auch dann gelöscht werden, wenn es vergangene Sitzungen oder einen Anmeldeverlauf hat. Sitzungs- und Transaktionsverlauf bleiben für Berichtszwecke erhalten, sind aber nicht mehr mit einem Mitgliederprofil verknüpft. Guthaben und Zeitguthaben werden mit dem Profil entfernt. Um den vollständigen Datensatz eines Mitglieds zu erhalten, deaktivieren Sie es, statt es zu löschen.

Berechtigungsanforderungen

Der Zugriff auf Mitgliederverwaltungsfunktionen wird durch folgende Berechtigungen der Kassiererrolle gesteuert:

Berechtigung Gewährt
MEMBER_VIEW Mitgliederliste anzeigen und Mitglieder suchen
MEMBER_ADD Neue Mitgliederprofile erstellen
MEMBER_UPDATE Bestehende Mitgliederprofile bearbeiten
MEMBER_DELETE Mitgliederprofile löschen
DISPLAY_EMAIL E-Mail-Adresse des Mitglieds in der Detailansicht anzeigen
DISPLAY_GSM Mobilnummer des Mitglieds in der Detailansicht anzeigen

Wenn die Rolle eines Kassierers DISPLAY_EMAIL oder DISPLAY_GSM nicht enthält, werden diese Felder im Mitglieder-Detailpanel ausgeblendet, obwohl die Daten in der Datenbank existieren.