Risoluzione Problemi

Questa pagina copre le soluzioni ai problemi comuni organizzati per categoria.

Problemi di Connessione

Il client non riesce a trovare il server

Sintomi: Il client mostra "Ricerca del server" o "Nessun server trovato".

Soluzioni:

1. Verifica che HandyCafe Server sia in esecuzione sul PC di gestione.
2. Conferma che entrambi i PC siano sulla stessa sottorete (ad esempio entrambi su 192.168.1.x).
3. Controlla che mDNS non sia bloccato dal tuo switch o router di rete.
4. Prova la connessione manuale: inserisci l'indirizzo IP del server direttamente nelle impostazioni del client.
5. Verifica che nessun altro software stia utilizzando la porta TCP del server (predefinita: 5001).

Il client si connette e poi si disconnette immediatamente

Sintomi: Il client mostra brevemente "Connesso" poi torna a "Ricerca".

Soluzioni:

1. Verifica che la chiave di connessione corrisponda su server e client. La chiave viene impostata in Impostazioni > Rete sul server.
2. Controlla l'instabilita della rete (perdita di pacchetti, problemi con i cavi).
3. Assicurati che il server non abbia raggiunto il limite PC della licenza.
4. Controlla i log del server per messaggi di errore di autenticazione.

Il client mostra "Offline" sul server ma il PC e acceso

Sintomi: Il PC client e acceso e l'applicazione client e in esecuzione ma il server lo mostra come offline.

Soluzioni:

