Application : dirCops
Projet : Suivi facturation / échéancier / paiement (EMGI)
Date : 2026-02-09
Objectif : Décrire de façon détaillée tous les workflows (états, transitions, acteurs, règles). En MVP il n’y a qu’un seul cycle de vie formalisé : celui de la facture (état dérivé de l’encours).
Dans ce projet, les workflows sont volontairement simples : pas de chaîne de validation (RH, IT), pas de statuts stockés en base pour les factures, pas de SLA ni relances. Le seul cycle de vie explicite est celui de la facture (état calculé : en attente / payée). Les autres entités (client, paiement, écheancier) n’ont pas de machine à états.
| Workflow / entité | États ? | Stocké en base ? | Acteur | Détail ci‑dessous |
|---|---|---|---|---|
| Facture (suivi) | Oui (2 états dérivés) | Non (calculé) | Commercial / système | § 2 |
| Paiement | Non | — | Commercial | Création directe, pas de statut |
| Écheancier | Non | — | Commercial | Création directe, pas de statut |
| Client | Non | — | — | Pas de cycle de vie métier |
L’état d’une facture est dérivé des paiements (non stocké en base). Il sert à l’affichage (Payé / En attente) et au filtrage (échéances à venir = factures en attente).
factures (+ agrégation des paiements).encours_facture = montant_ht - SUM(paiements.montant) ; si encours_facture <= 0 → Payée, sinon → En attente.| Code état | Libellé | Condition (calcul) |
|---|---|---|
en_attente |
En attente | encours_facture > 0 |
paye |
Payée | encours_facture ≤ 0 |
| Transition | Depuis | Vers | Déclencheur | Acteur | Règle métier |
|---|---|---|---|---|---|
| Paiement enregistré | En attente | Payée* | POST paiement (montant ≥ encours restant) | Commercial | Automatique après enregistrement du paiement. Pas de validation. |
*Une facture peut rester « En attente » après un paiement partiel (plusieurs paiements possibles).
┌─────────────────────────────────────┐
│ Condition : encours_facture > 0 │
▼ │
┌─────────────┐ │
│ EN ATTENTE │ │
└──────┬──────┘ │
│ │
│ Transition : enregistrement │
│ d’un ou plusieurs paiements │
│ tels que encours_facture ≤ 0 │
│ (acteur : Commercial) │
▼ │
┌─────────────┐ │
│ PAYÉE │ ────────────────────────────┘
└─────────────┘ (pas de transition retour
│ en MVP : on ne « défait »
│ pas un paiement)
│
└── État final (aucune autre transition)
factures.created_at et paiements.created_at ; pas d’audit log « qui a changé quel statut »./api/paiements.php (facture_id, montant, date_paiement). Acteur : Commercial./api/paiements.php?id=. Acteur : Commercial. L’encours de la facture est recalculé à la volée après suppression./api/echeanciers.php (facture_id, nb_echeances, date_debut_echeancier). Acteur : Commercial./api/echeanciers.php?id=. Acteur : Commercial./api/clients.php (nom). Acteur : Commercial./api/clients.php?id=. En cascade : factures, paiements, écheanciers du client. Vérification applicative possible (refus si factures existantes selon règle métier). Acteur : Commercial.| Entité | Action | Déclencheur | Confirmation | Effet |
|---|---|---|---|---|
| Client | Suppression | Bouton Supprimer (liste clients) | Oui (avec avertissement cascade) | DELETE clients.php?id= ; cascade factures → paiements, écheanciers. Vérification possible côté API (refus si factures). |
| Facture | Suppression | Bouton Supprimer (liste factures, fiche client) | Oui | DELETE factures.php?id= ; cascade paiements, écheancier. |
| Paiement | Suppression | Bouton Supprimer (liste paiements, fiche client) | Oui | DELETE paiements.php?id= ; encours recalculé à la volée. |
| Écheancier | Suppression | Bouton Supprimer (liste écheanciers, fiche client) | Oui | DELETE echeanciers.php?id= ; facture inchangée. |
Aucun workflow de validation : la confirmation utilisateur (dialog) suffit ; pas d’audit log des suppressions en MVP.
global_status / hr_status / it_status en base : non (seul l’état dérivé « en attente / payée » pour la facture, calculé à la volée).| Élément | Présent en MVP ? | Détail |
|---|---|---|
| États facture (en attente / payée) | Oui | Dérivés, non stockés ; diagramme § 2.4. |
| Transitions avec acteur | Oui | 1 transition : enregistrement paiement → passage à Payée si encours ≤ 0. |
| Workflow de validation (approbation) | Non | Saisie directe. |
| Statuts stockés en base | Non | Uniquement calcul à l’affichage. |
| SLA / relances / escalades | Non | Hors scope. |
| Historisation / audit log | Non | Uniquement created_at. |
Les workflows sont donc bien détaillés en schéma pour ce qui existe (facture) ; le reste du projet repose sur des créations directes sans machine à états.