Application : dirCops
Projet : Suivi facturation / échéancier / paiement (EMGI)
Date : 2026-02-09
Usage : Liste des ambiguïtés métier à trancher avant développement ou chiffrage final
| Règle | Décision | Impact développement |
|---|---|---|
| Authentification | Login MODX Livinweb (identifiant/mot de passe) | Écran login + session PHP |
| Rôles | Un seul rôle en MVP (multi-rôles en option) | Pas de gestion de permissions |
| Import Pennylane | EN OPTION (MVP = saisie manuelle) | Aucun en MVP |
| Modification/suppression | Autorisé (facture, paiement, écheancier, client) avec confirmation | CRUD complet |
| Suppression client | Cascade (factures → paiements/écheanciers) | Confirmation + message avertissement |
Question : Un client peut-il avoir deux factures avec le même numéro de facture ?
Options :
UNIQUE(n_facture)UNIQUE(client_id, n_facture)Recommandation technique : Option B (unicité par client) — plus souple et évite blocages si deux clients ont un n° similaire
Impact :
Décision client : À trancher
Question : Tous les champs facture sont-ils requis ou certains peuvent être laissés vides ?
Champs actuels : | Champ | Obligatoire actuel | À confirmer | |-------|-------------------|-------------| | n_facture | Oui (NOT NULL) | ✅ Confirmé | | n_vente | Non (NULL) | À confirmer | | date_facture | Oui (NOT NULL) | ✅ Confirmé | | type_produit | Non (NULL) | À clarifier : si vide, impact reporting Top clients ? | | cycle | Non (NULL) | À clarifier : si vide, impact reporting par cycle ? | | quantites | Non (NULL) | À clarifier : si vide, impact reporting Quantités clients ? | | qte_livree | Non (NULL) | À clarifier : si vide, OK ou bloquer ? | | montant_ht | Oui (NOT NULL) | ✅ Confirmé |
Recommandation :
type_produit devrait être obligatoireDécision client : _À trancher (valider si typeproduit, cycle, quantites obligatoires ou pas)
Question : Faut-il ajouter des champs TVA et devise ?
Contexte : Actuellement seul le montant HT est stocké. Pas de gestion de TVA, TTC, ou devise.
Options :
tva (%), montant_ttc, devise (EUR, USD, etc.)Recommandation : Garder MVP simple (HT uniquement, € implicite) sauf besoin explicite client
Décision client : À trancher
Question : Que se passe-t-il si un utilisateur enregistre un paiement > montant HT de la facture ?
Options :
Recommandation technique : Option A (autoriser, encours = 0) avec avertissement visuel dans l'interface ("Paiement supérieur au montant, facture soldée")
Décision client : À trancher
Question : Peut-on enregistrer un paiement avec une date future (paiement "prévu") ?
Options :
Recommandation : Option B (bloquer date future) — si besoin de "paiement prévu", utiliser les écheanciers
Décision client : À trancher
Question : Les échéances sont-elles toujours mensuelles ou faut-il permettre d'autres fréquences ?
Options :
frequence, calcul dates adapté)Recommandation : Option A (mensuel) pour MVP, option B en post-MVP si besoin réel
Décision client : À trancher (mensuel suffit-il ?)
Question : Faut-il lier un paiement à une échéance spécifique (suivi par échéance : à venir / payée / partielle / en retard) ?
Options :
Recommandation : Option A pour MVP (suivi global facture suffit), option B en post-MVP si demandé
Décision client : À trancher
Question : Comment gérer les clients avec des noms similaires (doublons potentiels) ?
Exemples :
Options :
UNIQUE(LOWER(nom))Recommandation : Option B (avertissement) — souple mais évite doublons accidentels
Décision client : À trancher
Question : Quel séparateur, encodage et format pour les exports CSV ?
Options :
| Paramètre | Option A (Excel FR) | Option B (Standard) |
|---|---|---|
| Séparateur | ; (point-virgule) |
, (virgule) |
| Encodage | UTF-8 avec BOM | UTF-8 sans BOM |
| Décimale | , (virgule) |
. (point) |
| Format date | DD/MM/YYYY |
YYYY-MM-DD |
Recommandation : Option A (Excel FR) si le client utilise Excel sur Windows en français
Recommandation alternative : Option B si interopérabilité avec outils internationaux
Décision client : À trancher (test avec un export pour valider)
Question : Quelles colonnes exactement dans l'export CSV "encours par client" ?
Colonnes actuelles (proposées) :
À clarifier :
Décision client : À trancher (liste exacte des colonnes souhaitées)
Question : Quelles colonnes et quel format pour l'export factures (suivi-factures-YYYY-MM-DD.csv) ?
Colonnes proposées (à valider) :
Colonnes supplémentaires possibles :
Décision client : À trancher (colonnes exactes + format)
Question : Faut-il limiter l'affichage aux "Top 10" ou "Top 15" clients, ou afficher tous les clients selon le filtre ?
Options :
Recommandation : Option B (pas de limite) pour MVP — le client peut exporter et filtrer dans Excel si besoin
Décision client : À trancher
Question : Les indicateurs suivants sont-ils requis en MVP ou en post-MVP ?
| Indicateur | Calcul | MVP ou post-MVP ? |
|---|---|---|
| Couverture livraison | (Qté livrée / Qté facturée) × 100 | À trancher |
| % GTT (écart livraison) | Dérivé de couverture | À trancher |
| Délai moyen de paiement | (Somme des délais par facture payée) / Nb factures payées | À trancher |
Recommandation : Post-MVP (priorité au suivi encours + paiements en MVP)
Décision client : À trancher
Question : Les colonnes "Accord", "J out", "Situation" doivent-elles être affichées sur le dashboard ?
Contexte : Ces colonnes sont mentionnées dans les captures Excel "COMEX", mais les données ne sont pas dans la base actuelle.
Options :
Recommandation : Option B (masquer) pour MVP
Décision client : À trancher
| Priorité | Règle à clarifier | Impact chiffrage |
|---|---|---|
| 🔴 HAUTE | 1.1 Unicité n° facture | Contrainte DB + validation |
| 🔴 HAUTE | 2.1 Paiement > montant facture | Logique métier |
| 🔴 HAUTE | 5.1 Format export CSV | Développement export |
| 🟠 MOYENNE | 1.2 Champs facture obligatoires | Validation front/back |
| 🟠 MOYENNE | 2.2 Date paiement future | Validation |
| 🟠 MOYENNE | 3.1 Fréquence échéances | Calcul dates |
| 🟠 MOYENNE | 4.1 Clients en doublon | Vérification suggérée |
| 🟠 MOYENNE | 5.2 Colonnes export encours | Contenu export |
| 🟠 MOYENNE | 5.3 Colonnes export factures PJ | Contenu export |
| 🟠 MOYENNE | 6.2 Indicateurs type Excel | Scope MVP |
| 🟢 BASSE | 1.3 TVA et devise | Champs supplémentaires |
| 🟢 BASSE | 3.2 Lien paiement ↔ échéance | Table liaison |
| 🟢 BASSE | 6.1 Top clients limite | Affichage |
| 🟢 BASSE | 7.1 Colonnes optionnelles dashboard | Affichage |
Objectif : Trancher les règles 🔴 HAUTE et 🟠 MOYENNE avant chiffrage final
Méthode :
Durée estimée : 1h d'atelier
Document à compléter au fur et à mesure des décisions client. Référence pour développement et tests.