Aller au contenu principal
Aide

Centre d'Aide

Documentation complète de la plateforme Cocktail-O-Matic — couvrant la machine Pi, le Portail Cloud et la Caisse NFC.

Machine Pi — Guide Utilisateur

L'application Cocktail-O-Matic Pi tourne sur un Raspberry Pi et contrôle votre machine à cocktails. Elle dispose de deux interfaces principales : l'expérience Client (pour commander des cocktails) et le panneau Admin (pour gérer la machine).

Installation & Configuration

Prérequis & Configuration Requise

Avant d'installer Cocktail-O-Matic, assurez-vous d'avoir : Python 3.11 ou supérieur, Node.js 20 ou supérieur, et au moins 2 Go d'espace disque libre. Pour un usage en production, un Raspberry Pi 3 B+, 4 ou 5 avec au moins 1 Go de RAM est supporté (4 Go recommandé). Pour le développement et les tests, toute machine sous Linux, macOS ou Windows convient. Une connexion internet est nécessaire pour l'installation initiale et le téléchargement des paquets.
Astuce

Sur un Raspberry Pi, nous recommandons une carte microSD de 32 Go ou plus (Classe 10 / A2) pour de meilleures performances et suffisamment d'espace pour les recettes, images et logs.

Installation sur Raspberry Pi

C'est la plateforme cible principale.
  1. Flashez Raspberry Pi OS Lite (64 bits, Bookworm) sur une carte microSD avec Raspberry Pi Imager.
  2. Démarrez le Pi, connectez-vous au WiFi et ouvrez un terminal.
  3. Lancez l'installeur en une ligne :
    curl -fsSL https://get.cocktail-o-matic.com | bash
    Cela installe toutes les dépendances (Python, Node.js, paquets système), télécharge la dernière version et configure le démarrage automatique.
  4. Après l'installation, le Pi redémarre et l'interface Cocktail-O-Matic s'ouvre automatiquement en mode kiosque.

Le processus complet prend moins de 15 minutes.

Astuce

Activez SSH avant le premier démarrage (dans les paramètres de Raspberry Pi Imager) pour pouvoir installer à distance sans connecter clavier ni écran.

Installation sur Windows

