CapPatrol cappatrol

Préparation : un client facturé chaque mois depuis au moins trois mois, sans facture ce mois-ci.

1. Avant le jour du mois des oublis (6 par défaut), lancer "Recalculer maintenant" sur Anomalies clients. Attendu : le client n'est pas signalé.
2. À partir du jour 6, recalculer. Attendu : le client apparaît dans l'onglet Oubliées. Un client à cadence irrégulière n'y apparaît jamais.

Préparation : un client facturé régulièrement, dont le mois courant est nettement au-dessus (pic) ou en dessous (chute, mais supérieur à zéro) de sa médiane.

1. Recalculer sur Anomalies clients. Attendu : le client apparaît dans l'onglet Pics ou Chutes avec sa médiane, le chiffre du mois et son score. Sur un petit parc, la méthode affichée est MAD.

Préparation : un client récent (3 mois de factures) et un client annuel (une facture par an, la précédente sortie de la fenêtre d'historique).

1. Recalculer sur Anomalies clients. Attendu : le client récent n'est pas signalé en pic à cause des mois antérieurs à sa première facture ; le client annuel n'est pas signalé comme oublié.

1. Sur une ligne d'Anomalies clients, cliquer "Marquer comme normal" et confirmer. Attendu : la ligne disparaît ; le client reste masqué pour cette catégorie pendant la durée configurée (30 jours par défaut), y compris aux recalculs suivants.
2. Marquer comme normal un client en pic, puis le faire signaler en écart récurrent. Attendu : il ne revient pas par la catégorie écart récurrent.

1. Filtrer Anomalies clients (onglet, score minimum, catégorie de tiers), changer de page, puis cliquer "Exporter (CSV)". Attendu : le fichier contient exactement les lignes filtrées (UTF-8 avec BOM, séparateur ;).
2. Avec un tiers dont le nom commence par "=", ouvrir le CSV dans un tableur. Attendu : le nom s'affiche comme du texte, aucune formule n'est exécutée.

Préparation : Multicompany actif avec deux entités.

1. Depuis l'entité 1, cliquer "Recalculer maintenant". Attendu : seule l'entité 1 est recalculée ; les scores de l'entité 2 ne changent pas.

Préparation : une catégorie de clients habituellement facturée du 1er au 5 de chaque mois.

1. Ce mois-ci, ne facturer qu'une partie de ces clients, puis ouvrir Facturation -> capPatrol -> Cadence du mois et recalculer. Attendu : une ligne "Chute" pour la catégorie, avec le créneau de jours, le cumul observé, la médiane historique et le score. Un seul créneau (le plus marqué) par catégorie, type et sens.

1. Dans Configuration -> capPatrol, saisir une profondeur d'historique de 2 mois, puis une adresse de notification invalide, et enregistrer. Attendu : enregistrement refusé avec un message explicite, rien n'est modifié.
2. Remettre des valeurs valides. Attendu : enregistrement accepté. Un utilisateur qui a seulement le droit de configuration capPatrol peut aussi enregistrer.

Préparation : une adresse de notification et au moins une anomalie.

1. Fréquence quotidienne : lancer deux fois la tâche planifiée dans la journée. Attendu : un seul courriel, qui résume les anomalies et renvoie vers la page.
2. Fréquence hebdomadaire sur le lundi : lancer la tâche un mardi. Attendu : aucun courriel. Avec un modèle d'email Dolibarr configuré, ses jetons sont remplacés.

1. Dans Outils -> Tâches planifiées, lancer la tâche capPatrol. Attendu : chaque entité active est analysée ; le résultat vaut 0 et la sortie résume chaque entité (statut, nombre d'anomalies), y compris quand il n'y a rien à signaler. La tâche est planifiée chaque jour à 06:00.

1. Appeler en GET, ou en POST sans jeton, les actions de recalcul, de correction de paiement, d'ignorance d'un signalement et de liste blanche. Attendu : refusées, rien n'est modifié.
2. Ouvrir les pages capPatrol avec un utilisateur sans droit capPatrol. Attendu : accès refusé.

Préparation : instance de test (MAIN_FEATURES_LEVEL >= 2, CAPPATROL_ALLOW_DEMO_DATA = 1 ou DEMO_INSTANCE = 1), administrateur avec le droit de créer des factures.

1. Ouvrir admin/demo.php, cocher la confirmation, cliquer "Générer les données de démonstration". Attendu : 18 clients fictifs, 12 mois de factures, un compte rendu sans erreur ; le tableau de bord montre un oubli (Garage Moreau), une double facturation (Hôtel Belvédère), une chute (Imprimerie Nouvelle) et des factures non transmises.
2. Relancer la génération : rien n'est dupliqué.
3. Cliquer "Supprimer les données de démonstration" : tout ce qui a été créé disparaît. Sur une instance de production, la page refuse les deux actions.

Préparation : un client facturé 20 EUR chaque mois depuis cinq mois, facturé 40 EUR ce mois-ci.

1. Recalculer sur Anomalies clients. Attendu : le client apparaît dans l'onglet Écart récurrent (+100 %). Le montant comparé est le cumul du 1er au jour J du mois, face au cumul des mêmes jours des mois précédents.

Préparation : un client facturé chaque mois le 10, et un client facturé plusieurs fois par mois.

1. Ce mois-ci, émettre la facture du 10 dès le 8 et recalculer le 8. Attendu : pas de pic (tolérance de 3 jours, CAPPATROL_RECUR_DAY_TOLERANCE).
2. Recalculer le 10 pour le client facturé plusieurs fois par mois, avant ses factures de fin de mois. Attendu : pas de chute, la comparaison se fait sur les mêmes jours des mois précédents.

Préparation : un client facturé par une facture modèle A depuis cinq mois.

1. Arrêter le modèle A, créer un modèle B au même montant, générer la facture du mois par B, recalculer. Attendu : aucun écart signalé.
2. Pour un second client, laisser A et B générer chacun une facture ce mois-ci, recalculer. Attendu : le client ressort en écart récurrent (pic, double facturation).

Préparation : sur une installation existante, désactiver puis réactiver le module (déclencheur BILL_VALIDATE) ; un client facturé 20 EUR par mois depuis cinq mois.

1. Créer et valider une facture de 40 EUR pour ce client. Attendu : la validation réussit ; un événement d'agenda "écart" est rattaché à la facture, avec le cumul du mois et la moyenne des mêmes jours.
2. Valider une facture de 20 EUR pour un autre client stable. Attendu : aucun événement. Avec CAPPATROL_RECUR_TRIGGER = 0, aucun événement non plus.

Préparation : une facture validée envoyée par email, une validée jamais envoyée à un client qui a un email, une validée pour un client sans email, un brouillon.

1. Ouvrir Facturation -> capPatrol -> Non transmises. Attendu : seules les deux factures jamais envoyées apparaissent, la première en "A un email, jamais envoyée" avec le bouton Envoyer, la seconde en "Tiers sans email". Le brouillon et la facture envoyée n'apparaissent pas. Les compteurs correspondent aux listes filtrées.

Préparation : modules Stancer et Mollie ; une facture dont le paiement Dolibarr est rattaché à une transaction Stancer refusée, alors que Mollie a encaissé.

1. Ouvrir Facturation -> capPatrol -> Paiements et cliquer "Re-vérifier les paiements maintenant". Attendu : la facture est signalée "Lié à une tentative refusée", avec la passerelle enregistrée (Stancer) et la passerelle réelle (Mollie) confirmée par l'API.

1. Préparer une facture encaissée par deux passerelles pour son montant total, et un paiement Dolibarr sans transaction passerelle. Attendu après re-vérification : "Double encaissement" pour la première, "Paiement orphelin" pour le second.
2. Préparer une facture réglée en deux parts légitimes (Stancer + Mollie) et un prélèvement SEPA groupé couvrant plusieurs factures. Attendu : aucun signalement.

Préparation : un compte bancaire configuré par passerelle (Configuration -> Réconciliation des paiements) ; un signalement "Mauvaise passerelle" confirmé par API.

1. Cliquer "Re-rattacher le paiement" et confirmer. Attendu : le paiement porte la bonne passerelle et sa transaction, sa ligne bancaire passe sur le compte de la passerelle, aucun paiement n'est supprimé.
2. Refaire avec une ligne bancaire déjà rapprochée, ou un compte cible d'une autre entité ou devise. Attendu : correction refusée, rien n'est modifié.

1. Sur une fiche facture client, cliquer "Piste de paiement". Attendu : la chronologie des transactions passerelle et des paiements Dolibarr de la facture.
2. Avec un utilisateur qui a le droit capPatrol mais pas celui de lire les factures, ouvrir payment_trace.php?facid=X. Attendu : accès refusé.

Préparation : générer le jeu de démonstration (admin/demo.php) ou disposer d'au moins une anomalie client, une incohérence de paiement ouverte et une facture validée jamais envoyée.

1. Ouvrir Facturation -> capPatrol.
2. Vérifier les quatre tuiles : Anomalies clients, Cadence du mois, Paiements, Non transmises. Attendu : chaque tuile affiche son nombre d'alertes, le montant en jeu quand il existe, l'état "À vérifier" (icône triangle) ou "Rien à signaler" (icône coche). Une incohérence de paiement ignorée n'est pas comptée. Chaque ligne de tuile mène à la page filtrée correspondante.

Préparation : jeu de démonstration généré.

1. Ouvrir Facturation -> capPatrol, bloc "À traiter en priorité". Attendu : au plus dix lignes, tous contrôles confondus (anomalies clients, cadence, paiements), triées par score décroissant. Une ligne client mène à la fiche du tiers, une ligne paiement à la piste de paiement de la facture, une ligne cadence à la page de cadence.

1. Ouvrir Facturation -> capPatrol, bloc "Santé de la surveillance". Attendu : 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.
2. Désactiver la tâche planifiée capPatrol, attendre plus de 48 h sans analyse réussie (ou vieillir la dernière analyse en base). Attendu : un bandeau d'avertissement indique que la surveillance est peut-être arrêtée ; la prochaine exécution affiche "Tâche planifiée absente ou désactivée".
3. Sous la santé, la courbe des oubliés, pics et chutes apparaît dès deux analyses, avec "Afficher les chiffres".

Préparation : module fraîchement activé, aucune analyse lancée.

1. Ouvrir Facturation -> capPatrol. Attendu : un message indique que le détecteur n'a pas encore tourné ; les tuiles Anomalies clients, Cadence du mois et Paiements affichent "Pas encore analysé" (icône sablier), jamais "Rien à signaler". La tuile Non transmises, calculée en direct, affiche son état réel.

Préparation : sur une installation existante, désactiver puis réactiver le module.

1. Ouvrir le menu Facturation. Attendu : une seule entrée "capPatrol" avec l'icône du chien, qui ouvre le tableau de bord.
2. Cliquer sur capPatrol. Attendu : les sous-entrées Anomalies clients, Cadence du mois, Paiements, Non transmises apparaissent au même niveau, et restent ouvertes en naviguant entre elles. Un contrôle désactivé dans la configuration n'a pas de sous-entrée.