Domande Frequenti

Configurazione e Installazione

Quali tipi di attivita supporta HandyCafe?

HandyCafe e progettato per internet cafe, gaming center, arene esports, cybercafe e PC bang. Qualsiasi attivita che fornisce accesso a tempo a PC o console da gioco puo utilizzare HandyCafe per gestire sessioni, fatturazione e abbonamenti.

Quali sono i requisiti di sistema per HandyCafe Server?

Il server richiede Windows 10 o successivo (64-bit), almeno 4 GB di RAM, 500 MB di spazio su disco e una connessione di rete locale. I PC client necessitano di Windows 10 o successivo con 2 GB di RAM. Tutti i PC devono essere sulla stessa LAN. Consulta Requisiti di Sistema per tutti i dettagli.

Come installo HandyCafe Server?

Scarica il programma di installazione dal sito ufficiale, eseguilo e segui le istruzioni. Al primo avvio, la Configurazione Guidata Iniziale crea il tuo account admin. Consulta Installazione Server per le istruzioni passo a passo.

Come collego un PC client al server?

Installa HandyCafe Client sul PC. Utilizza mDNS per scoprire automaticamente il server sulla rete locale. Se la scoperta automatica fallisce, inserisci manualmente l'indirizzo IP del server nelle impostazioni del client. Consulta Installazione Client.

Perche il mio client non si connette al server?

Cause comuni: il server non e in esecuzione, i PC sono su sottoreti diverse, il firewall blocca le porte (TCP 5001, 5002, 5003 e UDP 5004), oppure la chiave di connessione non corrisponde. Consulta Risoluzione Problemi per soluzioni dettagliate.

Quali porte utilizza HandyCafe?

TCP 5001 (comandi), TCP 5002 (trasferimento file), TCP 5003 (gestione remota), UDP 5004 (streaming schermo). Sono configurabili nelle Impostazioni di Rete.

Come attivo la mia licenza?

Inserisci la chiave di licenza nel pannello licenze. Il server la valida con il server di licenze. Una connessione internet attiva e necessaria per l'attivazione iniziale. Consulta Licenze.

Cosa succede quando il server resta offline per piu di 72 ore?

HandyCafe ha un periodo di grazia offline di 72 ore. Durante questo periodo tutte le funzionalita operano normalmente. Dopo 72 ore senza connettivita al server di licenze, il server entra in stato bloccato fino al ripristino dell'accesso internet.

Sessioni e Tariffe

Come avvio una sessione su un PC?

Nel Pannello Admin, seleziona un PC inattivo (ciano) e clicca Avvia sulla scheda. Scegli la modalita postpagata o prepagata, assegna opzionalmente un membro, imposta durata/importo se prepagata, seleziona un metodo di pagamento e conferma. Consulta Sessioni.

Qual e la differenza tra sessioni prepagate e postpagate?

Nella modalita postpagata, il cliente paga alla fine in base al tempo effettivo di utilizzo. Nella modalita prepagata, il cliente paga in anticipo per una durata o importo fisso. La modalita prepagata supporta due sotto-modalita: Blocco all'Acquisto (costo congelato all'avvio) e Programmazione in Tempo Reale (il costo si adatta ai cambi di fascia oraria). Consulta Sessioni.

Come funziona la programmazione tariffe?

La programmazione tariffe e una griglia 7 giorni per 24 ore dove ogni blocco temporale e assegnato a una fascia tariffaria con codice colore. Ogni fascia ha un moltiplicatore (ad esempio 1,0x standard, 1,5x punta, 0,5x fuori punta). Il costo della sessione viene calcolato come: tariffa oraria base moltiplicata per il moltiplicatore della fascia moltiplicato per la durata. Consulta Tariffe Sessioni.

Come imposto prezzi diversi per weekend e giorni feriali?