L'installation Windows est prévue pour le développement et les tests — pas pour le contrôle de pompes en production.
  1. Installez Python 3.11+ depuis python.org (cochez 'Ajouter au PATH' pendant l'installation).
  2. Installez Node.js 20+ depuis nodejs.org.
  3. Clonez le dépôt :
    git clone https://github.com/actabi/Cocktail-O-Matic.git
  4. Lancez le backend :
    cd pi/backend && pip install -r requirements.txt && python run.py
  5. Lancez le frontend :
    cd pi/frontend && npm install && npm run dev
  6. Ouvrez http://localhost:5173 dans votre navigateur.

Les fonctionnalités GPIO et pompes sont simulées sous Windows.

Astuce

Utilisez VS Code avec les extensions Python et ESLint pour la meilleure expérience de développement sous Windows.

Installation sur Linux / macOS

Linux et macOS sont idéaux pour le développement et les tests.
  1. Installez Python 3.11+ via votre gestionnaire de paquets (apt, brew, dnf, etc.).
  2. Installez Node.js 20+ via nvm, brew ou votre gestionnaire de paquets.
  3. Clonez le dépôt :
    git clone https://github.com/actabi/Cocktail-O-Matic.git
  4. Lancez le backend :
    cd pi/backend && pip install -r requirements.txt && python run.py
  5. Lancez le frontend :
    cd pi/frontend && npm install && npm run dev
  6. Ouvrez http://localhost:5173 dans votre navigateur.

Sur une machine Linux native avec support GPIO, le contrôle des pompes fonctionne comme sur un Raspberry Pi.

Astuce

Sur Linux avec matériel GPIO (ex. Orange Pi, Jetson), installez la bibliothèque compatible RPi.GPIO pour votre carte pour activer le contrôle réel des pompes.

Expérience Client

Client — Menu Cocktails

L'écran principal client affiche tous les cocktails disponibles dans une belle grille photo. Chaque carte montre le nom du cocktail, l'image et la catégorie. Les cocktails non réalisables (ingrédients manquants) sont grisés ou masqués selon les paramètres. Appuyez sur un cocktail pour voir ses détails et le commander.
Astuce

Utilisez la barre de filtres en haut pour filtrer par spiritueux (Vodka, Rhum, Gin...), sans alcool ou profil gustatif. Le filtre 'Disponibles uniquement' masque les cocktails avec des ingrédients manquants.

Client — Détail Cocktail et Commande

La vue détail affiche la description du cocktail, la liste des ingrédients (avec quantités) et une grande photo. Vous pouvez ajuster la taille de service (verre vs shaker) si configuré, et voir le prix si la tarification est activée. Appuyez sur 'Commander' pour lancer la production. Si un ingrédient est en rupture, une option de remplacement peut apparaître.
Astuce

En mode party, les clients peuvent ajouter plusieurs cocktails au panier avec tarification dégressive. Le sélecteur de force permet d'ajuster le niveau d'alcool.

Client — Progression de Production

Après la commande, un écran de progression animé en temps réel montre le cocktail en cours de préparation. Chaque étape de production est affichée : quelle pompe dose, le nom de l'ingrédient et la barre de progression. Les étapes manuelles (comme ajouter de la glace ou décorer) affichent des instructions pour le barman. Une animation de fin apparaît quand la production est terminée.
Astuce

La vue de progression utilise WebSocket pour les mises à jour en temps réel — vous voyez les ml exacts dosés en direct.

Client — Mode Party et Kiosque

Le mode party est une interface client simplifiée conçue pour les événements et le self-service. Il supprime l'accès admin et affiche un parcours de commande épuré. Le mode kiosque fait démarrer le Pi directement sur l'interface client en plein écran, parfait pour les machines sans surveillance. Un QR code peut être affiché pour que les clients commandent depuis leur téléphone.
Astuce

Le mode party supporte la commande multi-cocktails avec panier, tarification dégressive et plusieurs méthodes de paiement (espèces, terminal CB, bracelet NFC).

Client — Parcours de Paiement

Quand la tarification est activée, les clients voient les prix des cocktails et peuvent sélectionner un mode de paiement avant le lancement de la production. Méthodes supportées : gratuit (pas de paiement), espèces, terminal de paiement (CB) et bracelet NFC cashless. Pour le paiement CB, le Pi communique avec le terminal de paiement connecté. Pour le NFC, le client approche son bracelet pour débiter son portefeuille prépayé.

Pour la gestion des bracelets NFC, voir Scanner un Bracelet dans la Caisse NFC.

Astuce

Les commandes multi-cocktails bénéficient de prix dégressifs — plus il y a de cocktails dans une commande, meilleur est le prix unitaire.

Client — Recharge de Bouteille

Quand un ingrédient est bas ou vide, les clients (ou le personnel) peuvent déclencher une recharge sans accéder au panneau admin. Si un code PIN de recharge est configuré dans les Paramètres, saisissez le PIN sur le clavier numérique. Puis sélectionnez la taille de la bouteille (700ml par défaut) et confirmez. Le niveau de remplissage est remis au nouveau montant. Utile pendant les événements quand l'accès admin n'est pas pratique.
Astuce

Définissez un code PIN de recharge dans Paramètres → Écran Client pour éviter les recharges non autorisées tout en permettant des changements de bouteille rapides.

Client — Vérification du Solde NFC

Quand les paiements NFC sont activés, les clients peuvent vérifier le solde de leur bracelet directement depuis l'écran de cocktails en appuyant sur l'icône de solde en haut à droite. Scannez le bracelet pour voir le solde actuel, quels cocktails vous pouvez vous offrir et combien il manque pour les autres. Aucune intervention du personnel requise.

Voir Détail du Portefeuille dans la Caisse NFC pour les opérations de recharge et remboursement.

Astuce

La vérification de solde montre aussi des suggestions de cocktails accessibles — utile pour les invités qui décident quoi commander avec leur crédit restant.

Sortir du Mode Kiosque

En mode kiosque, le Pi démarre directement sur l'écran cocktails client sans accès admin visible. Pour sortir du mode kiosque et revenir à la connexion admin : utilisez le raccourci clavier Ctrl+Shift+A, ou appuyez 5 fois rapidement dans le coin inférieur droit de l'écran. Cela ouvre la page de connexion admin.
Astuce

Formez votre personnel d'événement au geste des 5 taps — c'est le moyen le plus rapide d'accéder à l'admin quand aucun clavier n'est connecté.

Administration

Admin — Tableau de Bord

Le tableau de bord admin donne une vue d'ensemble de votre machine : statuts des pompes avec jauges de remplissage, activité de production récente, accès rapide à toutes les sections admin. Chaque carte de pompe montre l'ingrédient connecté, le niveau de remplissage actuel (en jauge visuelle) et un indicateur de statut (prêt, vide, erreur).
Astuce

Le tableau de bord se met à jour en temps réel via WebSocket — les niveaux des pompes diminuent à mesure que les cocktails sont produits.

Admin — Tableau de Bord

Admin — Gestion des Pompes

Gérez toutes les pompes connectées : ajouter/modifier/supprimer des pompes, assigner des pins GPIO, définir le type de pompe (DC, pas-à-pas, vanne), configurer le débit, le volume du tube et la capacité. Chaque pompe peut être testée individuellement (marche avant/arrière), calibrée et amorcée. Les opérations en masse permettent de faire tourner ou inverser toutes les pompes en une fois pour la maintenance.
Astuce

Utilisez l'assistant de calibration pour affiner les débits — il dose un volume test et vous entrez le volume réellement mesuré pour calculer automatiquement le facteur de correction.

Admin — Gestion des Pompes

Admin — Gestion des Ingrédients

Créez et gérez les ingrédients : nom, type (spiritueux, mixer, sirop, frais...), coût unitaire et image optionnelle. Les ingrédients sont liés aux pompes — une fois un ingrédient assigné à une pompe, il devient disponible pour les recettes. Les groupes d'ingrédients permettent la substitution automatique (ex. n'importe quelle marque de cola peut en remplacer une autre).
Astuce