1. Sul PC client, verifica che HandyCafe Client sia effettivamente in esecuzione (controlla l'area di notifica).
2. Controlla la connessione di rete sul PC client (riesce a pingare il server?).
3. Verifica le regole del firewall: le porte TCP 5001-5003 devono essere aperte su server e client.
4. Riavvia HandyCafe Client sul PC interessato.
5. Se utilizzi VLAN, assicurati che le VLAN di server e client possano comunicare.

Impossibile connettersi dopo la modifica delle impostazioni di rete

Sintomi: Dopo aver cambiato porte o chiave di connessione, i client non riescono a connettersi.

Soluzioni:

1. Assicurati che i client siano aggiornati con i nuovi numeri di porta e la nuova chiave di connessione.
2. Riavvia il Server HandyCafe dopo aver modificato le impostazioni di rete.
3. Aggiorna le regole del firewall per consentire le nuove porte.
4. Tutti i client devono essere riconfigurati con i nuovi valori.

Problemi con le Sessioni

Impossibile avviare una sessione su un client

Sintomi: Il pulsante Avvia e disabilitato o l'azione di avvio fallisce con un errore.

Soluzioni:

1. Controlla lo stato della licenza. Se in modalita sola lettura, le nuove sessioni non possono essere avviate.
2. Verifica che lo stato del client sia "Inattivo". Le sessioni possono essere avviate solo su client inattivi.
3. Controlla i permessi del cassiere. Il ruolo deve avere il permesso AUTH_CLIENT_LOGIN.
4. Assicurati che le tariffe siano configurate (Impostazioni > Tariffe deve avere una tariffa oraria valida).

Il timer della sessione mostra un tempo errato

Sintomi: Il tempo visualizzato non corrisponde al tempo effettivamente trascorso.

Soluzioni:

1. Controlla gli orologi di sistema su entrambi i PC server e client. Devono essere sincronizzati (usa NTP).
2. Se la sessione e stata messa in pausa, la durata della pausa non viene contata.
3. Per le sessioni prepagate, il timer mostra il tempo rimanente, non il tempo trascorso.

Il costo della sessione sembra errato

Sintomi: L'importo addebitato non corrisponde alle aspettative.

Soluzioni:

1. Controlla la programmazione tariffe. Se abilitata, la sessione potrebbe essere passata attraverso piu fasce tariffarie con moltiplicatori diversi.
2. Verifica le impostazioni tariffe: tariffa oraria base, IVA, tariffa di avvio, arrotondamento.
3. Controlla i segmenti tariffari della sessione nei dettagli della transazione per una suddivisione.
4. Verifica la commissione e le tariffe fisse del metodo di pagamento.
5. Per le sessioni prepagate, controlla se e attiva la modalita "Blocco all'Acquisto" o "Programmazione in Tempo Reale".

La sessione in pausa non puo essere ripresa

Sintomi: L'azione Riprendi fallisce o non e disponibile.

Soluzioni:

1. Verifica che il PC client sia ancora connesso al server.
2. Controlla che lo stato del client mostri "In Pausa" (arancione).
3. Se il client si e disconnesso durante la pausa, potrebbe dover riconnettersi prima.

Problemi di Pagamento

Il metodo di pagamento non appare nel menu a tendina

Sintomi: Il metodo di pagamento previsto non appare alla chiusura di una sessione o un ordine.

Soluzioni:

1. Verifica che il metodo di pagamento esista in Gestione > Metodi di Pagamento.
2. Controlla che il metodo di pagamento sia attivo (non eliminato o disabilitato).
3. Controlla i permessi del cassiere. PAYMENT_MANAGE deve essere concesso per vedere tutti i metodi.

Il calcolo della commissione sembra errato

Sintomi: La commissione detratta non corrisponde al tasso previsto.

Soluzioni:

1. Verifica il tasso di commissione del metodo di pagamento (come percentuale) e la tariffa fissa.
2. Formula commissione: commissione = (importo addebitato * tasso commissione / 100) + tariffa fissa.
3. Controlla se il cassiere ha applicato un override manuale all'importo addebitato.

Problemi di Visualizzazione Client

La schermata di inattivita del client e vuota

Sintomi: La schermata di inattivita non mostra nulla al posto dello slideshow configurato.

Soluzioni:

1. Verifica che la schermata di inattivita sia abilitata in Impostazioni > Client > Schermata di Inattivita.
2. Controlla che sia stato aggiunto almeno un elemento multimediale (immagine o video).
3. Verifica che i file multimediali siano validi e non corrotti.
4. Attiva una sincronizzazione per inviare le ultime impostazioni al client.

Il menu client non mostra le app

Sintomi: Il launcher di app e vuoto o mancano le categorie.

Soluzioni:

1. Verifica che app e categorie siano configurate in Impostazioni > Client > Contenuti.
2. Controlla che categorie e app abbiano la visibilita attivata.
3. Verifica che il client abbia ricevuto i dati piu recenti del menu (le modifiche vengono inviate automaticamente tramite TCP).
4. Riavvia il client se la sincronizzazione in tempo reale non si e applicata.

Il tema dell'aspetto del client non e applicato

Sintomi: Il client mostra l'aspetto predefinito anziche il tema configurato.

Soluzioni:

1. Verifica che le impostazioni del tema siano salvate in Impostazioni > Client > Aspetto.
2. Attiva un push delle impostazioni ai client.
3. Riavvia l'applicazione client.

Problemi Desktop Remoto

Il desktop remoto e lento o scattoso

Sintomi: Il feed video e ritardato, balbettante o ha un frame rate basso.

Soluzioni:

1. Abbassa il bitrate (prova 1000-2000 kbps per un uso LAN standard).
2. Riduci l'impostazione FPS.
3. Usa Ethernet cablato anziche Wi-Fi.
4. Controlla la congestione di rete o l'elevato utilizzo di banda da altre applicazioni.
5. Assicurati che la porta UDP 5004 non sia bloccata o con limitazione di banda.

Il desktop remoto mostra uno schermo nero

Sintomi: La finestra del desktop remoto si apre ma mostra solo nero.

Soluzioni:

1. Verifica che il client sia online e reattivo (prova prima a catturare uno screenshot).
2. Controlla che la porta UDP 5004 sia aperta bidirezionalmente.
3. Il driver grafico del client potrebbe necessitare di aggiornamento.
4. Prova a richiedere un aggiornamento del keyframe.

Impossibile controllare mouse o tastiera da remoto

Sintomi: Puoi vedere lo schermo remoto ma clic e pressioni di tasti non hanno effetto.

Soluzioni:

1. Verifica che la porta di gestione remota (TCP 5003) sia aperta.
2. Controlla che l'applicazione client abbia i permessi di sistema appropriati.
3. Alcuni giochi a schermo intero potrebbero bloccare l'input remoto.

Problemi di Licenza

La licenza mostra "offline_grace"

Sintomi: Lo stato della licenza mostra offline_grace con un conto alla rovescia.

Soluzioni:

1. Ripristina la connettivita internet sul PC server.
2. Controlla la risoluzione DNS. Il server deve raggiungere il server di licenze.
3. Controlla se proxy o firewall bloccano le connessioni HTTPS in uscita.
4. Hai 72 ore per ripristinare la connettivita prima che il server si blocchi.

La licenza mostra "over_limit"

Sintomi: Sono connessi piu client di quanti la licenza consenta.

Soluzioni:

1. Disconnetti i client inattivi non in uso.
2. Controlla il conteggio client corrente rispetto al limite della licenza.
3. Aggiorna la licenza per una maggiore capacita PC.
4. Nota: le console contano nel limite totale dei PC.

La licenza mostra "expired" o "revoked"

Sintomi: Il server entra in modalita limitata.

Soluzioni:

1. Controlla la data di scadenza della licenza.
2. Rinnova la licenza tramite il sito web HandyCafe.
3. Per le licenze revocate, contatta il supporto HandyCafe.

Problemi Generali

Le modifiche alle impostazioni non vengono salvate

Sintomi: Le modifiche vengono annullate dopo aver navigato altrove nelle impostazioni.

Soluzioni:

1. Assicurati di cliccare il pulsante Salva dopo aver effettuato le modifiche.
2. Controlla gli errori di validazione (campi evidenziati con messaggi di errore).
3. Verifica di avere i permessi admin.

Le voci dei log di controllo mancano

Sintomi: Le azioni previste non appaiono nella pagina Log.

Soluzioni:

1. Controlla i filtri dei log. Assicurati che la categoria e l'intervallo di date corretti siano selezionati.
2. Verifica che il permesso LOG_DISPLAY_FULL sia concesso (altrimenti vengono mostrati solo i log di oggi).
3. Cerca utilizzando il campo di ricerca testuale per l'azione specifica.