In Impostazioni > Programmazione Tariffe, crea fasce tariffarie con moltiplicatori diversi (ad esempio "Feriale" a 1,0x, "Weekend" a 1,3x). Colora le colonne del weekend con il colore della fascia Weekend e le colonne feriali con il colore della fascia Feriale. Consulta Impostazioni Programmazione Tariffe.

Come metto in pausa e riprendo una sessione?

Clicca Pausa sulla scheda del PC online. La fatturazione si ferma durante la pausa. Per riprendere, clicca Riprendi sulla scheda del PC in pausa. Un nuovo segmento tariffario inizia alla ripresa. Consulta Sessioni.

Come aggiungo tempo extra a una sessione attiva?

Clicca Aggiungi Tempo sulla scheda del PC online. Inserisci il numero di minuti da aggiungere (positivo per estendere, negativo per ridurre). Viene creato un record di transazione per la rettifica.

Cosa succede quando una sessione attraversa piu fasce tariffarie?

La sessione viene automaticamente divisa in segmenti ai confini delle fasce. Ogni segmento utilizza il moltiplicatore attivo durante quel periodo. Il costo totale e la somma dei costi di tutti i segmenti. Consulta Tariffe Sessioni.

Cos'e la tariffa di avvio?

La tariffa di avvio e un addebito minimo applicato a ogni sessione. Anche se una sessione e molto breve, il cliente viene addebitato almeno di questo importo. Configurala nelle Impostazioni Tariffe.

Membri e Fedelta

Come creo un nuovo membro?

Vai alla pagina Membri e clicca Aggiungi Membro. Inserisci il nome utente, il nome visualizzato, email opzionale, telefono e altri dettagli. Assegna un livello se applicabile. Consulta Membri.

Come funziona il sistema portafoglio?

Ogni membro ha un saldo portafoglio. Quando ricarichi il portafoglio, viene creato un credito portafoglio con un importo specifico e un tipo di credito (pagato, bonus, manuale, ecc.). Durante le sessioni, il portafoglio viene consumato automaticamente. I crediti possono avere date di scadenza e restrizioni per dispositivo. Consulta Portafoglio Membro.

Cos'e un credito portafoglio?

Un credito portafoglio e una voce discreta di saldo portafoglio creata da una singola ricarica. Ogni credito traccia il proprio importo, tipo di credito (pagato, bonus, manuale), stato (attivo, scaduto, consumato) e restrizione dispositivo idoneo. I crediti vengono consumati in ordine (piu vecchio per primo). Consulta Portafoglio Membro.

Come funzionano i livelli fedelta e i punti?

I membri guadagnano punti tramite attivita (spesa, visite, ricariche, ordini). Ogni livello ha una soglia di punti. Quando un membro accumula abbastanza punti, avanza al livello successivo. I livelli superiori possono avere tassi di sconto migliori. Consulta Livelli Fedelta.

Come ricarico il portafoglio di un membro?

Seleziona il membro nella pagina Membri, clicca l'opzione di pagamento/ricarica, inserisci l'importo, seleziona il tipo di credito e il metodo di pagamento e conferma. Viene creato un nuovo credito portafoglio. Consulta Portafoglio Membro.

Un membro puo usare il saldo portafoglio sia per PC che per console?

Dipende dalla restrizione dispositivo del credito. I crediti possono essere limitati a "solo PC", "solo console" o "entrambi". Quando si acquista un pacchetto, la restrizione dispositivo e definita dalla configurazione del pacchetto. Consulta Pacchetti.

Cosa succede quando un credito portafoglio scade?

Quando un credito raggiunge la data di scadenza, il suo stato cambia in "scaduto" e il saldo rimanente non e piu disponibile per l'uso. L'importo scaduto viene registrato nello storico transazioni del membro.

Come visualizzo lo storico transazioni di un membro?

Seleziona il membro nella pagina Membri. Il pannello dettagli membro mostra il registro transazioni con tutte le ricariche, spese, rimborsi e rettifiche con date e importi.

