Domande Frequenti

Configurazione e Installazione

Quali tipi di attività supporta HandyCafe?

HandyCafe è progettato per internet cafe, centri gaming, arene esports, cybercafe e PC bang. Qualsiasi attività che fornisce accesso a tempo a PC o console di gioco può utilizzare HandyCafe per gestire sessioni, fatturazione e iscrizioni.

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. Vedi Requisiti di Sistema per i dettagli completi.

Come installo HandyCafe Server?

Scarica l'installer dal sito ufficiale, eseguilo e segui le istruzioni. Al primo avvio, la procedura guidata di configurazione iniziale crea il tuo account admin. Vedi Installazione Server per istruzioni dettagliate.

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. Vedi Installazione Client.

Perché il mio client non si connette al server?

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

Quali porte utilizza HandyCafe?

TCP 5001 (comandi), TCP 5002 (trasferimenti file), TCP 5003 (gestione remota), UDP 5004 (streaming schermo). Queste sono configurabili in Impostazioni di Rete.

Come attivo la mia licenza?

Inserisci la tua chiave di licenza nel pannello licenze. Il server la valida con il server di licenze. È necessaria una connessione internet attiva per l'attivazione iniziale. Vedi Licenze.

Cosa succede se il mio server rimane offline per più di 72 ore?

HandyCafe ha un periodo di grazia offline di 72 ore. Durante questo tempo, tutte le funzionalità funzionano normalmente. Dopo 72 ore senza connettività al server di licenze, il server entra in uno stato bloccato fino al ripristino dell'accesso a internet.

Sessioni e Prezzi

Come avvio una sessione su un PC?

Nel Pannello Admin, seleziona un PC inattivo (ciano) e clicca su Avvia sulla scheda. Scegli modalità postpagata o prepagata, assegna eventualmente un membro, imposta durata/importo se prepagata, seleziona un metodo di pagamento e conferma. Vedi Sessioni.

Qual è la differenza tra sessioni prepagate e postpagate?

In modalità postpagata, il cliente paga alla fine in base al tempo di utilizzo effettivo. In modalità prepagata, il cliente paga in anticipo per una durata o un importo fisso. La modalità prepagata supporta due sotto-modalità: Blocco all'Acquisto (costo congelato all'inizio) e Programma Live (costo che si adatta ai cambiamenti di fascia oraria). Vedi Sessioni.

Come funziona il programma di prezzi?

Il programma di prezzi è una griglia di 7 giorni per 24 ore in cui ogni blocco di tempo è assegnato a una fascia di prezzo codificata a colori. Ogni fascia ha un moltiplicatore (es. 1.0x standard, 1.5x picco, 0.5x fuori picco). Il costo della sessione è calcolato come: tariffa oraria base moltiplicata per il moltiplicatore della fascia moltiplicata per la durata. Vedi Prezzi Sessioni.

Come imposto prezzi diversi per i weekend rispetto ai giorni feriali?

In Impostazioni > Programma Prezzi, crea fasce di prezzo con moltiplicatori diversi (es. "Giorni Feriali" a 1.0x, "Weekend" a 1.3x). Colora le colonne del weekend con il colore della fascia Weekend e le colonne dei giorni feriali con il colore della fascia Giorni Feriali. Vedi Impostazioni Programma Prezzi.

Come metto in pausa e riprendo una sessione?

Clicca su Pausa sulla scheda del PC online. La fatturazione si ferma mentre è in pausa. Per riprendere, clicca su Riprendi sulla scheda del PC in pausa. Un nuovo segmento di prezzo inizia quando si riprende. Vedi Sessioni.

Come aggiungo tempo extra a una sessione attiva?

Clicca su 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 l'aggiustamento.

Cosa succede quando una sessione attraversa più fasce di prezzo?

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

Cos'è la tariffa di avvio?

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

Membri e Fedeltà

Come creo un nuovo membro?

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

Come funziona il sistema di 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 sui dispositivi. Vedi Portafoglio Membro.

Cos'è un credito portafoglio?

Un credito portafoglio è una voce discreta del 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 sui dispositivi idonei. I crediti vengono consumati in ordine (dal più vecchio al più recente). Vedi Portafoglio Membro.

Come funzionano i livelli di fedeltà e i punti?

I membri guadagnano punti attraverso attività (spese, visite, ricariche, ordini). Ogni livello ha una soglia di punti. Quando un membro accumula abbastanza punti, avanza al livello successivo. I livelli più alti possono avere tassi di sconto migliori. Vedi Livelli di Fedeltà.

Come ricarico il portafoglio di un membro?

Seleziona il membro nella pagina Membri, clicca sull'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. Vedi Portafoglio Membro.

Un membro può utilizzare il saldo del portafoglio sia per PC che per console?

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

Cosa succede quando un credito portafoglio scade?

Quando un credito raggiunge la sua data di scadenza, il suo stato cambia in "scaduto" e il saldo rimanente non è più disponibile per l'uso. L'importo scaduto viene registrato nella cronologia delle transazioni del membro.

Come visualizzo la cronologia delle transazioni di un membro?

