---
title: "Utilisation"
weight: 30
description: "Lire la page principale de capPatrol, exporter les anomalies, marquer un tiers comme normal, comprendre les notifications."
---

# Utilisation

Cette page explique comment lire le tableau de bord de capPatrol et exploiter la page des anomalies clients.

## Tableau de bord

L'entrée **Facturation -> capPatrol** ouvre le tableau de bord, qui résume tout ce que capPatrol contrôle :

- **Une tuile par contrôle** (anomalies clients, cadence du mois, paiements, factures non transmises) : nombre d'alertes, montant en jeu, et un état "À vérifier" ou "Rien à signaler". Avant la toute première analyse, les contrôles qui en dépendent affichent "Pas encore analysé" plutôt qu'un faux "Rien à signaler". Chaque ligne d'une tuile mène à la page filtrée correspondante.
- **À traiter en priorité** : les dix alertes les plus graves, tous contrôles confondus, classées par score, avec un lien direct vers le tiers, la piste de paiement de la facture ou la page de cadence.
- **Santé de la surveillance** : date et résultat de la dernière analyse, prochaine exécution de la tâche planifiée, nombre de clients marqués comme normaux. Un bandeau d'avertissement s'affiche si aucune analyse n'a réussi depuis plus de 48 heures : la surveillance est peut-être arrêtée.
- **Évolution** des oubliés, pics et chutes sur les dernières analyses, avec le détail chiffré sous la courbe ("Afficher les chiffres").

Les sous-entrées du menu (Anomalies clients, Cadence du mois, Paiements, Non transmises) s'affichent dès que vous êtes dans capPatrol.

![Tableau de bord capPatrol : tuiles des quatre contrôles, santé de la surveillance et alertes à traiter en priorité, avec le menu capPatrol et ses sous-entrées](screenshots/tableau-de-bord.webp)

## Anomalies clients

La page **Facturation -> capPatrol -> Anomalies clients** affiche, pour l'entité courante, les tiers que le détecteur considère comme **anormaux** sur le mois courant. Les lignes sont organisées en cinq onglets :

- **Toutes** : vue agrégée triée par score décroissant. Idéal pour repérer le "pire" d'un coup d'œil.
- **Oubliées** : tiers à cadence régulière qui n'ont rien reçu ce mois-ci alors que d'habitude oui.
- **Pics** : mois courant nettement plus élevé que la moyenne historique.
- **Chutes** : mois courant nettement plus faible que la moyenne (mais > 0).
- **Écart récurrent** : client dont la facturation du mois s'écarte de ce qu'il est habituellement facturé sur les mêmes jours (voir [Surveiller une facturation récurrente](/cappatrol/facturation-recurrente)).

![Page des anomalies clients avec les onglets Toutes, Oubliées, Pics, Chutes et Écart récurrent, et le tableau des tiers signalés](screenshots/page-principale.webp)

Au-dessus du tableau :

- un **badge de fraîcheur** (vert / orange / rouge) indique l'âge du dernier calcul terminé avec succès :
  - vert : moins de 24 heures ;
  - orange : entre 24 heures et 7 jours ;
  - rouge : plus de 7 jours, ou jamais.
- un bouton **"Recalculer maintenant"** force un calcul immédiat (la page se bloque le temps du calcul, quelques secondes pour la plupart des parcs) ;
- un bouton **"Exporter (CSV)"** télécharge la liste filtrée au format CSV (UTF-8 avec BOM, séparateur `;`).

![Badge de fraîcheur vert avec la date du dernier calcul terminé](screenshots/badge-fraicheur.webp)

## Lire une ligne

Pour chaque tiers signalé, le tableau affiche :

| Colonne | Sens |
|---------|------|
| **Tiers** | Lien vers la fiche tiers + lien rapide vers la liste de ses factures. |
| **Catégorie** | Oubli, Pic ou Chute. |
| **Score** | Score normalisé entre 0 et 1. Plus c'est haut, plus l'anomalie est marquante. |
| **CA mois courant** | Montant HT facturé pour le mois calendaire en cours (avoirs déduits par défaut). |
| **Médiane mensuelle** | Montant habituel facturé chaque mois sur l'historique configuré (12 mois par défaut, hors mois courant). |
| **Écart-type robuste (MAD)** | Volatilité de la médiane. Plus c'est grand, plus le tiers a un historique fluctuant. |
| **Cadence** | Mensuelle / Trimestrielle / Annuelle / Irrégulière, déduite de la régularité des mois non nuls. |
| **Dernière facture** | Date de la dernière facture (statut validé ou payé selon votre configuration). |
| **Action** | Bouton **"Marquer comme normal"** : whitelist ce tiers pour cette catégorie. |

### Exemple chiffré

> Tiers **"Atelier Martin"**, médiane 1 200 €, écart 100 €, mois courant 0 €, cadence mensuelle, dernière facture il y a 38 jours.

Lecture : ce client paie habituellement autour de 1 200 € par mois, avec très peu de variation. Or rien n'a été facturé ce mois-ci et la dernière facture remonte à plus de 35 jours. capPatrol le classe en **"Oubli"** avec un score de 0,95.

> Tiers **"Bureau Toulouse"**, médiane 800 €, écart 150 €, mois courant 5 200 €, cadence mensuelle.

Lecture : un client mensuel à 800 € est facturé 5 200 € ce mois-ci (6,5 fois la médiane). capPatrol le classe en **"Pic"** avec un score IF élevé (typiquement > 0,7). À vérifier : commande exceptionnelle, double facturation, erreur de saisie ?

> Tiers **"SARL Dupont"**, médiane 600 €, écart 50 €, mois courant 50 €, cadence mensuelle.

