Treuestufen

Das Treueprogramm belohnt Stammkunden mit automatischen Rabatten basierend auf ihrer gesammelten Aktivität. Wenn Mitglieder das Cafe nutzen (Geld ausgeben, sich anmelden, Pakete kaufen oder Bestellungen aufgeben), sammeln sie Treuepunkte. Wenn ihre Gesamtpunkte einen Stufenschwellenwert überschreiten, steigen sie in eine höhere Stufe auf und erhalten einen größeren Rabatt auf die Sitzungspreise.

Stufenstruktur

Jede Treuestufe wird durch vier Felder definiert:

Feld	Beschreibung
`code`	Ein eindeutiger Kurzcode für die Stufe (z. B. `silver`, `gold`, `vip`). Wird intern zur Identifikation und in API-Antworten verwendet.
`name`	Ein lesbarer Anzeigename (z. B. "Silber-Mitglied", "Gold-Mitglied"). Wird im Mitgliederprofil und auf dem Client-Sperrbildschirm angezeigt.
`threshold_points`	Die Mindestanzahl an Treuepunkten, die ein Mitglied ansammeln muss, um sich für diese Stufe zu qualifizieren.
`discount_bps`	Der Rabatt auf Sitzungspreise in Basispunkten. 100 BPS entsprechen 1%. Ein Wert von 500 bedeutet 5% Rabatt.

Stufen werden nach ihrem threshold_points-Wert geordnet. Ein Mitglied gehört zur höchsten Stufe, deren Punkteschwellenwert es erreicht hat.

Basispunkt-Rabatte (BPS)

Rabatte werden in Basispunkten (BPS) statt in Prozenten ausgedrückt, um Rundungsfehler bei Gleitkommazahlen in Finanzberechnungen zu vermeiden. Ein Basispunkt entspricht 0,01% oder einem Hundertstel Prozent.

Gängige Rabattwerte:

BPS-Wert	Prozent	Beispiel bei 1000 Einheiten/Stunde
250	2,5%	Mitglied zahlt 975 pro Stunde
500	5%	Mitglied zahlt 950 pro Stunde
1000	10%	Mitglied zahlt 900 pro Stunde
1500	15%	Mitglied zahlt 850 pro Stunde
2000	20%	Mitglied zahlt 800 pro Stunde

Wenn ein Mitglied mit Stufenrabatt eine Sitzung startet, reduziert die Preisberechnung den Grundstundensatz um den discount_bps-Wert der Stufe, bevor die Segmentkosten berechnet werden.

Treueereignisse

Mitglieder sammeln Punkte durch Treueereignisse. Jedes Ereignis erfasst eine Punkteänderung und die auslösende Aktivität:

Ereignistyp	Beschreibung	Typische Punkte
`spend`	Das Mitglied hat für eine Sitzung bezahlt (Nachzahlung oder Guthabenabzug). Punkte sind proportional zum ausgegebenen Betrag.	Variiert nach Ausgabenbetrag
`usage`	Das Mitglied hat einen PC oder eine Konsole für eine Sitzung genutzt, unabhängig von der Zahlung. Punkte basieren auf der Nutzungsdauer.	Variiert nach genutzten Minuten
`visit`	Das Mitglied hat sich von einem Client-PC angemeldet. Ein fester Bonus für jeden Besuch, der regelmäßige Besuche fördert.	Fest pro Besuch
`topup`	Das Mitglied hat Guthaben aufgeladen. Punkte spiegeln den Aufladebetrag wider.	Variiert nach Aufladebetrag
`order`	Das Mitglied hat eine Produktbestellung aufgegeben (Speisen, Getränke usw.). Punkte sind proportional zur Bestellsumme.	Variiert nach Bestellsumme
`adjustment`	Eine manuelle Punkteanpassung durch einen Administrator. Für Korrekturen, Aktionen oder besondere Belohnungen.	Beliebiger Wert (positiv oder negativ)

Jeder Treueereignis-Datensatz enthält:

