Fonctionnement général

L'appli est un fichier unique qui affiche l'interface, connecté en permanence à une base de données qui stocke toutes les vraies informations (produits, ventes, stock, dépenses...) et les synchronise en temps réel entre tous les téléphones connectés. Rien n'est perdu si l'appli est fermée et rouverte.

Bénévoles à la vente : la liste des prénoms proposés dans l'onglet Commande se gère depuis Configuration, triée automatiquement par ordre alphabétique.

Onglets : leurs noms et leur ordre sont personnalisables depuis Configuration. Certains onglets (Configuration, Dépenses, Bilan, Stock) demandent un code d'accès à l'ouverture — une fois débloqué sur un téléphone, il n'est plus redemandé pour les autres onglets protégés durant la même session.

Lien de partage en lecture seule : ajouter ?share=stats à la fin du lien de l'appli affiche uniquement l'onglet Stats, en lecture seule, verrouillé sur l'événement marqué comme actif, sans accès au reste de l'appli.

Gestion des événements

Le sélecteur d'événement en haut de l'écran est modifiable uniquement depuis l'onglet Configuration (protégé par un code) ; partout ailleurs il reste visible mais grisé, en lecture seule, pour éviter les erreurs de manipulation en pleine vente.

Depuis Configuration : création, renommage, suppression et duplication d'un événement. La duplication copie les produits actifs, le nombre de bénévoles et les livraisons (avec la date remise au jour de la duplication) ; elle ne copie ni les commandes ni les retours, qui repartent de zéro. Les événements peuvent être réordonnés avec des flèches, et l'un d'eux peut être marqué "actif" (une étoile apparaît dans le sélecteur) — c'est purement indicatif, ça n'impose rien aux téléphones déjà en cours d'utilisation.

Onglet Commande

Écran de vente utilisé par les bénévoles :

