HandyCafe Docs
owner cashier

Gestione Sessioni

Le sessioni sono l'unita di fatturazione fondamentale in HandyCafe. Ogni volta che un cliente nel tuo internet cafe o gaming center utilizza un PC o una console da gioco, una sessione traccia il tempo di utilizzo e calcola il costo. Questa pagina spiega il ciclo di vita completo delle sessioni, dall'avvio alla riscossione del pagamento.

Tipi di Sessione

HandyCafe supporta due tipi di sessioni:

  • Sessioni PC. Sessioni su PC client gestite tramite il Pannello Admin. Il software client blocca il PC quando inattivo e lo sblocca all'avvio di una sessione.
  • Sessioni console. Sessioni su console da gioco (PlayStation, Xbox, ecc.) gestite tramite la pagina Console. Queste vengono tracciate solo dal server; non c'e software client sulla console stessa.

Entrambi i tipi di sessione seguono lo stesso motore di tariffazione e ciclo di vita ma vengono gestiti da pagine diverse nel pannello di controllo.

Ciclo di Vita della Sessione

Ogni sessione segue un ciclo di vita definito con transizioni di stato chiare:

Avvio --> In Corso --> (Pausa <--> Ripresa) --> Aggiungi Tempo --> Termine

Gli stati nel dettaglio:

  1. Avvio. Un cassiere avvia la sessione. Il PC client si sblocca o il timer della console inizia.
  2. In Corso. La sessione e attiva. Il tempo sta scorrendo e la fatturazione si accumula.
  3. Pausa. Il cassiere sospende temporaneamente la sessione. La fatturazione si ferma. Il client mostra uno stato di pausa.
  4. Ripresa. Il cassiere continua una sessione in pausa. La fatturazione riprende da un nuovo segmento tariffario.
  5. Aggiungi Tempo. Il cassiere aggiunge (o rimuove) minuti a una sessione attiva.
  6. Termine. La sessione finisce. Il sistema calcola il costo finale e richiede il pagamento.

Avvio di una Sessione

Per avviare una nuova sessione su un PC client:

  1. Seleziona il client. Nel Pannello Admin, clicca su un PC in stato Inattivo (ciano) per rivelare i pulsanti azione.
  2. Scegli il tipo di fatturazione. Seleziona Postpagata (paga alla fine) o Prepagata (paga in anticipo).
  3. Assegna un membro (opzionale). Se il cliente e un membro registrato, cerca il suo account utilizzando il campo di ricerca autocomplete membro. L'assegnazione di un membro abilita i pagamenti tramite portafoglio e traccia la sessione nel suo storico.
  4. Imposta durata o importo (solo prepagata). Per le sessioni prepagate, inserisci il numero di minuti che il cliente sta acquistando o l'importo monetario che sta pagando. Il sistema calcola il tempo corrispondente in base alla fascia tariffaria corrente.
  5. Seleziona metodo di pagamento. Scegli il metodo di pagamento (Contanti, Carta di Credito o qualsiasi metodo personalizzato configurato).
  6. Conferma. Controlla i dettagli e conferma. Il PC client si sblocca immediatamente e il timer della sessione inizia.

Per le sessioni console, il processo e simile ma viene avviato dalla pagina Console.

Sessioni Postpagate

In una sessione postpagata, il cliente utilizza il PC prima e paga al termine. Questa e la modalita di fatturazione piu comune in internet cafe, cybercafe e gaming center.

Come funziona:

  • La sessione inizia senza pagamento anticipato.
  • Il timer scorre e il costo si accumula in tempo reale in base alla fascia tariffaria attiva.
  • Quando la sessione viene terminata, il sistema presenta il costo finale calcolato.
  • Il cassiere riscuote il pagamento e conferma la transazione.

Le sessioni postpagate non hanno limite di tempo. Proseguono fino a quando il cassiere le termina o il cliente chiede di andarsene.

Sessioni Prepagate

In una sessione prepagata, il cliente paga in anticipo per un tempo specifico. La sessione termina automaticamente alla scadenza del tempo acquistato.

Ci sono due modalita tariffarie prepagata, configurate in Impostazioni > Tariffe:

Blocco all'Acquisto

Il costo viene congelato al momento dell'avvio della sessione. La fascia tariffaria e il moltiplicatore attivi al momento dell'acquisto vengono utilizzati per l'intera durata della sessione, indipendentemente dai cambi di programmazione che si verificano durante la sessione.

Programmazione in Tempo Reale

Il costo si adatta in tempo reale man mano che la sessione attraversa diverse fasce tariffarie. Se la sessione del cliente attraversa un cambio di fascia, il tempo rimanente viene ricalcolato in base alla nuova tariffazione.

Messa in Pausa di una Sessione

La messa in pausa sospende temporaneamente la fatturazione senza terminare la sessione. E utile quando un cliente deve allontanarsi brevemente.

Per mettere in pausa una sessione:

  1. Seleziona il PC attivo nel Pannello Admin e clicca il pulsante Pausa sulla scheda.

