Questions fréquentes

capPatrol fait-il des appels à un service externe ?

Non. Tout le calcul tourne en local sur votre serveur Dolibarr. Le détecteur Isolation Forest (Rubix ML) est embarqué dans le dossier vendor/ du module. Aucune donnée client n'est envoyée à un service tiers, aucun cloud n'est utilisé.

Que se passe-t-il si le détecteur plante ?

Le cron capture l'erreur, marque le run en statut error dans la table d'audit, journalise via dol_syslog (préfixe CAPPATROL) et conserve les anciens scores. La table d'anomalies n'est pas vidée si l'écriture en base a échoué : la transaction est annulée et vous gardez la dernière analyse réussie à l'écran.

Le mois courant est-il vraiment le mois calendaire ?

Oui. capPatrol raisonne sur le mois calendaire courant, pas sur une fenêtre roulante de 30 jours. Donc le 1er du mois, le mois courant est forcément vide jusqu'à votre première facture, ce qui explique le paramètre "Jour du mois pour signaler un oubli" (jour à partir duquel on commence à signaler).

Mon Dolibarr est multidevises. Comment capPatrol gère-t-il ?

En v1, capPatrol somme total_ht brut, sans conversion. Si vous avez des factures en plusieurs devises pour un même tiers, les scores peuvent être imprécis. Une conversion est prévue en v2.

En attendant, vous pouvez :

• exclure les tiers multidevises via la liste des catégories à exclure ;
• créer une catégorie "Multidevise" dédiée et la déclarer dans le paramètre CAPPATROL_EXCLUDED_CATEGORIES.

Pourquoi un tiers à cadence irrégulière n'est-il jamais en "Oubli" ?

Parce que pour un client irrégulier, l'absence de facture sur un mois donné n'a aucune valeur prédictive. capPatrol n'a pas de référence stable à comparer.

Si vous voulez quand même surveiller un tel tiers, vous pouvez :

• modifier la profondeur d'historique pour englober suffisamment d'événements et lui faire passer le seuil de cadence trimestrielle ou annuelle ;
• créer une alerte manuelle dans votre logiciel de comptabilité.

Puis-je voir l'historique des runs ?

La table llx_cappatrol_run conserve une trace de chaque exécution (date, durée, méthode, comptes par catégorie, statut, message). Une page dédiée d'audit est prévue en v2 ; en attendant, votre administrateur peut consulter la table avec une requête SQL :

SELECT * FROM llx_cappatrol_run ORDER BY started_at DESC LIMIT 20;

Comment supprimer une whitelist avant son expiration ?

En v1, il faut supprimer manuellement la ligne dans llx_cappatrol_whitelist. Une page d'administration des whitelists est prévue en v2.

Votre administrateur base de données peut exécuter :

DELETE FROM llx_cappatrol_whitelist
WHERE entity = 1 AND fk_soc = <ID_DU_TIERS> AND category = '<oubli|pic|chute>';

capPatrol fonctionne-t-il avec mon activité saisonnière ?

capPatrol v1 ne corrige pas la saisonnalité. Un client B2B fortement saisonnier (par exemple : pic en décembre, creux en août) peut générer des faux positifs "Pic" ou "Chute".

Pour atténuer :

• augmentez la profondeur d'historique à 24 mois (capture deux cycles annuels) ;
• augmentez le ratio d'écart minimum à 0,30 ou plus pour absorber les variations saisonnières naturelles ;
• whitelistez ponctuellement les périodes connues (par exemple, marquez comme normal pendant les soldes).

Une comparaison "même mois N-1" est prévue en v2.

Que faire si je vois trop d'alertes ?

Trois leviers principaux :

1. Augmenter le seuil de médiane minimale (CAPPATROL_MIN_MEDIAN_AMOUNT) pour ignorer les très petits comptes.
2. Augmenter le ratio d'écart (CAPPATROL_DEVIATION_MIN_RATIO) à 0,30 ou 0,40 : seules les anomalies vraiment marquantes seront signalées.
3. Diminuer le taux de contamination (CAPPATROL_IF_CONTAMINATION) à 0,02 (2 %) : Isolation Forest sera plus exigeant.

Que faire si je ne vois aucune alerte alors que je devrais ?

Vérifiez dans cet ordre :

1. Le cron a-t-il tourné ? Regardez le badge de fraîcheur sur la page principale. S'il est rouge, lancez "Recalculer maintenant".
2. Les factures sont-elles bien validées ? capPatrol n'analyse que les factures aux statuts validé (1) ou payé (2) par défaut. Si vous travaillez surtout en brouillon, activez le paramètre "Inclure les factures brouillon".
3. Les tiers sont-ils dans une catégorie exclue ? Vérifiez la configuration du paramètre "Catégories de tiers à exclure".
4. La médiane est-elle au-dessus du seuil ? Si vous avez beaucoup de petits comptes, baissez le seuil de médiane minimale.
5. Les logs Dolibarr : filtrez sur CAPPATROL pour voir le diagnostic complet du dernier run.

La méthode MAD donne-t-elle des résultats fiables ?

Oui pour les chutes et les pics extrêmes. La méthode MAD est moins fine qu'Isolation Forest car elle ignore la structure multivariée des données (corrélations entre médiane, MAD, cadence, etc.) mais elle reste très solide statistiquement (z-score robuste).

Sur les très petits parcs (< 100 tiers), MAD est en réalité préférable à Isolation Forest qui devient instable avec si peu de données.

Mes alertes sont-elles confidentielles ?

Oui :

• aucune donnée n'est envoyée à un service externe ;
• les emails de notification sont envoyés via votre serveur SMTP Dolibarr habituel, à l'adresse que vous configurez ;
• les logs CAPPATROL ne contiennent jamais d'identifiant client ni de montant : seulement des compteurs techniques.

Si vous avez besoin d'un suivi RGPD strict, vérifiez la rotation de vos logs Dolibarr et restreignez l'accès à la page capPatrol via le système de permissions Dolibarr (cappatrol -> read).

Comment puis-je remonter un bug ou demander une amélioration ?

Utilisez le formulaire de retour intégré : Configuration -> Modules -> capPatrol -> À propos, encart "Vous aimez ce module ?". Le formulaire permet de noter le module et d'écrire un message libre. Tout est envoyé directement à l'éditeur (commercial+cappatrol@cap-rel.fr).

Vous pouvez aussi écrire directement à https://cap-rel.fr/contact/ ou poster une question sur le forum officiel Dolibarr https://www.dolibarr.fr/forum.