Trois façons de trouver un article :

• Tapez le nom du produit dans la barre de recherche — les résultats s'affichent en temps réel
• Scannez directement un code-barres avec une douchette (pistolet) n'importe où dans l'interface — le scanner rapide s'ouvre automatiquement
• Cliquez sur 🔎 Scanner pour ouvrir manuellement le mode scan et saisir un code-barres à la main
• Appuyez sur F1 pour mettre le focus sur la barre de recherche
• Les badges 🆕 Nouveau et ⚠️ Stock bas s'affichent directement sur les produits
• Filtrez par catégorie grâce au menu déroulant à côté de la barre de recherche

Lorsqu'une douchette / pistolet code-barres est connecté(e) à l'ordinateur, le scan est entièrement automatisé :

• Scannez un article → la fenêtre Scanner rapide s'ouvre instantanément
• La carte produit s'affiche : nom, catégorie, prix, image, stock et badge de promotion
• L'article est ajouté automatiquement au panier sans aucune action supplémentaire
• Le panier s'ouvre s'il n'était pas déjà visible
• La fenêtre se ferme toute seule après 2,4 secondes (barre de décompte visible)
• Cliquez sur 📷 Autre scan pour enchaîner immédiatement un deuxième article
• Si le code-barres n'est pas reconnu, un message d'erreur ❌ Code-barres non reconnu s'affiche

Pour une saisie manuelle, cliquez sur 🔎 Scanner : le champ de code-barres s'ouvre, et la détection est immédiate dès la fin de la lecture de la douchette.

Le panier flottant glisse depuis le côté droit de l'écran :

• Le total et le nombre d'articles se mettent à jour en temps réel
• Utilisez les boutons – et + pour modifier les quantités
• Cliquez sur la 🗑️ corbeille pour supprimer un article du panier
• Appliquez une promotion individuelle sur n'importe quel article depuis le panier
• Utilisez "Vider le panier" pour tout effacer d'un coup
• Appuyez sur F5 pour ouvrir / fermer le panier rapidement
• Le bouton FAB 🛒 (coin bas droite) affiche le nombre d'articles et ouvre le panier

Les produits au kilogramme sont identifiés par le badge ⚖️ kg ✏️ dans le panier.

• Cliquez sur le nom ou la quantité d'un article kg pour ouvrir la fenêtre de saisie du poids
• Choisissez l'unité : g (grammes) ou kg (kilogrammes)
• Utilisez les raccourcis 100g, 250g, 500g, 1 kg pour aller plus vite
• Le prix total se recalcule en temps réel à chaque saisie
• Validez avec ✅ Valider ou Entrée
• Les boutons – et + du panier incrémentent / décrémentent de 100g
• La quantité et le prix en kg apparaissent sur le ticket de caisse

Appuyez sur F3 ou cliquez sur le bouton de validation depuis le panier :

• 💶 Espèces : entrez le montant reçu — la monnaie à rendre est calculée automatiquement
• 💳 Carte bancaire : validation directe, aucun montant à saisir
• 💳💶 Paiement mixte : répartissez librement entre carte et espèces sur une même vente
• Après validation, le ticket de caisse s'affiche — imprimable ou téléchargeable en PDF
• Le stock est mis à jour automatiquement après chaque vente

Un aperçu du ticket s'affiche automatiquement après chaque vente. Retrouvez n'importe quel ticket depuis l'historique :

• Cliquez sur 🧾 Ticket #... dans l'historique pour l'aperçu complet
• 🖨️ Imprimer : impression directe via le navigateur
• ⬇️ Télécharger PDF : sauvegarde locale du ticket
• Le ticket affiche : articles, quantités, total, mode de paiement, monnaie rendue et nom du caissier
• Un ticket peut être annulé depuis l'historique (droits admin requis) — le stock est automatiquement restitué

Appuyez sur F4 ou cliquez sur 📊 Statistiques :

