Glossario

Un riferimento alfabetico dei termini di dominio utilizzati nella documentazione HandyCafe.

Pannello Admin Il pannello di monitoraggio principale in HandyCafe Server. Mostra tutti i client connessi, i loro stati e le sessioni attive. Fornisce anche pulsanti azione su ogni scheda client per il controllo delle sessioni e le operazioni di gestione remota.

Tasso di Commissione Una percentuale utilizzata per esprimere le commissioni di elaborazione pagamenti. Ad esempio 1% o 5%. Utilizzato nella configurazione dei metodi di pagamento per definire il costo di accettazione di un particolare metodo di pagamento.

Protocollo Binario Un formato di codifica compatto utilizzato per la comunicazione TCP tra HandyCafe Server e i client. Scelto per la sua velocita e la dimensione ridotta dei messaggi rispetto ai formati basati su testo.

Client Un PC destinato ai clienti che esegue il software HandyCafe Client. I client si connettono al server tramite la rete locale, ricevono comandi di sessione e riportano stato e dati di utilizzo. Ogni client e identificato dal suo indirizzo MAC e nome host.

Chiave di Connessione Un segreto condiviso configurato sia sul server che su ogni client durante la configurazione. Viene utilizzato per generare token di autenticazione crittografica per la comunicazione TCP, garantendo che solo dispositivi autorizzati possano scambiare comandi con il server.

Console Un dispositivo da gioco come PlayStation o Xbox gestito da HandyCafe. Le console supportano sessioni, tariffe e utilizzo da parte dei membri proprio come i PC client ma non eseguono il software HandyCafe Client. Vengono tracciate tramite indirizzo MAC.

Cybercafe / Cyber Cafe Un'attivita che fornisce accesso pubblico a computer e connettivita internet, tipicamente addebitando a ore. Indicato anche come internet cafe. HandyCafe gestisce tutti gli aspetti delle operazioni di un cybercafe incluse sessioni, fatturazione e abbonamenti.

Restrizione Dispositivo Un'impostazione che specifica a quali tipi di dispositivi si applica un credito portafoglio, credito tempo o regola tariffaria. I valori possibili sono: client (PC), console (console da gioco), solo PC, solo console o entrambi (qualsiasi dispositivo).

Arena Esports Una struttura dedicata al gaming competitivo e agli eventi esports, spesso dotata di PC ad alte prestazioni, aree per tornei e posti a sedere per gli spettatori. HandyCafe supporta le arene esports con gestione sessioni, tracciamento membri e fatturazione console.

Diritto Il valore che un membro riceve dall'acquisto di un pacchetto. Puo essere un credito tempo (minuti prepagati di utilizzo sessione), un saldo monetario del portafoglio o una combinazione di entrambi. I diritti vengono registrati come voci di credito nel portafoglio o nel saldo tempo del membro.

Tasso di Cambio Il tasso di cambio utilizzato per convertire la valuta base in una valuta di visualizzazione locale. Questo permette ai locali in regioni con valute diverse di prezzare nella valuta locale mantenendo una base contabile interna coerente.

Gaming Center Una struttura commerciale dove i clienti pagano per utilizzare PC o console da gioco, tipicamente dotata di hardware ad alte prestazioni e un ambiente di gioco sociale. HandyCafe e costruito per gestire le operazioni dei gaming center dalla fatturazione delle sessioni ai programmi di fidelizzazione.

Autenticazione Crittografica Un meccanismo di verifica dei messaggi utilizzato per garantire l'integrita e l'autenticita dei messaggi TCP tra server e client. Entrambe le parti utilizzano la Chiave di Connessione per calcolare e validare i codici di autenticazione.

Internet Cafe Un'attivita che fornisce ai clienti accesso a tempo a computer e servizi internet. Gli internet cafe sono il caso d'uso principale per HandyCafe, che gestisce sessioni, tariffe, programmi di fidelizzazione e operazioni del punto vendita.

Inattivo Lo stato del client quando il PC e connesso al server ma nessuna sessione e attiva. In stato inattivo, il client mostra la schermata di blocco (IdlePage) e attende l'avvio di una sessione, l'accesso di un membro o un'azione amministrativa.

Credito Portafoglio / Credito Tempo Una voce discreta di saldo portafoglio o minuti prepagati creata da una ricarica o acquisto di pacchetto. Ogni voce di credito registra la sua origine (ricarica contanti, diritto pacchetto, bonus campagna), il valore residuo e la restrizione dispositivo applicabile. I crediti vengono consumati in ordine durante il saldo della sessione.

Indirizzo MAC Un identificativo hardware assegnato a un'interfaccia di rete. HandyCafe utilizza gli indirizzi MAC per identificare univocamente client e console, garantendo che i dispositivi vengano riconosciuti anche se i loro indirizzi IP cambiano.

mDNS (Multicast DNS) Un protocollo per la scoperta automatica dei servizi sulle reti locali. I client HandyCafe annunciano la loro presenza tramite mDNS, permettendo al server di rilevarli senza configurazione IP manuale.

Membro Un cliente registrato con un profilo nel sistema HandyCafe. I membri hanno un portafoglio, un livello di fedelta e uno storico transazioni. Possono accedere ai PC client per sessioni personalizzate. I membri possono anche avere account collegati tramite OAuth.

