HandyCafe Docs
owner

Come Configurare il Tuo Locale da Zero

Questa guida ti accompagna in ogni passaggio di una nuova installazione di HandyCafe per il tuo internet cafe, gaming center o arena esports. Al termine avrai un server funzionante, almeno un PC client connesso, le tariffe configurate e una sessione di test completata con il pagamento registrato nel report di cassa.

Cosa Ti Servira

  • Un PC Windows da usare come HandyCafe Server (Windows 10 o successivo, minimo 4 GB di RAM).
  • Almeno un altro PC Windows da usare come postazione client.
  • Una rete locale che connette tutti i PC (si consiglia Ethernet cablato per affidabilita).
  • Una chiave di licenza beta HandyCafe valida. La inserirai durante la prima configurazione.
  • La tariffa oraria e la valuta desiderate gia decise in anticipo.

Fase 1: Installare e Configurare il Server

  1. Scarica l'ultimo programma di installazione di HandyCafe Server dalla tua dashboard HandyCafe.
  2. Esegui il programma di installazione sul PC designato come server. Segui le istruzioni sullo schermo e accetta la directory di installazione predefinita.
  3. Avvia HandyCafe Server. La procedura guidata di Prima Configurazione apparira automaticamente al primo avvio.
  4. Inserisci la tua chiave di licenza beta quando richiesto. Il server validera la chiave online e mostrera il nome del tuo locale e il limite di PC.
  5. Crea il tuo account amministratore. Inserisci un nome utente e una password robusta. Questo account ha accesso illimitato a tutte le funzionalita.
  6. Imposta il nome del tuo locale. Questo nome apparira sulle schermate di inattivita dei client e nei report.
  7. Clicca Fine per completare la procedura guidata.

Risultato atteso: La finestra principale del server si apre mostrando il Pannello Admin con zero client connessi. Il nome del tuo locale appare nella barra del titolo.

Fase 2: Configurare le Tariffe

  1. Apri la pagina Impostazioni cliccando l'icona ingranaggio nella barra laterale sinistra.
  2. Vai alla scheda Tariffe.
  3. Imposta la tua valuta base. Seleziona dal menu a tendina delle valute. Tutti i prezzi, le transazioni e i report useranno questa valuta.
  4. Inserisci la tua tariffa oraria. Questo e il prezzo base per ora per le sessioni postpagate. Ad esempio, inserisci 10,00 per dieci unita della tua valuta all'ora.
  5. Imposta l'aliquota IVA. Inserisci la percentuale (da 0 a 100) che si applica agli addebiti di sessione. Inserisci 0 se l'IVA non si applica.
  6. Imposta la tariffa di avvio. Questo e l'addebito minimo per sessione indipendentemente dalla durata. Inserisci 0 se non vuoi un addebito minimo.
  7. Crea preimpostazioni tariffarie per le durate comuni. Scorri verso il basso fino alla sezione Preimpostazioni. Clicca Aggiungi Preimpostazione. Crea preimpostazioni come:
    • "30 Minuti" con durata di 30 minuti.
    • "1 Ora" con durata di 60 minuti.
    • "2 Ore" con durata di 120 minuti.
  8. Clicca Salva per applicare la configurazione delle tariffe.

Risultato atteso: La scheda Tariffe mostra la tua tariffa oraria, l'aliquota IVA, la tariffa di avvio e tutte le preimpostazioni elencate in basso. Queste preimpostazioni appariranno come pulsanti a selezione rapida quando si avviano le sessioni prepagate.

Fase 3: Verificare le Impostazioni di Rete

  1. Sempre nelle Impostazioni, vai alla scheda Rete.
  2. Verifica la porta di ascolto. Il valore predefinito e 7842. Cambialo solo se un altro servizio sulla tua rete usa quella porta.
  3. Imposta o annota la chiave di connessione. Questa chiave autentica le connessioni dei client. Tutti i PC client devono usare la stessa chiave per connettersi.
  4. Assicurati che il firewall del PC server consenta le connessioni TCP in entrata sulla porta configurata. Su Windows, HandyCafe di solito aggiunge questa regola durante l'installazione. Se hai cambiato la porta, aggiungi manualmente una nuova regola del firewall.
  5. Annota l'indirizzo IP del PC server visualizzato nella scheda Rete. Ti servira se i client non riescono a trovare il server tramite il rilevamento automatico.

Risultato atteso: La scheda Rete mostra la porta di ascolto e la chiave di connessione. L'indicatore di stato del server mostra "In Ascolto" in verde.

Fase 4: Distribuire il Primo Client

  1. Scarica il programma di installazione di HandyCafe Client dalla tua dashboard.
  2. Installalo sul tuo primo PC client. Esegui il programma di installazione e segui le istruzioni.
  3. Avvia HandyCafe Client. Il client tentera di individuare il server automaticamente tramite mDNS sulla rete locale.
  4. Se il rilevamento automatico fallisce, inserisci l'indirizzo IP del server e la porta manualmente nel dialogo di connessione del client.
  5. Inserisci la chiave di connessione annotata nella Fase 3.
  6. Attendi che la connessione si stabilisca. La schermata del client passa alla pagina Inattivo mostrando una schermata di blocco con un orologio.