points_delta: Die Anzahl der gewonnenen (positiv) oder verlorenen (negativ) Punkte durch dieses Ereignis.
amount_minor: Der mit dem Ereignis verbundene Geldbetrag (in Währungsuntereinheiten), falls zutreffend.
minutes_delta: Die Anzahl der mit dem Ereignis verbundenen Minuten, falls zutreffend.
source_entity / source_entity_id: Ein Rückverweis auf die Sitzung, Bestellung oder Transaktion, die das Ereignis generiert hat.
event_at: Der Zeitstempel des Ereignisses.

Stufenaufstieg

Der Stufenaufstieg funktioniert wie folgt:

Ein Mitglied führt eine Aktivität aus (Sitzung, Kauf, Anmeldung usw.).
Das System erstellt ein Treueereignis mit dem entsprechenden points_delta.
Die Gesamtpunkte des Mitglieds werden als Summe aller points_delta-Werte seiner Treueereignisse neu berechnet.
Das System prüft, ob die neue Summe den Schwellenwert für eine höhere Stufe erreicht.
Wenn das Mitglied sich für eine neue Stufe qualifiziert, wird sein tier-Feld aktualisiert und der neue Rabatt gilt ab der nächsten Sitzung.

Die Stufenzuweisung kann auch manuell durch einen Administrator gesetzt werden, was die automatische Berechnung überschreibt.

Wie Stufenrabatte auf Sitzungspreise angewendet werden

Wenn die Preisberechnung die Kosten eines Sitzungssegments für ein Mitglied ermittelt:

Der Grundstundenpreis wird durch den aktiven Preisslot bestimmt.
Wenn das Mitglied eine Stufe mit einem discount_bps-Wert hat, wird der Grundpreis reduziert: rabattierter_preis = grundpreis * (10000 - discount_bps) / 10000.
Zusätzlich werden individuelle Mitgliederrabatte (member_discount_bps im Mitgliederdatensatz) angewendet, falls vorhanden.
Der endgültige rabattierte Satz wird zur Berechnung der Segmentkosten verwendet.

Stufenrabatte und Mitgliederrabatte können sich addieren und dem Mitglied den kombinierten Vorteil beider bieten.

Stufen erstellen und verwalten

So erstellen Sie eine neue Stufe:

Navigieren Sie zu Einstellungen und öffnen Sie den Bereich Preise (oder den dedizierten Stufenverwaltungsbereich).
Klicken Sie auf Stufe hinzufügen.
Geben Sie Code (eindeutig, Kleinbuchstaben), Name (Anzeigebezeichnung), Schwellenwert-Punkte und Rabatt-BPS ein.
Speichern Sie die Stufe.

Zum Bearbeiten einer vorhandenen Stufe wählen Sie sie aus der Liste und ändern beliebige Felder. Änderungen am discount_bps einer Stufe gelten für alle derzeit dieser Stufe zugewiesenen Mitglieder ab ihrer nächsten Sitzung.

Zum Löschen einer Stufe entfernen Sie sie aus der Liste. Mitglieder, die der gelöschten Stufe zugewiesen waren, fallen auf die nächstniedrigere Stufe zurück, für die sie sich basierend auf ihren Punkten qualifizieren.

Beispiel-Stufenkonfiguration

Eine typische Drei-Stufen-Konfiguration könnte so aussehen:

Code	Name	Schwellenwert-Punkte	Rabatt-BPS
`bronze`	Bronze	0	0
`silver`	Silber	500	500
`gold`	Gold	2000	1000
`vip`	VIP	5000	1500

In dieser Konfiguration startet ein neues Mitglied bei Bronze (kein Rabatt). Nach dem Sammeln von 500 Punkten durch Besuche, Ausgaben und Bestellungen steigt es automatisch auf Silber mit 5% Rabatt auf. Bei 2000 Punkten erreicht es Gold (10%) und bei 5000 Punkten erhält es VIP-Status (15%).