Dépannage

Cette page regroupe les solutions aux problèmes courants, organisées par catégorie.

Problèmes de connexion

Le client ne trouve pas le serveur

Symptômes : le client affiche "Recherche du serveur" ou "Aucun serveur trouvé".

Solutions :

Vérifiez que le serveur HandyCafe est en cours d'exécution sur le PC de gestion.
Confirmez que les deux PC sont sur le même sous-réseau (par exemple les deux en 192.168.1.x).
Vérifiez que le mDNS n'est pas bloqué par votre commutateur ou routeur réseau.
Essayez la connexion manuelle : saisissez l'adresse IP du serveur directement dans les paramètres du client.
Vérifiez qu'aucun autre logiciel n'utilise le port TCP du serveur (par défaut : 5001).

Le client se connecte puis se déconnecte immédiatement

Symptômes : le client affiche brièvement "Connecté" puis revient à "Recherche".

Solutions :

Vérifiez que la clé de connexion correspond sur le serveur et le client. La clé est définie dans Paramètres > Réseau sur le serveur.
Vérifiez la stabilité du réseau (pertes de paquets, problèmes de câble).
Assurez-vous que le serveur n'a pas atteint la limite de PC de sa licence.
Consultez les journaux du serveur pour les messages d'échec d'authentification.

Le client apparaît "Hors ligne" sur le serveur mais le PC est allumé

Symptômes : le PC client est allumé et l'application client fonctionne, mais le serveur l'affiche comme hors ligne.

Solutions :

Sur le PC client, vérifiez que HandyCafe Client est bien en cours d'exécution (vérifiez la zone de notification).
Vérifiez la connexion réseau du PC client (peut-il envoyer un ping au serveur ?).
Vérifiez les règles de pare-feu : les ports TCP 5001-5003 doivent être ouverts sur le serveur et le client.
Redémarrez HandyCafe Client sur le PC concerné.
Si vous utilisez des VLAN, assurez-vous que les VLAN du serveur et du client peuvent communiquer.

Impossible de se connecter après modification des paramètres réseau

Symptômes : après avoir changé les ports ou la clé de connexion, les clients ne peuvent plus se connecter.

Solutions :

Assurez-vous que les clients sont mis à jour avec les nouveaux numéros de port et la nouvelle clé de connexion.
Redémarrez le serveur HandyCafe après avoir modifié les paramètres réseau.
Mettez à jour les règles de pare-feu pour autoriser les nouveaux ports.
Tous les clients doivent être reconfigurés avec les nouvelles valeurs.

Problèmes de session

Impossible de terminer une session sur un client

Symptômes : le bouton Démarrer est désactivé ou l'action de démarrage échoue avec une erreur.

Solutions :

Vérifiez le statut de la licence. En mode lecture seule, les nouvelles sessions ne peuvent pas démarrer.
Vérifiez que le statut du client est "Inactif". Les sessions ne peuvent démarrer que sur les clients inactifs.
Vérifiez les permissions du caissier. Le rôle doit disposer de la permission AUTH_CLIENT_LOGIN.
Assurez-vous que la tarification est configurée (Paramètres > Tarification doit avoir un tarif horaire valide).

Le chronomètre de session affiche une heure incorrecte

Symptômes : l'heure affichée ne correspond pas au temps réel écoulé.

Solutions :

Vérifiez les horloges système des PC serveur et client. Elles doivent être synchronisées (utilisez NTP).
Si la session a été mise en pause, la durée de la pause n'est pas comptabilisée.
Pour les sessions prépayées, le chronomètre affiche le temps restant, pas le temps écoulé.

Le coût de la session semble incorrect

Symptômes : le montant facturé ne correspond pas aux attentes.

Solutions :

Vérifiez la grille tarifaire. Si elle est activée, la session a pu traverser plusieurs créneaux tarifaires avec des multiplicateurs différents.
Vérifiez les paramètres de tarification : tarif horaire de base, TVA, frais de démarrage, arrondi.
Consultez les segments tarifaires de la session dans les détails de la transaction pour un détail complet.
Vérifiez la commission et les frais fixes du mode de paiement.
Pour les sessions prépayées, vérifiez si le mode "Verrouillage à l'achat" ou "Grille en temps réel" est actif.

Impossible de reprendre une session en pause

Symptômes : l'action de reprise échoue ou n'est pas disponible.

Solutions :

Vérifiez que le PC client est toujours connecté au serveur.
Vérifiez que le statut du client affiche "En pause" (orange).
Si le client s'est déconnecté pendant la pause, il devra peut-être se reconnecter d'abord.

Problèmes de paiement

Un mode de paiement est absent du menu déroulant

Symptômes : le mode de paiement attendu n'apparaît pas lors de la clôture d'une session ou d'une commande.

Solutions :

Vérifiez que le mode de paiement existe dans Gestion > Modes de paiement.
Vérifiez que le mode de paiement est actif (non supprimé ni désactivé).
Vérifiez les permissions du caissier. La permission PAYMENT_MANAGE doit être accordée pour voir tous les modes.

Le calcul de la commission semble incorrect

Symptômes : la commission déduite ne correspond pas au taux attendu.

