Gestione Membri

I membri sono clienti registrati nel tuo internet café o gaming center. Un profilo membro conserva l'identità del cliente, le informazioni di contatto, le credenziali di accesso e le preferenze di fatturazione. I membri possono accedere dai PC client, accumulare saldi portafoglio, acquistare pacchetti tempo, guadagnare punti fedeltà e ricevere sconti basati sul livello per sessioni e ordini.

Campi del Profilo Membro

Ogni record membro contiene le seguenti informazioni:

• Nome utente: Un identificativo univoco, senza distinzione maiuscole/minuscole, che il membro usa per accedere ai PC client. Una volta creato, il nome utente non può essere duplicato nel sistema.
• Nome visualizzato: Il nome mostrato nel Pannello Admin, negli elenchi sessioni e nel saluto lato client. Questo è un campo obbligatorio.
• Password: I membri possono impostare una password per l'accesso autonomo ai PC client. La password è conservata come hash e può essere lasciata vuota inizialmente (il membro la imposta al primo accesso).
• Email: Indirizzo email opzionale. La visibilità è controllata dal permesso DISPLAY_EMAIL.
• Cellulare: Numero di telefono opzionale. La visibilità è controllata dal permesso DISPLAY_GSM.
• Avatar: Un URL dell'immagine profilo visualizzato sulla schermata di blocco del client e negli elenchi membri.
• Genere: Predefinito "sconosciuto". Può essere impostato su maschile, femminile o altro per il filtraggio demografico.
• Note: Un campo di testo libero per uso interno. Visibile solo al personale, non al membro.

Stati del Membro

Ogni membro ha due flag di stato indipendenti:

Attivo / Inattivo

L'interruttore attivo/inattivo controlla se il membro appare nei risultati di ricerca standard e può interagire con il sistema. Disattivare un membro è un'eliminazione logica. Il profilo e tutti i dati associati (crediti portafoglio, crediti tempo, storico sessioni) vengono conservati ma il membro viene nascosto dalle operazioni quotidiane.

Permesso di Accesso

Il flag can_login controlla se il membro è autorizzato ad accedere dai PC client. Un membro può essere attivo (visibile nel sistema) ma avere l'accesso disabilitato, utile per membri con debiti in sospeso o violazioni delle politiche.

Assegnazione Livello

Ogni membro può essere assegnato a un livello fedeltà. Il livello determina:

• Sconto in BPS: Uno sconto in punti base applicato alle tariffe sessione. Ad esempio, un livello con discount_bps = 500 offre al membro uno sconto del 5% sulla tariffa oraria.
• Etichetta ruolo: Un'etichetta descrittiva (come Silver, Gold, VIP) mostrata nella scheda profilo del membro e nei pannelli sessione.

L'assegnazione del livello può essere manuale o automatica basata sul sistema di punti fedeltà. Consulta la pagina Livelli Fedeltà per i dettagli su come i livelli vengono configurati e come i membri progrediscono.

Tempo Residuo e Ambito dei Dispositivi

Il tempo residuo di un membro non è un unico numero. Il tempo è conservato in lotti. Ogni lotto è utilizzabile solo su PC, solo su console oppure su entrambi. I gruppi non si sovrappongono. Il saldo totale è la loro semplice somma.

Quello che un membro può davvero spendere dipende da dove è seduto:

Il pannello di abbonamento mostra il saldo totale e, separatamente, quanta parte è utilizzabile su PC e su console. Mentre il membro è seduto, mostra anche quanto è utilizzabile in quella postazione, calcolato con il gruppo tariffario e l'ambito del dispositivo su cui si trova. Il distintivo scompare quando il membro lascia la postazione.

Ecco perché un membro può avere 480 minuti in totale mentre sulla macchina davanti a lui sono disponibili solo pochi minuti. Un pacchetto valido solo per console non vale nulla su un PC.

Se una sessione viene aperta su un dispositivo che nessun tempo del membro copre, il pannello mostra Tempo del membro non utilizzabile su questo dispositivo.

Tempo in scadenza

