Sitzungsverwaltung

Sitzungen sind die zentrale Abrechnungseinheit in HandyCafe. Jedes Mal, wenn ein Kunde in Ihrem Internetcafé oder Gaming Center einen PC oder eine Spielekonsole nutzt, verfolgt eine Sitzung seine Nutzungszeit und berechnet die Kosten. Diese Seite erklärt den gesamten Sitzungslebenszyklus, vom Start einer Sitzung bis zur Zahlungseingabe.

Sitzungstypen

HandyCafe unterstützt zwei Arten von Sitzungen:

• PC-Sitzungen. Sitzungen auf Client-PCs, die über das Admin-Panel verwaltet werden. Die Client-Software sperrt den PC im Leerlauf und entsperrt ihn, wenn eine Sitzung beginnt.
• Konsolensitzungen. Sitzungen auf Spielkonsolen (PlayStation, Xbox, etc.), die über die Konsolenseite verwaltet werden. Diese werden nur vom Server verfolgt; es gibt keine Client-Software auf der Konsole selbst.

Beide Sitzungstypen folgen derselben Preis-Engine und demselben Lebenszyklus, werden jedoch von verschiedenen Seiten im Dashboard verwaltet.

Sitzungslebenszyklus

Jede Sitzung folgt einem definierten Lebenszyklus mit klaren Zustandsübergängen:

Start --> Laufend --> (Pause <--> Fortsetzen) --> Zeit hinzufügen --> Stopp

Die Zustände im Detail:

1. Start. Ein Kassierer startet die Sitzung. Der Client-PC entsperrt sich oder der Konsolentimer beginnt.
2. Laufend. Die Sitzung ist aktiv. Die Zeit läuft und die Abrechnung summiert sich.
3. Pause. Der Kassierer hält die Sitzung vorübergehend an. Die Abrechnung stoppt. Der Client zeigt einen pausierten Zustand an.
4. Fortsetzen. Der Kassierer setzt eine pausierte Sitzung fort. Die Abrechnung wird mit einem neuen Preissegment fortgesetzt.
5. Zeit hinzufügen. Der Kassierer fügt einer aktiven Sitzung Minuten hinzu (oder entfernt sie).
6. Stopp. Die Sitzung endet. Das System berechnet die endgültigen Kosten und fordert zur Zahlung auf.

Starten einer Sitzung

Um eine neue Sitzung auf einem Client-PC zu starten:

1. Wählen Sie den Client aus. Klicken Sie im Admin-Panel auf einen PC im Leerlaufzustand (cyan), um die Aktionsschaltflächen anzuzeigen.
2. Wählen Sie den Abrechnungstyp. Wählen Sie entweder Postpaid (Zahlung am Ende) oder Prepaid (Vorauszahlung).
3. Weisen Sie ein Mitglied zu (optional). Wenn der Kunde ein registriertes Mitglied ist, suchen Sie nach seinem Konto über das Autocomplete-Suchfeld für Mitglieder. Die Zuordnung eines Mitglieds ermöglicht Wallet-Zahlungen und verfolgt die Sitzung in seiner Historie.
4. Dauer oder Betrag festlegen (nur Prepaid). Geben Sie für Prepaid-Sitzungen entweder die Anzahl der Minuten ein, die der Kunde kauft, oder den Geldbetrag, den er zahlt. Das System berechnet die entsprechende Zeit basierend auf dem aktuellen Preisslot.
5. Zahlungsmethode auswählen. Wählen Sie die Zahlungsmethode (Bar, Kreditkarte oder eine von Ihnen konfigurierte benutzerdefinierte Methode).
6. Bestätigen. Überprüfen Sie die Details und bestätigen Sie. Der Client-PC entsperrt sich sofort und der Sitzungstimer beginnt.

Für Konsolensitzungen ist der Prozess ähnlich, wird jedoch von der Konsolenseite aus gestartet.

Postpaid-Sitzungen

Bei einer Postpaid-Sitzung nutzt der Kunde zuerst den PC und zahlt, wenn er fertig ist. Dies ist der häufigste Abrechnungsmodus in Internetcafés, Cybercafés und Gaming Centers.

So funktioniert es:

• Die Sitzung beginnt ohne Vorauszahlung.
• Der Timer läuft und die Kosten summieren sich in Echtzeit basierend auf dem aktiven Preisslot.
• Wenn die Sitzung gestoppt wird, präsentiert das System die endgültig berechneten Kosten.
• Der Kassierer kassiert die Zahlung und bestätigt die Transaktion.

Postpaid-Sitzungen haben keine Zeitbegrenzung. Sie laufen, bis der Kassierer sie stoppt oder der Kunde um Beendigung bittet.

Prepaid-Sitzungen

