Cahier des recettes – Livraison application dirCops
Application : dirCops
Projet : Suivi facturation / échéancier / paiement — Écloserie marine (remplacement du fichier Excel)
Version : 1.0
Date : 2026-02-10
Usage : cocher chaque critère après test de recette et indiquer O (OK) / N (Non conforme) / NA (Non applicable) + commentaire si nécessaire.
0. Périmètre et règles d’alignement (références)
Écrans/pages (MVP)
- Clients :
app/index.html
- Fiche client :
app/client.html?id=...
- Tableau de bord :
app/dashboard.html
- Meilleurs clients :
app/top-clients.html (Top 15)
- Quantités :
app/quantites-clients.html
Référence : app/LISTING-ECRANS-PAGES.md.
Accès / rôles
- L’authentification est Livinweb ModX (identifiant/mot de passe). Le contrôle d’accès est hors scope applicatif si géré par l’environnement de déploiement.
- Rôle MVP : Commercial / Admin (lecture/écriture). Autres rôles éventuels = options.
Références : app/README.md, app/ROLES-PERMISSIONS-RBAC.md, app/ACTEURS-UTILISATEURS.md.
Règles métier clés (à respecter en recette)
- Encours facture =
montant_ht − somme(paiements) ; si encours < 0, afficher 0 (pas de crédit client affiché).
- Paiement > montant facture : autorisé ; encours affiché = 0.
- Unicité
n_facture : pas de contrainte en périmètre actuel.
- Clients en doublon : non gérés (pas de détection/fusion).
- Navigateurs : Safari non supporté (ne pas exiger de recette Safari).
Références : app/REGLES-METIER.md, app/LOGIQUE-PAIEMENTS-ECHEANCIERS.md, app/QUESTIONS-A-TRANCHER.md.
Modes de test (au choix)
- Mode simulation : données depuis
app/mock/*.json (pas de MySQL).
- Mode base : MySQL/MariaDB +
MOCK_MODE=0 + schéma app/sql/schema.sql.
Référence : app/README.md.
1. Gestion clients
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 1.1 |
Depuis l’accueil Clients, la liste des clients s’affiche. |
|
|
| 1.2 |
La recherche par nom de client filtre correctement la liste (saisie partielle). |
|
|
| 1.3 |
Depuis l’accueil, on peut ajouter un client ; le nouveau client apparaît dans la liste. |
|
|
| 1.4 |
Depuis l’accueil, on peut supprimer un client ; une confirmation est demandée ; la liste est mise à jour (et les données associées sont gérées selon la règle d’implémentation). |
|
|
| 1.5 |
Les doublons de clients (même nom) sont acceptés et affichés tels quels (pas de blocage). |
|
|
2. Fiche client (affichage)
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 2.1 |
En cliquant sur un client, la fiche client s’ouvre avec le bon id et le bon nom. |
|
|
| 2.2 |
La fiche client affiche : nom, encours client, liste des factures, liste des paiements, et la zone échéancier par facture (si présent). |
|
|
| 2.3 |
Après une action (ajout/modif/suppression facture/paiement/échéancier), la fiche se met à jour et reste cohérente (montants/états). |
|
|
3. Factures (suivi)
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 3.1 |
Pour un client, la liste des factures affiche au minimum : n° facture, n° vente, date facture, type produit, cycle, quantités, montant HT, total payé, encours, état (Payée / En attente). |
|
|
| 3.2 |
Le formulaire Ajouter une facture (suivi) est accessible et compréhensible. |
|
|
| 3.3 |
L’ajout d’une facture avec les champs obligatoires (ex. n° facture, date, montant HT) enregistre la facture et l’affiche dans la liste. |
|
|
| 3.4 |
L’ajout/modification d’une facture avec type (alevins/larves), cycle, quantités et quantité livrée enregistre et ré-affiche correctement ces champs (cas “quantité livrée vide” géré sans erreur). |
|
|
| 3.5 |
On peut modifier une facture : le formulaire se remplit ; après validation, les données sont mises à jour et l’encours/état se recalculent. |
|
|
4. Paiements
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 4.1 |
Sur la fiche client, la liste des paiements s’affiche (facture concernée, date, montant). |
|
|
| 4.2 |
Le formulaire Enregistrer un paiement propose uniquement des factures en attente (encours > 0). |
|
|
| 4.3 |
La saisie d’un montant et d’une date enregistre le paiement et met à jour l’encours/état de la facture (sans incohérence). |
|
|
| 4.4 |
Un paiement supérieur au montant restant dû est accepté ; l’encours affiché de la facture (et du client) reste à 0 (pas de crédit affiché). |
|
|
5. Échéancier de paiement
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 5.1 |
Depuis la fiche client, on peut ajouter un échéancier à une facture (facture, nb échéances, date de début). |
|
|
| 5.2 |
Après ajout, l’échéancier apparaît pour la facture concernée (nb échéances, date de début, montant par échéance si affiché). |
|
|
| 5.3 |
Une facture ne peut avoir qu’un seul échéancier ; une tentative de doublon est empêchée (message ou blocage). |
|
|
| 5.4 |
Une facture soldée (encours ≤ 0) ne permet pas de créer un échéancier (blocage + message). |
|
|
6. Calculs financiers (encours, états, échéances)
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 6.1 |
L’encours par facture correspond à montant_ht − somme(paiements) et est plafonné à 0 si négatif. |
|
|
| 6.2 |
L’encours par client correspond à la somme des encours factures du client (après plafonnement à 0). |
|
|
| 6.3 |
L’état facture est Payée si encours ≤ 0, En attente sinon, et se met à jour après ajout/suppression de paiement. |
|
|
| 6.4 |
Le bloc échéances à venir (tableau de bord) liste des échéances cohérentes : avec échéancier (date début + N mois, montant par échéance), sans échéancier (date facture + encours). |
|
|
7. Tableau de bord / Top clients / Quantités (pages analytiques)
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 7.1 |
Le tableau de bord affiche : encours par client, synthèse (dont encours total), échéances à venir, et les liens d’exports. |
|
|
| 7.2 |
La page Meilleurs clients permet de choisir le type (Alevins/Larves) et optionnellement un cycle, et affiche un Top 15 cohérent (totaux/% cohérents). |
|
|
| 7.3 |
La page Quantités affiche des quantités par client et le filtre type (Alevins/Larves) restreint correctement les lignes. |
|
|
| 7.4 |
Les liens vers la fiche client depuis les pages (dashboard/top/quantités) ouvrent le bon client. |
|
|
8. Exports CSV
Référence : app/EXPORT-CSV-SPEC.md (colonnes “retenues” + options à trancher).
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 8.1 |
Export Encours par client : téléchargement d’un fichier reporting-encours-YYYY-MM-DD.csv ; séparateur cohérent (ex. ;), encodage OK (accents), au minimum colonnes Nom client et Encours. |
|
|
| 8.2 |
Export Ensemble des factures : téléchargement d’un fichier suivi-factures-YYYY-MM-DD.csv ; en-têtes/colonnes conformes à la spécification retenue (client, n° facture, dates, type, cycle, quantités, montant, total payé, encours, état). |
|
|
| 8.3 |
Les formats dates (jj/mm/aaaa ou ISO selon décision) et montants (virgule/points, symbole € ou non) sont cohérents et documentés. |
|
|
9. Navigation, erreurs, non-fonctionnel
| # |
Critère de recette |
O/N/NA |
Commentaires |
| 9.1 |
Depuis chaque page, l’en-tête propose la navigation : Clients, Tableau de bord, Meilleurs clients, Quantités. |
|
|
| 9.2 |
Les montants sont affichés en euros et les dates dans un format cohérent sur l’ensemble des pages. |
|
|
| 9.3 |
En cas d’erreur (champ obligatoire, API indisponible, erreur serveur), un message compréhensible s’affiche (sans écran blanc). |
|
|
| 9.4 |
Temps de réponse acceptable en conditions normales (ordre de grandeur : affichage initial < 3s, actions usuelles ~< 1s) et accès restreint aux personnes autorisées (selon déploiement ModX). |
|
|
Cahier des recettes – Livraison application dirCops
Application : dirCops
Projet : Suivi facturation / échéancier / paiement (EMGI)
Version : 1.0
Date : 2026-02-09
Usage : Cocher chaque ligne après test de recette. Indiquer O (OK) / N (Non conforme) / NA (non applicable) si besoin.
1. Gestion clients (FR1, FR2)
| # |
Critère de recette |
O/N |
| 1.1 |
Depuis l’accueil, la liste des clients s’affiche. |
|
| 1.2 |
La recherche par nom de client filtre bien la liste (saisie partielle). |
|
| 1.3 |
En cliquant sur un client, la page détail client s’ouvre avec le bon client. |
|
| 1.4 |
La page détail affiche : nom du client, encours, liste des factures, liste des paiements. |
|
| 1.5 |
Depuis l’accueil, on peut ajouter un client (formulaire « Ajouter un client ») ; le nouveau client apparaît dans la liste. |
|
| 1.6 |
Depuis l’accueil, on peut supprimer un client (icône/bouton supprimer) ; une confirmation est demandée ; la suppression supprime aussi factures, paiements et écheanciers associés (ou un message d’erreur si factures existantes selon règle métier). |
|
2. Factures (FR3, FR3b)
| # |
Critère de recette |
O/N |
| 2.1 |
Pour un client, la liste des factures affiche : n° facture, n° vente, date, type produit, cycle, quantité facturée, quantité livrée, montant HT, encours facture, état (Payé / En attente). |
|
| 2.2 |
Depuis la page détail client, le formulaire « Ajouter une facture (suivi) » est accessible et compréhensible. |
|
| 2.3 |
L’ajout d’une facture avec n° facture, date, montant HT obligatoires enregistre bien la facture et la fait apparaître dans la liste du client. |
|
| 2.4 |
L’ajout d’une facture avec type (alevins/larves), cycle, quantités et quantité livrée enregistre correctement ces champs et les affiche dans la liste. |
|
| 2.5 |
Une facture sans quantité livrée affiche « - » ou 0 selon le cas, sans erreur. |
|
| 2.6 |
On peut modifier une facture existante (bouton/icône Modifier) : le formulaire se remplit avec les données de la facture ; après envoi, les données sont mises à jour. |
|
| 2.7 |
On peut supprimer une facture (bouton/icône Supprimer) ; une confirmation est demandée ; la facture et ses paiements/écheancier associés sont supprimés. |
|
3. Écheancier de paiement (FR4b, FR5b)
| # |
Critère de recette |
O/N |
| 3.0.1 |
Depuis la page détail client, on peut ajouter un écheancier à une facture (facture associée, nombre d’échéances, date de début d’écheancier). |
|
| 3.0.2 |
Après ajout, l’écheancier apparaît pour la facture concernée (nombre d’échéances, date de début). |
|
| 3.0.3 |
Une facture ne peut avoir qu’un seul écheancier (ou pas d’écheancier). |
|
| 3.0.4 |
On peut supprimer un écheancier (bouton/icône Supprimer) ; une confirmation est demandée ; l’écheancier disparaît de la liste. |
|
4. Paiements (FR4, FR5)
| # |
Critère de recette |
O/N |
| 3.1 |
Sur la page client, la liste des paiements du client s’affiche (facture concernée, date, montant). |
|
| 3.2 |
Le formulaire « Enregistrer un paiement » propose uniquement les factures en attente (encours > 0). |
|
| 3.3 |
La saisie d’un montant et d’une date puis la soumission enregistre le paiement et met à jour l’encours de la facture. |
|
| 3.4 |
Après enregistrement d’un paiement, la page se recharge et les montants (encours client, encours par facture) sont cohérents. |
|
| 3.5 |
On peut supprimer un paiement (bouton/icône Supprimer) ; une confirmation est demandée ; le paiement disparaît et l’encours de la facture se met à jour. |
|
5. Calculs financiers (FR6, FR7, FR8, FR9)
| # |
Critère de recette |
O/N |
| 4.1 |
L’encours affiché par client correspond à la somme des montants HT des factures moins la somme des paiements de ce client. |
|
| 4.2 |
Le tableau de bord affiche un encours total cohérent avec la somme des encours par client. |
|
| 4.3 |
Les échéances à venir listent les échéances prévues (date ≥ aujourd’hui) : pour les factures avec écheancier, les dates et montants sont calculés à partir de l’écheancier (date début + N mois, montant par échéance) ; pour les factures sans écheancier, la date de facture et l’encours sont affichés. Colonnes : client, n° facture (éventuellement numéro d’échéance), date échéance, montant. |
|
| 4.4 |
Après ajout d’un paiement, l’encours du client et l’état des factures (Payé / En attente) se mettent à jour sans re-saisie. |
|
6. Reporting et tableaux de bord (FR10, FR10b, FR10c, FR11)
| # |
Critère de recette |
O/N |
| 5.1 |
Le tableau de bord affiche : encours par client (tri croissant), synthèse (encours total en k€, délai moyen de paiement en j), échéances à venir, liens export encours CSV et export ensemble des factures (PJ). |
|
| 5.1b |
Les clients affichés sont des noms de clients (pas des lieux de départ ; EMGI = lieu de départ, pas un client). |
|
| 5.2 |
La page « Top clients » permet de choisir le type (Alevins / Larves) et optionnellement le cycle (24-25, 25-26). |
|
| 5.3 |
La page « Top clients » affiche pour le type et cycle choisis : client, quantités, % qté, CA HT, % CA, lien vers fiche client. Les totaux sont cohérents. |
|
| 5.4 |
La page « Quantités » affiche par client : quantité facturée, quantité livrée, lien vers fiche client. |
|
| 5.5 |
Le filtre par type (Alevins / Larves) sur la page « Quantités » restreint correctement les lignes affichées. |
|
| 5.6 |
L’export encours CSV (reporting?format=csv) télécharge un fichier avec encours par client (séparateur cohérent, caractères accentués corrects). |
|
| 5.7 |
L’export « ensemble des factures (PJ) » (reporting?format=factures_csv) télécharge un CSV calqué sur l’onglet Factures Excel (EMGI_FTI_Suivi des Ventes) : en-têtes EXO, Mois, CLIENT, PAYS, DEPART DEM, NEG., TYPE, CYCLE, produc, PAI, DATE FACTUR, N° DE VENTE, N° FACTURE, QTE FACT, QTE LIVREE, % GT, CA FACTURE HT, PU, Total payé, Encours ; colonnes renseignées selon les données appli, format français (dates jj/mm/aaaa, nombres virgule/espaces). |
|
7. Navigation et ergonomie
| # |
Critère de recette |
O/N |
| 6.1 |
Depuis chaque page, l’en-tête affiche le nom de l’application (dirCops) et les liens vers Clients, Tableau de bord, Top clients, Quantités. |
|
| 6.2 |
Les montants sont affichés en euros (format français). Les dates sont au format français. |
|
| 6.3 |
En cas d’erreur (ex. champ obligatoire manquant, API indisponible), un message d’erreur compréhensible s’affiche. |
|
8. Non fonctionnel (NFR1, performance)
| # |
Critère de recette |
O/N |
| 7.1 |
L’application est accessible uniquement aux personnes autorisées (contrôle d’accès selon environnement de déploiement). |
|
| 7.2 |
Le chargement initial de la liste des clients ou du tableau de bord reste acceptable (< 3 s dans des conditions normales). |
|
| 7.3 |
Les actions (recherche, clic, enregistrement) répondent en moins d’environ 1 s. |
|
9. Synthèse
| Section |
Nombre de critères |
Validés (O) |
Non conformes (N) |
NA |
| 1. Gestion clients |
6 |
|
|
|
| 2. Factures |
7 |
|
|
|
| 3. Écheancier |
4 |
|
|
|
| 4. Paiements |
5 |
|
|
|
| 5. Calculs financiers |
4 |
|
|
|
| 6. Reporting |
9 |
|
|
|
| 7. Navigation |
3 |
|
|
|
| 8. Non fonctionnel |
3 |
|
|
|
| Total |
41 |
|
|
|
Livraison acceptée si : tous les critères bloquants sont à O (ou NA documenté). Les critères N doivent être listés et traités (correctif ou décision d’acceptation sous réserve).
Document généré à partir du PRD et des fonctionnalités livrées. À compléter par le client ou la maîtrise d’ouvrage lors de la recette.