> For the complete documentation index, see [llms.txt](https://guideadmin.margipro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guideadmin.margipro.com/supervision/page-supervision.md). # Page Supervision La page **Supervision** donne une vue d'ensemble de l'activité de **tous les clients** MargiPro : documents chargés, volumes, gains de marge, utilisateurs actifs. Elle sert à repérer les comptes inactifs, suivre l'usage et retrouver rapidement un document. Elle est accessible depuis le menu **Supervision**, réservé au rôle **administrateur**. {% hint style="info" %} Les sociétés dont le nom contient **« test »**, **« demo »** ou **« démo »** sont exclues de toute la page : indicateurs, graphiques, tableaux et liste des clients. {% endhint %} ## Filtres Les filtres du haut de page s'appliquent à tous les blocs. | Filtre | Rôle | | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Client** | Limite la page à une société. | | **Site** | Limite la page à un site du client sélectionné. | | **Période** | Par défaut : **année en cours, par date d'import**. Le menu permet de basculer sur la **date du document** et de choisir une autre plage. | | **Recherche** | Numéro de document ou nom du fournisseur. | {% hint style="warning" %} Pour comparer le **gain de marge** avec le Tableau de bord d'un client, passez la période sur **Date du document** : le Tableau de bord filtre toujours sur la date du document. Avec la date d'import, les deux chiffres diffèrent. {% endhint %} ## Indicateurs | Carte | Contenu | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | **Clients & sites actifs** | Clients et sites ayant chargé au moins un document sur la période, rapportés à leur total. Un grand écart signale des comptes inactifs. | | **Documents** | Nombre de documents chargés, date du dernier chargement et répartition Factures · BL · Tickets. | | **Volumes** | Volume d'achat (montants HT des factures, hors BL) et volume de vente estimé (prix de vente × poids vendable, sur marges validées). | | **Gain de marges** | Gain en **points**, avec le montant en **euros** en dessous. Voir le détail ci-dessous. | | **Utilisateurs actifs** | Utilisateurs connectés pendant la période, rapportés au nombre total d'utilisateurs. | ### Calcul du gain de marge Le calcul est **identique à celui du Tableau de bord** des clients. * Le gain d'une ligne est l'écart entre le **prix de vente appliqué** et le **prix de départ**, multiplié par le **poids vendable**. Exemple : une bavette passée de 31,40 € à 36,95 €/kg sur 2,83 kg rapporte +15,71 €. * Seules les **marges validées** comptent. Les lignes en double et les lignes sans poids vendable sont ignorées. * Un prix de départ **à zéro ou vide ne produit aucun gain**. * La **première marge** d'un produit sur un site est écartée si elle a été enregistrée **avant le 30/07/2026**. Avant cette date, les produits recevaient un prix modèle par défaut, et l'écart avec ce prix faussait le premier gain. * Les **points** rapportent le gain en euros à la marge brute (ventes − achats des factures concernées). ## Graphiques | Graphique | Contenu | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Imports par jour** | Nombre de documents chargés chaque jour sur la période. | | **Gains de marge par document** | Les 10 documents qui pèsent le plus dans le gain de marge, gains en vert et pertes en rouge. Le survol affiche le client, la date du document et le montant. **Un clic ouvre les marges du document dans un nouvel onglet.** | | **Top clients (documents)** | Les clients qui ont chargé le plus de documents. | ## Activité par client Une ligne par client : documents, sites actifs, utilisateurs, volumes d'achat et de vente, date du dernier import et de la dernière connexion. Les boutons **Tous / Actifs / Inactifs** filtrent les clients selon qu'ils ont chargé des documents sur la période. Cliquer sur un client applique le filtre **Client** à toute la page. ## Documents chargés La liste affiche les documents de la période, du plus récent au plus ancien selon le type de date choisi dans la période. * Colonnes : type, numéro, **client / site**, fournisseur, **date du document**, **date d'import**, **importé par**, total TTC, statut des marges et lien vers le PDF. * **Un clic sur une ligne ouvre la page Marges du document dans un nouvel onglet.** ### Filtrer par importateur Au-dessus du tableau, la barre **Importé par** affiche les **20 utilisateurs** ayant chargé le plus de documents, avec leur nombre. Cliquez sur un nom pour ne voir que ses documents, cliquez à nouveau (ou sur **Tous**) pour revenir à la liste complète. La case **Hors MargiPro** retire de la liste et de cette barre les documents chargés par une adresse **@margipro.com**, pour ne voir que l'activité réelle des clients. Les documents dont l'importateur est inconnu sont aussi masqués. {% hint style="info" %} Ces deux filtres ne s'appliquent qu'à la liste : ils ne modifient ni les indicateurs ni les graphiques. {% endhint %} ## Points d'attention | Situation | Comportement | | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Ouvrir un document (graphique ou liste) d'un autre client que celui consulté | La page Marges s'affiche avec les droits du **client actuellement consulté** : elle sera vide. Basculez d'abord sur ce client, voir [Consulter le compte d'un client](/support/changement-client.md). | | Les chiffres semblent ne couvrir qu'un seul client | Vérifiez quel client est actuellement consulté dans le menu de l'avatar. La lecture des données de tous les clients dépend des droits configurés côté base. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://guideadmin.margipro.com/supervision/page-supervision.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.