Bei einer Prepaid-Sitzung zahlt der Kunde im Voraus für eine bestimmte Zeit. Die Sitzung endet automatisch, wenn die gekaufte Zeit abläuft.

Es gibt zwei Prepaid-Preismodi, die unter Einstellungen > Preise konfiguriert werden:

Fixierung beim Kauf

Die Kosten werden zum Zeitpunkt des Sitzungsbeginns eingefroren. Der zu diesem Zeitpunkt aktive Preisslot und Multiplikator werden für die gesamte Sitzungsdauer verwendet, unabhängig von Änderungen im Zeitplan, die während der Sitzung auftreten.

Beispiel: Ein Kunde kauft 60 Minuten um 10:00 Uhr während eines Standardtarifs. Selbst wenn der Preisplan um 11:00 Uhr auf einen Halbpreisslot wechselt, wird die verbleibende Zeit des Kunden nicht beeinflusst. Er erhält genau das, wofür er zum ursprünglichen Tarif bezahlt hat.

Live-Zeitplan

Die Kosten passen sich in Echtzeit an, während die Sitzung durch verschiedene Preisslots läuft. Wenn die Sitzung des Kunden einen Slotwechsel umfasst, wird die verbleibende Zeit basierend auf dem neuen Preis neu berechnet.

Beispiel: Ein Kunde kauft 60 Minuten um 10:00 Uhr während eines Standardtarifs. Um 11:00 Uhr wechselt der Zeitplan zu einem Halbpreisslot. Da jede Minute jetzt halb so viel kostet, verlängert sich die verbleibende Zeit des Kunden effektiv. Er könnte am Ende mehr Gesamtminuten haben als ursprünglich gekauft.

Pausieren einer Sitzung

Das Pausieren hält die Abrechnung vorübergehend an, ohne die Sitzung zu beenden. Dies ist nützlich, wenn ein Kunde kurz weg muss.

Um eine Sitzung zu pausieren:

1. Wählen Sie den aktiven PC im Admin-Panel aus und klicken Sie auf die Pause-Schaltfläche auf der Karte.

Was passiert, wenn eine Sitzung pausiert wird:

• Die Abrechnung stoppt sofort. Während der Pause fallen keine Kosten an.
• Das aktuelle Preissegment wird mit einer "Pause"-Grenze geschlossen.
• Der Client-PC zeigt einen pausierten Zustand mit einem orangefarbenen Statusindikator an.
• Der Sitzungstimer friert ein.

Pausierte Sitzungen bleiben unbegrenzt pausiert, bis ein Kassierer sie fortsetzt oder stoppt.

Fortsetzen einer Sitzung

Das Fortsetzen setzt eine pausierte Sitzung dort fort, wo sie aufgehört hat.

Um eine Sitzung fortzusetzen:

1. Wählen Sie den pausierten PC im Admin-Panel aus und klicken Sie auf die Fortsetzen-Schaltfläche auf der Karte.

Was passiert, wenn eine Sitzung fortgesetzt wird:

• Ein neues Preissegment beginnt zur aktuellen Zeit mit dem aktiven Preisslot.
• Die Abrechnung wird fortgesetzt.
• Der Client-PC kehrt in den aktiven (grünen) Zustand zurück.

Beachten Sie, dass der Preisslot zum Zeitpunkt des Fortsetzens von dem Slot abweichen kann, als die Sitzung pausiert wurde. Das neue Segment verwendet den aktuell aktiven Tarif im Preisplan.

Zeit hinzufügen

Sie können jederzeit Minuten zu einer aktiven Sitzung hinzufügen oder entfernen.

Um Zeit hinzuzufügen:

1. Wählen Sie den aktiven PC im Admin-Panel aus und klicken Sie auf die Zeit hinzufügen-Schaltfläche auf der Karte.
2. Geben Sie die Anzahl der hinzuzufügenden Minuten ein. Verwenden Sie einen positiven Wert, um die Sitzung zu verlängern, oder einen negativen Wert, um sie zu verkürzen.
3. Bestätigen.

Was passiert, wenn Zeit hinzugefügt wird:

• Ein Transaktionsdatensatz wird in der Sitzungshistorie erstellt.
• Bei Prepaid-Sitzungen wird die Endzeit um die angegebene Anzahl von Minuten vor- oder zurückgestellt.
• Bei Postpaid-Sitzungen wird das Ereignis "Zeit hinzufügen" aufgezeichnet, aber keine feste Endzeit festgelegt.

Beenden einer Sitzung

Das Beenden einer Sitzung stoppt alle Abrechnungen, sperrt den Client-PC und löst den Zahlungsvorgang aus.

Um eine Sitzung zu beenden:

1. Wählen Sie den aktiven oder pausierten PC im Admin-Panel aus und klicken Sie auf die Stopp-Schaltfläche auf der Karte.
2. Der Zahlungsdialog erscheint und zeigt eine Zusammenfassung der Sitzung.

