Questions Fréquemment Posées

Installation et Configuration

Quels types d'entreprises HandyCafe prend-il en charge ?

HandyCafe est conçu pour les cybercafés, centres de jeux, arènes esports, cybercafés et PC bangs. Toute entreprise offrant un accès chronométré aux PC ou consoles de jeux peut utiliser HandyCafe pour gérer les sessions, la facturation et les adhésions.

Quelles sont les exigences système pour HandyCafe Server ?

Le serveur nécessite Windows 10 ou une version ultérieure (64 bits), au moins 4 Go de RAM, 500 Mo d'espace disque et une connexion réseau locale. Les PC clients ont besoin de Windows 10 ou plus récent avec 2 Go de RAM. Tous les PC doivent être sur le même LAN. Voir Exigences Système pour plus de détails.

Comment installer HandyCafe Server ?

Téléchargez l'installateur depuis le site officiel, exécutez-le et suivez les instructions. Au premier lancement, l'assistant de première configuration crée votre compte administrateur. Voir Installation du Serveur pour des instructions détaillées.

Comment connecter un PC client au serveur ?

Installez HandyCafe Client sur le PC. Il utilise mDNS pour découvrir automatiquement le serveur sur le réseau local. Si la découverte automatique échoue, entrez l'adresse IP du serveur manuellement dans les paramètres du client. Voir Installation du Client.

Pourquoi mon client ne se connecte-t-il pas au serveur ?

Causes courantes : le serveur n'est pas en cours d'exécution, les PC sont sur des sous-réseaux différents, le pare-feu bloque les ports (TCP 5001, 5002, 5003 et UDP 5004), ou la clé de connexion ne correspond pas. Voir Dépannage pour des solutions détaillées.

Quels ports HandyCafe utilise-t-il ?

