HandyCafe Docs
owner

Gestion du menu

L'onglet Menu de Cafétéria est l'endroit où vous construisez le catalogue que les clients voient à handy.cafe/{slug}. Les menus se composent de catégories et de produits. Les produits peuvent avoir des groupes de variantes pour des choix comme Taille ou Garnitures.

Structure

Niveau Rôle
Catégorie Une section du menu, par exemple "Boissons chaudes" ou "Burgers". Chaque catégorie possède une icône et un ordre de tri.
Produit Un article commandable à l'intérieur d'une catégorie. Il contient le nom, la description, la photo, le prix, le taux de TVA et le temps de préparation.
Groupe de variantes Facultatif. Un ensemble de choix rattaché à un produit, par exemple "Taille : petite, moyenne, grande". Chaque variante a un supplément de prix.

Catégories

Chaque catégorie possède les champs suivants :

Champ Signification
Nom Affiché comme en-tête de section dans le menu client.
Icône Nom d'une icône MDI (Material Design Icons). Choisissez-en une dans le sélecteur d'icônes.
Ordre de tri Entier. Les nombres les plus faibles apparaissent en premier. Ajustez-le par glisser-déposer ou avec les boutons monter et descendre.
Actif Lorsqu'il est désactivé, la catégorie et tous ses produits sont masqués dans le menu client, sans être supprimés.

Ajouter une catégorie

  1. Ouvrez Cafétéria > Menu.
  2. Cliquez sur Add Category.
  3. Saisissez un nom.
  4. Cliquez sur la boîte d'icône et sélectionnez une icône MDI. Le sélecteur ouvre une liste recherchable. Essayez des mots-clés comme "coffee", "burger" ou "pizza".
  5. Enregistrez. La catégorie apparaît dans l'éditeur de menu.

Réordonner les catégories

Faites glisser la poignée d'une ligne de catégorie pour la déplacer. La nouvelle position est enregistrée dès le relâchement. Vous pouvez aussi utiliser les flèches monter et descendre pour un placement plus précis.

Suppression douce

Supprimer une catégorie qui possède des produits dépendants la marque comme inactive au lieu de supprimer l'enregistrement. Cela préserve l'historique des commandes qui référence les identifiants de produits d'origine. Pour la restaurer, réactivez la catégorie depuis l'interface d'administration.

Produits

Chaque produit possède les champs suivants :

Champ Signification
Catégorie Catégorie parente.
Nom Visible par le client.
Description Markdown pris en charge. Apparaît dans la fiche de détail du produit lorsque le client touche l'article.
Ingrédients Ligne courte sous la description. Utilisez-la pour les allergènes ou les points forts des ingrédients.
Prix de base Prix avant variantes. Stocké en unités mineures (par exemple centimes), mais saisi en unités monétaires entières.
Taux de TVA Pourcentage. Appliqué lors de l'affichage des totaux sur le reçu client.
Unité Libellé facultatif comme "ml" ou "g". S'affiche à côté du prix.
Photo Image du produit. Tous les formats sont acceptés. Le format WebP jusqu'à 2 Mo est recommandé pour obtenir les menus les plus rapides.
Suivre le stock Lorsqu'il est activé, le produit conserve une quantité en stock qui diminue à chaque commande.
En stock Quantité de stock actuelle. Les commandes échouent côté client lorsque le stock atteint zéro et le produit se masque automatiquement.
Actif Lorsqu'il est désactivé, le produit est masqué dans le menu client.
Ordre de tri Position dans la catégorie.
Temps de préparation Estimation de secours fixe en minutes. Voir Temps de préparation dynamique ci-dessous.

Importer une photo

  1. Ouvrez le produit.
  2. Cliquez sur la zone de photo.
  3. Sélectionnez une image sur votre ordinateur. Tous les formats sont acceptés par l'endpoint d'envoi.
  4. Le serveur traite le fichier, stocke un identifiant d'actif, le type MIME et le checksum, puis renvoie une URL.
  5. La photo apparaît immédiatement dans l'éditeur et sur le menu client en quelques secondes.

Remplacez une photo en cliquant sur l'image existante et en téléversant un nouveau fichier. L'ancien fichier est remplacé.