Définissez le coût des ingrédients pour activer le calcul automatique du coût des cocktails et le suivi des marges dans le tableau de bord des prix.

Admin — Gestion des Ingrédients

Admin — Gestion des Recettes

Créez et éditez des recettes de cocktails avec un éditeur visuel. Chaque recette a : nom, description, image, catégorie, collection et étapes de production. Les étapes peuvent être automatisées (la pompe dose X ml d'ingrédient) ou manuelles (instructions pour le barman comme 'ajouter de la glace' ou 'secouer'). Les étapes peuvent être réordonnées par glisser-déposer, exécutées en parallèle ou en série. Import/export des recettes en fichiers ZIP avec images.
Astuce

Utilisez les groupes d'ingrédients dans les étapes de recette pour la substitution automatique — si l'Absolut Vodka est vide mais la Smirnoff est connectée, la recette fonctionne toujours.

Admin — Gestion des Recettes

Admin — Configuration GPIO et Cartes

Configurez les cartes d'extension I2C (MCP23017, XL9535) qui contrôlent vos pompes. Chaque carte fournit 16 pins GPIO. Définissez les adresses I2C, la polarité (actif HAUT ou BAS) et testez les pins individuellement. Le système détecte automatiquement les cartes connectées au démarrage.
Astuce

Vous pouvez utiliser plusieurs cartes pour dépasser 16 pompes — jusqu'à 40+ pompes par machine.

Admin — Calibration des Pompes

L'assistant de calibration interactif aide à définir des débits précis. Pour chaque pompe : 1) Définir le volume cible (ex. 100ml), 2) Faire tourner la pompe, 3) Mesurer le volume réellement dosé, 4) Le système calcule automatiquement le débit corrigé. Vous pouvez aussi configurer le volume du tube (quantité de liquide dans le tube) pour un amorçage précis.
Astuce

Calibrez les pompes après avoir changé les tubes ou switché vers des ingrédients de viscosité différente.

Admin — Système d'Événements

Configurez des événements qui déclenchent des actions pendant le cycle de vie du cocktail. Événements : commande reçue, production démarrée, étape démarrée, étape terminée, production terminée, erreur. Actions : jouer un son, exécuter un script Python, envoyer un webhook, activer un pin GPIO. Plusieurs actions peuvent être chaînées par événement.
Astuce

Utilisez les événements audio pour jouer un son de célébration quand un cocktail est prêt, ou un webhook pour mettre à jour un affichage externe.

Admin — Système d'Événements

Admin — Paramètres Système

Configurez les paramètres globaux : apparence (thème client, thème admin, logo personnalisé, couleurs de marque), préférences de langue, activation du mode party, paramètres du mode kiosque, mode de service (verre vs shaker), paramètres de production (dosage parallèle, limites de puissance). Contrôles système : arrêt, redémarrage, vérification des mises à jour.
Astuce

Les paramètres d'apparence vous permettent de personnaliser la machine en marque blanche avec votre propre logo et palette de couleurs — parfait pour les événements de marque.

Admin — Paramètres Système

Admin — Gestion des Utilisateurs

Gérez les comptes utilisateurs avec 5 niveaux de rôles : Superadmin (accès total), Admin (tout sauf la gestion des utilisateurs), Opérateur (contrôle de production), Éditeur (gestion des recettes/ingrédients), Invité (commande uniquement). Créez des comptes avec email, mot de passe et rôle. La hiérarchie des rôles garantit que les utilisateurs ne voient que les fonctionnalités adaptées à leur niveau d'accès.
Astuce

Pour les événements, créez un seul compte Opérateur pour le personnel — ils peuvent faire fonctionner la machine mais ne peuvent pas modifier les recettes ou les paramètres.

Admin — Licence et Activation

Consultez le statut de votre licence actuelle (Communauté, Personnel, Pro, Événement), la date d'expiration et les limites de fonctionnalités. Entrez une clé d'activation depuis le Portail Cloud pour activer ou mettre à niveau votre licence. La page licence affiche les fonctionnalités débloquées (limite de pompes, branding, analytiques, etc.) et l'ID Machine nécessaire pour l'activation liée au matériel.

Voir Détail de Licence dans le Portail Cloud pour la gestion des clés d'activation et la liaison matérielle.

Astuce

Votre ID Machine est affiché sur cette page — vous devrez le saisir dans le Portail Cloud lors de la liaison d'une licence à votre Pi.

Admin — Tarification des Cocktails

Configurez la tarification des cocktails : activer/désactiver la tarification, définir les prix par recette, configurer les prix de vente et voir les calculs de coût automatiques basés sur les coûts des ingrédients. Le tableau de bord des marges affiche le coût, le chiffre d'affaires et la marge bénéficiaire pour chaque cocktail. Configurez les règles de prix dégressifs pour les commandes multi-cocktails et la tarification par shaker.
Astuce

Activez d'abord la tarification dans les Paramètres, puis définissez les prix individuels des cocktails dans la section Recettes.

Admin — Analytiques Cocktails

Consultez les statistiques de production : total de cocktails servis, recettes les plus populaires, historique de production avec filtrage par date, analytiques de revenus et profits. Les données sont synchronisées vers le Portail Cloud pour le stockage long terme et la comparaison entre machines.

Voir Analytiques dans le Portail Cloud pour le reporting multi-machines et les exports CSV.

Astuce

Les données analytiques sont envoyées au Cloud via le heartbeat — assurez-vous que votre Pi a une connexion internet pour la synchronisation cloud.

Système & Configuration

Admin — Historique des Commandes

Consultez un journal complet de toutes les commandes de cocktails avec date, nom de recette, prix, coût, marge, méthode de paiement (CB, NFC, Gratuit) et numéro de référence. Filtrez par période (Aujourd'hui, Cette Semaine, Ce Mois, Tout). Ces données sont aussi synchronisées vers le Portail Cloud pour un reporting centralisé sur plusieurs machines.
Astuce

Utilisez l'historique des commandes pour réconcilier les paiements en espèces et par carte à la fin d'un événement.

Admin — Catégories

Organisez les recettes en catégories pour faciliter la navigation. Créez des catégories, modifiez leurs noms et traduisez-les en plusieurs langues (FR/EN). Les catégories apparaissent comme boutons de filtre sur la grille de cocktails client. Chaque recette peut appartenir à plusieurs catégories. Supprimez les catégories dont vous n'avez plus besoin — les recettes resteront mais perdront cette étiquette.
Astuce

Créez des catégories comme 'Signature', 'Classiques', 'Sans Alcool' pour aider les clients à trouver rapidement les cocktails.

Admin — Logs Système et Monitoring

Surveillez la santé de votre Pi : utilisation CPU, utilisation RAM, température et espace disque. Le visualiseur de logs en direct affiche les journaux de l'application en temps réel avec filtrage par niveau (DEBUG, INFO, WARNING, ERROR). Le défilement automatique vous garde aux dernières entrées. Téléchargez le fichier de logs complet pour le dépannage. Utilisez les boutons Redémarrer et Éteindre pour un contrôle système sécurisé.
Astuce

Si la machine se comporte de façon inattendue, vérifiez les logs avec le filtre ERROR — la plupart des problèmes sont consignés avec des messages d'erreur clairs.

Admin — Logs Système et Monitoring

Admin — Configuration Réseau

Basculez entre deux modes réseau : Hotspot (le Pi crée son propre réseau WiFi pour la connexion directe des appareils) et Client WiFi (le Pi se connecte à votre WiFi existant). En mode Hotspot, vous voyez le SSID et le mot de passe pour vous connecter. Activez 'Garder le hotspot au redémarrage' pour les événements où vous voulez que le Pi démarre toujours en mode hotspot. Le mode Client WiFi est nécessaire pour la synchronisation Cloud et la validation de licence.
Astuce

Pour les événements sans WiFi, utilisez le mode Hotspot — les invités peuvent se connecter directement au WiFi du Pi pour commander des cocktails depuis leur téléphone.

Besoin d'Aide Supplémentaire ?

Notre équipe est là pour vous accompagner sur toutes les questions liées à la plateforme.

Contacter le Support Voir les Tarifs