Commandes

L'onglet Commandes est le tableau de bord en direct de toutes les commandes Cafétéria passées par vos clients. Il interroge le cloud toutes les 3 secondes et signale les nouvelles activités par une notification bureau, une alerte audio et un badge de nombre en attente sur l'en-tête de l'onglet.

Disposition

La page Commandes comporte deux zones :

Sondage en direct

Le tableau de bord Orders interroge /v1/cafeteria/admin/orders/poll toutes les 3 secondes. Chaque nouvelle commande déclenche :

1. Une notification de bureau avec le code de table et le nombre d'articles.
2. Une alerte audio sur les haut-parleurs du serveur si les notifications sonores sont activées dans Paramètres > Cafétéria.
3. Une augmentation du badge de nombre en attente sur l'onglet Orders.
4. Une impression automatique du reçu si l'imprimante est configurée avec l'option Auto Print on New Order.

Le badge reste visible tant que toutes les commandes au statut placed ou confirmed n'ont pas avancé à un état ultérieur ou n'ont pas été écartées. Le badge est visible globalement dans la section Cafétéria de la barre latérale ; vous n'avez pas besoin de laisser l'onglet Orders ouvert pour le voir.

Cycle de vie d'une commande

Chaque commande suit une séquence d'états définie.

La barre d'actions de chaque carte de commande affiche le prochain état disponible. L'avancement se fait en un clic. L'interface utilise un modèle de mise à jour optimiste : le nouveau statut s'affiche immédiatement. Si le serveur refuse le changement, le statut revient en arrière et une notification d'erreur apparaît.

Statut par article

Certaines commandes contiennent plusieurs articles qui se terminent à des moments différents. Par exemple, un burger est prêt avant une pizza. Le statut par article permet de suivre chaque ligne indépendamment.

Chaque article possède sa propre liste déroulante avec cinq options : placed, preparing, ready, served, cancelled. Chaque article possède aussi trois horodatages :

• created_at est défini à l'arrivée de la commande.
• ready_at est défini la première fois que l'article passe à ready.
• served_at est défini lorsque l'article passe à served.

Le menu client affiche un badge à côté de chaque ligne afin que le client voie quels articles sont prêts ou en route.

Annuler une commande

1. Ouvrez la carte de commande.
2. Cliquez sur Cancel.
3. Confirmez dans la boîte de dialogue qui s'affiche.
4. La commande passe à l'état cancelled. Elle reste dans l'historique mais disparaît de la vue en direct par défaut.

L'annulation s'applique à toute la commande. Pour annuler une seule ligne, changez plutôt le statut de cet article à cancelled.

Règlement (Settle Check)

Le règlement clôt toutes les commandes ouvertes d'une table en une seule étape. Utilisez-le lorsque le client part et souhaite régler toute la note.

1. Ouvrez la table depuis la page Tables ou depuis le menu d'actions du plan de salle.
2. Cliquez sur Settle Check.
3. La fenêtre répertorie toutes les commandes de la table qui ne sont pas déjà à l'état served.
4. Choisissez un mode de paiement. Les options sont : Cash, Card, Online, Other.
5. Confirmez.

Le serveur effectue les actions suivantes de manière atomique :

• Chaque commande ouverte de la table passe à served avec payment_status=paid.
• Un enregistrement cafeteria_settlements est créé avec le montant total, le mode de paiement et l'heure de création.
• Une piste d'audit settlement-orders enregistre quelles commandes appartiennent à ce règlement.
• Le code de sécurité de la table expire afin que le QR devienne invalide.
• La table revient à l'état idle.

Si vous avez choisi Online comme mode de paiement, l'enregistrement de règlement est marqué comme payé en ligne. Aucune charge Stripe n'est déclenchée par cette action. Le paiement en ligne côté client est géré au moment de la commande ; l'action de règlement enregistre le flux de trésorerie pour votre comptabilité.

Minuteur d'ouverture

Chaque table possède un horodatage opened_at défini lorsque le client est installé. Les pages Plan de salle et Tables affichent un minuteur en direct depuis ce moment. Cela aide le personnel à repérer les tables actives depuis longtemps sans commande, ou celles qui approchent peut-être de la fin d'une session.

Le minuteur revient à zéro lors de Close Table ou Settle Check.

Affichage dynamique du temps de préparation

Lorsque le temps de préparation dynamique est actif pour un produit, la carte de commande affiche l'estimation à côté du nom de l'article. Le personnel voit l'estimation même lorsque la bascule Show Prep Time on Menu est désactivée pour les clients.

L'estimation se met à jour chaque fois qu'une nouvelle commande est passée et chaque fois qu'une commande se termine. Le système apprend de votre cadence réelle en cuisine.

Comportement des notifications de nouvelle commande

Les notifications sont déclenchées globalement, pas par onglet. Vous recevez donc des alertes lorsque vous parcourez une autre partie du serveur HandyCafe, par exemple le panneau d'administration ou les paramètres. L'alerte audio est activée ou désactivée depuis Paramètres > Cafétéria > Sound Notification.

Les notifications de bureau nécessitent que le système d'exploitation ait accordé à HandyCafe l'autorisation d'afficher des notifications. Si vous ne voyez pas de notification après une nouvelle commande, vérifiez les paramètres de notifications de votre système.

Conseils

• Utilisez les onglets de statut pour répartir la charge. Un écran filtré sur preparing affiche la file de la cuisine. Un autre écran sur ready montre ce qui doit être livré.
• Settle Check est la façon la plus rapide de clôturer une table. Utilisez Cancel sur des commandes individuelles uniquement en cas d'erreur explicite.
• Formez le personnel à faire avancer les statuts de manière cohérente. L'estimateur dynamique de temps de préparation apprend à partir de ces signaux, donc sauter des états réduit sa précision.
• Consultez périodiquement les commandes annulées et remboursées depuis l'endpoint d'administration pour repérer les tendances d'erreur du personnel.