# Schéma de chiffrage & grille de complexité — dirCops (EMGI) Application : Suivi FTI EMGI Projet : Suivi facturation / échéancier / paiement (EMGI) Date : 2026-02-09 Public : Client (ampleur du travail), équipes techniques (chiffrage, lots, complexité) > Ce document **fusionne** et **remplace** : > - `schema-chiffrage-projet.md` > - `grille-complexite-chiffrage.md` > > Objectif : cadrer le périmètre et fournir un référentiel unique pour structurer le backlog et chiffrer. --- ## 1) Schéma fonctionnel par modules (WBS / lots chiffrables) Objectif : découper le projet en lots livrables et chiffrables. Livrable : backlog structuré par module + dépendances. ### Modules identifiés (périmètre aligné) | Module | Fonctionnalités | Règles métier principales | Dépendances | Priorité | |---|---|---|---|---| | **Config / Fondations** | Base de données, config (`.env`, PDO), mode mock vs DB | Mock et DB doivent rester cohérents (mêmes règles métier) | — | P0 | | **Clients** | Liste, détail client (en-tête + encours), ajout, suppression | Encours = somme factures − somme paiements (via Calculs) | Calculs | P0 | | **Factures** | Liste par client, ajout, modification, suppression | Facturation source Pennylane (ici : **suivi**) ; pas de contrainte d’unicité `n_facture` en MVP | Clients | P0 | | **Paiements** | Liste par client, enregistrement, suppression | montant > 0 ; recalcul encours après ajout/suppression | Factures, Calculs | P0 | | **Écheanciers** | Liste, création, suppression ; affichage par client/facture | 1 écheancier max par facture ; échéances dérivées (ex. mensuelles) | Factures | P0 | | **Calculs financiers** | Encours par client, encours total, échéances à venir | Encours client = Σ montant_ht − Σ paiements ; état facture dérivé (payée / en attente) | Factures, Paiements | P0 | | **Reporting** | Tableau de bord, export encours CSV, export factures CSV, Top clients, Quantités par client | Agrégations par client/type/cycle ; exports compatibles Excel (UTF‑8, séparateur `;`) | Calculs, Factures | P0 | | **Accès (optionnel selon hébergement)** | Login Livinweb ModX (identifiant/mot de passe), SSO en option | Accès restreint ; pas de RBAC multi-profils en MVP (option post‑MVP) | Config | P1 | ### Lots recommandés (périmètre actuel) - **Lot 1 — Fondations & données** : schéma DB, config, mode mock, CRUD clients, liste + détail client. - **Lot 2 — Factures & paiements** : APIs factures/paiements, recalcul encours, intégration page client. - **Lot 3 — Écheanciers** : API écheanciers, formulaire + affichage, règle 1 écheancier / facture. - **Lot 4 — Reporting** : dashboard, exports CSV, Top clients, Quantités clients. - **Lot 5 — Accès (si requis)** : intégration login ModX / restriction d’accès (et SSO si demandé). --- ## 2) Schéma des rôles et permissions (matrice RBAC) Objectif : éviter l’oubli fréquent du chiffrage (droits, écrans, actions par profil). Livrable : matrice rôles × ressources/actions. Contexte projet (aligné) : - **MVP** : un seul profil (**Commercial / Admin**) avec tous les droits. - **Option** : ajouter un profil **Lecture seule** (Trésorerie / Direction). ### Matrice RBAC (cible) | Ressource / Action | Commercial / Admin | Lecteur (Tréso / Direction) | |---|---:|---:| | Clients | CRUD | R | | Factures | CRUD | R | | Paiements | CRD | R | | Écheanciers | CRD | R | | Calculs / Encours | R | R | | Reporting / Export | R + Export | R + Export | Notes : - **Pas de** délégation/héritage en MVP. - **Pas de** multi-tenant (une seule entité EMGI). - **Audit log** (qui a fait quoi) : hors MVP. Références : `app/ROLES-PERMISSIONS-RBAC.md`, `app/ACTEURS-UTILISATEURS.md`. --- ## 3) Schéma de données (référence) Objectif : chiffrer le back (tables, règles, index). Livrable : schéma relationnel + description des champs. Entités (simplifié) : - **clients** \(1\) → \(N\) **factures** - **factures** \(1\) → \(N\) **paiements** - **factures** \(0..1\) → \(1\) **echeanciers** Règles métier données (résumé) : - Client : nom obligatoire ; suppression en cascade des factures (et donc paiements, écheanciers). - Paiement : lié à une facture ; montant > 0 ; somme paiements vs montant facture = règle à préciser (bloquer/alerter). - Écheancier : au plus un par facture ; dates d’échéance dérivées (règle : mensuelle, etc.). Document détaillé : `schema-relationnel-et-tables-donnees.md`. Schéma SQL : `app/sql/schema.sql` (+ `app/sql/migration-*.sql`). --- ## 4) Schéma des workflows métier (états et transitions) Objectif : chiffrer validations, statuts, automatisations (léger sur ce projet). Livrable : diagramme d’états + règles. Résumé (aligné) : - **Facture** : 2 états **dérivés** (En attente / Payée), **non stockés** ; Payée si encours ≤ 0 après paiement(s). - **Paiement, écheancier, client** : pas de workflow (création directe). - **Hors MVP** : SLA/relances/escalades, validations multi-étapes, audit log. Document détaillé : `schema-workflows.md`. --- ## 5) Schéma des intégrations et flux (endpoints + points complexes) Objectif : lister les APIs et points techniques complexes pour un chiffrage réaliste. Livrable : liste des endpoints + points complexes. ### Endpoints (API REST) | Méthode | Endpoint | Utilité | |---|---|---| | GET | `/api/clients.php?id=` | Détail d’un client (page client) | | GET | `/api/clients.php` | Liste des clients | | POST | `/api/clients.php` | Création d’un client | | DELETE | `/api/clients.php?id=` | Suppression d’un client (cascade) | | GET | `/api/factures.php?client_id=` | Liste des factures d’un client (avec encours/état) | | POST | `/api/factures.php` | Ajout d’une facture | | PUT | `/api/factures.php` | Modification d’une facture | | DELETE | `/api/factures.php?id=` | Suppression d’une facture (cascade) | | GET | `/api/paiements.php?client_id=` | Liste des paiements d’un client | | POST | `/api/paiements.php` | Enregistrement d’un paiement | | DELETE | `/api/paiements.php?id=` | Suppression d’un paiement | | GET | `/api/echeanciers.php?client_id=` ou `?facture_id=` | Liste des écheanciers (client ou facture) | | POST | `/api/echeanciers.php` | Création d’un écheancier | | DELETE | `/api/echeanciers.php?id=` | Suppression d’un écheancier | | GET | `/api/calculs.php?client_id=` | Encours d’un client | | GET | `/api/calculs.php` | Encours global + échéances à venir (dashboard) | | GET | `/api/reporting.php?format=csv` | Export encours CSV | | GET | `/api/reporting.php?format=factures_csv` | Export factures CSV | | GET | `/api/top-clients.php?type=&cycle=` | Top clients (type/cycle) | | GET | `/api/quantites-clients.php?type=` | Quantités facturées/livrées par client | ### Points complexes à chiffrer spécifiquement (alignés) | Point | Description | Complexité | |---|---|---| | Encours + état facture | Encours = montant_ht − Σ paiements ; état dérivé ; cohérence après chaque mutation paiement | Moyenne | | Échéances à venir | Dériver dates/montants à partir de l’écheancier ; filtrer date ≥ aujourd’hui ; tri | Faible → Moyenne | | Export CSV (Excel) | UTF‑8 (BOM si nécessaire), séparateur `;`, échappement, formats dates/nombres | Faible | | Agrégations Top clients | Agrégations type_produit/cycle ; totaux et pourcentages | Moyenne | | Mode mock vs DB | Même comportement métier entre JSON et PDO ; éviter divergence | À ne pas surchiffrer (discipline) | --- ## 6) Schéma d’architecture applicative (rappel) Objectif : visualiser les blocs du système pour répartir le travail. Livrable : diagramme composants. Résumé : - **Frontend** : HTML + JS vanilla + Tailwind (MPA : une page = un écran) - **API** : PHP, un script par ressource (`clients`, `factures`, `paiements`, `echeanciers`, `calculs`, `reporting`, `top-clients`, `quantites-clients`) - **Données** : soit mock (JSON), soit DB (PDO) Document étendu : `architecture-generale-fonctionnelle-et-interfaces.md` et `architecture.md`. --- ## 7) Grille de complexité (référentiel — version épurée) Usage : barème d’estimation (ordre de grandeur) pour les lots/modules ci‑dessus. ### 7.1 Écrans / Pages | Type d’écran | Complexité | Estimation (ordre de grandeur) | Détail | |---|---|---:|---| | CRUD simple | Faible | 1–2 j | Liste + formulaire, sans calculs complexes | | Avec agrégations/calculs | Moyenne | 2–3 j | Plusieurs sources + calculs (fiche client, dashboard) | | Reporting avancé | Élevée | 3–4 j | Filtres, agrégations, export (Top clients) | | Auth (si applicable) | Faible | 0,5–1 j | Page login + session (si intégration existante) | ### 7.2 API / Backend | Type d’API | Complexité | Estimation (ordre de grandeur) | Détail | |---|---|---:|---| | CRUD simple (GET/POST) | Faible | ~0,5 j | Une table, validation simple | | Calculs / agrégations | Moyenne | 1–2 j | Logique métier, agrégations | | Règles métier avancées | Élevée | 2–3 j | Contraintes multiples, transactions | | Export CSV/JSON | Faible | 0,5–1 j | Génération fichier, encodage, téléchargement | ### 7.3 Tests & qualité (si chiffrés) | Type | Estimation (ordre de grandeur) | Détail | |---|---:|---| | Tests manuels par écran | 0,25–0,5 j | Cas nominaux + limites | | Tests API par endpoint | ~0,25 j | Postman/curl + erreurs | | Recette complète (cahier) | 2–3 j | Exécution critères + corrections mineures | ### 7.4 Estimation indicative par module (ordre de grandeur) > Cette estimation est un **point de départ** (à ajuster selon les décisions finales et le niveau d’exigence). > Elle **n’inclut pas** les options hors périmètre listées en section 8. | Module | Écrans | API | Tests | Total indicatif | |---|---:|---:|---:|---:| | Config / Fondations | — | 1 j | 0,25 j | 1,25 j | | Accès (login ModX / restriction) *(optionnel)* | 1 j | 0,5 j | 0,25 j | 1,75 j | | Clients | 1,5 j | 0,5 j | 0,5 j | 2,5 j | | Factures | 2 j | 1,5 j | 0,5 j | 4 j | | Paiements | 1,5 j | 1 j | 0,5 j | 3 j | | Écheanciers | 1,5 j | 1,5 j | 0,5 j | 3,5 j | | Calculs financiers | — | 2 j | 0,5 j | 2,5 j | | Reporting / Dashboard + exports CSV | 2,5 j | 1,5 j | 0,5 j | 4,5 j | | Top clients | 2 j | 1 j | 0,5 j | 3,5 j | | Quantités clients | 1,5 j | 1 j | 0,5 j | 3 j | | Intégration / Recette | — | — | 2 j | 2 j | | Documentation technique | — | — | 0,5 j | 0,5 j | Notes : - Total indicatif **avec** accès ModX : ~32 j (ordre de grandeur). - Total indicatif **sans** accès ModX : ~30 j (ordre de grandeur). --- ## 8) Alignement périmètre (ce qu’on garde / ce qu’on retire) Cette section est la consolidation des décisions de périmètre pour éviter de chiffrer du hors‑scope. ### À retirer / hors périmètre (MVP) - Recherche client par nom (FR1) **retirée** - Contrainte d’unicité `n_facture` **non prévue** - Cibles de performance (NFR) « < 3 s / < 1 s » **non contractualisées ici** - Infra/CI-CD/monitoring **hors doc de chiffrage MVP** - Workflows/statuts avancés (multi-étapes, SLA, relances, escalades, audit log) **hors MVP** - Multi-tenant, délégation/héritage **hors MVP** ### Fonctionnalités à conserver (périmètre à chiffrer) | Domaine | Fonctionnalité | Fichiers / API concernés | |--------|----------------|---------------------------| | **Clients** | Liste, détail, ajout, suppression | `app/api/clients.php`, `app/index.html`, `app/client.html`, `app/js/client-detail.js` | | **Factures** | Liste par client, ajout, modification, suppression | `app/api/factures.php`, `app/client.html`, `app/js/facture-form.js`, `app/js/client-detail.js` | | **Paiements** | Liste par client, enregistrement, suppression | `app/api/paiements.php`, `app/client.html`, `app/js/paiements.js` | | **Écheanciers** | Liste, création, suppression ; répartition encours | `app/api/echeanciers.php`, `app/client.html`, `app/js/echeancier-form.js`, `app/js/client-detail.js` | | **Calculs** | Encours par client, encours total, échéances à venir | `app/api/calculs.php`, `app/dashboard.html`, `app/js/dashboard.js` | | **Reporting** | Tableau de bord, export encours CSV, export factures CSV | `app/api/reporting.php`, `app/dashboard.html` | | **Meilleurs clients** | Top clients par type (alevins/larves), cycle | `app/api/top-clients.php`, `app/top-clients.html`, `app/js/top-clients.js` | | **Quantités** | Quantités facturées / livrées par client, filtre type | `app/api/quantites-clients.php`, `app/quantites-clients.html`, `app/js/quantites-clients.js` | | **Accès** | Login Livinweb ModX (identifiant / mot de passe), SSO en option | Côté hébergement / MODX | | **Rôles** | Un seul rôle : Commercial / Admin (tous droits) ; Lecteur en option | `app/ROLES-PERMISSIONS-RBAC.md`, `app/ACTEURS-UTILISATEURS.md` |