Configuration

L'écran de configuration se trouve dans Configuration -> Modules/Applications -> capPatrol -> Configuration. Tous les réglages sont stockés dans llx_const avec le préfixe CAPPATROL_. Ils prennent effet à la prochaine exécution du détecteur (manuelle via le bouton "Recalculer", ou automatique via le cron quotidien).

Périmètre de la détection

Profondeur d'historique (CAPPATROL_HISTORY_MONTHS)

Nombre de mois utilisés pour calculer la médiane et la cadence de chaque tiers.

• Défaut : 12.
• Plage : 3 à 60.
• Recommandation : 12 pour la plupart des activités. 24 si vous avez beaucoup de cycles annuels (audits, formations) ou si votre activité est très saisonnière.

Plus la valeur est élevée, plus la médiane est stable mais moins le détecteur réagit aux changements récents.

Médiane mensuelle minimale (CAPPATROL_MIN_MEDIAN_AMOUNT)

Seuil sous lequel un tiers ne sera jamais signalé, même si son chiffre du mois est à zéro. Évite les faux positifs sur les très petits comptes.

• Défaut : 10 €.
• Recommandation : adaptez à votre panier moyen. Pour un SaaS à 9,99 €/mois choisissez 5 €. Pour une activité de conseil, 100 € ou plus.

Catégories de tiers à exclure (CAPPATROL_EXCLUDED_CATEGORIES)

Liste à choix multiple. Tous les tiers appartenant à ces catégories sont exclus de l'analyse.

Cas typiques d'usage :

• catégorie "Test" utilisée pour les tiers de démonstration ;
• catégorie "Interne" pour les facturations intra-groupe que vous ne voulez pas surveiller ;
• catégorie "Ponctuel" pour les clients qui ne sont jamais facturés régulièrement.

Inclure les factures brouillon (CAPPATROL_INCLUDE_DRAFT)

Si oui, les factures au statut brouillon (fk_statut = 0) sont comptées comme du chiffre. Utile si vous saisissez les factures en brouillon en début de mois et ne les validez qu'à la clôture.

• Défaut : non.

Inclure les factures d'acompte (CAPPATROL_INCLUDE_DEPOSIT)

Si oui, les factures de type "acompte" (type = 3) sont comptées. Si non (défaut), elles sont ignorées.

• Défaut : non.

Inclure les avoirs en négatif (CAPPATROL_INCLUDE_CREDIT_NOTES)

Si oui (défaut), les avoirs (type = 2) sont comptés en négatif sur le mois où ils sont émis (date pivot = datef). Le CA mensuel reflète ainsi le net.

Mettez non si les avoirs émis tardivement après une facture polluent vos détections de chute.

• Défaut : oui.

Réglages du détecteur

Nombre d'arbres Isolation Forest (CAPPATROL_IF_ESTIMATORS)

Plus la valeur est haute, plus le score est stable, mais plus le calcul est long.

• Défaut : 300.
• Plage utile : 100 à 1000.
• Recommandation : 300 pour la plupart des parcs. Augmentez à 500 si vos résultats fluctuent trop d'un jour à l'autre.

Taux estimé d'anomalies (CAPPATROL_IF_CONTAMINATION)

Proportion attendue de tiers anormaux dans votre parc. Sert à calibrer le seuil interne d'Isolation Forest.

• Défaut : 0,05 (5 %).
• Plage : 0,01 à 0,49.
• Recommandation : 0,05 si vous avez peu d'attente, 0,10 si vous voulez voir plus d'alertes.

Note : ce paramètre n'est pas un quota dur. Le plafond réel est CAPPATROL_IF_MAX_FLAGGED.

Seuil de bascule MAD (CAPPATROL_IF_MIN_SAMPLES)

En dessous de ce nombre de tiers exploitables, capPatrol bascule sur une détection MAD (déviation absolue médiane) plus prudente. Isolation Forest perd en qualité statistique sur les petits parcs.

• Défaut : 100.
• Recommandation : laissez à 100. Si vous voulez forcer la méthode MAD même sur de gros parcs (par exemple en début de mise en service), montez à 10 000.