Cosa succede quando una sessione viene messa in pausa:

  • La fatturazione si ferma immediatamente. Nessun costo matura durante la pausa.
  • Il segmento tariffario corrente viene chiuso con un confine "pausa".
  • Il PC client mostra uno stato di pausa con indicatore di stato arancione.
  • Il timer della sessione si congela.

Le sessioni in pausa restano in pausa indefinitamente fino a quando un cassiere le riprende o le termina.

Ripresa di una Sessione

La ripresa continua una sessione in pausa da dove si era interrotta.

Per riprendere una sessione:

  1. Seleziona il PC in pausa nel Pannello Admin e clicca il pulsante Riprendi sulla scheda.

Cosa succede quando una sessione viene ripresa:

  • Un nuovo segmento tariffario inizia all'ora corrente, utilizzando la fascia tariffaria attiva.
  • La fatturazione riprende.
  • Il PC client ritorna allo stato attivo (verde).

Nota che la fascia tariffaria al momento della ripresa potrebbe differire dalla fascia al momento della pausa. Il nuovo segmento utilizza qualsiasi tariffa sia attualmente attiva nella programmazione tariffe.

Aggiunta di Tempo

Puoi aggiungere o rimuovere minuti da una sessione attiva in qualsiasi momento.

Per aggiungere tempo:

  1. Seleziona il PC attivo nel Pannello Admin e clicca il pulsante Aggiungi Tempo sulla scheda.
  2. Inserisci il numero di minuti da aggiungere. Usa un valore positivo per estendere la sessione o un valore negativo per ridurla.
  3. Conferma.

Cosa succede quando viene aggiunto tempo:

  • Viene creato un record di transazione nello storico della sessione.
  • Per le sessioni prepagate, l'ora di fine viene spostata in avanti (o indietro) del numero di minuti specificato.
  • Per le sessioni postpagate, l'evento di aggiunta tempo viene registrato ma non imposta un'ora di fine fissa.

Terminazione di una Sessione

La terminazione di una sessione pone fine a tutta la fatturazione, blocca il PC client e attiva il processo di pagamento.

Per terminare una sessione:

  1. Seleziona il PC attivo o in pausa nel Pannello Admin e clicca il pulsante Termina sulla scheda.
  2. Appare la Finestra di Pagamento con un riepilogo della sessione.

Finestra di Pagamento

La finestra di pagamento mostra le seguenti informazioni:

Campo Descrizione
Durata Tempo attivo totale (esclusi i periodi di pausa)
Importo Calcolato Il costo grezzo calcolato in base ai segmenti tariffari
Importo Addebitato L'importo da addebitare al cliente (predefinito al calcolato ma sovrascrivibile)
IVA Importo dell'imposta, se configurato
Commissione Commissione del metodo di pagamento, se applicabile
Tariffa Fissa Tariffa fissa del metodo di pagamento, se applicabile
Metodo di Pagamento Menu a tendina per selezionare come il cliente sta pagando

Override del cassiere: Il cassiere puo rettificare manualmente l'importo addebitato. L'importo calcolato originale viene sempre conservato nei registri per il controllo.

  1. Seleziona un metodo di pagamento e conferma. La sessione viene registrata, il PC client si blocca e la transazione viene salvata.

Sessioni Membro

Quando un membro e assegnato a una sessione, diventano disponibili opzioni di fatturazione aggiuntive:

  • Pagamento portafoglio. Il costo della sessione puo essere detratto dal saldo portafoglio del membro.
  • Detrazione pacchetto tempo. Se il membro ha acquistato un pacchetto tempo, i minuti vengono detratti dal saldo del pacchetto anziche addebitare un importo monetario.
  • Sconto membro. Se il membro ha uno sconto configurato (in punti base), viene applicato al costo della sessione.
  • Storico sessioni. La sessione viene collegata all'account del membro e appare nel suo storico sessioni.

I membri possono anche avviare le proprie sessioni dalla schermata di inattivita del client accedendo con nome utente e password o tramite OAuth (se configurato).

Valori di Stato della Sessione

Ogni PC client mostra un indicatore di stato con codice colore:

Stato Colore Significato
Online Verde La sessione e attiva e in corso
In Pausa Arancione La sessione e in pausa; la fatturazione e sospesa
Inattivo Ciano Il client e connesso ma nessuna sessione e attiva
Offline Rosso Il client non e connesso al server
Admin Viola Il client e in modalita admin/manutenzione
Occupato Giallo Il client sta elaborando una richiesta

Questi colori di stato appaiono sulle schede client nel Pannello Admin, rendendo facile vedere lo stato di ogni PC a colpo d'occhio.

Addebito Minimo e Tariffa di Avvio

Anche le sessioni molto brevi vengono addebitate almeno per l'importo della tariffa di avvio. Questa viene configurata in Impostazioni > Tariffe e garantisce che ogni sessione generi un livello minimo di ricavi, indipendentemente dalla brevita dell'utilizzo.


Passi Successivi

  • Tariffe Sessioni: Approfondimento sul motore di tariffazione, i segmenti e la matematica del saldo
  • Pannello Admin: Monitora e controlla i PC client
  • Membri: Gestisci account membro e portafogli
  • Report di Cassa: Consulta i ricavi delle sessioni e i riepiloghi dei turni