Configurer et administrer BarDistribution

Configurer et administrer BarDistribution

Cette page explique comment paramétrer et suivre le contrôleur BarDistribution côté NUC : associer les produits de la caisse aux boissons du contrôleur (PLU), associer les serveurs, suivre les envois, consulter les statistiques et afficher l'écran du bar.
Pour ajouter le contrôleur dans la caisse et y rattacher les iPad, voir la page Connecter et utiliser BarDistribution dans l'application.

Accéder à l'administration du NUC

  • Depuis la caisse : Réglages > Périphériques > Contrôleur de débit de boisson, bouton Mapping produits et serveurs.
  • Depuis un navigateur sur le réseau de l'établissement : http://<adresse du NUC>:7710/admin.
L'en-tête de chaque page donne accès à Administration, Statistiques et Écran de la rampe. Les liens Page de test et Page de debug sont réservés au support.
La carte et les serveurs doivent d'abord avoir été envoyés par la caisse (automatiquement à l'ouverture de service, ou avec Envoyer la carte et Envoyer les serveurs). Tant que ce n'est pas fait, les listes restent vides.

1. Associer les produits aux PLU

Onglet Produits. Chaque produit de la carte doit être associé au PLU de la boisson correspondante sur le contrôleur BarDistribution (numéro de 0 à 9999, fourni par l'installateur).
Un produit sans PLU n'est jamais envoyé au contrôleur : il est vendu normalement en caisse, mais rien n'est crédité au bar.

Ajouter un PLU à un produit

    Trouvez le produit avec la recherche (nom, identifiant, prix, catégorie, type) ou les filtres.
    Dans la colonne PLU BarDistribution, appuyez sur + PLU.
    Saisissez le PLU et, à droite du ×, le nombre de verres par produit (1 par défaut).
    Appuyez sur Valider ou sur Entrée. Entrée passe directement au produit suivant de la liste, ce qui permet d'enchaîner la saisie au clavier. Échap annule.
Le PLU apparaît sous la forme 120 ×1. Pour le retirer, appuyez sur la petite croix de la pastille.
Exemples :
  • Un demi : PLU de la bière ×1.
  • Un pichet qui correspond à 4 doses : PLU ×4. Un pichet vendu crédite alors 4 doses.
  • Un produit composé de plusieurs boissons du contrôleur (par exemple une boisson et son diluant) : ajoutez plusieurs PLU au même produit. Chaque PLU est crédité.

Filtres utiles

  • Non mappés : les produits actifs qui n'ont encore aucun PLU. C'est la liste à vider à l'installation.
  • Mappés, Inactifs, Tous.
  • Point de fabrication et Type de produit : par exemple « Bar » + « Bière » pour ne voir que les bières du bar.
Le compteur en haut indique le nombre de produits et le nombre de produits mappés. Les produits retirés de la carte restent dans la liste, grisés avec la mention inactif, et gardent leur PLU s'ils reviennent.

Mapper plusieurs produits à la fois

    Cochez les produits concernés. La case de l'en-tête coche tous les résultats du filtre en cours, y compris ceux qui ne sont pas affichés à l'écran.
    Dans la barre de sélection, saisissez le PLU et le nombre de verres, puis :
  • Ajouter ce PLU : ajoute le PLU à tous les produits cochés ;
  • Retirer ce PLU : retire ce PLU des produits cochés qui l'ont ;
  • Vider les PLU : retire tous les PLU des produits cochés (une confirmation est demandée).
    Désélectionner vide la sélection.

2. Associer les serveurs

Onglet Serveurs.
    Dans la liste, saisissez pour chaque serveur son numéro BarDistribution (0 à 999). L'enregistrement est automatique : « ✓ enregistré » s'affiche.
    Laissez la case vide pour retirer le numéro.
En haut de l'onglet, le numéro de serveur par défaut est utilisé pour les commandes passées par un serveur qui n'a pas de numéro BarDistribution. Les boissons sont quand même créditées, au nom de ce numéro par défaut.
Pensez à mapper les nouveaux serveurs : sinon leurs boissons seront toutes créditées sur le numéro par défaut, et les relevés par serveur du contrôleur seront faussés.

3. Suivre les envois

Onglet Envois. Un badge sur l'onglet indique le nombre d'envois en attente.

Contrôleurs

Une carte par contrôleur contacté depuis le démarrage du NUC :
  • OK (voyant vert) : les envois partent normalement.
  • En erreur (voyant rouge) : le contrôleur ne répond pas ou refuse l'envoi. Le message d'erreur et le délai avant le prochain essai sont affichés.

En attente

Les crédits et annulations que le NUC n'a pas encore réussi à transmettre. Le NUC les renvoie automatiquement, sans intervention, tant que le contrôleur est injoignable.
  • Au bout de 10 minutes sans succès, l'envoi est abandonné automatiquement.
  • Le bouton Abandonner permet de l'abandonner tout de suite (par exemple si le contrôleur est en panne pour la soirée). Le contrôleur ne recevra jamais cet envoi.

Terminés récents

Les 100 derniers envois terminés :
  • envoyé : le contrôleur a accepté l'envoi ;
  • abandonné, avec la raison : clôture, expiré (10 min), abandon manuel, rien à annuler (crédit jamais envoyé) ou envoi invalide (vérifier le paramétrage).
Un envoi abandonné peut être renvoyé avec Relancer. Il repart avec un nouveau numéro de requête.
Attention aux doubles crédits. Si le dernier essai a échoué en « timeout », le contrôleur a peut-être reçu l'envoi sans que sa réponse revienne : le relancer peut créditer deux fois. La page demande une confirmation dans ce cas, ainsi que lorsque la boisson a été annulée en caisse entre-temps.

4. Statistiques

Page Statistiques. Elle montre ce que le NUC a envoyé aux contrôleurs, pour le comparer avec les relevés du contrôleur BarDistribution (ce qui a réellement été servi). Les commandes sont conservées 31 jours.
    Choisissez la période : Aujourd'hui, Hier, 7 jours, Ce mois, 31 jours, ou des dates Du … Au (31 jours au plus).
    Regrouper par : PLU (avec les articles qui l'utilisent), Article ou Serveur.
    Découper par : Toute la période, Heure, Jour ou Semaine. Un graphique du net envoyé s'affiche alors au-dessus du détail.
    Le champ Filtrer réduit le tableau à un PLU, un article ou un serveur.
Colonne
Signification
Crédités
crédits acceptés par le contrôleur
Annulés
annulations acceptées par le contrôleur
Net envoyé
crédités moins annulés : ce que le contrôleur devrait avoir servi. C'est la colonne à comparer aux relevés du contrôleur.
Non envoyés
crédits abandonnés : jamais crédités, donc rien n'a pu être servi
Annulations non envoyées
le crédit est resté sur le contrôleur et a pu être servi : c'est le cas qui explique un écart
En attente
pas encore transmis
Unités : par PLU et par serveur, les chiffres sont des doses ; par article, ce sont des articles.
Exporter en CSV télécharge le tableau, prêt à ouvrir dans Excel. L'adresse de la page garde la période et les choix : on peut la mettre en favori ou l'envoyer.
Le NUC sait ce qu'il a envoyé, pas ce qui a réellement été versé. En cas d'écart avec les relevés BarDistribution, regardez d'abord les annulations non envoyées, puis les produits non mappés.

5. Écran de la rampe (optionnel)

La page Écran de la rampe (http://<adresse du NUC>:7710/screen) s'affiche sur un écran ou un iPad au bar. À chaque boisson créditée, elle montre le nom du produit, le PLU, la quantité et le numéro du serveur, avec une animation adaptée au type de produit : rampe à pression pour les bières, machine à café pour les boissons chaudes, doseurs pour le reste.
  • Une annulation est signalée en rouge.
  • Seuls les envois arrivés après l'ouverture de la page s'affichent. Un produit sans PLU n'apparaît jamais.


En cas de problème

Situation
Que faire
Les listes de produits ou de serveurs sont vides
Envoyer la carte et les serveurs depuis la caisse (Envoyer la carte, Envoyer les serveurs).
Un produit est introuvable
Renvoyer la carte depuis la caisse après l'avoir créé, puis vérifier le filtre (Tous).
Une boisson n'est pas créditée
Vérifier que le produit a un PLU (filtre Non mappés), puis l'onglet Envois : envoi en attente, abandonné ou en erreur.
Contrôleur En erreur, envois qui s'accumulent
Vérifier que le PC du bar et l'Interface Master sont allumés et sur le réseau. Les envois repartent seuls dès que le contrôleur répond, pendant 10 minutes.
Envoi abandonné envoi invalide (vérifier le paramétrage)
Une valeur est hors limites pour le contrôleur (quantité de plus de 99 doses, par exemple) : vérifier le PLU et le nombre de verres du produit.
Envoi En erreur avec un code HTTP, puis expiré (10 min) alors que le contrôleur est allumé
Le contrôleur refuse l'envoi : vérifier que le PLU existe bien sur le contrôleur et que le numéro de serveur est connu de lui.
Boissons créditées au mauvais serveur
Mapper le serveur dans l'onglet Serveurs ; sinon c'est le numéro par défaut qui est utilisé.
Écart entre les statistiques et les relevés du contrôleur
Comparer la colonne Net envoyé ; regarder les annulations non envoyées et les envois abandonnés sur la période.