Risultato atteso: Sul server, il Pannello Admin ora mostra un client connesso. La tessera del client mostra il nome host e uno stato blu "Inattivo". Il PC client mostra la schermata di blocco.

  1. Il server assegnera automaticamente un nome visualizzato al client in base al suo nome host. Per rinominarlo, seleziona la tessera del client sul server e clicca Rinomina.

Fase 5: Eseguire la Prima Sessione di Test

  1. Nel Pannello Admin del server, clicca Avvia sulla tessera del client inattivo.
  2. Nel dialogo di sessione, seleziona Postpagata. Lascia il campo membro vuoto per una sessione ospite.
  3. Clicca Conferma per avviare la sessione.

Risultato atteso: La tessera del client diventa verde e mostra un timer in esecuzione che conta in avanti. Sul PC client, la schermata di blocco scompare e appare il desktop della Pagina Online.

  1. Lascia la sessione in esecuzione per almeno 5 minuti per poter verificare i calcoli delle tariffe.
  2. Clicca Termina sulla tessera del client verde sul server.
  3. Esamina il dialogo di riepilogo costi. Mostrera:
    • Durata (ad es. 5 minuti).
    • Tariffa oraria applicata.
    • Importo IVA.
    • Addebito totale.
  4. Seleziona un metodo di pagamento (i Contanti sono il predefinito).
  5. Clicca Conferma per chiudere la sessione e registrare il pagamento.

Risultato atteso: La tessera del client torna allo stato blu "Inattivo". Il PC client mostra di nuovo la schermata di blocco. Una transazione viene registrata nel sistema.

Fase 6: Verificare nel Report di Cassa

  1. Vai alla pagina Report di Cassa tramite la barra laterale sinistra.
  2. Conferma che il report di oggi mostri una transazione di sessione.
  3. Verifica che l'importo della transazione corrisponda al riepilogo dei costi che hai visto quando hai terminato la sessione.
  4. Controlla che la colonna del metodo di pagamento mostri "Contanti" (o qualsiasi metodo selezionato).

Risultato atteso: Il report di cassa elenca una sessione completata con l'importo corretto, la durata e il metodo di pagamento. Il tuo locale e ora operativo.

Fase 7: Passi Successivi Opzionali

Una volta che la configurazione di base funziona, considera la configurazione di queste funzionalita:

  1. Aggiungi membri. Vai alla pagina Membri. Clicca Aggiungi per creare account membro con nomi utente e saldi portafoglio opzionali. I membri possono accedere dai PC client.
  2. Configura i prodotti. Vai alla pagina Prodotti. Aggiungi articoli di cibo e bevande con prezzi in modo che i cassieri possano creare ordini.
  3. Configura il menu client. Vai su Impostazioni > Menu Client. Aggiungi categorie di applicazioni e app in modo che i clienti vedano una griglia di avvio nella Pagina Online.
  4. Distribuisci altri client. Installa HandyCafe Client su ogni PC postazione nel tuo locale. Ognuno apparira automaticamente sul server.
  5. Crea account cassiere. Vai alla pagina Gestione. Aggiungi account cassiere con ruoli appropriati in modo che il personale possa accedere e gestire le sessioni.
  6. Configura tariffe di punta/fuori punta. Vai su Impostazioni > Programmazione Tariffe. Crea moltiplicatori basati sul tempo per addebitare di piu durante le ore di punta.
  7. Abilita l'accesso OAuth. Vai su Impostazioni > OAuth. Configura Google o altri provider in modo che i clienti possano accedere con i loro account social.

Errori Comuni da Evitare

  • Saltare la regola del firewall. Se i client non riescono a connettersi, la causa piu comune e una regola di Windows Firewall che blocca la porta di ascolto. Verifica che la regola esista prima di risolvere altri problemi.
  • Chiavi di connessione non corrispondenti. La chiave su ogni client deve corrispondere esattamente alla chiave sul server. Copia e incolla per evitare errori di battitura.
  • Impostare la tariffa oraria a 0. Se lasci la tariffa oraria a zero, tutte le sessioni postpagate saranno gratuite. Verifica sempre le tariffe prima di andare in produzione.
  • Dimenticare di salvare le impostazioni. Le modifiche nella pagina Impostazioni non si applicano finche non clicchi Salva. Se le impostazioni sembrano invariate dopo un riavvio, probabilmente hai dimenticato di salvare.
  • Eseguire server e client sullo stesso PC. Sebbene tecnicamente possibile per i test, non e consigliato per la produzione. Il PC server dovrebbe essere una postazione dedicata.