HandyCafe Docs
owner it-admin

Licences

Les versions de production de HandyCafe exigent un compte HandyCafe vérifié avant toute configuration du serveur local ou connexion du personnel. Votre plan détermine le nombre de connexions simultanées de PC clients et de consoles que le serveur accepte. Il contrôle également l'accès aux fonctionnalités propres à chaque plan.

Activation de la licence

  1. Lancez le serveur HandyCafe.
  2. HandyCafe vérifie si une licence de compte est déjà activée sur ce serveur.
  3. Saisissez votre e-mail et votre mot de passe sur l'écran Se connecter lorsqu'aucune licence de compte activée n'existe.
  4. Sélectionnez Créez-en un gratuitement si vous avez besoin d'un compte. Indiquez uniquement votre adresse e-mail.
  5. Ouvrez le lien d'inscription sécurisé reçu par e-mail. Créez votre mot de passe et terminez l'inscription dans le navigateur.
  6. Revenez au serveur HandyCafe et connectez-vous avec le nouveau compte.
  7. HandyCafe crée ou sélectionne la licence de café associée au compte et l'active sur le serveur.
  8. Créez le premier compte Admin local si le serveur n'en possède aucun. Sinon, l'écran de connexion Admin ou Caissier s'affiche.

Les nouveaux comptes vérifiés reçoivent automatiquement le plan Gratuit. Une clé de licence HC- neutre vis-à-vis du plan reste utilisée en interne. La clé ne contient pas le nom du plan en cours et conserve la même identité lorsque le plan change. Les utilisateurs GA n'ont pas besoin de saisir ni de copier cette clé.

Les versions de production ne proposent plus de plan d'essai. Si une installation ancienne conserve un enregistrement d'essai signé, HandyCafe maintient l'activation du compte vérifié et la présente comme Version gratuite le temps que la migration cloud se termine. L'application ne redemande pas le mot de passe du compte à chaque lancement.

L'écran d'activation du compte est la première étape obligatoire en production. L'assistant de première configuration local et l'écran de connexion Admin ou Caissier ne se chargent pas tant que l'activation du compte n'a pas abouti. L'écran de compte des versions de production ne peut pas être contourné par un aperçu de démonstration.

Sélectionnez Mot de passe oublié ? sous le champ du mot de passe pour demander un lien de réinitialisation. HandyCafe affiche toujours la même confirmation après l'envoi. L'écran ne révèle donc pas si l'adresse e-mail est enregistrée.

Plan Gratuit

Le plan Gratuit n'expire pas. Il nécessite une connexion internet fonctionnelle et comporte les limites suivantes :

Capacité Comportement du plan Gratuit
PC clients Jusqu'à 2 connexions simultanées
Consoles Jusqu'à 2 connexions simultanées
Personnel 1 propriétaire et 1 caissier actif. Les rôles personnalisés et gestionnaire ne sont pas disponibles.
Bureau à distance 2 sessions par jour UTC. Une seule session à la fois. Une reconnexion dans les 3 minutes prolonge la même session.
Captures d'écran 2 nouvelles captures par jour UTC, tous modes confondus : plein écran, fenêtre et mobile
Membres Illimité
Tickets individuels Illimité
Tickets en lot La création, l'import et l'impression en lot nécessitent Genesis
Rapports Les rapports standard sont disponibles. Le Générateur de rapports avancé nécessite Genesis.
Sécurité de la base de données Sauvegarde locale, export, restauration et contrôles d'intégrité disponibles
Maintenance de la base de données Vacuum, Analyze, Optimize, maintenance planifiée et purge des anciens journaux nécessitent Genesis
Code QR client Toujours visible sur les écrans d'attente et de session

HandyCafe affiche VERSION GRATUITE dans la barre supérieure tant que le plan Gratuit est actif. Une carte Version gratuite, que vous pouvez fermer, apparaît une fois au démarrage de l'application. La page À propos identifie elle aussi la Version gratuite et ses limites de 2 PC et 2 consoles actives, sans compte à rebours d'essai ni date d'expiration.

Le plan Gratuit exige un Lien en direct Cloud authentifié en permanence. Le serveur envoie un battement de cœur WebSocket toutes les 30 secondes. Trois fenêtres de battement manquées, soit environ 90 secondes, interrompent l'usage opérationnel. Les sessions PC et console en cours se ferment. Les nouvelles sessions, le bureau à distance, les captures d'écran et les autres opérations d'écriture restent bloqués jusqu'au rétablissement du Lien en direct authentifié.

