HandyCafe Docs
owner cashier

Zeitpakete

Zeitpakete bieten Mitgliedern ein Prepaid-Minutenguthaben. Anstatt zum Standardtarif pro Stunde zu bezahlen, kann ein Mitglied im Voraus einen Minutenblock kaufen und diesen über mehrere Sitzungen hinweg nutzen. Das System verfolgt das verbleibende Guthaben und zieht automatisch Minuten ab, wenn das Mitglied PCs oder Konsolen nutzt.

Zeitgutschrift-System

Ähnlich dem Guthabensystem verwenden Zeitpakete eine gutschriftbasierte Architektur. Jede Zeitsaldo-Aufladung erstellt eine neue Zeitgutschrift. Jede Gutschrift ist ein unabhängiger Datensatz mit eigenem Minutenguthaben, Quelle, Ablaufdatum und Gerätebeschränkungen.

Die verfügbaren Gesamtminuten eines Mitglieds sind die Summe aller verbleibenden Minuten über alle aktiven Zeitgutschriften hinweg.

Felder einer Zeitgutschrift

Jeder Zeitgutschrift-Datensatz enthält:

Feld Beschreibung
Gesamtminuten Die ursprüngliche Anzahl der Minuten, die beim Erstellen in diese Gutschrift geladen wurden.
Verbleibende Minuten Das aktuelle Guthaben ungenutzter Minuten. Verringert sich, wenn das Mitglied Sitzungen nutzt.
Kredittyp Wie diese Gutschrift erstellt wurde (siehe Kredittypen unten).
Gerätebeschränkung Welche Gerätetypen von dieser Gutschrift abziehen können (siehe Gerätebeschränkung unten).
Status Der aktuelle Lebenszyklusstatus der Gutschrift.
Läuft ab am Optionaler Ablaufzeitstempel. Nach diesem Datum können verbleibende Minuten nicht mehr genutzt werden.
Kauf-ID Wenn diese Gutschrift aus einem Kampagnenpaket-Kauf erstellt wurde, ein Verweis auf den Kaufdatensatz.

Kredittypen

Jede Zeitgutschrift verfolgt, wie sie erstellt wurde:

Kredittyp Beschreibung
Bezahlt Das Mitglied hat für diese Minuten bezahlt, entweder durch einen direkten Kauf oder als Basisanspruch eines Kampagnenpakets.
Bonus Werbeminuten, die als Bonus mit einem Paketkauf gewährt werden. Zum Beispiel "120 Minuten kaufen, 30 Bonusminuten gratis erhalten".
Manuell Minuten, die manuell von einem Kassierer oder Administrator hinzugefügt wurden. Für Kulanzgutschriften, Entschädigungen oder besondere Vereinbarungen.

Gutschrift-Status

Jede Zeitgutschrift durchläuft folgende Status:

  • Aktiv: Die Gutschrift hat verbleibende Minuten und ist nicht abgelaufen. Minuten können von dieser Gutschrift verbraucht werden.
  • Abgelaufen: Das Ablaufdatum der Gutschrift ist überschritten. Verbleibende Minuten sind nicht mehr nutzbar, selbst wenn das Guthaben größer als null ist.
  • Verbraucht: Die verbleibenden Minuten der Gutschrift haben durch normale Nutzung null erreicht.
  • Storniert: Die Gutschrift wurde manuell von einem Administrator storniert, wodurch alle verbleibenden Minuten verfallen.

Gerätebeschränkungen

Jede Zeitgutschrift 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. Konsolensitzungen können nicht von dieser Gutschrift abziehen.
Nur Konsolen Ausschließlich auf Spielkonsolen nutzbar. PC-Sitzungen können nicht von dieser Gutschrift abziehen.
Beides Auf jedem Gerätetyp ohne Einschränkung nutzbar. Dies ist die Standardeinstellung.

Die Gerätebeschränkung wird beim Erstellen der Gutschrift festgelegt und kann danach nicht geändert werden. Die Beschränkung wird typischerweise von der Kampagnenpaket-Definition geerbt, die die Gutschrift generiert hat.

Verbrauchsverfolgung

Jedes Mal, wenn Minuten von einer Zeitgutschrift abgezogen werden, erstellt das System einen Zeitverbrauchsdatensatz:

Feld Beschreibung
Verbrauchte Minuten Die Anzahl der bei diesem Verbrauchsereignis abgezogenen Minuten. Immer eine positive Ganzzahl.
Verbraucht am Der Zeitstempel des Abzugs.
Kontext Was den Abzug ausgelöst hat (siehe unten).
Referenz Ein Verweis auf die spezifische Sitzung, Gutschrift oder Anpassung, die den Abzug verursacht hat.

Kontexttypen

Kontext Beschreibung
Sitzungsnutzung Minuten, die zur Bezahlung einer aktiven Sitzung verbraucht wurden. Der primäre Verbrauchspfad.
Ablauf Minuten, die beim Ablaufen einer Gutschrift entfernt wurden oder wenn verbleibende Minuten aufgrund eines Ablaufereignisses angepasst wurden.
Erstattung Minuten, die im Rahmen eines Erstattungsprozesses zurückgegeben wurden (erfasst als negativer Verbrauch oder neuer Gutschrifteneintrag).

Integration mit Kampagnenpaketen

Zeitgutschriften werden am häufigsten durch Kampagnenpaket-Käufe erstellt:

  1. Ein Inhaber erstellt eine Kampagne mit einem oder mehreren Paketen des Pakettyps "Minuten".
  2. Ein Mitglied wählt und kauft ein Paket (über das clientseitige Mitglieder-Panel oder über einen Kassierer an der Kasse).
  3. Das System erstellt die entsprechenden Zeitgutschriften:
    • Eine bezahlte Gutschrift für den Basisminutenanspruch (der Grundbetrag aus dem Paket).
    • Wenn das Paket einen Bonustyp "Minuten" mit einem Bonusbetrag größer als null definiert, wird eine separate Bonusgutschrift für die Bonusminuten erstellt.
  4. Die Gutschriften erben die Gerätebeschränkungs-Einstellung des Pakets.
  5. Wenn das Paket eine Gültigkeitsdauer hat, wird das Ablaufdatum der Gutschrift aus dem Kaufdatum plus der Anzahl der Gültigkeitstage berechnet.

Wie Zeit während Sitzungen abgezogen wird

Wenn ein Mitglied mit verfügbaren Zeitminuten eine Sitzung startet:

  1. Das System prüft aktive Zeitgutschriften, die zum Gerätetyp der Sitzung passen.
  2. Gutschriften werden in der Reihenfolge des Ablaufdatums verbraucht (am frühesten ablaufende zuerst), um Verluste durch kurz vor dem Ablauf stehende Gutschriften zu minimieren.
  3. Während die Sitzung läuft, werden periodisch Minuten von den berechtigten Gutschriften abgezogen.
  4. Jeder Abzug erstellt einen Verbrauchsdatensatz als "Sitzungsnutzung"-Eintrag.
  5. Wenn alle Zeitgutschriften vor dem Sitzungsende erschöpft sind, läuft die Sitzung weiter und die verbleibende Zeit wird zum Standardstundensatz abgerechnet (Zahlung beim Sitzungsabschluss).

Das bedeutet, das Zeitguthaben und Geldguthaben eines Mitglieds können zusammenwirken. Zeitgutschriften decken so viele Minuten ab wie verfügbar und jeder Überschuss wird über das Geldguthaben oder Barzahlung abgewickelt.