HandyCafe Docs
owner it-admin

Cafétéria

Cafétéria est le module intégré de service de nourriture et de boissons de HandyCafe. Il vous permet de construire un plan de salle numérique pour vos tables, de publier un menu libre-service de marque sur le web à handy.cafe/{your-slug}, et de suivre chaque commande entrante en temps réel depuis le tableau de bord du serveur.

Les clients scannent le QR code de leur table, saisissent un code de sécurité à 6 chiffres, parcourent le menu dans leur propre langue, puis passent commande. La commande apparaît sur votre écran Orders de Cafétéria en quelques secondes. Votre équipe valide chaque étape de préparation, et lorsque le service est terminé, l'action "Settle Check" clôt la note en une seule étape.

A qui s'adresse ce module

Cafétéria est conçu pour les cybercafés, centres de jeux et arènes esport qui servent aussi des repas et boissons aux places clients. Il remplace les bons de commande papier et les demandes verbales au comptoir. Il fonctionne avec le système standard de sessions et de tarification de HandyCafe ; les commandes Cafétéria sont suivies séparément, mais sur la même licence de café.

Fonctionnalités principales

Fonctionnalité Résumé
Plan de salle Editeur visuel pour plusieurs niveaux. Déplacez les tables, basculez en vue 3D, marquez les tables hors service.
Tables Configurez par table le nombre de places, la forme, la taille (1 à 10) et le code d'affichage. Générez des QR codes et faites-les tourner à la demande.
Menu Catégories avec icônes MDI, produits avec photos, descriptions en Markdown, listes d'ingrédients et groupes de variantes (par exemple Taille, Garnitures).
Commandes Tableau de bord en direct avec sondage toutes les 3 secondes, badge de nombre en attente, notifications bureau et audio, statut par commande et par article.
Règlement Action de clôture en un clic qui règle toutes les commandes ouvertes d'une table avec le mode de paiement choisi.
Menu client Menu web de marque en 24 langues sur handy.cafe/{slug}, avec thème clair et sombre et langue par défaut adaptée à l'appareil.
Paiement en ligne Intégration facultative de Stripe Checkout pour le paiement à la commande, avec repli vers le paiement en espèces à la table.
Imprimante Imprimante de reçus TCP facultative avec coupe automatique et impression automatique à chaque nouvelle commande.

Où Cafétéria se trouve dans l'interface serveur

Cafétéria dispose de deux points d'entrée :

  1. Section Cafétéria dans la barre latérale. C'est l'espace opérationnel pour l'usage quotidien. Il contient cinq onglets : Tables, Plan de salle, Menu, Commandes et Planning. L'onglet Commandes affiche un badge d'attente lorsqu'il y a de nouvelles commandes.
  2. Paramètres > Cafétéria. C'est la zone de configuration. Elle regroupe le profil de l'établissement (slug, nom d'affichage, logo, image d'en-tête, adresse, devise, fuseau horaire), les réglages d'imprimante, la gestion des niveaux et les bascules de fonctionnalités facultatives.

Mise en service d'un café

Lorsque vous activez Cafétéria pour la première fois, le serveur utilise automatiquement votre licence HandyCafe comme jeton d'autorisation. Vous n'avez rien à saisir manuellement. L'assistant de mise en service vous demande ensuite quatre informations :

  1. Slug. Il devient l'URL publique à handy.cafe/{slug}. Les caractères autorisés sont les lettres minuscules, les chiffres et les tirets. Le slug doit contenir entre 3 et 62 caractères. Le système vérifie la disponibilité en temps réel et refuse les slugs réservés comme "admin", "api" ou "dashboard".
  2. Nom d'affichage. Le nom lisible affiché en haut du menu client.
  3. Pays et devise. La devise par défaut des prix du menu. Les prix sont stockés en unités mineures (par exemple les centimes) et affichés avec le symbole de devise configuré.
  4. Fuseau horaire. Utilisé pour les calculs dynamiques de temps de préparation, les horodatages des commandes et les enregistrements de règlement.

Une fois le provisionnement terminé, le café est créé dans la base de données cloud et l'espace de travail Cafétéria s'ouvre. Vous pouvez alors ajouter des niveaux, des tables et des éléments de menu.

Profil de l'établissement

Le profil de l'établissement est modifiable à tout moment dans Paramètres > Cafétéria. Champs principaux :

Champ Rôle
Slug Segment d'URL publique. Changer le slug casse les QR codes existants jusqu'à leur régénération.
Nom d'affichage Affiché en haut du menu client.
Logo Image carrée. WebP recommandé jusqu'à 2 Mo.
Image d'en-tête Large bannière en haut du menu client. WebP recommandé jusqu'à 2 Mo.
Adresse et téléphone Facultatifs. Affichés dans le pied de page du menu.
Devise Appliquée à chaque prix de produit dans le menu.
Pays Utilisé pour la fiscalité et les paramètres régionaux par défaut.
Fuseau horaire Appliqué aux horodatages des commandes et des règlements.
Afficher le temps de préparation dans le menu Bascule. Lorsqu'elle est activée, chaque produit affiche un badge de temps de préparation estimé.

Paramètres de l'imprimante

La section imprimante accepte la configuration suivante :

  • Type. Désactivé ou TCP. L'impression USB directe n'est pas prise en charge dans cette version.
  • IP et port. Adresse réseau de votre imprimante de reçus. La plupart des imprimantes ESC POS TCP écoutent sur le port 9100.
  • Coupe automatique. Ajoute la commande de coupe du papier après chaque reçu imprimé.
  • Impression automatique à la nouvelle commande. Lorsqu'elle est activée, chaque commande entrante déclenche automatiquement l'impression d'un reçu.
  • Notification sonore. Joue une alerte audio en plus de la notification de bureau lorsqu'une nouvelle commande arrive.
  • Test d'impression. Envoie un reçu d'exemple à l'imprimante configurée pour vérifier la connexion.

Résumé de l'architecture

Cafétéria utilise un modèle de données cloud-first. Chaque table, catégorie, produit, commande et enregistrement de règlement est stocké dans la base cloud handy.cafe. Votre serveur HandyCafe local réplique cet état et interroge l'endpoint Orders toutes les 3 secondes pour détecter les nouvelles activités. Les pages côté client sont servies directement par le cloud handy.cafe ; elles n'ont pas besoin que votre serveur soit joignable depuis Internet.

Comme les données vivent dans le cloud :

  • Les QR codes continuent de fonctionner même si le serveur est hors ligne, mais le personnel ne peut pas voir les commandes dans le tableau de bord tant que la connectivité n'est pas rétablie.
  • Les changements de menu sont poussés vers handy.cafe quelques secondes après l'enregistrement.
  • Les commandes passées par les clients arrivent dans le tableau de bord Orders après le prochain sondage de 3 secondes.

Etapes suivantes