Comment installer l'agent d'impression en cuisine

Ce que ce petit programme fait au poste

L'agent d'impression est un petit programme léger qui tourne à l'intérieur du restaurant et fait le pont entre qmen.us, qui est dans le cloud, et l'imprimante thermique, qui est sur votre réseau local. Le cloud n'atteint pas l'imprimante derrière le routeur : c'est donc lui qui se connecte vers l'extérieur, demande de temps en temps s'il y a un nouveau ticket, l'imprime et confirme. Il n'y a aucun port à ouvrir sur le routeur.

Il existe en version pour trois appareils : Linux (un seul fichier AppImage), Windows (un seul fichier .exe) et Android (une appli du projet, avec imprimante en Bluetooth ou en réseau). Sur les trois, la configuration est la même paire : l'adresse de la Cuisine et le jeton que vous donne le tableau de bord. qmen.us continue de tourner dans le navigateur, sans appli en boutique ; seul lui s'installe, et seulement sur cet appareil de la cuisine.

Pourquoi avoir le ticket sur papier vaut la peine

• Le ticket sort tout seul, sans que personne clique. Le serveur envoie depuis la Table, qmen.us crée le travail d'impression et le programme le récupère au battement suivant, toutes les 3 secondes par défaut.
• Un ticket en double vaut mieux qu'une commande perdue. Imprimante sans papier, éteinte ou internet instable : l'échec est signalé et le travail retourne dans la file. Le serveur le repropose après une minute sans confirmation et réessaie jusqu'à dix fois avant d'abandonner.
• Chaque poste n'imprime que ce qui le concerne. Adresse et jeton sont propres à chaque Cuisine, donc le grill ne reçoit pas le dessert. Une maison avec deux postes et deux thermiques fait tourner deux agents, chacun avec son config.
• Le même appareil peut imprimer et afficher l'écran. Avec l'écran activé dans le config, l'écran de la cuisine s'ouvre dans le navigateur au démarrage. Si vous ne voulez que l'écran, inutile : il suffit d'ouvrir le lien de l'écran.

Comment installer l'agent d'impression en 7 étapes

Sept étapes, du bouton dans le tableau de bord jusqu'au programme qui démarre tout seul quand l'appareil s'allume.

1. Activez l'impression du poste dans le tableau de bord

   Dans le tableau de bord, ouvrez Cuisines. Chaque poste est une carte, et elle contient le bloc Impression avec le bouton Configurer. La fenêtre Impression en cuisine s'ouvre : activez l'interrupteur Imprimer les commandes, choisissez la Largeur du papier (80 mm ou 58 mm), le nombre d'Exemplaires voulus (de 1 à 5) et touchez Enregistrer. La carte affiche alors Activée, avec la largeur et le nombre d'exemplaires à côté.

2. Copiez l'adresse et le jeton

   Dans la même fenêtre, sous Infos pour l'appli d'impression, il y a deux lignes : l'adresse de la Cuisine et le jeton, caché sous des points. L'œil le révèle et le bouton à côté le copie. Si (créé à l'enregistrement) apparaît, c'est que vous n'avez pas encore enregistré. Gardez bien le jeton : il vaut mot de passe de l'impression. Le lien Générer un nouveau jeton invalide aussitôt le précédent.

3. Téléchargez la version de votre appareil

   Sur l'appareil de la cuisine, téléchargez le fichier de votre système : sous Windows un fichier .exe (Windows 7 ou plus), sous Linux un AppImage qui tourne sur n'importe quelle distribution. C'est un seul fichier, dans un dossier. Sur Raspberry Pi et autres ARM, générez l'AppImage sur l'appareil lui-même ou lancez directement depuis le code source, avec Python 3.9 ou plus récent.

4. Collez l'adresse, le jeton et l'imprimante

   À côté du programme se trouve un config.json avec base (l'adresse), token, printer (l'imprimante) et poll (toutes les combien de secondes il interroge). Sous Windows ce fichier se trouve dans le même dossier que le .exe ; sous Linux, dans ~/.config/pedis-agent/config.json. Le printer dépend de la connexion : network:192.168.0.50 pour une imprimante réseau, windows: pour la file par défaut de Windows, file:/dev/usb/lp0 pour de l'USB sous Linux, serial:/dev/ttyUSB0 pour du série.

   Astuce : Sous Windows, installez la thermique comme file Generic / Text Only : un pilote qui dessine la page brouille les commandes et le papier sort sale. Sous Linux, si /dev/usb/lp0 donne permission refusée, lancez sudo usermod -aG lp $USER et reconnectez-vous.

5. Faites un test avant le service

   Avant de compter sur le déjeuner, lancez un passage avec l'imprimante dummy seulement : le ticket s'affiche à l'écran, sans gaspiller de papier. Puis envoyez une commande de test par la Table et regardez le papier sortir : en-tête avec la maison, la table, le numéro de commande, le serveur, le poste et l'heure, et chaque article en gros caractères, avec le complément et la remarque dessous.

6. Faites-le démarrer tout seul

   La cuisine n'a pas le temps de penser à ouvrir un programme. Avec pedis-agent --install, Windows crée une tâche qui démarre à l'ouverture de session et Linux crée un service utilisateur qui redémarre tout seul s'il plante. Sur un appareil où personne n'est connecté, comme un Raspberry Pi derrière la TV, lancez aussi sudo loginctl enable-linger. Pour annuler, pedis-agent --uninstall.

7. Sur une tablette Android, c'est le même chemin

   Si la cuisine utilise une tablette, l'appli Android (5.0 ou plus) fait le même travail et affiche en plus l'écran de la cuisine. Sur l'écran d'accueil, vous remplissez Adresse, Jeton et Imprimante (bt: et l'adresse MAC de la thermique Bluetooth déjà appairée, ou net: et l'IP de celle en réseau) et touchez Enregistrer et démarrer. Accordez la permission Bluetooth et sortez l'appli de l'économie de batterie, sinon l'impression s'arrête quand l'écran s'éteint.

Questions fréquentes

Glossaire

Agent d'impression

Le petit programme qui tourne sur l'appareil de la cuisine, récupère les tickets sur qmen.us, imprime sur la thermique et confirme.

Jeton d'impression

Le mot de passe de l'impression d'une Cuisine. Il s'affiche dans le tableau de bord, va dans la config de l'agent et peut être changé quand vous voulez.

Cuisine

L'écran où les commandes apparaissent et avancent de En préparation jusqu'à PRÊT.

ESC/POS

Le langage que comprennent les imprimantes thermiques de tickets. C'est ce que l'agent génère pour chaque ticket.

Ressources associées