Seleziona il membro nella pagina Membri. Il pannello dettagli del membro mostra il registro delle transazioni con tutti i caricamenti, spese, rimborsi e aggiustamenti del portafoglio con timestamp e importi.

Prodotti, Ordini e Inventario

Come aggiungo un prodotto al catalogo?

Vai su Prodotti e clicca su Aggiungi Prodotto. Inserisci il nome, categoria, unità, codice a barre, prezzo di vendita, prezzo di costo e aliquota IVA. Attiva/disattiva attivo/inattivo. Vedi Prodotti.

Come creo un ordine per un cliente?

Vai su Ordini, clicca su Nuovo Ordine, assegna eventualmente a un PC o aggiungi una nota, aggiungi articoli dal catalogo prodotti con quantità, quindi chiudi l'ordine con un metodo di pagamento. Vedi Ordini.

Come annullo o rimborsa un ordine?

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

Come funziona il tracciamento delle scorte?

Ogni prodotto ha un livello di scorte. Il registro delle scorte traccia i cambiamenti con motivi: vendita (decremento automatico alla chiusura dell'ordine), acquisto (da voci di inventario), aggiustamento, spreco e reso. Vedi Prodotti e Inventario.

Campagne e Pacchetti

Come creo una campagna?

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

Qual è la differenza tra pacchetti basati su minuti e su denaro?

I pacchetti basati su minuti danno al membro tempo (minuti) che può essere utilizzato per le sessioni. I pacchetti basati su denaro aggiungono fondi al portafoglio del membro. Entrambi possono includere importi bonus. Vedi Pacchetti.

Come funziona il sistema bonus nei pacchetti?

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

Come funzionano le restrizioni sui dispositivi nei pacchetti?

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

Gestione dei Cassieri

Come creo un account cassiere?

Vai su Gestione > Cassieri. Clicca su Aggiungi Cassiere, inserisci un nome utente e una password, e assegna un ruolo. Il cassiere può quindi accedere con queste credenziali. Vedi Ruoli Cassiere.

Come imposto i permessi per un ruolo cassiere?

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

Quali sono le 6 categorie di permessi?

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

Come funziona la protezione brute-force sul login del cassiere?

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

Come visualizzo i report dei turni del cassiere?

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

Impostazioni e Configurazione

Come cambio la lingua?

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

Come configuro il login OAuth di Google?

Vai su Impostazioni > OAuth. Abilita OAuth globalmente, quindi abilita Google. Inserisci il tuo Google Client ID e Client Secret (dal Google Cloud Console). Importa eventualmente il file di credenziali JSON. Testa avviando un login OAuth da un PC client. Vedi Impostazioni OAuth.

Come configuro la griglia del programma di prezzi?

Vai su Impostazioni > Programma Prezzi. Abilita il programma, crea fasce codificate a colori con moltiplicatori, quindi clicca/trascina sulla griglia di 7x24 ore per dipingere blocchi di tempo con la fascia desiderata. Vedi Impostazioni Programma Prezzi.

Come personalizzo lo schermo inattivo del client?

Vai su Impostazioni > Client > Scheda Schermo Inattivo. Abilita la presentazione, aggiungi immagini o video, imposta durate e transizioni. Abilita eventualmente sovrapposizioni di orologio e nome del cafe. Vedi Schermo Inattivo Client.

Come cambio il tema di aspetto del client?

Vai su Impostazioni > Client > Scheda Aspetto. Seleziona un tema (Neon Arena, Crimson Pulse, Emerald Depth), scegli un preset di layout e configura sfondo, densità delle schede ed effetti. Vedi Aspetto Client.

Come configuro le notifiche sonore?

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

Cos'è la chiave di connessione e perché è importante?

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

Gestione Remota

Come faccio uno screenshot remoto di un PC client?

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

Come uso il desktop remoto per controllare un PC client?

Seleziona la scheda del client e clicca su Desktop Remoto. Si apre una finestra con streaming video live H.264. Puoi controllare mouse e tastiera a distanza e la sincronizzazione degli appunti funziona tra server e client. Vedi Desktop Remoto.

Come funziona il sistema di sincronizzazione file?

Configura le directory da sincronizzare in Impostazioni > Esplora Sincronizzazione. Quando attivato, 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 chunk. Vedi Sincronizzazione File.

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

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

Come invio un messaggio a un PC client?

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

Come spengo o riavvio un PC client a distanza?

Seleziona la scheda del client e clicca su Spegni o Riavvia. Puoi anche selezionare più client per operazioni in blocco. Wake on LAN è disponibile per accendere PC offline che lo supportano.

Report e Analisi

Come visualizzo il report cassa?

Vai su Report Cassa dalla barra laterale. Il report mostra schede di riepilogo, cronologia delle transazioni, guadagni per dispositivo e grafici. Usa i filtri di data per restringere l'intervallo di tempo. Vedi Report Cassa.

Come esporto i dati del report?

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

Quali analisi sono disponibili nella pagina Statistiche?

Nove schede di analisi: Tendenze di Ricavo, Analisi delle Vendite, Tracciamento delle Spese, Statistiche delle Sessioni, Utilizzo delle Console, Utilizzo delle Applicazioni, Tassi di Utilizzo dei Computer, Attività dei Membri e Prestazioni dei Cassieri. Vedi Statistiche.

Come controllo i tassi di utilizzo dei computer?

Vai su Statistiche > Scheda Utilizzo Computer. Questo mostra le percentuali di utilizzo per PC, uptime e ricavi per macchina. Identifica anche i tuoi PC più occupati. Vedi Statistiche Sessioni & Computer.

Risoluzione dei Problemi

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

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

Il prezzo della sessione sembra errato. Come verifico?

Controlla le impostazioni dei prezzi (Impostazioni > Prezzi) per la tariffa oraria base e l'IVA. Controlla il programma di prezzi (Impostazioni > Programma Prezzi) per i moltiplicatori attivi al momento della sessione. Rivedi i segmenti di prezzo della sessione nei dettagli della transazione per vedere come è stato calcolato ogni segmento.

Il login OAuth è bloccato su "in attesa". Come risolvo?

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

Il desktop remoto è lento. Come miglioro le prestazioni?

Abbassa il bitrate nelle impostazioni dello stream (prova 1000-2000 kbps per LAN). Controlla la larghezza di banda della rete tra server e client. Assicurati che la porta UDP 5004 non sia bloccata. Usa Ethernet cablata invece del WiFi per i migliori risultati.

La mia licenza mostra "over_limit". Cosa significa?

Sono connessi più PC client di quanti la tua licenza permetta. Disconnetti i client non utilizzati o aggiorna la tua licenza. Il server non avvierà nuove sessioni finché il numero di client connessi non sarà al di sotto del limite.

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

Aspetta 15 minuti per la scadenza automatica del blocco. Se urgente, un admin può gestire l'account del cassiere tramite l'interfaccia di gestione.

Caffetteria

Come fanno i clienti a ordinare dal loro tavolo?

Scansionano il codice QR sul tavolo con il loro telefono, inseriscono il codice di sicurezza a 6 cifre fornito dal personale, sfogliano il menu nella loro lingua, aggiungono articoli al carrello e inviano con pagamento in contanti o online (Stripe). Gli ordini appaiono sulla tua dashboard Ordini Caffetteria entro 3 secondi. Vedi Menu Cliente.

Come abilito il modulo Caffetteria?

Apri Impostazioni > Caffetteria e attiva Abilita Caffetteria. Il server utilizza automaticamente la tua licenza HandyCafe come autorizzazione. Una procedura guidata di provisioning richiede il tuo slug, nome visualizzato, paese, valuta e fuso orario. Vedi Panoramica Caffetteria e Come Configurare la Caffetteria.

Quali lingue supporta il menu cliente?

Il menu cliente su handy.cafe/{slug} supporta 24 lingue. Alla prima visita, sceglie la migliore corrispondenza dall'intestazione Accept-Language del browser. I clienti possono cambiare lingua in qualsiasi momento con il selettore in alto.

La Caffetteria funziona senza internet?

No. La Caffetteria è cloud-first. Il provisioning, la sincronizzazione del menu e il polling degli ordini richiedono tutti l'accesso a internet in uscita. Le pagine rivolte ai clienti sono servite dal cloud e non dipendono dal fatto che il tuo server locale sia raggiungibile da internet.

Client Legacy

HandyCafe supporta i miei vecchi client V3 o V4?

Sì. Abilita il supporto runtime in Impostazioni > Client Legacy e il server avvia i listener sulle porte legacy originali (UDP 710/711, TCP 712, trasferimento file 717). I tuoi client esistenti si connettono senza alcuna modifica da parte loro. Appaiono nel Pannello Admin con un set di azioni ridotto (Login, Logout, Aggiungi Tempo, Screenshot, Disconnetti, Riavvia, Spegni). Vedi Client Legacy.

I client legacy e moderni possono funzionare sullo stesso server contemporaneamente?

Sì. I due stack di protocollo utilizzano porte diverse e non si sovrappongono. Puoi mescolare client vecchi e nuovi sulla stessa LAN e gestirli dallo stesso Pannello Admin.

Posso portare i miei dati da un'installazione HandyCafe più vecchia?

Sì, su Windows. Apri Impostazioni > Client Legacy, scorri fino a Migrazione Database e clicca su Avvia Migrazione. Membri, prezzi, prodotti, ordini, transazioni e log vengono importati. I file originali non vengono modificati o eliminati. Se il risultato non è quello che ti aspettavi, clicca su Annulla Migrazione per ripristinare. Vedi Come Migrare da un'Installazione Legacy.

Qual è la differenza tra le varianti di protocollo STE e Standard?

I frame STE (Smart/Turbo Edition) includono un prefisso di informazioni sulla licenza di 70 byte; la dimensione del frame è di 1337 byte. I frame Standard omettono il prefisso; la dimensione del frame è di 1267 byte. Scegli la variante che corrisponde a come è stato costruito il tuo server legacy. Scegliere la variante sbagliata causa frame persi o letti male.