Plafond de tiers signalés par exécution (CAPPATROL_IF_MAX_FLAGGED)

Nombre maximum de pics + chutes remontés par exécution (les oublis ne sont pas plafonnés).

• Défaut : 50.
• Recommandation : 50 sur un parc de 5 000 tiers, 100 au-delà.

Évite les vagues d'alertes qui décourageraient le gestionnaire.

Écart minimum (ratio) pour pic/chute (CAPPATROL_DEVIATION_MIN_RATIO)

Un tiers n'est classé en pic ou en chute que si l'écart relatif |courant - médiane| / médiane dépasse ce ratio.

• Défaut : 0,20 (soit 20 %).
• Plage : 0 à 5.
• Recommandation : 0,20 pour la plupart des activités. 0,30 si vos chiffres oscillent naturellement beaucoup.

Avec 0,20, un client à 1 000 € de médiane qui passe à 1 150 € le mois courant ne sera pas signalé (écart = 15 % < 20 %).

Jour du mois pour signaler un oubli (CAPPATROL_FORGOTTEN_DAY_OF_MONTH)

Pour les clients à cadence mensuelle, capPatrol ne signale l'oubli qu'à partir de ce jour du mois en cours. Tolérance pour vous laisser le temps de saisir vos factures en début de mois.

• Défaut : 6.
• Plage : 1 à 28.
• Recommandation : 5 si vous facturez le 1er, 10 si vous facturez avant le 5, 15 si vous facturez avant le 10.

Les cadences trimestrielle et annuelle utilisent un autre mécanisme (âge de la dernière facture > 100 j ou > 380 j respectivement).

Durée du marquage "comme normal" (CAPPATROL_WHITELIST_DAYS)

Lorsque vous cliquez sur "Marquer comme normal" sur une ligne, l'exclusion dure ce nombre de jours puis le tiers redevient surveillé.

• Défaut : 30 jours.
• Recommandation : 30 pour les pics ponctuels (gros chantier exceptionnel), 90 pour les chutes saisonnières connues.

Notifications par courriel

Adresse email (CAPPATROL_NOTIF_EMAIL)

L'adresse (ou la liste d'adresses séparées par des virgules) qui reçoit l'email de synthèse. Laissez vide pour désactiver complètement les notifications.

Fréquence (CAPPATROL_NOTIF_FREQUENCY)

• Jamais : aucun email envoyé.
• Tous les jours : un email à chaque exécution du cron, uniquement si des anomalies sont détectées.
• Une fois par semaine : un email par semaine, le jour configuré ci-dessous.

Jour d'envoi hebdomadaire (CAPPATROL_NOTIF_WEEKDAY)

Si la fréquence est hebdomadaire, ce paramètre choisit le jour de la semaine (1 = lundi, 7 = dimanche, norme ISO-8601).

• Défaut : 1 (lundi).

Une garde d'idempotence interne empêche le double envoi : si un email a déjà été envoyé dans les 24 dernières heures pour la même entité, le nouveau cron ne le renvoie pas.

Modèle d'email (CAPPATROL_NOTIF_EMAIL_TEMPLATE)

Libellé d'un modèle d'email défini dans Outils -> Modèles d'emails. Si renseigné, capPatrol utilise le sujet et le contenu du modèle, en remplaçant les jetons suivants :

Si laissé vide, capPatrol utilise un texte générique en français ou anglais selon la langue Dolibarr du serveur.

Bonnes pratiques de configuration

• Première mise en service : laissez les valeurs par défaut, exécutez un calcul, regardez les alertes pendant une semaine. Ajustez ensuite la médiane minimale et le ratio d'écart selon ce que vous trouvez pertinent ou non.
• Activité saisonnière marquée : montez la profondeur d'historique à 24 et le ratio d'écart à 0,30 pour absorber la saisonnalité.
• Facturation mensuelle stricte : laissez le jour du mois à 6 si vous facturez avant le 5. Plus haut sinon.
• Très petit parc (< 50 tiers) : capPatrol bascule automatiquement sur la détection MAD ; les paramètres Isolation Forest n'ont pas d'effet.