Solutions :

Vérifiez le taux de commission du mode de paiement (en pourcentage) et les frais fixes.
Formule de commission : commission = (montant facturé * taux de commission / 100) + frais fixes.
Vérifiez si le caissier a appliqué un ajustement manuel au montant facturé.

Problèmes d'affichage du client

L'écran d'inactivité du client est vide

Symptômes : l'écran d'inactivité n'affiche rien au lieu du diaporama configuré.

Solutions :

Vérifiez que l'écran d'inactivité est activé dans Paramètres > Clients > Écran d'inactivité.
Vérifiez qu'au moins un élément multimédia (image ou vidéo) a été ajouté.
Vérifiez que les fichiers multimédia sont valides et non corrompus.
Lancez une synchronisation pour envoyer les derniers paramètres au client.

Le menu client n'affiche pas les applications

Symptômes : le lanceur d'applications est vide ou des catégories sont manquantes.

Solutions :

Vérifiez que les applications et les catégories sont configurées dans Paramètres > Clients > Contenu.
Vérifiez que les catégories et les applications ont la visibilité activée.
Vérifiez que le client a reçu les dernières données du menu (les modifications sont transmises automatiquement via TCP).
Redémarrez le client si la synchronisation en temps réel ne s'est pas appliquée.

Le thème d'apparence du client n'est pas appliqué

Symptômes : le client affiche l'apparence par défaut au lieu du thème configuré.

Solutions :

Vérifiez que les paramètres de thème sont enregistrés dans Paramètres > Clients > Apparence.
Lancez un envoi des paramètres vers les clients.
Redémarrez l'application client.

Problèmes de bureau à distance

Le bureau à distance est lent ou saccadé

Symptômes : le flux vidéo est retardé, saccadé ou a un faible taux de rafraîchissement.

Solutions :

Diminuez le débit binaire (essayez 1000 à 2000 kbps pour une utilisation LAN standard).
Réduisez le paramètre de FPS.
Utilisez un câble Ethernet plutôt que le Wi-Fi.
Vérifiez l'encombrement du réseau ou une utilisation élevée de la bande passante par d'autres applications.
Assurez-vous que le port UDP 5004 n'est pas bloqué ou limité en débit.

Le bureau à distance affiche un écran noir

Symptômes : la fenêtre de bureau à distance s'ouvre mais n'affiche que du noir.

Solutions :

Vérifiez que le client est en ligne et réactif (essayez d'abord de prendre une capture d'écran).
Vérifiez que le port UDP 5004 est ouvert dans les deux sens.
Le pilote graphique du client peut nécessiter une mise à jour.
Essayez de demander un rafraîchissement de l'image clé.

Impossible de contrôler la souris ou le clavier à distance

Symptômes : vous pouvez voir l'écran distant mais les clics et les frappes clavier n'ont aucun effet.

Solutions :

Vérifiez que le port de gestion à distance (TCP 5003) est ouvert.
Vérifiez que l'application client dispose des permissions système appropriées.
Certains jeux en plein écran peuvent bloquer les entrées à distance.

Problèmes de licence

La licence affiche "offline_grace"

Symptômes : le statut de la licence affiche offline_grace avec un compte à rebours.

Solutions :

Rétablissez la connexion Internet sur le PC serveur.
Vérifiez la résolution DNS. Le serveur doit pouvoir atteindre le serveur de licences.
Vérifiez la présence d'un proxy ou d'un pare-feu bloquant les connexions HTTPS sortantes.
Vous disposez de 72 heures pour rétablir la connexion avant que le serveur ne se verrouille.

La licence affiche "over_limit"

Symptômes : plus de clients sont connectés que la licence ne l'autorise.

Solutions :

Déconnectez les clients inactifs qui ne sont pas utilisés.
Vérifiez le nombre actuel de clients par rapport à la limite de votre licence.
Mettez à niveau votre licence pour une capacité PC supérieure.
Remarque : les consoles comptent dans la limite totale de PC.

La licence affiche "expirée" ou "révoquée"

Symptômes : le serveur passe en mode restreint.

Solutions :

Vérifiez la date d'expiration de votre licence.
Renouvelez votre licence via le site web de HandyCafe.
Pour les licences révoquées, contactez le support HandyCafe.

Problèmes généraux

Les modifications de paramètres ne sont pas sauvegardées

Symptômes : les modifications sont annulées après avoir quitté la page des paramètres.

Solutions :

Assurez-vous de cliquer sur le bouton Enregistrer après avoir effectué vos modifications.
Vérifiez les erreurs de validation (champs surlignants avec des messages d'erreur).
Vérifiez que vous disposez des permissions d'administrateur.

Des entrées sont manquantes dans les journaux d'audit

Symptômes : les actions attendues n'apparaissent pas dans la page Journaux.

Solutions :

Vérifiez les filtres de journaux. Assurez-vous que la catégorie et la plage de dates correctes sont sélectionnées.
Vérifiez que la permission LOG_DISPLAY_FULL est accordée (sinon seuls les journaux du jour sont affichés).
Utilisez le champ de recherche textuel pour trouver l'action spécifique.