• Ventes du jour & du mois : chiffres clés en temps réel
• Graphique 7 jours : évolution visuelle des ventes
• Top 5 produits et produits à faible rotation
• 🧾 Historique : toutes les ventes filtrables (aujourd'hui, 7 jours, mois, tout)
• La recherche par article dans l'historique affiche automatiquement les suggestions et met en évidence les tickets correspondants
• Cliquez sur un ticket de l'historique pour voir son aperçu complet

L'onglet ☂️ Prédictions permet d'anticiper les ruptures :

• Alertes stock : produits avec moins de 5 unités restantes
• Jours de stock estimés : calculé sur les ventes des 30 derniers jours
• Badge ⚠️ Urgent : moins de 7 jours de stock restants
• Suggestions de réapprovisionnement : quantité recommandée à commander

L'onglet 🔄 Retours centralise trois types de gestion en sous-onglets :

• 🔄 Retours clients : enregistrez les retours de clients avec motif, ticket d'origine, montant et mode de remboursement (espèces, carte, avoir, échange…).
  Statuts disponibles : En attente → En traitement → Approuvé / Refusé
• 📦 Retours fournisseur : déclarez les marchandises défectueuses ou non conformes à renvoyer. Suivez l'état (En attente, Envoyé, Confirmé, Avoir reçu) et notez le bon de livraison (BL).
• 📅 Échéances articles : surveillez les dates limites de consommation (DLC / DLUO).
  Les articles sont colorés selon leur état : Expiré · Urgent ≤ 3 jours · Bientôt ≤ 7 jours · OK
  Filtrez par statut ou par catégorie (les catégories sont gérées dans le panneau admin)
• 📋 Historique : journal de toutes les actions retours / échéances, filtrable par type

Les barres de recherche sont séparées des filtres : la recherche occupe la première ligne, les filtres et boutons la seconde — les badges de statut restent toujours visibles.

Chaque liste est exportable en ⬇️ CSV. Les compteurs en haut de page (retours en attente, en traitement, approuvés, échéances urgentes, valeur du mois) se mettent à jour en temps réel.

La barre de progression en haut de l'écran affiche votre avancement vers l'objectif de ventes du jour :

• À gauche : montant encaissé aujourd'hui — à droite : % d'atteinte de l'objectif
• 🔴 Rouge : moins de 30 %
• 🟠 Orange : entre 30 % et 70 %
• 🟢 Vert : 70 % et plus — objectif presque atteint ou dépassé
• Les tickets annulés sont automatiquement déduits du total
• Configurable par l'admin : Panneau admin → Configuration Générale → 🎯 Objectif de vente journalier

Les catégories sont unifiées : une seule liste sert à la fois pour :

• Le filtre de la grille produits (onglet caisse)
• Le formulaire "Ajouter un produit" dans l'administration
• La modale "Nouvelle échéance article"
• Le filtre par catégorie du tableau des échéances

Les catégories se gèrent depuis le panneau admin : 🏷️ Catégories — Échéances articles & Produits. Ajouter ou supprimer une catégorie à cet endroit la répercute partout immédiatement.

Si l'administrateur vous a accordé des permissions d'édition :

• Cliquez sur "Mode Édition OFF" pour l'activer
• Le bouton devient vert : "✅ Mode Édition ON" et une bannière verte apparaît
• Des boutons "✏️ Éditer cet article" s'affichent sur chaque produit
• Vous ne pouvez modifier que les champs autorisés par l'administrateur (nom, prix, stock, code-barres…)
• Recliquez sur le bouton pour désactiver le mode édition

• F1 : Focus sur la barre de recherche produit
• F5 : Ouvrir / Fermer le panier
• F3 : Valider la vente en cours
• F4 : Afficher les statistiques
• F11 : Activer / Désactiver le plein écran
• ESC : Fermer la fenêtre ou annuler l'action en cours
• Entrée : Valider la saisie de poids (fenêtre kg) ou confirmer un scan manuel
• ? : Afficher / Masquer ce guide

• Utilisez F11 pour un affichage plein écran sans distractions pendant le service
• En scan automatique avec douchette, aucun clic n'est nécessaire — la fenêtre s'ouvre, affiche le produit et se ferme seule
• Pour enchaîner plusieurs articles scannés rapidement, cliquez sur 📷 Autre scan avant la fermeture automatique
• Pour un article au kg, cliquer sur son nom dans le panier est plus rapide que les boutons +/–
• En paiement mixte, vous pouvez combiner librement carte et espèces sur une même vente
• Pour retrouver tous les tickets contenant un article, tapez son nom dans la recherche de l'historique
• Le mode sombre 🌙 est disponible dans les paramètres pour réduire la fatigue visuelle — il s'applique à toute l'interface, y compris la section Retours
• Les catégories ajoutées dans l'admin apparaissent automatiquement dans le formulaire d'ajout produit et dans les échéances articles