Commande QR client — procédure complète

Le parcours complet du client qui scanne un QR code et commande sans compte.

Vue d’ensemble

Un client présent dans le restaurant scanne le QR code de sa table avec son téléphone. Sans créer de compte, il consulte le menu, compose sa commande et la valide. La commande apparaît instantanément en cuisine et dans la liste des commandes du staff, exactement comme une commande saisie manuellement.

Le staff (POS, Serveur) peut toujours créer des commandes manuellement depuis le POS — les deux modes coexistent.

Étape 1 — Configurer le mode d’attribution

Accessible depuis Dashboard → Tables → “Mode attribution” (MAITRE_HOTEL, MANAGER, DAF, OWNER).

Sur l’app Android : icône QR code dans la barre d’actions de l’écran Commandes.

Mode	Comportement
Désactivé	QR codes inactifs. Seul le staff crée les commandes. Page client affiche “non disponible”.
Pré-assigné	Le MAITRE_HOTEL assigne un serveur à chaque table en début de service. La commande QR est automatiquement attribuée à ce serveur.
Premier répondant	Commande non assignée. Tous les serveurs reçoivent une notification. Le premier à appuyer sur “Prendre en charge” obtient la commande.
Charge automatique	La commande est auto-assignée au serveur actif avec le moins de commandes ouvertes dans la journée.
Manuel	Commande non assignée. Le MAITRE_HOTEL reçoit une notification et assigne depuis le dashboard.

Étape 2 — Configurer les tables (mode Pré-assigné uniquement)

Aller sur Dashboard → Tables
Appuyer sur l’icône 👤 de la table à configurer
Sélectionner le serveur dans la liste → Confirmer

Le badge vert “Prénom Nom” s’affiche sur la carte de la table. En fin de service, désassigner en choisissant ”— Aucun serveur —”.

Étape 3 — Générer et afficher le QR code

Sur Dashboard → Tables, appuyer sur l’icône QR de la table
Le QR code s’affiche dans une modale avec l’URL complète
Appuyer sur “Télécharger le QR (SVG)” pour l’imprimer ou l’afficher sur un support de table

L’URL du QR a la forme : https://[domaine]/menu/[token-unique]

Le token est stable — le QR imprimé reste valide même après des modifications de la table.

Étape 4 — Parcours client (scan QR)

Le client scanne le QR code avec l’appareil photo de son téléphone
Le navigateur s’ouvre sur la page du menu (aucune app à installer)
Le client navigue par catégories, ajoute des articles au panier (+/-)
Il peut renseigner son prénom et des remarques (allergies, préférences) — optionnel
Il appuie sur “Commander”
Un écran de confirmation affiche le numéro de commande et le total
Le client peut passer une nouvelle commande depuis la même page

Étape 5 — Prise en charge par le staff

Mode Pré-assigné

Le serveur assigné à la table reçoit la commande directement dans sa liste. Il la voit dès le prochain rafraîchissement (polling 5s) ou via SSE.

Mode Premier répondant

Notification push reçue par tous les serveurs actifs : “Commande QR — Table 5”
Sur le dashboard web ou l’app Android, la commande apparaît avec le bouton “Prendre en charge” (visible en vert sur les commandes sans serveur)
Le premier serveur qui appuie sur ce bouton est assigné à la commande
Les autres serveurs voient le bouton disparaître

Mode Charge automatique

Aucune action requise. Le système attribue automatiquement au serveur le moins chargé. La commande apparaît dans sa liste.

Mode Manuel

Le MAITRE_HOTEL reçoit une notification push
La commande apparaît sans serveur dans la liste des commandes
Le MAITRE_HOTEL assigne depuis le tableau de bord (web ou Android) en modifiant le statut ou en utilisant l’interface d’attribution

Étape 6 — Traitement en cuisine

La commande QR arrive en cuisine exactement comme une commande staff :

Elle apparaît dans Dashboard → Cuisine avec le numéro de table
La cuisine prépare, passe en En préparation puis Prêt
Si le client a laissé un prénom ou des remarques, ils apparaissent dans le champ Notes de la commande (ex : "Client : Marie — sans piment")

Étape 7 — Encaissement

Une fois le service terminé, le serveur encaisse la commande normalement depuis l’écran Commandes (bouton Encaisser) ou le POS. Le flux de paiement est identique à une commande créée manuellement.

Vérification du mode actif

Le mode d’attribution en cours est affiché dans le sous-titre de la page Tables :

“12 tables · Mode QR : Pré-assigné (début de service)”