HandyCafe Docs
owner cashier

Pacchetti Tempo

I pacchetti tempo forniscono ai membri un saldo prepagato in minuti. Anziche pagare a ore alla tariffa standard, un membro puo acquistare un blocco di minuti in anticipo e utilizzarli in piu sessioni. Il sistema traccia il saldo rimanente e detrae i minuti automaticamente man mano che il membro utilizza PC o console.

Sistema dei Crediti Tempo

Analogamente al sistema portafoglio, i pacchetti tempo utilizzano un'architettura basata su crediti. Ogni aggiunta al saldo tempo crea un nuovo credito tempo. Ogni credito e un record indipendente con il proprio saldo in minuti, origine, scadenza e restrizioni per dispositivo.

Il totale dei minuti disponibili di un membro e la somma di tutti i minuti rimanenti nei suoi crediti tempo attivi.

Campi del Credito Tempo

Ogni record di credito tempo contiene:

Campo Descrizione
Minuti totali Il numero originale di minuti caricati in questo credito al momento della creazione.
Minuti rimanenti Il saldo corrente di minuti non utilizzati in questo credito. Diminuisce man mano che il membro utilizza le sessioni.
Tipo di credito Come questo credito e stato creato (vedi Tipi di Credito sotto).
Restrizione dispositivo Quali tipi di dispositivi possono consumare da questo credito (vedi Restrizione Dispositivo sotto).
Stato Lo stato corrente del ciclo di vita del credito.
Scade il Timestamp di scadenza opzionale. Dopo questa data, i minuti rimanenti non possono piu essere utilizzati.
ID Acquisto Se questo credito e stato creato dall'acquisto di un pacchetto campagna, un riferimento a quel record di acquisto.

Tipi di Credito

Ogni credito tempo traccia come e stato creato:

Tipo di Credito Descrizione
Pagato Il membro ha pagato per questi minuti, tramite un acquisto diretto o come diritto base di un pacchetto campagna.
Bonus Minuti promozionali concessi come bonus con l'acquisto di un pacchetto. Ad esempio "acquista 120 minuti, ottieni 30 minuti bonus gratis".
Manuale Minuti aggiunti manualmente da un cassiere o amministratore. Utilizzato per crediti di cortesia, compensazioni o accordi speciali.

Stato del Credito

Ogni credito tempo progredisce attraverso questi stati:

  • Attivo: Il credito ha minuti rimanenti e non e scaduto. I minuti possono essere consumati da questo credito.
  • Scaduto: La data di scadenza del credito e passata. I minuti rimanenti non sono piu utilizzabili, anche se il saldo e maggiore di zero.
  • Consumato: I minuti rimanenti del credito hanno raggiunto lo zero tramite utilizzo normale.
  • Annullato: Il credito e stato cancellato manualmente da un amministratore, annullando i minuti rimanenti.

Restrizioni per Dispositivo

Ogni credito tempo ha una restrizione per dispositivo che controlla quali tipi di dispositivi possono detrarre da esso:

Restrizione Significato
Client Utilizzabile su PC client. Utilizzabile anche su console salvo restrizioni esplicite.
Console Utilizzabile su console da gioco. Utilizzabile anche su PC salvo restrizioni esplicite.
Solo PC Utilizzabile esclusivamente su PC client. Le sessioni console non possono detrarre da questo credito.
Solo Console Utilizzabile esclusivamente su console da gioco. Le sessioni PC non possono detrarre da questo credito.
Entrambi Utilizzabile su qualsiasi tipo di dispositivo senza restrizioni. Questa e l'impostazione predefinita.

La restrizione per dispositivo viene impostata quando il credito viene creato e non puo essere modificata successivamente. La restrizione e tipicamente ereditata dalla definizione del pacchetto campagna che ha generato il credito.

Tracciamento dei Consumi

Ogni volta che vengono detratti minuti da un credito tempo, il sistema crea un record di consumo tempo:

Campo Descrizione
Minuti consumati Il numero di minuti detratti in questo evento di consumo. Sempre un intero positivo.
Consumati il Il timestamp di quando la detrazione e avvenuta.
Contesto Cosa ha attivato la detrazione (vedi sotto).
Riferimento Un riferimento alla sessione, credito o rettifica specifica che ha causato la detrazione.

Tipi di Contesto

Contesto Descrizione
Utilizzo sessione Minuti consumati per pagare una sessione attiva. Il percorso di consumo principale.
Scadenza Minuti rimossi quando un credito scade o quando i minuti rimanenti vengono rettificati a causa di un evento di scadenza.
Rimborso Minuti restituiti al credito come parte di un processo di rimborso (registrato come consumo negativo o nuova voce di credito).

Integrazione con i Pacchetti Campagna

I crediti tempo vengono creati piu comunemente tramite acquisti di pacchetti campagna:

  1. Un proprietario crea una campagna con uno o piu pacchetti di tipo "minuti".
  2. Un membro seleziona e acquista un pacchetto (dal Pannello Membro lato client o tramite un cassiere al bancone).
  3. Il sistema crea i crediti tempo appropriati:
    • Un credito pagato per i minuti del diritto base (l'importo base dal pacchetto).
    • Se il pacchetto definisce un tipo di bonus "minuti" con un importo bonus maggiore di zero, viene creato un credito bonus separato per i minuti bonus.
  4. I crediti ereditano l'impostazione di restrizione per dispositivo del pacchetto.
  5. Se il pacchetto ha un periodo di validita impostato, la data di scadenza del credito viene calcolata dalla data di acquisto piu il numero di giorni validi.

Come il Tempo Viene Detratto Durante le Sessioni

Quando un membro con minuti tempo disponibili avvia una sessione:

  1. Il sistema verifica i crediti tempo attivi corrispondenti al tipo di dispositivo della sessione.
  2. I crediti vengono consumati in ordine di data di scadenza (scadenza piu vicina per prima) per minimizzare lo spreco di crediti in procinto di scadere.
  3. Man mano che la sessione procede, i minuti vengono periodicamente detratti dai crediti idonei.
  4. Ogni detrazione crea un record di consumo come voce "Utilizzo sessione".
  5. Se tutti i crediti tempo si esauriscono prima del termine della sessione, la sessione continua e il tempo rimanente viene fatturato alla tariffa oraria standard (pagato alla chiusura della sessione).

Questo significa che il saldo tempo e il saldo portafoglio di un membro possono funzionare insieme. I crediti tempo coprono quanti minuti sono disponibili e qualsiasi eccedenza passa al saldo portafoglio o al pagamento in contanti.