Il pannello indica la prossima scadenza come gruppo anziché come singolo lotto. Tutti i lotti che scadono nello stesso momento vengono sommati e suddivisi per ambito. L'avviso riflette quindi l'intero importo che sta per essere perso.

Tessere dei Membri

A un membro può essere assegnata una tessera NFC o RFID che apre una sessione con un tocco anziché con nome utente e password. Le tessere vengono assegnate, restituite e annullate dal pannello del membro. Vedi Tessere dei membri.

Limite Connessioni Simultanee

Il campo max_connection imposta il numero massimo di sessioni attive simultanee che un membro può avere su tutti i PC client. Il valore predefinito è 1, il che significa che il membro può essere connesso solo a un PC alla volta. Se un membro tenta di accedere a un secondo PC mentre ha già una sessione attiva, il sistema rifiuterà l'accesso.

Aumentare questo valore è utile per i membri che gestiscono più macchine (come account del personale) o per livelli di abbonamento speciali che consentono l'utilizzo multi-dispositivo.

Ricerca e Filtraggio Membri

La pagina Membri fornisce un elenco con scorrimento virtuale che gestisce efficientemente grandi database di membri. Puoi:

• Cercare: Digita nella barra di ricerca per filtrare per nome utente, nome visualizzato, email o numero di cellulare. La ricerca è senza distinzione maiuscole/minuscole e aggiorna i risultati in tempo reale.
• Filtrare per stato: Alterna tra mostrare tutti i membri, solo i membri attivi o solo i membri inattivi.
• Ordinare: Clicca sulle intestazioni delle colonne per ordinare per nome, data dell'ultimo accesso o data di creazione.

L'implementazione dello scorrimento virtuale carica in memoria solo la porzione visibile dell'elenco membri così le prestazioni restano fluide anche con decine di migliaia di membri registrati.

Indicatore di Stato Online

Quando un membro è attualmente connesso a un PC client o ha una sessione console attiva, il suo profilo mostra un indicatore verde online nell'elenco membri. L'indicatore mostra anche quale specifico client o console il membro sta attualmente utilizzando così il personale può localizzare rapidamente un cliente.

Creare un Nuovo Membro

Per creare un nuovo membro:

1. Vai alla pagina Membri dalla barra laterale.
2. Clicca il pulsante Aggiungi Membro nella barra degli strumenti.
3. Compila almeno il nome visualizzato (obbligatorio) e opzionalmente un nome utente per l'accesso.
4. Imposta un livello se applicabile oppure lascia quello predefinito.
5. Regola il valore connessioni massime se quello predefinito di 1 non è appropriato.
6. Clicca Salva per creare il membro.

Il sistema genera automaticamente un ID univoco per il membro e registra l'identità del cassiere che lo ha creato.

Modificare un Membro

Seleziona un membro dall'elenco per aprire la vista dettagli del profilo. Da qui puoi:

• Aggiornare qualsiasi campo del profilo (nome visualizzato, email, cellulare, genere, note).
• Cambiare l'assegnazione del livello del membro.
• Attivare/disattivare i flag active e can_login.
• Reimpostare o cambiare la password del membro.
• Regolare il limite di connessioni simultanee.

Tutte le modifiche vengono salvate immediatamente e viene creata una voce nel log di controllo.

Eliminare un Membro

Eliminare un membro rimuove il suo profilo dal sistema attivo. Questa azione richiede il permesso MEMBER_DELETE. Un membro può essere eliminato anche se ha sessioni passate o uno storico di accessi. Lo storico di sessioni e transazioni viene conservato per scopi di reportistica ma non è più collegato a un profilo membro. I saldi del portafoglio e dei crediti tempo vengono rimossi insieme al profilo. Per mantenere intatto il record completo di un membro, disattivalo anziché eliminarlo.

Requisiti di Permesso

L'accesso alle funzionalità di gestione membri è controllato dai seguenti permessi sul ruolo cassiere:

Se il ruolo di un cassiere non include DISPLAY_EMAIL o DISPLAY_GSM, quei campi vengono nascosti nel pannello dettagli membro anche se i dati esistono nel database.