Portafoglio Membro

Il portafoglio membro e un sistema di saldo monetario che permette ai membri di prepagare per i servizi del locale. Anziche pagare in contanti per ogni singola sessione, un membro puo caricare fondi nel portafoglio e il sistema detrae automaticamente da quel saldo man mano che utilizza PC, console o ordina prodotti.

Architettura Basata su Crediti

Il portafoglio utilizza un sistema a crediti anziche un singolo saldo corrente. Ogni volta che vengono aggiunti fondi al portafoglio di un membro, il sistema crea un nuovo credito portafoglio. Ogni voce di credito e un record individuale con il proprio saldo, origine, scadenza e restrizione per dispositivo. Questo design fornisce:

Completa tracciabilita della provenienza di ogni unita di saldo.
Date di scadenza indipendenti per ogni voce di credito.
Restrizioni specifiche per dispositivo (alcuni crediti possono essere utilizzabili solo su PC, altri solo su console).
Chiara separazione tra fondi pagati e bonus promozionali.

Il saldo totale del portafoglio del membro e la somma di tutti i valori residui nelle sue voci di credito attive.

Tipi di Credito

Ogni credito portafoglio ha un tipo di credito che identifica come i fondi sono entrati nel sistema:

Tipo di Credito	Descrizione
Pagato	Il membro ha pagato per questi fondi (contanti, carta o altro metodo di pagamento). Creato all'acquisto di un pacchetto campagna monetario.
Bonus	Fondi promozionali concessi come parte dell'acquisto di un pacchetto. Ad esempio "paga per 100 minuti, ottieni 20 minuti bonus di credito".
Manuale	Caricato manualmente da un cassiere o admin. Utilizzato per crediti di cortesia o accordi speciali.
Correzione	Una rettifica amministrativa per correggere un errore nel saldo del membro.
Migrazione	Fondi importati da un sistema precedente durante la migrazione dei dati.
Rimborso Annullato	Fondi ripristinati quando un rimborso precedentemente emesso viene annullato.

Il tipo di credito viene impostato alla creazione del credito e non puo essere modificato successivamente. Serve come traccia di controllo permanente.

Stato del Credito

Ogni credito portafoglio attraversa un ciclo di vita tracciato dal suo stato:

Attivo: Il credito ha fondi rimanenti e non e scaduto. I fondi possono essere consumati da questo credito.
Scaduto: La data di scadenza del credito e passata. I fondi rimanenti non sono piu utilizzabili.
Consumato: Il saldo rimanente del credito ha raggiunto lo zero tramite consumo normale.
Annullato: Il credito e stato cancellato manualmente da un amministratore, annullando il saldo rimanente.

Consumo del Portafoglio

Quando il portafoglio di un membro viene addebitato (per tempo di sessione, un ordine o un altro evento fatturabile), il sistema crea un record di consumo portafoglio che si collega a una specifica voce di credito e registra esattamente quanto e stato detratto.

Ogni record di consumo include un contesto che identifica cosa ha attivato la detrazione:

Contesto	Descrizione
Utilizzo sessione	Fondi consumati per pagare il tempo di utilizzo della sessione. Il sistema detrae dal portafoglio man mano che la sessione procede.
Pagamento portafoglio	Un pagamento diretto dal portafoglio (ad esempio quando il membro paga un ordine prodotti usando il saldo portafoglio).
Ordine	Fondi consumati per pagare un ordine prodotti al bancone o consegnato al PC del membro.
Rimborso	Una rettifica negativa creata quando viene elaborato un rimborso, riducendo il consumo per restituire fondi alla voce di credito.

Ogni record di consumo si ricollega alla sessione, ordine o transazione specifica che l'ha causato, permettendo la completa traccia di controllo.

Log del Saldo

Oltre ai record di consumo a livello di credito, il sistema mantiene un log del saldo membro che registra ogni evento che modifica il saldo complessivo del portafoglio:

Tipo di Evento	Descrizione
`load`	Fondi aggiunti al portafoglio (nuova voce di credito creata o esistente ricaricata).
`spend`	Fondi consumati dal portafoglio (pagamento sessione, pagamento ordine).
`refund`	Fondi restituiti al portafoglio (rimborso ordine, rimborso sessione).
`adjustment`	Una modifica amministrativa al saldo (correzione, annullamento).

Ogni voce del log del saldo registra l'importo della variazione e il saldo risultante, cosi puoi ricostruire il saldo del membro in qualsiasi momento leggendo il log cronologicamente.

Restrizione per Dispositivo

Ogni credito portafoglio ha una restrizione per dispositivo che controlla quali tipi di dispositivi possono consumare 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. Non consumabile da sessioni console.
Solo Console	Utilizzabile esclusivamente su console da gioco. Non consumabile da sessioni PC.
Entrambi	Utilizzabile su qualsiasi tipo di dispositivo senza restrizioni. Questa e l'impostazione predefinita.

Quando il sistema deve detrarre dal portafoglio di un membro, filtra i crediti disponibili per restrizione dispositivo per garantire che vengano addebitati solo i crediti idonei.

Categoria Portafoglio e Spesa Cross-Categoria

I crediti portafoglio possono essere etichettati con una categoria portafoglio (ad esempio "gaming" o "generale"). Questo permette al locale di creare pool di saldo isolati utilizzabili solo in determinati contesti.

L'opzione di spesa cross-categoria su ogni credito controlla se i suoi fondi possono essere utilizzati al di fuori della categoria designata:

Quando disabilitata (predefinita), il credito puo essere consumato solo nella propria categoria.
Quando abilitata, il credito puo essere consumato anche da transazioni in altre categorie.

Se un credito non ha una categoria portafoglio assegnata, viene trattato come credito generico e puo essere consumato da qualsiasi transazione indipendentemente dalla categoria.

Come Funzionano le Ricariche

I fondi del portafoglio possono essere aggiunti tramite diversi metodi:

Acquisto pacchetto campagna: Quando un membro acquista un pacchetto monetario da una campagna, il sistema crea automaticamente crediti portafoglio in base alla definizione del pacchetto. Un singolo acquisto di pacchetto puo creare piu crediti (uno per la porzione pagata, uno per la porzione bonus).
Caricamento manuale: Un cassiere puo aggiungere manualmente fondi al portafoglio di un membro dal pannello dettagli membro. Questo crea una voce di credito con il tipo "Manuale".
Migrazione: Durante la configurazione del sistema, i saldi esistenti da un sistema precedente possono essere importati come voci di credito con il tipo "Migrazione".

Come il Portafoglio Viene Consumato Durante le Sessioni

Quando un membro con saldo portafoglio avvia una sessione, il sistema puo pagare automaticamente la sessione dal portafoglio:

Il motore di tariffazione calcola il costo al minuto in base alla fascia tariffaria attiva e agli sconti di livello applicabili.
Man mano che la sessione procede, il sistema detrae periodicamente il costo accumulato dai crediti portafoglio idonei del membro.
I crediti vengono consumati in ordine di data di scadenza (scadenza piu vicina per prima) per minimizzare lo spreco da scadenza.
Se il saldo portafoglio si esaurisce prima del termine della sessione, il costo rimanente viene addebitato come pagamento in contanti alla chiusura della sessione.
Ogni detrazione crea un record di consumo collegato alla sessione come voce "Utilizzo sessione".