Chapitre 1 — Écran de cuisine (KDS)

L'écran de cuisine est une page dans le navigateur qui s'ouvre sur un écran en cuisine ou au bar et affiche en direct les bons de commande. Le personnel de cuisine s'en sert pour faire avancer les commandes de « nouveau » à « prêt ». Il est connecté à Internet et reçoit les commandes en temps réel.

⚠️ Langue de l'application : cette application s'ouvre par défaut en allemand et la traduction persane de la cuisine est incomplète — c'est-à-dire que même si vous passez la langue en persan, certains libellés (comme Done, Preparing, Refresh) restent en anglais. Les libellés indiqués entre parenthèses dans ce chapitre correspondent exactement à ce que vous voyez à l'écran.

1-1. Connexion

• Connectez-vous avec votre e-mail et mot de passe (le même compte que la caisse). La connexion propose aussi un onglet Téléphone et, si l'authentification à deux facteurs est activée, une étape Code s'ajoute ; il existe également des options de connexion sociale ainsi que des pages d'inscription / de mot de passe oublié.
• Écran de verrouillage / PIN rapide : comme à la caisse, si l'utilisateur dispose d'un PIN, il peut verrouiller le tableau et le déverrouiller avec son PIN (sans se déconnecter complètement), changer d'utilisateur depuis la liste ou ajouter un autre caissier.

1-2. Choix de l'établissement et du poste (avant le tableau)

Après la connexion, un écran distinct vous demande de choisir l'établissement (Location) et le poste (Station) de cet écran :

• Tout poste déjà pris par un autre utilisateur apparaît désactivé.
• Après la sélection, une barre de progression en pourcentage charge les données initiales, puis vous accédez au tableau. Si une partie des données n'a pas été mise en cache, le message « le tableau s'ouvre, mais… » s'affiche avec un bouton Réessayer.
• En cas de problème : « la session de cuisine n'a pas pu être chargée » (→ aller à la connexion) ou « les établissements n'ont pas pu être chargés » (→ réessayer).

Cette étape est différente du choix de la destination (Destination) à l'intérieur du tableau ; ce dernier est expliqué à la section 1-3.

1-3. Le tableau des commandes

L'écran principal est un tableau composé de colonnes d'état qui défilent chacune indépendamment :

• Nouveau (New) : commandes qui viennent d'arriver.
• En préparation (Preparing) : travaux commencés.
• Prêt/Terminé (Completed) : travaux terminés.
• Annulé (Cancelled) : commandes annulées (en rouge).

En tête de chaque colonne figurent le nombre de bons et le nombre d'articles ; une colonne vide affiche son propre message (« No new work », « Nothing preparing », « No completed work », « Nothing cancelled »).

La barre supérieure du tableau

• Choix de la destination (Destination) : choisir quel moniteur/poste de cuisine cet écran doit afficher (par exemple « cuisine chaude » ou « bar »). S'il n'existe qu'une seule destination, elle est sélectionnée automatiquement et votre dernier choix est mémorisé. Si aucune destination n'est disponible, un message d'aide s'affiche et vous devez choisir une destination avant le chargement.
• Le bouton d'actualisation (Refresh), le libellé « Refreshing » pendant l'actualisation, l'heure de la dernière vérification, le nombre de bons/articles et le dernier événement en direct.
• Information de pagination : si le serveur contient plus d'éléments que ce qui a été chargé, le message « Showing X of Y backend orders » s'affiche — c'est-à-dire qu'après avoir modifié le filtre/la page côté serveur, vous devez appuyer sur Actualiser.

Ce que vous voyez sur chaque bon

• Type de source : Open cart (panier ouvert), Finalized order (commande finalisée) ou Kitchen dispatch (envoi en cuisine) ; numéro de révision (« Rev N »).
• Le titre de la commande, la ligne de source, l'heure de création et de mise à jour, et l'étiquette d'état.
• Ligne d'articles : la quantité sous la forme xN (négative pour un retour), le nom de l'article, « Note: » pour les notes, les suppléments, et les articles complémentaires imbriqués portant l'étiquette « Cross-sell for … » ; le cas échéant, l'arrière-plan coloré de chaque article.