Zahlungsdialog

Der Zahlungsdialog zeigt folgende Informationen an:

Kassierer-Override: Der Kassierer kann den berechneten Betrag manuell anpassen. Zum Beispiel könnte ein Kassierer aus Kulanz abrunden oder einen manuellen Rabatt gewähren. Der ursprünglich berechnete Betrag wird immer in den Aufzeichnungen für Prüfzwecke beibehalten.

4. Wählen Sie eine Zahlungsmethode und bestätigen Sie. Die Sitzung wird aufgezeichnet, der Client-PC gesperrt und die Transaktion gespeichert.

Abrechnungsprozess

Wenn eine Sitzung beendet wird, durchläuft die Abrechnungs-Engine diese Schritte:

1. Schließen Sie das letzte offene Preissegment.
2. Summieren Sie alle geschlossenen Segmentbeträge.
3. Wenden Sie Rundungsregeln an (wird immer auf den konfigurierten Rundungsschritt aufgerundet).
4. Wenden Sie die Mindeststartgebühr an (der Gesamtbetrag ist nie geringer als die Startgebühr).
5. Berechnen Sie die Zahlungsmethodenprovision (BPS-basiert) und die Festgebühr.
6. Präsentieren Sie die endgültigen Beträge im Zahlungsdialog.

Für eine detaillierte Erklärung, wie Preissegmente und Abrechnungsberechnungen funktionieren, siehe Sitzungspreise.

Mitgliedersitzungen

Wenn einem Mitglied eine Sitzung zugewiesen wird, stehen zusätzliche Abrechnungsoptionen zur Verfügung:

• Wallet-Zahlung. Die Sitzungskosten können vom Wallet-Guthaben des Mitglieds abgezogen werden.
• Zeitpaketabzug. Wenn das Mitglied ein Zeitpaket gekauft hat, werden Minuten von seinem Paketguthaben abgezogen, anstatt einen Geldbetrag zu berechnen.
• Mitgliederrabatt. Wenn das Mitglied einen konfigurierten Rabatt hat (in Basispunkten), wird dieser auf die Sitzungskosten angewendet.
• Sitzungshistorie. Die Sitzung wird mit dem Konto des Mitglieds verknüpft und erscheint in seiner Sitzungshistorie.

Mitglieder können auch ihre eigenen Sitzungen vom Leerlaufbildschirm des Clients aus starten, indem sie sich mit ihrem Benutzernamen und Passwort anmelden oder über OAuth (falls konfiguriert).

Sitzungsstatuswerte

Jeder Client-PC zeigt einen farbcodierten Statusindikator an:

Diese Statusfarben erscheinen auf den Client-Karten im Admin-Panel, sodass der Zustand jedes PCs auf einen Blick erkennbar ist.

Sitzungs-Preissegmente

Jede Sitzung wird in ein oder mehrere Preissegmente unterteilt. Ein neues Segment wird erstellt, wann immer ein abrechnungsrelevantes Ereignis eintritt:

• Sitzungsstart
• Pause
• Fortsetzen
• Preisslotwechsel (wenn die Uhr in einen anderen Zeitslot im Zeitplan wechselt)
• Basispreisänderung (wenn der Admin den Stundensatz während der Sitzung ändert)
• Trennen oder Wiederverbinden

Jedes Segment zeichnet den Preisslot, den Multiplikator, den Basispreis, die Startzeit, die Endzeit und den berechneten Betrag auf. Die Sitzungssumme ist die Summe aller Segmente, unterliegt jedoch Rundungs- und Mindestgebührenregeln.

Für vollständige Details zur Berechnung der Segmente siehe Sitzungspreise.

Mindestgebühr und Startgebühr

Selbst sehr kurze Sitzungen werden mindestens mit dem Betrag der Startgebühr berechnet. Dies wird unter Einstellungen > Preise konfiguriert und stellt sicher, dass jede Sitzung ein Mindestmaß an Einnahmen generiert, unabhängig davon, wie kurz die Nutzung war.

Beispiel: Wenn Ihre Startgebühr auf 1,00 € festgelegt ist und ein Kunde einen PC nur 30 Sekunden lang nutzt, beträgt der berechnete Betrag 1,00 €, nicht den Bruchteil eines Cents, den 30 Sekunden zum Stundensatz kosten würden.

Nächste Schritte

• Sitzungspreise: Vertiefung in die Preis-Engine, Segmente und Abrechnungsberechnungen
• Admin-Panel: Überwachen und Steuern von Client-PCs
• Mitglieder: Verwalten von Mitgliederkonten und Wallets
• Kassenbericht: Überprüfen von Sitzungseinnahmen und Schichtzusammenfassungen