Le bail en ligne signé de 10 minutes constitue une seconde couche de vérification. Rétablir le simple accès internet ne suffit pas. Le Lien en direct Cloud authentifié doit se reconnecter et le bail signé doit toujours être valide. Les commandes de licence et d'achat, les journaux, la sauvegarde locale, l'export et les outils de récupération restent accessibles pendant que l'usage opérationnel est verrouillé.

Les limites quotidiennes de bureau à distance et de captures d'écran font autorité côté cloud. Une capture en échec ne consomme pas le quota. Ouvrir ou enregistrer une capture existante ne le consomme pas non plus. Les plans Genesis payants offrent un bureau à distance et des captures d'écran locales illimités.

Lorsqu'un plan payant expire, est résilié ou subit un échec de paiement, le café bascule sur le plan Gratuit au lieu de perdre l'accès à ses données. Les connexions et les sessions console au-delà des limites du plan Gratuit s'arrêtent immédiatement. Une licence révoquée ou désactivée pour raison de sécurité coupe tout accès client et console.

Plans Genesis à durée déterminée

Un plan Genesis peut être attribué directement à un café pour une durée déterminée, sans abonnement à paiement récurrent. Le Dashboard HandyCafe le présente comme le plan actuel du café sur Dashboard, Mon plan et Facturation. Il affiche la date de fin fixe au lieu d'une date de renouvellement.

Un plan à durée déterminée n'a ni renouvellement automatique ni résiliation Stripe. Les commandes de résiliation d'abonnement, de réactivation et de changement de plan en libre-service restent indisponibles pour ce plan. Contactez le support HandyCafe lorsque le plan attribué doit changer avant sa date de fin.

Transition depuis un plan annuel Legacy

Un achat annuel Legacy actif effectué avant le 1er juillet 2026 peut basculer vers Genesis sans perdre la période Legacy déjà payée. HandyCafe vérifie le paiement Legacy réussi avant de proposer la transition. Un prix ou un identifiant d'abonnement enregistré ne suffit pas comme preuve de paiement. HandyCafe sélectionne le plus petit forfait Genesis couvrant la limite de clients Legacy. L'accès Genesis s'ouvre immédiatement. L'accès inclus prend fin à l'horodatage de fin de la période Legacy existante.

Ouvrez Mon plan et repérez la licence Legacy éligible. Sélectionnez Passer à Genesis et examinez la confirmation. Celle-ci indique un montant nul aujourd'hui. Elle affiche également le montant Genesis annuel exact et la date du premier paiement. Stripe vérifie et enregistre la carte. HandyCafe programme ensuite le nouvel abonnement Genesis annuel pour qu'il démarre à la fin de la période Legacy payée. Cette transition ne crée pas de période d'essai.

Le renouvellement Legacy existant n'est désactivé qu'une fois la programmation du futur abonnement Genesis créée avec succès. Une configuration en échec restaure le réglage de renouvellement Legacy antérieur. HandyCafe réconcilie également une configuration interrompue avant d'autoriser un nouveau paiement. Cela évite une rupture de facturation, un prélèvement futur invisible ou deux renouvellements actifs.

Sélectionnez Annuler le renouvellement programmé pour interrompre le futur prélèvement Genesis. L'accès Genesis inclus se poursuit jusqu'à la date de fin Legacy payée. Le café bascule ensuite sur le plan Gratuit. Un premier paiement Genesis en échec fait également basculer le café sur le plan Gratuit. Les données restent disponibles dans les limites du plan Gratuit.

Les renouvellements Legacy par PayPal nécessitent l'intervention du support avant une transition en libre-service. HandyCafe ne programme pas un second prélèvement récurrent tant qu'un renouvellement PayPal existant peut encore être actif.

Paramètres du compte

Ouvrez Paramètres, puis sélectionnez Compte pour gérer le compte HandyCafe lié au serveur. La page indique la personne à contacter et son e-mail, le café, le pays, le plan actuel, le quota de PC, le quota de consoles actives et l'exigence de connexion en ligne. Les forfaits Cloud et Cafétéria actifs apparaissent sous forme de cartes distinctes dans la section Modules complémentaires, sous le plan. Sélectionnez Dashboard pour ouvrir le Dashboard HandyCafe lié dans le navigateur du système.

Pour un abonnement Stripe à renouvellement automatique, la page présente la limite réelle de la période de facturation comme date de renouvellement. Si le renouvellement automatique est inactif, elle signale que le renouvellement est inactif et affiche à la place la date de fin d'accès de la licence. Cette date de fin d'accès peut être postérieure à la limite de la période de facturation. HandyCafe prévoit en effet une courte marge de réconciliation pour les webhooks de paiement retardés. Un accès Cloud ou Cafétéria accordé par un administrateur apparaît comme un forfait actif, sans date de renouvellement inventée.