• Choix du lieu de vente : la grille de produits proposés s'adapte automatiquement. Certains lieux (voir "Lieux" dans Configuration) demandent un code à la sélection, encaissent toujours à 0€, et sont exclus des recettes (lieux "OFFERT ..."), ou proposent un choix de client à facturer à la place du règlement (lieu "À FACTURER").
• Choix du bénévole dans une liste déroulante — obligatoire avant toute vente, à resélectionner à chaque changement de lieu ou actualisation de la page.
• Ajout des produits en tapant sur les vignettes ; possibilité de retirer un article en trop directement avec le bouton "−" sur sa ligne dans le panier.
• Retour de consigne via un bouton dédié (absent sur les lieux "OFFERT").
• Vérification d'âge : si le lieu sélectionné l'exige (réglage par lieu dans Configuration), une fenêtre demande si le client est né avant une date calculée (aujourd'hui moins 18 ans). Si non, seules les boissons sans alcool restent proposées pour cette commande ; la réponse peut être corrigée via le bouton "Modifier" sans perdre le panier.
• Mode de règlement : Carte bancaire, Espèces (calcul automatique de la monnaie à rendre) ou Client à facturer selon le lieu. Si la commande ne contient que des retours de consigne, le règlement se verrouille automatiquement sur Espèces avec le montant à rendre déjà calculé.
• Alertes de fermeture : si une heure de fermeture est réglée (Configuration), des fenêtres d'alerte apparaissent aux moments choisis, et la vente peut se bloquer automatiquement sur les lieux concernés (réglage par lieu) jusqu'à 8h du matin.
• Validation : les commandes sur un lieu "OFFERT" demandent une confirmation supplémentaire bien visible avant d'être enregistrées. Le bouton "Vider la commande" permet de tout annuler avant validation, avec confirmation.

Ventes validées

Liste des commandes validées, numérotées dans l'ordre, avec date, heure, lieu, bénévole, mode de règlement et statut Majeur/Mineur si applicable. Bouton "MARQUER PRÊTE" par commande, export Excel de l'ensemble.

Espèces

Liste uniquement les commandes réglées en espèces, avec le montant remis et la monnaie à rendre. Les commandes déjà marquées "Rendu" apparaissent atténuées. Export Excel dédié.

Factures

Liste les commandes passées sur le lieu "À FACTURER", groupées par client choisi au moment de la vente, avec bouton "MARQUER PAYÉE" et export Excel. La liste des clients à facturer se gère dans Configuration.

Stats

Tableau de bord complet : CA (HT et TTC), panier moyen, coût moyen par bénévole (basé sur toutes les dépenses de la famille "Bénévoles"), répartition des règlements, Top 3 produits et Top 3 bénévoles, taux de retour des consignes, indicateurs bière (fûts partis, litres servis), contenants consommés et stock restant par boisson (avec comparaison à une quantité N-1 saisie dans Stock), répartition Majeurs/Mineurs.

Le graphique "Commandes par heure" affiche 4 courbes en barres (Commandes, Chiffre d'affaires, Boissons avec alcool, Boissons sans alcool) plus une courbe superposée comparant les quatre tendances. La plage horaire filtrée et la granularité (heure / demi-heure / quart d'heure) se règlent depuis Configuration et s'appliquent automatiquement ici.

Synthèse

Regroupe les ventes par bénévole, par produit, par lieu et par mode de règlement, chaque vue exportable en Excel séparément.

Stock (protégé)

Livraisons : jusqu'à 4 par produit (affichage limité aux emplacements déjà remplis + 1 vide), avec date/heure, quantité, conditionnement (pré-rempli automatiquement si réglé par défaut dans Configuration) et taux de perte. Le stock en verres se calcule automatiquement (Quantité × Conditionnement ÷ Contenance du verre × (1 − taux de perte)) et s'ajoute au stock existant sans jamais l'écraser.

Retours (invendus rendus) : date/heure et quantité en fûts/bouteilles/autre, sans taux de perte (contenants complets). Le conditionnement utilisé est déduit automatiquement de la moyenne des livraisons du produit.

Correction manuelle du stock disponible pour chaque produit, indépendamment des livraisons/retours.

Quantité N-1 : valeur de référence de l'an dernier (en fûts/bouteilles), utilisée pour la comparaison affichée dans Stats.

Exports Excel : stock restant par produit, et détail complet des livraisons + retours (deux feuilles dans un même fichier).

Dépenses (protégé)

Familles de dépenses personnalisables (création/suppression). Dépenses automatiques générées à partir des livraisons/retours de boissons (au prix d'achat HT, TVA achat propre à chaque produit) et des commandes sur les lieux "OFFERT" (calculées au coût moyen réel, dans la famille correspondant au lieu). Ces lignes "offert" apparaissent grisées avec la mention "hors total" — elles ne sont jamais recomptées dans le total puisqu'elles sont déjà incluses via les livraisons.

Dépenses libres entièrement modifiables (description, famille, quantité, unité, tarif HT, TVA), réorganisables et supprimables individuellement.

Bilan (protégé)

Recettes par produit (exclut automatiquement les commandes "OFFERT"), consignes (idem), reprise des dépenses, et résultat final : Bénéfice HT = Recettes HT − Dépenses HT. Export Excel complet en 3 feuilles.

Affichage

Génère un écran public par lieu (produits actifs, contenance, degré, tarif) avec une zone de texte libre pour des annonces. Bouton d'impression qui masque automatiquement tout le reste de l'écran.

Configuration (protégé)

• Gestion des événements : créer, dupliquer, renommer, supprimer ; ordre et événement actif.
• Onglets : noms et ordre personnalisables, réinitialisables en un clic.
• Bénévoles à la vente : liste des prénoms proposés dans Commande.
• Nombre de bénévoles : utilisé pour calculer le coût moyen par bénévole dans Stats.
• Heure de fermeture et Alertes de fermeture : nombre d'alertes et minutage entièrement personnalisables, activables/désactivables individuellement.
• Filtrage horaire des Stats : plage horaire et granularité du graphique "Commandes par heure".
• Lieux : ajout, suppression, réorganisation, case "Vérif. âge" et case "Bloquer à la fermeture" par lieu.
• Lieux visibles dans Commande : masque un lieu du sélecteur pour l'événement en cours sans le supprimer.
• Produits actifs : active/désactive un produit pour l'événement en cours.
• Produits (édition complète) : nom, prix de vente, prix d'achat TTC (le HT est calculé automatiquement selon la TVA achat), conditionnement d'achat par défaut, taux de perte par défaut, degré, contenance, TVA vente, TVA achat, type de contenant (Fût/Bouteille/Cubi/Autre), couleur repère, lieux. Réorganisables ; ajout d'un nouveau produit directement dans la liste ; bouton unique pour tout enregistrer d'un coup.
• Clients à facturer : liste proposée sur le lieu "À FACTURER".