Prodotti, Ordini e Inventario

Come aggiungo un prodotto al catalogo?

Vai su Prodotti e clicca Aggiungi Prodotto. Inserisci il nome, la categoria, l'unita, il codice a barre, il prezzo di vendita, il prezzo di costo e l'aliquota IVA. Attiva/disattiva lo stato attivo/inattivo. Consulta Prodotti.

Come creo un ordine per un cliente?

Vai su Ordini, clicca Nuovo Ordine, assegna opzionalmente a un PC o aggiungi una nota, aggiungi articoli dal catalogo prodotti con le quantita, poi chiudi l'ordine con un metodo di pagamento. Consulta Ordini.

Come annullo o rimborso un ordine?

Apri l'ordine dalla pagina Ordini e clicca Annulla. L'ordine viene annullato e nessun pagamento viene registrato. Per i rimborsi sugli ordini chiusi, utilizza il flusso di rimborso appropriato.

Come funziona il tracciamento delle scorte?

Ogni prodotto ha un livello di scorta. Il registro delle scorte traccia le variazioni con motivazioni: vendita (decrementato automaticamente alla chiusura dell'ordine), acquisto (dalle voci di inventario), rettifica, scarto e reso. Consulta Prodotti e Inventario.

Campagne e Pacchetti

Come creo una campagna?

Vai su Campagne e clicca Aggiungi Campagna. Inserisci il nome, la descrizione, impostala come attiva e configura una data di scadenza se applicabile. Poi aggiungi i pacchetti alla campagna. Consulta Campagne.

Qual e la differenza tra pacchetti a minuti e pacchetti monetari?

I pacchetti a minuti danno al membro tempo (minuti) utilizzabile per le sessioni. I pacchetti monetari aggiungono fondi al portafoglio del membro. Entrambi possono includere importi bonus. Consulta Pacchetti.

Come funziona il sistema bonus nei pacchetti?

Un pacchetto puo includere un bonus oltre al diritto base. Ad esempio, un pacchetto potrebbe offrire "60 minuti + 15 minuti bonus" o "10 euro + 2 euro bonus". Il bonus crea una voce di credito separata contrassegnata con il tipo di credito "Bonus".

Come funzionano le restrizioni per dispositivo nei pacchetti?

Ogni pacchetto definisce una restrizione per dispositivo: client (PC), console (console), entrambi, solo PC o solo console. Quando il pacchetto viene acquistato, i crediti portafoglio/tempo creati ereditano questa restrizione e possono essere utilizzati solo su tipi di dispositivo corrispondenti.

Gestione Cassieri

Come creo un account cassiere?

Vai su Gestione > Cassieri. Clicca Aggiungi Cassiere, inserisci nome utente e password e assegna un ruolo. Il cassiere puo poi accedere con queste credenziali. Consulta Ruoli Cassiere.

Come imposto i permessi per un ruolo cassiere?

Vai su Gestione > Ruoli Cassiere. Crea un nuovo ruolo o modificane uno esistente. Seleziona o deseleziona i singoli flag di permesso in ognuna delle 6 categorie (Autenticazione, Membri, Console, Log, Report, Metodi di Pagamento). Consulta Ruoli Cassiere.

Quali sono le 6 categorie di permessi?

Autenticazione (1 flag), Membri (6 flag: visualizza, aggiungi, elimina, modifica, mostra email, mostra telefono), Console (4 flag: visualizza, aggiungi, elimina, modifica), Log (4 flag: visualizza, storico completo, solo oggi, elimina), Report (3 flag: visualizza, storico completo, solo oggi), Metodi di Pagamento (4 flag: gestisci, aggiungi, elimina, modifica). Totale: 22 flag di permesso individuali.

Come funziona la protezione anti brute-force sull'accesso cassiere?

Dopo 5 tentativi di accesso falliti entro 10 minuti, l'account viene bloccato per 15 minuti. Tutti i tentativi falliti vengono registrati nella traccia di controllo con un avviso di sicurezza.

Come visualizzo i report dei turni cassiere?

Apri la pagina Report di Cassa. Filtra per nome cassiere per vedere le transazioni elaborate da un cassiere specifico durante il turno. Il riepilogo del turno mostra i totali e il dettaglio per metodo di pagamento.

Impostazioni e Configurazione

Come cambio la lingua?

Vai su Impostazioni > Generali e seleziona la tua lingua dal menu a tendina. HandyCafe supporta 24 lingue. L'interfaccia si aggiorna immediatamente. Consulta Impostazioni Generali.

Come configuro l'accesso Google OAuth?

Vai su Impostazioni > OAuth. Abilita OAuth globalmente, poi abilita Google. Inserisci il tuo Google Client ID e Client Secret (dalla Google Cloud Console). Opzionalmente importa il file delle credenziali JSON. Testa avviando un accesso OAuth da un PC client. Consulta Impostazioni OAuth.

Come configuro la griglia della programmazione tariffe?

Vai su Impostazioni > Programmazione Tariffe. Abilita la programmazione, crea fasce con codice colore e moltiplicatori, poi clicca/trascina sulla griglia 7x24 ore per colorare i blocchi temporali con la fascia desiderata. Consulta Impostazioni Programmazione Tariffe.

Come personalizzo la schermata di inattivita del client?

Vai su Impostazioni > Client > Scheda Schermata di Inattivita. Abilita lo slideshow, aggiungi immagini o video, imposta durate e transizioni. Opzionalmente abilita le sovrapposizioni orologio e nome locale. Consulta Schermata di Inattivita Client.

Come cambio il tema dell'aspetto del client?

Vai su Impostazioni > Client > Scheda Aspetto. Seleziona un tema (Neon Arena, Crimson Pulse, Emerald Depth), scegli un layout preimpostato e configura sfondo, densita schede ed effetti. Consulta Aspetto Client.

Come configuro le notifiche sonore?

Vai su Impostazioni > Suoni. Abilita l'interruttore principale dei suoni, poi seleziona un suono per ogni evento (Chiama Cassiere, Nuovo Ordine, Fine Sessione, Richiesta di Accesso) tra le 15 opzioni integrate. Consulta Impostazioni Suoni.

Cos'e la chiave di connessione e perche e importante?

La chiave di connessione e un segreto condiviso utilizzato per l'autenticazione crittografica tra server e client. Impedisce a dispositivi non autorizzati di connettersi al tuo server. Tutti i client devono utilizzare la stessa chiave del server. Configurala nelle Impostazioni di Rete.

Gestione Remota

Come cattura uno screenshot remoto di un PC client?

Seleziona il client nel Pannello Admin e clicca Screenshot sulla scheda. Il visualizzatore screenshot mostra l'immagine catturata. Puoi aggiornare per una nuova cattura o scaricare l'immagine. Consulta Screenshot.

Come uso il desktop remoto per controllare un PC client?

Seleziona la scheda client e clicca Desktop Remoto. Si apre una finestra con streaming video H.264 in tempo reale. Puoi controllare mouse e tastiera da remoto e la sincronizzazione degli appunti funziona tra server e client. Consulta Desktop Remoto.

Come funziona il sistema di sincronizzazione file?

Configura le directory da sincronizzare in Impostazioni > Sincronizzazione File. Quando attivata, il server crea un manifesto dei file. I client confrontano il manifesto con i file locali e scaricano solo i file modificati o nuovi utilizzando il trasferimento basato su blocchi. Consulta Sincronizzazione File.

Come vedo quali app sono in esecuzione su un PC client?

Seleziona il client nel Pannello Admin e clicca App in Esecuzione sulla scheda. Un pannello mostra tutti i processi attualmente in esecuzione con nomi e dettagli. Puoi anche visualizzare App all'Avvio, App Installate e App con Finestra dagli stessi pulsanti azione.

Come invio un messaggio a un PC client?

Seleziona la scheda client e clicca Invia Messaggio. Digita il messaggio e conferma. Il messaggio appare sullo schermo del cliente.

Come spengo o riavvio un PC client da remoto?

Seleziona la scheda client e clicca Spegni o Riavvia. Puoi anche selezionare piu client per operazioni massive. Wake on LAN e disponibile per accendere i PC offline che lo supportano.

Report e Analisi

Come visualizzo il report di cassa?

Vai su Report di Cassa dalla barra laterale. Il report mostra schede riepilogative, storico transazioni, guadagni per dispositivo e grafici. Usa i filtri data per restringere l'intervallo temporale. Consulta Report di Cassa.

Come esporto i dati dei report?

Nel Report di Cassa, usa la funzione esporta/copia per copiare i dati delle transazioni negli appunti in formato CSV. Puoi poi incollarli in Excel o qualsiasi applicazione di foglio di calcolo.

Quali analisi sono disponibili nella pagina Statistiche?

Nove schede analitiche: Andamento ricavi, Analisi vendite, Tracciamento spese, Statistiche sessioni, Utilizzo console, Utilizzo applicazioni, Tassi di utilizzo computer, Attivita membri e Prestazioni cassieri. Consulta Statistiche.

Come verifico i tassi di utilizzo dei computer?

Vai su Statistiche > Scheda Utilizzo Computer. Mostra le percentuali di utilizzo per PC, il tempo di attivita e i ricavi per macchina. Identifica anche i PC piu utilizzati. Consulta Statistiche Sessioni e Computer.

Risoluzione Problemi

Il client mostra "offline" ma il PC e acceso. Cosa faccio?

Verifica che: 1) HandyCafe Client sia in esecuzione sul PC, 2) Entrambi i PC siano sulla stessa rete/sottorete, 3) Il firewall consenta le porte TCP 5001-5003, 4) La chiave di connessione corrisponda tra server e client. Consulta Risoluzione Problemi.

