# 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.*