La démo des ventes

Sales demo est une petite application livrée avec Liberty Next pour montrer, sur un sujet cohérent, ce que le framework fait sans code : des lignes de facture mensuelles chargées depuis Excel, des périodes validées puis clôturées, un tableau de bord d'accueil, l'analyse libre dans l'explorateur de données, l'assistant IA, une synthèse envoyée chaque mois par e-mail, et des utilisateurs limités à leur propre société. Tout y est configuration — connecteur, dictionnaire, écrans, menus, tableaux de bord, modèle, tâches — consultable et modifiable dans les Paramètres.

C'est une vitrine, pas un produit : l'ouvrir pour voir une fonction en action, et reprendre ce qui convient dans sa propre application.

---

Vue d'ensemble

---

Les données

Table	Contenu
Articles	Les articles, avec leur famille et leur sous-famille.
Sociétés	Les sociétés, avec leur business unit, leur région et leur devise.
Clients	Les clients rencontrés dans les ventes ; chaque chargement ajoute les codes, les noms se complètent à la main.
Lignes de vente	Une ligne par ligne de facture : période, société, article, client, pays de destination, quantité, poids, chiffre d'affaires dans la devise de la société.
Périodes	Une ligne par période chargée : statut (open, validated, closed), nombre de sociétés et de lignes, quantité, auteur et date du changement de statut, commentaire.

Le chiffre d'affaires est exprimé dans la devise de chaque société : il n'est jamais additionné d'une devise à l'autre, et les analyses le donnent donc par devise ou par société.

---

Les écrans

• Ventes → Lignes de vente : les lignes de facture, en lecture seule, jusqu'à 5 000 lignes. La grille s'ouvre vide : choisir d'abord une période, une business unit, une famille… Les filtres sont en cascade — les sociétés suivent la business unit, les sous-familles la famille, les articles les deux.
• Ventes → Périodes : les périodes chargées. Le menu de ligne propose Validate, Close et Reopen, chacun après confirmation. Une période clôturée passe en lecture seule dans la grille — voir Champs conditionnels — et tout nouveau chargement de cette période est refusé.
• Données de référence → Articles, Sociétés, Clients : les tables de référence, modifiables.

---

Le chargement des fichiers

Le dossier Import du menu regroupe les chargements, chacun sous forme de page de tâche où l'utilisateur choisit le fichier, lance la tâche et suit son journal :

Entrée	Tâche	Rôle
Fichier articles	nomademo-load-items	Charge le fichier des articles (feuille Items : code, nom, famille, sous-famille), en remplaçant la table.
Fichier sociétés	nomademo-load-companies	Charge le fichier des sociétés (feuille Companies : code, nom, business unit, région, devise), en remplaçant la table.
Fichier ventes (un mois)	nomademo-load-sales	Charge un mois de lignes de facture (feuille Sales).
Recalculer les périodes	nomademo-refresh-periods	Reconstruit les lignes de période à partir des lignes chargées, en conservant leur statut.
Charger les fichiers d'exemple	nomademo-load-samples	Charge les fichiers d'exemple livrés avec la démo — tous à la fois, sans envoi de fichier. À relancer à tout moment pour réinitialiser la démo.

