Mitglieder-Guthaben
Das Mitglieder-Guthaben ist ein monetäres Saldosystem, mit dem Mitglieder Cafe-Dienste im Voraus bezahlen können. Anstatt für jede einzelne Sitzung bar zu bezahlen, kann ein Mitglied Geld auf sein Guthaben laden und das System zieht automatisch von diesem Saldo ab, wenn es PCs, Konsolen nutzt oder Produkte bestellt.
Gutschriftbasierte Architektur
Das Guthaben verwendet ein Gutschriftsystem anstelle eines einzelnen laufenden Saldos. Jedes Mal, wenn Geld auf das Guthaben eines Mitglieds geladen wird, erstellt das System eine neue Guthabenbuchung. Jeder Eintrag ist ein individueller Datensatz mit eigenem Saldo, Quelle, Ablaufdatum und Gerätebeschränkung. Dieses Design bietet:
- Vollständige Nachverfolgbarkeit der Herkunft jeder Saldeneinheit.
- Unabhängige Ablaufdaten pro Guthabeneintrag.
- Gerätespezifische Beschränkungen (einige Gutschriften nur auf PCs, andere nur auf Konsolen nutzbar).
- Klare Trennung zwischen bezahlten Mitteln und Werbeboni.
Das Gesamtguthaben des Mitglieds ist die Summe aller verbleibenden Werte über alle aktiven Guthabeneinträge hinweg.
Kredittypen
Jede Guthabenbuchung hat einen Kredittyp, der angibt, wie die Mittel ins System gelangten:
| Kredittyp | Beschreibung |
|---|---|
| Bezahlt | Das Mitglied hat für diese Mittel bezahlt (Bar, Karte oder andere Zahlungsmethode). Erstellt beim Kauf eines geldbasierten Kampagnenpakets. |
| Bonus | Werbemittel, die als Teil eines Paketkaufs gewährt werden. Zum Beispiel "100 Minuten bezahlen, 20 Bonusminuten als Guthaben erhalten". |
| Manuell | Manuell von einem Kassierer oder Administrator geladen. Für Kulanzgutschriften oder besondere Vereinbarungen. |
| Korrektur | Eine administrative Anpassung zur Behebung eines Fehlers im Mitgliedersaldo. |
| Migration | Mittel, die während der Datenmigration aus einem Altsystem importiert wurden. |
| Rückgängig gemachte Erstattung | Mittel, die wiederhergestellt werden, wenn eine zuvor ausgestellte Erstattung rückgängig gemacht wird. |
Der Kredittyp wird beim Erstellen festgelegt und kann danach nicht geändert werden. Er dient als dauerhafte Prüfspur.
Gutschrift-Status
Jede Guthabenbuchung durchläuft einen Lebenszyklus:
- Aktiv: Die Gutschrift hat verbleibende Mittel und ist nicht abgelaufen. Mittel können verbraucht werden.
- Abgelaufen: Das Ablaufdatum ist überschritten. Verbleibende Mittel sind nicht mehr nutzbar.
- Verbraucht: Der verbleibende Saldo hat durch normalen Verbrauch null erreicht.
- Storniert: Die Gutschrift wurde manuell von einem Administrator storniert, wodurch der verbleibende Saldo verfällt.
Guthabenverbrauch
Wenn das Guthaben eines Mitglieds belastet wird (für Sitzungszeit, eine Bestellung oder ein anderes abrechnungsfähiges Ereignis), erstellt das System einen Verbrauchsdatensatz, der mit einem bestimmten Guthabeneintrag verknüpft ist und genau erfasst, wie viel abgezogen wurde.
Jeder Verbrauchsdatensatz enthält einen Kontext, der identifiziert, was den Abzug ausgelöst hat:
| Kontext | Beschreibung |
|---|---|
| Sitzungsnutzung | Mittel, die zur Bezahlung der Sitzungsnutzungszeit verbraucht wurden. Das System zieht während der laufenden Sitzung vom Guthaben ab. |
| Guthabenzahlung | Eine direkte Zahlung vom Guthaben (z. B. wenn das Mitglied eine Produktbestellung mit Guthaben bezahlt). |
| Bestellung | Mittel, die zur Bezahlung einer Produktbestellung an der Cafe-Kasse verbraucht wurden. |
| Erstattung | Eine negative Anpassung bei einer Erstattung, die den Verbrauch reduziert und Mittel an den Guthabeneintrag zurückgibt. |
Jeder Verbrauchsdatensatz verweist auf die spezifische Sitzung, Bestellung oder Transaktion, die ihn verursacht hat, und ermöglicht eine vollständige Prüfungsverfolgung.
Saldoprotokoll
Zusätzlich zu den Verbrauchsdatensätzen auf Gutschriftebene führt das System ein Mitglieder-Saldoprotokoll, das jedes Ereignis erfasst, das den Gesamtguthabensaldo ändert:
| Ereignistyp | Beschreibung |
|---|---|
load |
Mittel wurden zum Guthaben hinzugefügt (neuer Guthabeneintrag erstellt oder bestehender aufgeladen). |
spend |
Mittel wurden vom Guthaben verbraucht (Sitzungszahlung, Bestellungszahlung). |
refund |
Mittel wurden zum Guthaben zurückerstattet (Bestellungserstattung, Sitzungserstattung). |
adjustment |
Eine administrative Änderung am Saldo (Korrektur, Abschreibung). |
Jeder Saldoprotokoll-Eintrag erfasst den Änderungsbetrag und den resultierenden Saldo, sodass Sie den Saldo des Mitglieds zu jedem Zeitpunkt rekonstruieren können, indem Sie das Protokoll chronologisch lesen.
Gerätebeschränkung
Jede Guthabenbuchung hat eine Gerätebeschränkung, die steuert, welche Gerätetypen davon abziehen können:
| Beschränkung | Bedeutung |
|---|---|
| Client | Nutzbar auf Client-PCs. Auch auf Konsolen nutzbar, sofern nicht ausdrücklich eingeschränkt. |
| Konsole | Nutzbar auf Spielkonsolen. Auch auf PCs nutzbar, sofern nicht ausdrücklich eingeschränkt. |
| Nur PCs | Ausschließlich auf Client-PCs nutzbar. Kann nicht von Konsolensitzungen verbraucht werden. |
| Nur Konsolen | Ausschließlich auf Spielkonsolen nutzbar. Kann nicht von PC-Sitzungen verbraucht werden. |
| Beides | Auf jedem Gerätetyp ohne Einschränkung nutzbar. Dies ist die Standardeinstellung. |
Wenn das System vom Guthaben eines Mitglieds abziehen muss, filtert es die verfügbaren Gutschriften nach Gerätebeschränkung, um sicherzustellen, dass nur berechtigte Gutschriften belastet werden.
Guthabenkategorie und kategorieübergreifende Ausgaben
Guthabenbuchungen können mit einer Guthabenkategorie versehen werden (z. B. "Gaming" oder "Allgemein"). Dies ermöglicht dem Cafe die Erstellung isolierter Saldopools, die nur in bestimmten Kontexten verwendet werden können.
Die Option kategorieübergreifende Ausgaben steuert, ob Mittel außerhalb der vorgesehenen Kategorie verwendet werden können:
- Wenn deaktiviert (Standard), kann die Gutschrift nur in ihrer eigenen Kategorie verbraucht werden.
- Wenn aktiviert, kann die Gutschrift auch von Transaktionen in anderen Kategorien verbraucht werden.
Wenn einer Gutschrift keine Kategorie zugewiesen ist, wird sie als Allzweck-Gutschrift behandelt und kann von jeder Transaktion unabhängig von der Kategorie verbraucht werden.
Wie Aufladungen funktionieren
Guthaben kann auf verschiedene Weisen aufgeladen werden:
Kampagnenpaket-Kauf: Wenn ein Mitglied ein geldbasiertes Paket aus einer Kampagne kauft, erstellt das System automatisch Guthabenbuchungen basierend auf der Paketdefinition. Ein einzelner Paketkauf kann mehrere Gutschriften erstellen (eine für den bezahlten Anteil, eine für den Bonusanteil).
Manuelle Aufladung: Ein Kassierer kann dem Guthaben eines Mitglieds über das Mitglieder-Detailpanel manuell Mittel hinzufügen. Dies erstellt einen Guthabeneintrag mit dem Kredittyp "Manuell".
Migration: Während der Systemeinrichtung können bestehende Salden aus einem vorherigen System als Guthabeneinträge mit dem Kredittyp "Migration" importiert werden.
Wie das Guthaben während Sitzungen verbraucht wird
Wenn ein Mitglied mit Guthaben eine Sitzung startet, kann das System automatisch die Sitzung vom Guthaben bezahlen:
- Die Sitzungspreisberechnung ermittelt die Kosten pro Minute basierend auf dem aktiven Preisslot und anwendbaren Stufenrabatten.
- Während die Sitzung läuft, zieht das System periodisch die angefallenen Kosten von den berechtigten Guthabenbuchungen des Mitglieds ab.
- Gutschriften werden in der Reihenfolge des Ablaufdatums verbraucht (am frühesten ablaufende zuerst), um Verluste durch Ablauf zu minimieren.
- Wenn das Guthaben vor dem Sitzungsende erschöpft ist, werden die verbleibenden Kosten als Barzahlung beim Sitzungsabschluss berechnet.
- Jeder Abzug erstellt einen Verbrauchsdatensatz, der als "Sitzungsnutzung"-Eintrag mit der Sitzung verknüpft ist.