TCP 5001 (commandes), TCP 5002 (transferts de fichiers), TCP 5003 (gestion à distance), UDP 5004 (streaming d'écran). Ces ports sont configurables dans Paramètres Réseau.

Comment activer ma licence ?

Entrez votre clé de licence dans le panneau de licence. Le serveur la valide avec le serveur de licences. Une connexion internet active est requise pour l'activation initiale. Voir Licences.

Que se passe-t-il lorsque mon serveur est hors ligne pendant plus de 72 heures ?

HandyCafe dispose d'une période de grâce hors ligne de 72 heures. Pendant ce temps, toutes les fonctionnalités fonctionnent normalement. Après 72 heures sans connectivité au serveur de licences, le serveur entre dans un état verrouillé jusqu'à ce que l'accès à Internet soit rétabli.

Sessions et Tarification

Comment démarrer une session sur un PC ?

Dans le panneau d'administration, sélectionnez un PC inactif (cyan) et cliquez sur Démarrer sur la carte. Choisissez le mode postpayé ou prépayé, assignez éventuellement un membre, définissez la durée/le montant si prépayé, sélectionnez un mode de paiement et confirmez. Voir Sessions.

Quelle est la différence entre les sessions prépayées et postpayées ?

En mode postpayé, le client paie à la fin en fonction du temps d'utilisation réel. En mode prépayé, le client paie à l'avance pour une durée ou un montant fixe. Le prépayé prend en charge deux sous-modes : Verrouiller à l'achat (coût figé au départ) et Horaire en direct (coût ajusté avec les changements de créneau horaire). Voir Sessions.

Comment fonctionne le calendrier tarifaire ?

Le calendrier tarifaire est une grille de 7 jours par 24 heures où chaque bloc horaire est attribué à un créneau tarifaire codé par couleur. Chaque créneau a un multiplicateur (par exemple, 1.0x standard, 1.5x pic, 0.5x creux). Le coût de la session est calculé comme suit : tarif horaire de base multiplié par le multiplicateur du créneau multiplié par la durée. Voir Tarification des Sessions.

Comment définir des prix différents pour les week-ends par rapport aux jours de semaine ?

Dans Paramètres > Calendrier Tarifaire, créez des créneaux tarifaires avec des multiplicateurs différents (par exemple, "Semaine" à 1.0x, "Week-end" à 1.3x). Peignez les colonnes du week-end avec la couleur du créneau Week-end et les colonnes de la semaine avec la couleur du créneau Semaine. Voir Paramètres du Calendrier Tarifaire.

Comment mettre en pause et reprendre une session ?

Cliquez sur Pause sur la carte du PC en ligne. La facturation s'arrête pendant la pause. Pour reprendre, cliquez sur Reprendre sur la carte du PC en pause. Un nouveau segment tarifaire commence lors de la reprise. Voir Sessions.

Comment ajouter du temps supplémentaire à une session active ?

Cliquez sur Ajouter du Temps sur la carte du PC en ligne. Entrez le nombre de minutes à ajouter (positif pour prolonger, négatif pour réduire). Un enregistrement de transaction est créé pour l'ajustement.

Que se passe-t-il lorsqu'une session couvre plusieurs créneaux tarifaires ?

La session est automatiquement divisée en segments aux limites des créneaux. Chaque segment utilise le multiplicateur actif pendant cette période. Le coût total est la somme de tous les coûts des segments. Voir Tarification des Sessions.

Qu'est-ce que les frais de démarrage ?

Les frais de démarrage sont un minimum facturé pour chaque session. Même si une session est très courte, le client est facturé au moins ce montant. Configurez-le dans Paramètres de Tarification.

Membres et Fidélité

Comment créer un nouveau membre ?

Accédez à la page Membres et cliquez sur Ajouter un Membre. Entrez le nom d'utilisateur, le nom d'affichage, l'email optionnel, le téléphone et d'autres détails. Assignez un niveau si applicable. Voir Membres.

Comment fonctionne le système de portefeuille ?

Chaque membre a un solde de portefeuille. Lorsque vous rechargez le portefeuille, un crédit de portefeuille est créé avec un montant spécifique et un type de crédit (payé, bonus, manuel, etc.). Pendant les sessions, le portefeuille est consommé automatiquement. Les crédits peuvent avoir des dates d'expiration et des restrictions d'appareil. Voir Portefeuille des Membres.

Qu'est-ce qu'un crédit de portefeuille ?

Un crédit de portefeuille est une entrée discrète du solde du portefeuille créée par une seule recharge. Chaque crédit suit son propre montant, type de crédit (payé, bonus, manuel), statut (actif, expiré, consommé) et restriction d'appareil éligible. Les crédits sont consommés dans l'ordre (le plus ancien en premier). Voir Portefeuille des Membres.

Comment fonctionnent les niveaux de fidélité et les points ?

Les membres gagnent des points grâce à des activités (dépenses, visites, recharges, commandes). Chaque niveau a un seuil de points. Lorsqu'un membre accumule suffisamment de points, il passe au niveau suivant. Les niveaux supérieurs peuvent offrir de meilleurs taux de réduction. Voir Niveaux de Fidélité.

Comment recharger le portefeuille d'un membre ?

Sélectionnez le membre dans la page Membres, cliquez sur l'option de paiement/recharge, entrez le montant, sélectionnez le type de crédit et le mode de paiement, et confirmez. Un nouveau crédit de portefeuille est créé. Voir Portefeuille des Membres.

Un membre peut-il utiliser son solde de portefeuille pour les PC et les consoles ?

Cela dépend de la restriction d'appareil du crédit. Les crédits peuvent être limités à "PC uniquement", "consoles uniquement" ou "les deux". Lors de l'achat d'un forfait, la restriction d'appareil est définie par la configuration du forfait. Voir Forfaits.

Que se passe-t-il lorsqu'un crédit de portefeuille expire ?

Lorsqu'un crédit atteint sa date d'expiration, son statut passe à "expiré" et le solde restant n'est plus disponible. Le montant expiré est enregistré dans l'historique des transactions du membre.

Comment consulter l'historique des transactions d'un membre ?

Sélectionnez le membre dans la page Membres. Le panneau de détails du membre affiche le registre des transactions avec toutes les recharges de portefeuille, dépenses, remboursements et ajustements avec les horodatages et les montants.

Produits, Commandes et Inventaire

Comment ajouter un produit au catalogue ?

Accédez à Produits et cliquez sur Ajouter un Produit. Entrez le nom, la catégorie, l'unité, le code-barres, le prix de vente, le prix de revient et le taux de TVA. Activez/désactivez. Voir Produits.

Comment créer une commande pour un client ?

Accédez à Commandes, cliquez sur Nouvelle Commande, assignez éventuellement à un PC ou ajoutez une note, ajoutez des articles du catalogue de produits avec des quantités, puis clôturez la commande avec un mode de paiement. Voir Commandes.

Comment annuler ou rembourser une commande ?

Ouvrez la commande depuis la page Commandes et cliquez sur Annuler. La commande est annulée et aucun paiement n'est enregistré. Pour les remboursements sur les commandes clôturées, utilisez le flux de remboursement approprié.

Comment fonctionne le suivi des stocks ?

Chaque produit a un niveau de stock. Le journal des stocks suit les changements avec des raisons : vente (décrémenté automatiquement à la clôture de la commande), achat (à partir des entrées d'inventaire), ajustement, gaspillage et retour. Voir Produits et Inventaire.

Campagnes et Forfaits

Comment créer une campagne ?

Accédez à Campagnes et cliquez sur Ajouter une Campagne. Entrez le nom, la description, définissez-la comme active et configurez une date d'expiration si applicable. Ajoutez ensuite des forfaits à la campagne. Voir Campagnes.

Quelle est la différence entre les forfaits basés sur le temps et ceux basés sur l'argent ?

Les forfaits basés sur le temps offrent au membre du temps (minutes) qui peut être utilisé pour les sessions. Les forfaits basés sur l'argent ajoutent des fonds au portefeuille du membre. Les deux peuvent inclure des montants bonus. Voir Forfaits.

Comment fonctionne le système de bonus dans les forfaits ?

Un forfait peut inclure un bonus en plus de l'allocation de base. Par exemple, un forfait peut offrir "60 minutes + 15 minutes bonus" ou "10 € + 2 € bonus". Le bonus crée une entrée de crédit distincte étiquetée avec le type de crédit "Bonus".

Comment fonctionnent les restrictions d'appareil sur les forfaits ?

Chaque forfait définit une restriction d'appareil : client (PC), console (consoles), les deux, PC uniquement ou consoles uniquement. Lors de l'achat du forfait, les crédits de portefeuille/temps créés héritent de cette restriction et ne peuvent être utilisés que sur les types d'appareils correspondants.

Gestion des Caissiers

Comment créer un compte caissier ?

Accédez à Gestion > Caissiers. Cliquez sur Ajouter un Caissier, entrez un nom d'utilisateur et un mot de passe, et assignez un rôle. Le caissier peut ensuite se connecter avec ces identifiants. Voir Rôles des Caissiers.

Comment définir les permissions pour un rôle de caissier ?

Accédez à Gestion > Rôles des Caissiers. Créez un nouveau rôle ou modifiez un rôle existant. Cochez ou décochez les drapeaux de permission individuels dans chacune des 6 catégories (Authentification, Membres, Consoles, Journaux, Rapports, Modes de Paiement). Voir Rôles des Caissiers.

Quelles sont les 6 catégories de permissions ?

Authentification (1 drapeau), Membres (6 drapeaux : voir, ajouter, supprimer, mettre à jour, afficher l'email, afficher le téléphone), Consoles (4 drapeaux : voir, ajouter, supprimer, mettre à jour), Journaux (4 drapeaux : voir, historique complet, aujourd'hui seulement, supprimer), Rapports (3 drapeaux : voir, historique complet, aujourd'hui seulement), Modes de Paiement (4 drapeaux : gérer, ajouter, supprimer, mettre à jour). Total : 22 drapeaux de permission individuels.

Comment fonctionne la protection contre les attaques par force brute lors de la connexion des caissiers ?

Après 5 tentatives de connexion échouées en 10 minutes, le compte est verrouillé pendant 15 minutes. Toutes les tentatives échouées sont enregistrées dans le journal d'audit avec une alerte de sécurité.

Comment consulter les rapports de quart des caissiers ?

Ouvrez la page Rapport de Caisse. Filtrez par nom de caissier pour voir les transactions traitées par un caissier spécifique pendant son quart. Le résumé du quart montre les totaux et la répartition par mode de paiement.

Paramètres et Configuration

Comment changer la langue ?

Accédez à Paramètres > Général et sélectionnez votre langue dans le menu déroulant. HandyCafe prend en charge 24 langues. L'interface se met à jour immédiatement. Voir Paramètres Généraux.

Comment configurer la connexion OAuth Google ?

Accédez à Paramètres > OAuth. Activez OAuth globalement, puis activez Google. Entrez votre ID Client Google et Secret Client (depuis la Google Cloud Console). Importez éventuellement le fichier de crédentiels JSON. Testez en initiant une connexion OAuth depuis un PC client. Voir Paramètres OAuth.

Comment configurer la grille du calendrier tarifaire ?

Accédez à Paramètres > Calendrier Tarifaire. Activez le calendrier, créez des créneaux codés par couleur avec des multiplicateurs, puis cliquez/glissez sur la grille horaire 7x24 pour peindre les blocs horaires avec le créneau souhaité. Voir Paramètres du Calendrier Tarifaire.

Comment personnaliser l'écran d'attente du client ?

Accédez à Paramètres > Clients > Onglet Écran d'Attente. Activez le diaporama, ajoutez des images ou vidéos, définissez les durées et transitions. Activez éventuellement les superpositions d'horloge et de nom du café. Voir Écran d'Attente du Client.

Comment changer le thème d'apparence du client ?

Accédez à Paramètres > Clients > Onglet Apparence. Sélectionnez un thème (Neon Arena, Crimson Pulse, Emerald Depth), choisissez un préréglage de mise en page et configurez l'arrière-plan, la densité des cartes et les effets. Voir Apparence du Client.

Comment configurer les notifications sonores ?

Accédez à Paramètres > Sons. Activez le basculement des sons principaux, puis sélectionnez un son pour chaque événement (Appel Caissier, Nouvelle Commande, Fin de Session, Demande de Connexion) parmi les 15 options intégrées. Voir Paramètres des Sons.

Qu'est-ce que la clé de connexion et pourquoi est-elle importante ?

La clé de connexion est un secret partagé utilisé pour l'authentification cryptographique entre le serveur et les clients. Elle empêche les appareils non autorisés de se connecter à votre serveur. Tous les clients doivent utiliser la même clé que le serveur. Configurez-la dans Paramètres Réseau.

Gestion à Distance

Comment prendre une capture d'écran à distance d'un PC client ?

Sélectionnez le client dans le panneau d'administration et cliquez sur Capture d'Écran sur la carte. Le visualiseur de captures d'écran affiche l'image capturée. Vous pouvez actualiser pour une nouvelle capture ou télécharger l'image. Voir Captures d'Écran.

Comment utiliser le bureau à distance pour contrôler un PC client ?

Sélectionnez la carte du client et cliquez sur Bureau à Distance. Une fenêtre s'ouvre avec un streaming vidéo H.264 en direct. Vous pouvez contrôler la souris et le clavier à distance et la synchronisation du presse-papiers fonctionne entre le serveur et le client. Voir Bureau à Distance.

Comment fonctionne le système de synchronisation de fichiers ?

Configurez les répertoires à synchroniser dans Paramètres > Explorateur de Synchronisation. Lorsqu'il est déclenché, le serveur crée un manifeste de fichiers. Les clients comparent le manifeste aux fichiers locaux et téléchargent uniquement les fichiers modifiés ou nouveaux en utilisant un transfert basé sur des segments. Voir Synchronisation de Fichiers.

Comment voir quelles applications sont en cours d'exécution sur un PC client ?

Sélectionnez le client dans le panneau d'administration et cliquez sur Applications en Cours sur la carte. Un panneau montre tous les processus en cours avec leurs noms et détails. Vous pouvez également voir Applications au Démarrage, Applications Installées et Applications Fenêtrées à partir des mêmes boutons d'action.

Comment envoyer un message à un PC client ?

Sélectionnez la carte du client et cliquez sur Envoyer un Message. Tapez votre message et confirmez. Le message apparaît sur l'écran du client.

Comment éteindre ou redémarrer un PC client à distance ?

Sélectionnez la carte du client et cliquez sur Éteindre ou Redémarrer. Vous pouvez également sélectionner plusieurs clients pour des opérations en masse. Wake on LAN est disponible pour allumer des PC hors ligne qui le prennent en charge.

Rapports et Analyses

Comment consulter le rapport de caisse ?

Accédez à Rapport de Caisse depuis la barre latérale. Le rapport montre des cartes de résumé, l'historique des transactions, les revenus par appareil et des graphiques. Utilisez les filtres de date pour restreindre la plage de temps. Voir Rapport de Caisse.

Comment exporter les données de rapport ?

Dans le Rapport de Caisse, utilisez la fonction d'exportation/copier pour copier les données de transaction dans votre presse-papiers au format CSV. Vous pouvez ensuite les coller dans Excel ou toute application de feuille de calcul.

Quelles analyses sont disponibles dans la page Statistiques ?

Neuf onglets d'analyses : Tendances des revenus, Analyses des ventes, Suivi des dépenses, Statistiques des sessions, Utilisation des consoles, Utilisation des applications, Taux d'utilisation des ordinateurs, Activité des membres et Performance des caissiers. Voir Statistiques.

Comment vérifier les taux d'utilisation des ordinateurs ?

Accédez à Statistiques > Onglet Utilisation des Ordinateurs. Cela montre les pourcentages d'utilisation par PC, le temps de fonctionnement et les revenus par machine. Il identifie également vos PC les plus occupés. Voir Statistiques des Sessions & Ordinateurs.

Dépannage

Le client affiche "hors ligne" mais le PC est allumé. Que faire ?

Vérifiez que : 1) HandyCafe Client est en cours d'exécution sur le PC, 2) Les deux PC sont sur le même réseau/sous-réseau, 3) Le pare-feu autorise les ports TCP 5001-5003, 4) La clé de connexion correspond entre le serveur et le client. Voir Dépannage.

La tarification des sessions semble incorrecte. Comment vérifier ?

Vérifiez les paramètres de tarification (Paramètres > Tarification) pour le tarif horaire de base et la TVA. Vérifiez le calendrier tarifaire (Paramètres > Calendrier Tarifaire) pour les multiplicateurs actifs au moment de la session. Consultez les segments tarifaires de la session dans les détails de la transaction pour voir comment chaque segment a été calculé.

La connexion OAuth est bloquée sur "en attente". Comment résoudre ?

Assurez-vous que l'administrateur a approuvé la demande sur la page Demandes. Si la demande est bloquée, vérifiez : 1) Les crédentiels du fournisseur OAuth sont corrects dans Paramètres > OAuth, 2) Le serveur a accès à Internet pour atteindre l'API du fournisseur, 3) Le code de l'appareil n'a pas expiré (ils expirent généralement en 15-30 minutes).

Le bureau à distance est lent. Comment améliorer les performances ?

Réduisez le débit binaire dans les paramètres de flux (essayez 1000-2000 kbps pour le LAN). Vérifiez la bande passante réseau entre le serveur et le client. Assurez-vous que le port UDP 5004 n'est pas bloqué. Utilisez Ethernet câblé au lieu du WiFi pour de meilleurs résultats.

Ma licence affiche "over_limit". Qu'est-ce que cela signifie ?

Plus de PC clients sont connectés que votre licence ne le permet. Déconnectez les clients inutilisés ou mettez à niveau votre licence. Le serveur ne démarrera pas de nouvelles sessions tant que le nombre de clients connectés n'est pas inférieur ou égal à la limite.

Un caissier est verrouillé après trop de tentatives de connexion échouées. Comment le déverrouiller ?

Attendez 15 minutes pour que le verrouillage automatique expire. Si urgent, un administrateur peut gérer le compte du caissier via l'interface de gestion.

Cafétéria

Comment les clients passent-ils des commandes depuis leur table ?

Ils scannent le code QR sur la table avec leur téléphone, entrent le code de sécurité à 6 chiffres donné par le personnel, parcourent le menu dans leur propre langue, ajoutent des articles au panier et soumettent avec un paiement en espèces ou en ligne (Stripe). Les commandes apparaissent sur votre tableau de bord des commandes de cafétéria en 3 secondes. Voir Menu Client.

Comment activer le module Cafétéria ?

Ouvrez Paramètres > Cafétéria et activez Activer la Cafétéria. Le serveur utilise automatiquement votre licence HandyCafe comme autorisation. Un assistant de provisionnement demande votre slug, nom d'affichage, pays, devise et fuseau horaire. Voir Vue d'ensemble de la Cafétéria et Comment Configurer la Cafétéria.

Quelles langues le menu client prend-il en charge ?

Le menu client sur handy.cafe/{slug} prend en charge 24 langues. La première visite choisit la meilleure correspondance à partir de l'en-tête Accept-Language du navigateur. Les clients peuvent changer de langue à tout moment avec le sélecteur en haut.

La Cafétéria fonctionne-t-elle sans internet ?

Non. La Cafétéria est orientée cloud. Le provisionnement, la synchronisation du menu et le sondage des commandes nécessitent tous un accès internet sortant. Les pages destinées aux clients sont servies par le cloud et ne dépendent pas de votre serveur local pour être accessible depuis Internet.

Clients Hérités

HandyCafe prend-il en charge mes anciens clients V3 ou V4 ?

Oui. Activez la prise en charge à l'exécution dans Paramètres > Clients Hérités et le serveur démarre les écouteurs sur les ports hérités d'origine (UDP 710/711, TCP 712, transfert de fichiers 717). Vos clients existants se connectent sans aucun changement de leur côté. Ils apparaissent dans le panneau d'administration avec un ensemble d'actions réduit (Connexion, Déconnexion, Ajouter du Temps, Capture d'Écran, Déconnexion, Redémarrage, Arrêt). Voir Clients Hérités.

Les clients hérités et modernes peuvent-ils fonctionner sur le même serveur en même temps ?

Oui. Les deux piles de protocoles utilisent des ports différents et ne se chevauchent pas. Vous pouvez mélanger d'anciens et de nouveaux clients sur le même LAN et les gérer depuis le même panneau d'administration.

Puis-je transférer mes données d'une installation HandyCafe plus ancienne ?

Oui, sur Windows. Ouvrez Paramètres > Clients Hérités, faites défiler jusqu'à Migration de Base de Données et cliquez sur Démarrer la Migration. Les membres, la tarification, les produits, les commandes, les transactions et les journaux sont importés. Les fichiers originaux ne sont pas modifiés ou supprimés. Si le résultat n'est pas celui attendu, cliquez sur Annuler la Migration pour revenir en arrière. Voir Comment Migrer depuis une Installation Héritée.

Quelle est la différence entre les variantes de protocole STE et Standard ?

Les trames STE (Smart/Turbo Edition) incluent un préfixe d'informations de licence de 70 octets ; la taille de la trame est de 1337 octets. Les trames Standard omettent le préfixe ; la taille de la trame est de 1267 octets. Choisissez la variante qui correspond à la façon dont votre serveur hérité a été construit. Choisir la mauvaise variante entraîne des trames perdues ou mal lues.