Markdown dans les descriptions

Les descriptions de produits prennent en charge Markdown. Usages courants :

  • Mettez des éléments en valeur avec **strong**.
  • Ajoutez des retours à la ligne pour les descriptions multiligne.
  • Utilisez de courtes listes pour les ingrédients ou les accords.

Evitez les titres (H1 à H6) dans les descriptions de produits. Le menu client affiche la description dans une fiche compacte et les titres y paraissent maladroits.

Groupes de variantes

Les variantes capturent les choix du client qui modifient le prix ou la configuration. Un produit peut avoir plusieurs groupes de variantes, par exemple Taille et Garnitures sur un même burger.

Chaque variante possède :

Champ Signification
Nom Libellé visible par le client, par exemple "Taille" ou "Fromage supplémentaire".
Ecart de prix Montant ajouté au prix de base lorsque cette variante est sélectionnée. Peut être nul ou négatif.
Obligatoire Lorsqu'il est activé, le client doit choisir au moins une variante de ce groupe avant d'ajouter au panier.
Ordre de tri Position dans le groupe.

Créer un groupe de variantes

  1. Ouvrez le produit.
  2. Faites défiler jusqu'à la section Variants.
  3. Cliquez sur Add Variant.
  4. Saisissez le nom et l'écart de prix. Activez Required si le choix est obligatoire.
  5. Enregistrez.

Répétez l'opération pour chaque option du groupe. Un groupe "Taille" typique comporte trois lignes : Petite avec un écart de 0, Moyenne avec un écart de +1,00, Grande avec un écart de +2,00.

Temps de préparation dynamique

HandyCafe peut calculer une estimation de temps de préparation en temps réel pour chaque produit, à partir des performances réelles de la cuisine. Cela améliore la précision du badge d'estimation affiché dans le menu client et sur les commandes actives.

Paramètre Effet
Temps statique Stocké sur le produit. Utilisé lorsqu'il n'y a pas assez d'historique pour calculer une valeur dynamique.
Estimation dynamique Calculée à partir des 30 derniers jours d'historique de commandes. Le temps moyen de préparation par produit est multiplié par un facteur d'activité dérivé de la longueur de la file actuelle. Le multiplicateur est borné entre 1,0 et 2,0. La valeur finale est bornée entre 1 et 120 minutes.

Le réglage "Show Prep Time on Menu" dans le profil de l'établissement contrôle si le badge d'estimation est visible par les clients. Le personnel voit toujours l'estimation sur le tableau de bord Orders.

Suivi du stock

Activez Track Stock produit par produit pour éviter de vendre des articles en rupture.

  • Lorsqu'une commande est passée, le stock diminue de la quantité commandée.
  • Lorsque le stock atteint zéro, le produit est automatiquement masqué du menu client jusqu'à ce que vous mettiez la quantité à jour.
  • Pour réapprovisionner, modifiez le produit et saisissez la nouvelle valeur In Stock.

Les produits sans Track Stock se comportent comme un inventaire infini et ne se masquent jamais automatiquement.

Réordonner les produits dans une catégorie

Faites glisser la poignée pour déplacer un produit vers le haut ou le bas. Le nouvel ordre est enregistré au relâchement. Le menu client reflète le nouvel ordre après la prochaine actualisation du menu, qui a lieu à chaque chargement de session.

Conseils

  • Commencez avec 6 à 10 catégories. Trop de catégories rendent la navigation du menu client lente.
  • Utilisez des photos très contrastées et bien éclairées. Les photos sombres ou bruitées réduisent la conversion en commande.
  • Gardez les descriptions sous 120 caractères lorsque c'est possible. Les descriptions trop longues repoussent le bouton Ajouter au panier hors du premier écran sur les téléphones.
  • Définissez des temps de préparation statiques réalistes. Le système dynamique met 30 jours à apprendre. D'ici là, le chiffre statique est ce que voient les clients.
  • Pour les articles avec beaucoup de choix, répartissez-les sur deux groupes de variantes plutôt qu'une énorme liste. "Taille" plus "Lait" est plus clair que "Taille avec lait".