Unita Minori La denominazione piu piccola di una valuta, utilizzata internamente per tutti i calcoli finanziari per evitare errori di arrotondamento in virgola mobile. Ad esempio, USD usa i centesimi (1 dollaro = 100 unita minori), mentre JPY usa gli yen direttamente (1 yen = 1 unita minore).

Moltiplicatore Un fattore applicato alla tariffa oraria base all'interno di una fascia della programmazione tariffe. Un moltiplicatore di 1,0 significa che si applica la tariffa standard. Un moltiplicatore di 1,5 significa che la tariffa e il 50% piu alta (ad esempio ore di punta), mentre 0,5 significa meta prezzo (ad esempio sconti fuori punta).

PC Bang Un internet cafe e gaming center in stile coreano dove i clienti pagano per l'accesso orario ai PC. I PC bang sono noti per l'hardware gaming di fascia alta e la cultura del gaming competitivo. HandyCafe supporta le operazioni dei PC bang con programmazioni tariffarie flessibili e gestione sessioni.

Online Lo stato del client durante una sessione attiva. Quando online, il client mostra l'interfaccia desktop (OnlinePage), permettendo al cliente di utilizzare applicazioni, navigare e interagire con il menu client.

Postpagata Una modalita di fatturazione sessione dove il cliente utilizza il PC liberamente e paga alla fine in base alla durata effettiva di utilizzo. Il costo finale viene calcolato alla chiusura della sessione utilizzando i segmenti della programmazione tariffe applicabili.

Prepagata Una modalita di fatturazione sessione dove il cliente paga in anticipo per una durata fissa. La sessione termina automaticamente alla scadenza del tempo acquistato, salvo estensioni.

Segmento Tariffario Una porzione di sessione durante la quale si applica un singolo moltiplicatore tariffario. I confini dei segmenti vengono creati da eventi come avvio sessione, pausa, ripresa o una transizione di fascia nella programmazione tariffe.

Fascia Tariffaria Una zona con codice colore nella griglia settimanale della programmazione tariffe. Ogni fascia definisce un intervallo temporale e un moltiplicatore che modifica la tariffa oraria base. Le fasce possono coprire ore specifiche in giorni specifici, permettendo tariffe diverse per periodi di punta e fuori punta.

Ruolo Un insieme denominato di permessi assegnato a un account cassiere. I ruoli definiscono quali azioni un cassiere puo eseguire (ad esempio avviare sessioni, gestire membri, visualizzare report). Piu cassieri possono condividere lo stesso ruolo e i permessi vengono applicati in tutta l'interfaccia.

Confine di Segmento Un evento che attiva la creazione di un nuovo segmento tariffario all'interno di una sessione. I confini includono: avvio sessione, termine sessione, pausa sessione, ripresa sessione e cambio di fascia tariffaria (quando l'orologio attraversa da una fascia all'altra).

Sessione Un periodo a tempo di utilizzo PC o console da parte di un cliente. Le sessioni tracciano ora di inizio, ora di fine, pause, segmenti tariffari e l'importo totale addebitato. Possono essere prepagate o postpagate.

Saldo Il calcolo eseguito al termine di una sessione per determinare il costo finale. Il saldo elabora tutti i segmenti tariffari, applica i moltiplicatori rilevanti, aggiunge tariffe di avvio e IVA, deduce eventuali sconti membro e produce l'importo totale dovuto.

Turno Il periodo di lavoro di un cassiere dall'accesso al logout. Tutte le transazioni, operazioni sulle sessioni e azioni amministrative eseguite durante un turno sono attribuite al cassiere connesso. I dati del turno sono utilizzati per la responsabilita e l'analisi delle prestazioni.

Tariffa di Avvio Un addebito minimo applicato per sessione indipendentemente dalla durata. Se il costo calcolato di una sessione (basato su tempo e tariffe) e inferiore alla tariffa di avvio, viene addebitata la tariffa di avvio. Questo garantisce un ricavo minimo per sessione.

Sincronizzazione Il processo di sincronizzazione file dal Server HandyCafe ai PC client. Utilizza un confronto basato su manifesto e un trasferimento basato su blocchi per distribuire efficientemente i file attraverso la rete.

Livello Un livello di fedelta nel sistema dei livelli membro. I livelli sono definiti da soglie di punti e forniscono tassi di sconto su sessioni e ordini. Man mano che i membri accumulano punti tramite la spesa, avanzano a livelli superiori con vantaggi migliori.

Transazione Un record finanziario di un pagamento per una sessione, ordine, ricarica portafoglio o altro evento fatturabile. Le transazioni registrano l'importo, il metodo di pagamento, il membro o cassiere associato e il timestamp.

IVA (Imposta sul Valore Aggiunto) Una percentuale di imposta applicata agli addebiti delle sessioni e agli importi degli ordini. L'aliquota IVA viene configurata nelle impostazioni tariffe e viene inclusa nel calcolo del saldo. Gli importi IVA vengono tracciati separatamente per la dichiarazione fiscale.

Portafoglio Il saldo monetario prepagato di un membro conservato nel sistema HandyCafe. Il portafoglio e composto da una o piu voci di credito e puo essere utilizzato per pagare sessioni, ordini e altri servizi. Le ricariche possono essere effettuate tramite contanti, pacchetti o campagne.