Les fichiers d'exemple sont livrés avec l'application : environ 320 articles répartis en six familles, 14 sociétés dans six business units, et six mois de lignes de facture (d'octobre à mars). Les données sont synthétiques et anonymes ; un rechargement redonne les mêmes chiffres.

Le chargement des ventes montre l'étape file_load en situation :

• il remplace les partitions présentes dans le fichier — année, mois et société — en une seule transaction : recharger un mois corrigé ne remplace que ce mois, et un chargement en échec laisse les données précédentes en place ;
• une garde refuse le fichier dès que l'une de ses périodes est clôturée, avec le motif dans le journal ;
• les lignes rejetées sont proposées au téléchargement sous le journal ;
• les étapes suivantes ajoutent les nouveaux clients et actualisent les lignes de période.

Deux autres tâches se lancent depuis Nomaflow → Tâches : nomademo-init-db crée les tables, nomademo-demo-accounts crée les utilisateurs de démonstration (plus bas). Les tâches sont livrées sans planification.

---

Le tableau de bord d'accueil

Vue d'ensemble est la page d'accueil de l'application : le tableau de bord Vue d'ensemble des ventes, construit avec les widgets de synthèse.

Widget	Contenu
Lignes de facture, Dernière période, Périodes, Articles vendus	Les chiffres, avec une ligne de détail : unités, sociétés et clients ; la dernière période et sa quantité ; les périodes encore ouvertes ; les familles.
Quantité mensuelle par pôle	Une série par business unit, par période.
Ce qui demande attention	Les périodes ouvertes à clôturer, les sociétés sans vente sur la dernière période.
Chiffre d'affaires par devise, Quantité par famille	Des barres de proportion — les totaux d'abord, puis par business unit. Le chiffre d'affaires n'est jamais additionné d'une devise à l'autre.
Périodes	Le statut de chaque période, l'auteur et la date du changement.
Meilleurs articles, Quantité par pôle	Les plus fortes quantités.

La barre porte une période (toutes les dates à l'ouverture) et un filtre Business unit qui restreint chaque widget dont la requête renvoie la business unit — sans écran derrière les widgets.

---

L'explorateur de données

Explorateur de données, juste sous Vue d'ensemble, ouvre l'explorateur de données sur le modèle Sales : les lignes de facture au centre, entourées de l'article (famille, sous-famille), de la société (business unit, devise) et du client.

Le modèle livre dix analyses partagées — quantité par business unit, par société, par famille ; chiffre d'affaires par devise, par business unit, par société ; quantité mensuelle, seule et croisée par business unit ; articles les plus vendus ; nombre de lignes de facture — ainsi que le tableau de bord Sales overview qui les réunit. Elles servent de point de départ : en ouvrir une, la modifier, l'enregistrer sous un autre nom.

---

L'assistant IA

L'application livre ses questions de départ sous quatre rubriques — Sales, Periods, Loads, Reference data —, par exemple Which business unit sold the most last month? ou How do I reload a month that was wrong?. L'écran Lignes de vente a les siennes, qui s'appuient sur le contexte de page : Sum the quantities of the rows I see, by business unit.

Trois procédures — Load a month of sales, Validate or close a period, Analyse quantities and revenue — permettent à l'assistant de guider un utilisateur dans les démarches de l'application. L'ensemble se consulte et se modifie dans Paramètres → IA.

---

La synthèse mensuelle

nomademo-monthly-digest est une synthèse planifiée, sans code :

1. deux étapes report produisent en Excel les analyses Revenue by business unit et Quantity by company, sur le mois précédent ;
2. une étape notify les envoie aux titulaires du rôle de groupe, avec les deux fichiers en pièces jointes.

La planifier le premier du mois, une fois le compte de messagerie renseigné dans les notifications.

---

Trois utilisateurs, trois vues

nomademo-demo-accounts crée deux rôles et trois utilisateurs, mot de passe demo :

Utilisateur	Rôle	Voit
demo_group	nomademo_group	Tout.
demo_bu	nomademo_scoped	Les sociétés d'une business unit.
demo_company	nomademo_scoped	Une seule société.

Les deux rôles accordent les mêmes droits : les requêtes de l'application, ses modèles d'exploration et l'assistant. Le rôle restreint ajoute un périmètre de données sur la société, dont les valeurs proviennent de l'attribut companies de chaque utilisateur. En se connectant successivement avec chacun, les mêmes écrans, tableau de bord, analyses et exports montrent d'autres lignes, totaux compris.

Charger les sociétés (ou les fichiers d'exemple) avant de lancer cette tâche : elle les lit pour renseigner les attributs des utilisateurs.

---

Mise en place

1. Dans Paramètres → Pools, un pool nommé nomademo qui pointe vers une base vide.
2. Dans Nomaflow, lancer nomademo-init-db.
3. Ouvrir Sales demo depuis le sélecteur d'applications, puis Import → Charger les fichiers d'exemple.
4. Lancer nomademo-demo-accounts dans Nomaflow pour créer les utilisateurs de démonstration.

---

Pour aller plus loin

• Tableaux de bord — les widgets et l'export.
• Explorateur de données — modèles, analyses, tableaux de bord.
• Étapes — chargements de fichiers, rapports et notifications.
• Rôles et permissions — le périmètre de données.