Lecture : ce client mensuel à 600 € de moyenne ne facture que 50 € ce mois-ci (8 % de l'habituel). capPatrol le classe en **"Chute"**. À vérifier : fin de prestation ? résiliation en cours ? facture en attente de validation ?

## Filtres disponibles

- **Score minimum** : ne montrer que les anomalies dont le score normalisé est >= une valeur donnée (par exemple 0,5 pour ignorer les alertes faibles).
- **Catégorie de tiers** : ne montrer que les tiers d'une catégorie donnée. Pratique pour cibler une zone géographique, un secteur d'activité ou un type d'abonnement.

![Barre de filtres au-dessus du tableau d'anomalies](screenshots/filtres.webp)

## Marquer un tiers comme normal (whitelist)

Lorsqu'une alerte est légitimement écartée (cas connu, exception saisonnière, gros chantier ponctuel), cliquez sur **"Marquer comme normal"** sur la ligne concernée. capPatrol :

1. crée une entrée dans la table de whitelist pour le couple **(tiers, catégorie)** ;
2. fixe la date d'expiration à **aujourd'hui + N jours** (paramétrable, 30 jours par défaut) ;
3. supprime immédiatement la ligne du tableau ;
4. empêche le détecteur de re-signaler ce couple (tiers, catégorie) tant que l'expiration n'est pas atteinte.

Une seule entrée whitelist par couple **(tiers, catégorie)** : si vous re-cliquez sur un tiers déjà whitelisté, l'expiration est simplement prolongée.

> **Important :** whitelister une catégorie ne désactive **pas** les autres. Un tiers whitelisté en "Pic" peut tout à fait remonter en "Oubli" le mois suivant si son chiffre passe à zéro.

## Export CSV

Le bouton **"Exporter (CSV)"** télécharge un fichier CSV contenant les anomalies actuellement filtrées :

- encodage UTF-8 avec BOM (compatible Excel et LibreOffice Calc) ;
- séparateur point-virgule (`;`) ;
- colonnes : id tiers, raison sociale, code client, catégorie, méthode, score brut, score normalisé, CA courant, médiane, MAD, cadence, date dernière facture, âge dernière facture, date du calcul.

## Le cron quotidien

capPatrol installe une tâche planifiée Dolibarr nommée **"capPatrol - calcul quotidien des anomalies de facturation"**. Configuration par défaut :

- exécution **tous les jours à 6 h du matin** ;
- itération sur **toutes les entités actives** si Multicompany est installé, sinon sur l'entité courante uniquement ;
- recalcul complet : la table d'anomalies est vidée puis remplie pour l'entité concernée.

Le cron Dolibarr lui-même doit être actif sur le serveur (cf. la page [Installation](/cappatrol/installation)).

## Méthodes de détection

Selon la taille du parc et la nature de l'anomalie, capPatrol utilise des méthodes différentes :

| Méthode | Quand ? | Score affiché |
|---------|---------|--------------|
| **Règle déterministe** | Oublis, sur tiers à cadence régulière. | Fixe selon la cadence (0,95 mensuel, 0,85 trimestriel, 0,75 annuel). |
| **Isolation Forest (IF)** | Pics et chutes, dès que vous avez >= 100 tiers exploitables. | Score continu IF normalisé entre 0 et 0,9. |
| **MAD** (déviation absolue médiane) | Pics et chutes, si vous avez < 100 tiers exploitables. | Z-score robuste plafonné à 1,0. |

La méthode utilisée est journalisée à chaque exécution du cron (préfixe `CAPPATROL` dans les logs Dolibarr). Le tri global combine les trois méthodes via le **score normalisé** qui vit toujours dans l'intervalle `[0, 1]`.

## Notifications par email

Si vous avez renseigné une adresse de notification et choisi une fréquence :

- **Quotidien** : à chaque cron, si des anomalies sont présentes, un email de synthèse est envoyé.
- **Hebdomadaire** : envoi le jour configuré (1 = lundi par défaut), si des anomalies sont présentes.

Le contenu peut être personnalisé via un **modèle d'email Dolibarr**. Voir la page [Configuration](/cappatrol/configuration) pour le détail des jetons disponibles.

## Widget tableau de bord

Le widget **"capPatrol - Top 5 anomalies"** s'ajoute à la page d'accueil Dolibarr (rendez-vous dans **Configuration -> Widgets** ou utilisez l'engrenage en haut à droite de la page d'accueil pour l'activer).

Il affiche les 5 anomalies au plus haut score normalisé, toutes catégories confondues, avec un lien direct vers la page principale.

![Widget Top 5 anomalies sur la page d'accueil Dolibarr](screenshots/widget-dashboard.webp)

## Protocole de test manuel

Pour valider qu'une installation est fonctionnelle, vous pouvez monter trois tiers fictifs sur un Dolibarr de test :

1. **"Tiers oublié"** - créez 11 factures à 100 € HT espacées d'un mois sur les 11 mois précédents, **aucune facture** ce mois-ci. Lancez le calcul. Le tiers doit apparaître dans **Oubliées** avec un score de 0,95.
2. **"Tiers pic"** - créez 11 factures à 800 € HT espacées d'un mois sur les 11 mois précédents, et une facture **à 5 000 €** ce mois-ci. Le tiers doit apparaître dans **Pics**.
3. **"Tiers chute"** - créez 11 factures à 800 € HT espacées d'un mois sur les 11 mois précédents, et une facture **à 50 €** ce mois-ci. Le tiers doit apparaître dans **Chutes**.

Si l'un de ces tests échoue, vérifiez :

- que les factures sont bien validées (`fk_statut = 1`) ou payées (`fk_statut = 2`) ;
- que vous avez bien lancé un calcul ("Recalculer maintenant") depuis l'écran principal ;
- les logs Dolibarr filtrés sur `CAPPATROL` (chaque étape majeure y est tracée).