1-4. Faire avancer la commande (Bump)

Sur chaque bon, seuls les boutons autorisés pour l'état correspondant sont affichés :

• Démarrer la préparation (Start preparing) → uniquement depuis l'état « nouveau » → passe à « en préparation ».
• Prêt (Done) → uniquement depuis l'état « en préparation » → passe à « prêt/terminé ».
• Annuler (Cancel) → depuis « nouveau » ou « en préparation » → passe à « annulé » (bouton rouge).

Chaque action est enregistrée sur le serveur et la page s'actualise ; pendant l'enregistrement d'une action, les autres boutons du même bon sont masqués. Les actions non autorisées n'ont tout simplement pas de bouton (elles sont masquées, pas désactivées). Si l'enregistrement de l'état échoue, une barre rouge distincte (« Kitchen status could not be updated ») s'affiche.

Impression du bon (Print)

• Le bouton d'impression n'apparaît que sur les bons imprimables.
• En cas de succès : « Kitchen ticket sent to … ».
• Si aucun modèle d'impression n'est configuré : l'avertissement « No kitchen print template is configured… ».
• Les erreurs sont distinguées selon leur cause : un problème de modèle (« …template could not be prepared… ») par opposition à un problème de matériel (« …could not be printed… Check the printer connection »).

1-5. Le signal sonore

• Pour une nouvelle tâche ou un changement, un bip/une alarme retentit afin que vous soyez averti même sans regarder l'écran.
• Le son n'est émis qu'après une confirmation réelle du serveur (nouvelle tâche, révision plus récente ou changement d'état) — ni à l'ouverture initiale de la page, ni lors de l'actualisation qui suit une reconnexion. Les sons ne s'accumulent pas non plus les uns sur les autres (intervalle minimal de 1,5 seconde).
• Barre d'autorisation du son : tant que le navigateur n'a pas autorisé la lecture du son, une barre jaune en bas de l'écran (« Kitchen alerts need sound permission ») s'affiche avec un bouton « Enable kitchen sound ».

💡 Si le son ne se lit pas, ce même bouton « Enable kitchen sound » ou une simple pression sur l'écran résout le problème.

1-6. État de la connexion et récupération

En haut de l'écran figure un indicateur Live / Stale / Offline (« Stale » signifie connexion lente / en cours de reconnexion). Lorsque la connexion en direct rencontre un problème, une barre bien visible apparaît :

• « Live order updates are offline » (déconnecté)
• « Reconnecting to live order updates… » (reconnexion en cours)
• « Live updates may be behind » (une mise à jour a été manquée ; le tableau s'actualise automatiquement de lui-même)

Si la connexion en direct est interrompue, la solution sûre est le bouton d'actualisation (Refresh) manuel en haut de l'écran. Le tableau conserve les bons existants entre les actualisations et n'affiche que le nouvel état.

• Le mode « détermination de l'établissement en cours » dispose de son propre bouton (« Retry location ») ; si le tableau ne se charge pas du tout, l'écran de récupération « Refresh board » apparaît.
• Les requêtes sont limitées dans le temps (en cas de délai dépassé, le message « request timed out — use Refresh » s'affiche).

1-7. Paramètres

Depuis le menu utilisateur, les paramètres du compte avec les onglets profil, sécurité, apparence (thème), notifications et intégration — ainsi que la déconnexion. ⚠️ L'onglet Intégration (Integration) est désactivé et ne s'ouvre pas.

Les paramètres système ne comptent que deux onglets : Catalogue et Ventes (le lien « general » mène lui aussi au catalogue). Si vous n'avez pas l'autorisation d'écriture, ils s'ouvrent avec une barre lecture seule ; et si vous n'avez pas l'autorisation de consultation, ils ne s'ouvrent pas du tout.