cahier-recettes-livraison.md 16 KB

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.