Sélectionnez Actualiser pour demander l'état signé le plus récent du compte et du plan. Sélectionnez Mettre à niveau vers Genesis ou Gérer la formule pour ouvrir le flux existant de sélection de plan et de paiement sécurisé.

Seul le caissier Admin local peut sélectionner Se déconnecter. HandyCafe demande une confirmation avant de retirer le compte du serveur. La déconnexion coupe le Lien en direct Cloud et le relais de la cafétéria, efface l'identifiant cloud partagé et ramène le serveur à l'écran obligatoire de connexion au compte HandyCafe. Une licence défectueuse ou en lecture seule peut aussi être effacée depuis l'écran de récupération bloquant lorsque la connexion Admin locale n'est pas disponible.

États de la licence

État Description
missing_key Aucune clé de licence n'a été saisie
inactive Clé saisie mais pas encore validée
active La licence est valide et opérationnelle
offline_grace Un serveur payant ne parvient pas à joindre le service de licences mais reste dans sa période de grâce configurée
offline_locked La période de grâce a expiré. Le serveur est verrouillé jusqu'au rétablissement de la connectivité.
online_required Le plan Gratuit n'a reçu aucun battement de cœur récent du Lien en direct Cloud authentifié ou ne peut pas renouveler son bail en ligne signé
expired La licence a dépassé sa date d'expiration
revoked La licence a été révoquée par l'autorité de licences
over_limit Plus de clients sont connectés que la licence ne l'autorise

Limite de PC

Votre licence spécifie le nombre maximum de connexions simultanées de PC clients et de consoles.

  • Lorsque la limite est atteinte, les nouvelles connexions de clients sont rejetées.
  • Le démarrage d'une troisième session console sur le plan Gratuit est refusé, même si davantage de consoles ont été enregistrées avant l'activation du plan Gratuit.
  • Le serveur affiche une notification de limite localisée. Il n'expose aucun code d'erreur interne.
  • Le plan Gratuit prend en charge 2 PC connectés et 2 consoles connectées à la fois.

Si vous avez besoin de plus de PC, mettez à niveau votre licence via le site HandyCafe.

Mode lecture seule

Lorsque la limite de PC est à 0 (ou lorsque la licence est dans certains états restreints), le serveur passe en mode lecture seule :

  • Vous pouvez consulter toutes les données et rapports
  • Vous ne pouvez pas démarrer de nouvelles sessions
  • Vous ne pouvez pas modifier les paramètres affectant les opérations des clients
  • Le panneau d'administration affiche un écran de superposition de licence indiquant la restriction

Comportement en ligne et hors ligne

Les plans payants utilisent la période de grâce hors ligne configurée. La valeur par défaut est de 48 heures. Si le serveur ne peut pas joindre le service de licences :

  1. La licence passe en état offline_grace.
  2. Vous avez jusqu'à l'échéance de grâce configurée pour rétablir la connectivité internet.
  3. Durant la période de grâce, toutes les fonctionnalités fonctionnent normalement.
  4. Après l'échéance, la licence passe en état offline_locked et le serveur est restreint.

Le plan Gratuit n'utilise pas la période de grâce hors ligne des plans payants. Il doit maintenir le Lien en direct Cloud authentifié. Une courte fenêtre de 90 secondes de battements manqués tolère de brèves instabilités réseau. Le bail en ligne signé de 10 minutes apporte une seconde couche de vérification.

Le serveur HandyCafe n'accepte l'état de licence renvoyé par le Cloud que lorsque la réponse porte une signature HandyCafe valide, liée à l'installation et à la requête en cours. Les réponses non signées, altérées, périmées, rejouées ou provenant d'une autre installation sont rejetées. L'accès opérationnel reste verrouillé jusqu'à l'arrivée d'une réponse valide.

Astuce : assurez-vous que votre PC serveur dispose d'une connexion internet stable autorisant le trafic WebSocket sécurisé vers HandyCafe Cloud. Le battement de cœur utilise un minimum de bande passante.

Écran de superposition de licence

L'écran de superposition de licence fournit également le récapitulatif de démarrage affiché une seule fois pour la Version gratuite. En cas de problème de licence, la même superposition présente l'action requise. Cet écran :

  • Affiche le statut actuel de la licence
  • Affiche la limite de PC
  • Affiche la limite de consoles actives
  • Fournit des instructions pour résoudre le problème
  • Bloque l'usage opérationnel lorsque la licence exige une action

Étapes suivantes