Le tariffe della sessione sembrano errate. Come verifico?

Controlla le impostazioni tariffe (Impostazioni > Tariffe) per la tariffa oraria base e l'IVA. Controlla la programmazione tariffe (Impostazioni > Programmazione Tariffe) per i moltiplicatori attivi al momento della sessione. Esamina i segmenti tariffari della sessione nei dettagli della transazione per vedere come e stato calcolato ogni segmento.

L'accesso OAuth e bloccato su "in attesa". Come risolvo?

Assicurati che l'admin abbia approvato la richiesta nella pagina Richieste. Se la richiesta e bloccata, verifica: 1) Le credenziali del provider OAuth siano corrette in Impostazioni > OAuth, 2) Il server abbia accesso internet per raggiungere l'API del provider, 3) Il codice dispositivo non sia scaduto (scadono tipicamente in 15-30 minuti).

Il desktop remoto e lento. Come migliorare le prestazioni?

Abbassa il bitrate nelle impostazioni dello streaming (prova 1000-2000 kbps per LAN). Controlla la larghezza di banda di rete tra server e client. Assicurati che la porta UDP 5004 non sia bloccata. Usa Ethernet cablato anziche Wi-Fi per i migliori risultati.

La mia licenza mostra "over_limit". Cosa significa?

Piu PC client sono connessi di quanti la tua licenza consenta. Disconnetti i client inutilizzati o aggiorna la licenza. Il server non avviera nuove sessioni fino a quando il numero di client connessi non sara uguale o inferiore al limite.

Un cassiere e bloccato dopo troppi tentativi di accesso falliti. Come sblocco?

Attendi 15 minuti per la scadenza del blocco automatico. Se urgente, un admin puo gestire l'account cassiere tramite l'interfaccia di gestione.