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 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.

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, falls zutreffend, oder 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. Zugehörige Daten wie Sitzungsverlauf und Guthabendatensätze bleiben für Berichtszwecke erhalten, sind aber nicht mehr mit einem aktiven Mitgliederprofil verknüpft.

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.