Développement web

Faire raconter la même histoire du dossier à chaque écran et chaque équipe

Jérémy Chomel Dawap
  • Publié le : 6 septembre 2026
  • Mis à jour le : 16 novembre 2026
  • Temps de lecture : 12 minutes
  1. Repérer les vérités concurrentes
  2. Savoir quand modéliser les états
  3. Partir du dossier et de ses décisions
  4. Séparer faits, état et affichage
  5. Écrire les invariants métier
  6. Définir les transitions autorisées
  7. Distinguer états global et partiels
  8. Construire des projections par usage
  9. Relier droits et transitions
  10. Conserver dates et chronologie
  11. Traiter exceptions et compensations
  12. Partager le modèle entre services
  13. Rejouer un dossier complet
  14. Contrôler les divergences
  15. Plan d’action et migration
  16. Éviter les erreurs fréquentes
  17. Relier architecture, statuts et mesure
  18. Conclusion : un état explicable
Portrait de Jérémy Chomel

Le portail annonce qu’un dossier est prêt, tandis que le service qui doit le reprendre attend encore un accord. Remontez à la décision et au fait enregistré, puis vérifiez ce que chacun des écrans en déduit.

Dans une application métier sur mesure, définissez les états que le dossier peut atteindre, les actions qui les font évoluer et les preuves dont les équipes ont besoin. Les libellés peuvent varier avec l’usage, à condition de remonter aux mêmes faits.

En pratique, le blocage apparaît dès qu’un écran déclenche une décision à partir d’un résumé conçu pour un autre usage. Prenez un dossier où les avis divergent et comparez le paiement, la disponibilité et l’engagement pris avant de modifier les libellés.

Repérer les vérités concurrentes

Une vérité concurrente existe lorsqu’une même décision reçoit plusieurs réponses selon l’interface. Peut-on facturer, relancer, annuler ou fermer ? Si les équipes consultent des colonnes différentes, le statut n’est qu’un raccourci local.

Chercher les conséquences plutôt que les libellés

Deux écrans peuvent employer des mots différents tout en autorisant les mêmes gestes ; le risque reste faible. À l’inverse, deux badges « terminé » peuvent masquer, pour le premier, un paiement reçu et, pour le second, une prestation livrée. L’audit compare droits et effets avant de normaliser les couleurs.

Le coût caché se mesure en dossiers rouverts, actions annulées, recherche de preuve et temps support. Contrairement à ce que l’on croit, harmoniser le design avant le modèle rend souvent la divergence plus difficile à voir.

Savoir quand modéliser les états

Le modèle devient indispensable lorsqu’un dossier traverse plusieurs rôles, possède des étapes non réversibles, déclenche des effets externes ou doit être expliqué après plusieurs mois. Un formulaire simple et éphémère peut rester plus léger.

Qualifier les décisions réellement partagées

Vente, opérations, finance, support et conformité n’ont pas besoin du même écran, mais ils doivent partager les faits qui autorisent une action. Le chantier commence par ces décisions transverses, pas par une liste exhaustive de micro-statuts.

Un signal faible apparaît lorsque l’équipe demande « quel écran fait foi ? ». Un second se voit quand une correction SQL devient la procédure normale. Dès qu’une transition critique dépend d’une interprétation humaine, le modèle exige un responsable et des tests.

Partir du dossier et de ses décisions

Le dossier possède une identité, une finalité, des parties et un cycle de vie. Il ne se confond ni avec une page, ni avec une table, ni avec un ticket. L’équipe liste d’abord les décisions : accepter, instruire, engager, exécuter, suspendre, compenser et clore.

Définir une frontière métier stable

Un dossier de demande peut contenir pièces, validations, paiements et échanges sans devenir chacun de ces objets. Les sous-objets gardent leurs états ; le dossier agrège seulement ce qui commande sa décision globale.

La frontière nomme le responsable, l’identifiant, les événements d’entrée, la sortie terminale et la durée de conservation. Si deux finalités indépendantes évoluent à des rythmes différents, elles deviennent deux agrégats reliés plutôt qu’un statut géant.

La modélisation documente également les dossiers qui n’entrent volontairement pas dans cette frontière. Une conversation support, une pièce brute ou une tentative de paiement garde son propre cycle. Le dossier référence leur résultat utile, ce qui évite qu’un changement secondaire force une transition globale et simplifie la reprise ciblée.

Séparer faits, état et affichage

Un fait décrit ce qui s’est produit : document reçu, paiement confirmé, contrôle refusé. L’état canonique résume les conséquences valides de ces faits. L’affichage adapte cette information à un rôle sans inventer une autre réalité.

Recalculer sans réécrire l’histoire

La chronologie conserve événements, auteurs, motifs et versions. Un correctif ajoute un nouveau fait ou une compensation. Il ne remplace pas silencieusement la décision antérieure, sinon l’audit ne peut plus expliquer le parcours.

Le front reçoit état, capacités et raisons. Il ne déduit pas « facturable » d’une combinaison locale de cinq champs. Cette capacité est produite par le domaine qui possède les invariants de facturation.

Cette distinction se retrouve dans un compte rendu d’intervention collecté hors connexion puis transmis à l’ERP. Enregistrement sur le téléphone, réception des photos et validation du bureau restent des faits différents. Une mission clôturée côté terrain ne doit pas devenir automatiquement une prestation facturable côté finance.

Écrire les invariants métier

Un invariant reste vrai après chaque transition : aucun dossier engagé sans consentement, aucune facture sans base, aucune clôture avec action critique ouverte. Ces règles protègent la cohérence plus efficacement qu’une liste de statuts autorisés.

Formuler une règle qui peut refuser

« Les pièces doivent être complètes » reste vague. « La transition vers prêt à instruire exige les trois pièces obligatoires valides à la date de décision » nomme état, population et preuve. Le rejet retourne les éléments manquants.

Les invariants sont testés au niveau domaine et rejoués sur des dossiers historiques. Une exception légitime devient une autre transition avec autorité et motif ; elle ne désactive pas la règle pour toute la population.

Définir les transitions autorisées

Une transition contient état de départ, commande, préconditions, décideur, effets et état d’arrivée. « Modifier le statut » disparaît de l’interface au profit d’actions métier comme approuver, demander une pièce, suspendre ou annuler.

Refuser les sauts qui contournent une preuve

Passer de reçu à terminé peut sembler pratique pour corriger un dossier importé, mais efface contrôle et engagement. Une migration ou une reprise possède sa commande dédiée, ses preuves et son audit.

Les transitions concurrentes utilisent version ou verrou optimiste. Si deux personnes décident depuis le même état, alors la seconde reçoit le nouvel état et requalifie son action au lieu d’écraser la première.

Distinguer états global et partiels

Une commande marquée « en cours » depuis neuf jours peut avoir un paiement en attente, huit unités prêtes à être remises au transporteur et quatre unités attendues du fournisseur. Affichez ces trois faits, le responsable du blocage et l’échéance du reliquat. La préparation du colis suit son propre cycle si le paiement doit être reçu avant la remise.

Un dossier peut être administrativement complet, financièrement en attente et opérationnellement en cours. Fusionner ces axes dans un seul enum crée une explosion de combinaisons ou masque l’information utile.

Composer sans fabriquer un statut impossible

Chaque sous-cycle possède ses invariants. L’état global exprime une décision de haut niveau et référence les axes qui la justifient. Il ne concatène pas mécaniquement tous les états.

Par exemple, « exécutable » peut exiger conformité validée et paiement autorisé, tandis que la livraison reste non commencée. L’écran support montre les axes ; le tableau de pilotage peut agréger la capacité « à lancer ».

Construire des projections par usage

La vue commerciale met en avant prochaine action et échéance ; le back-office voit pièces et contrôles ; la finance voit engagement et règlement. Ces projections lisent le même état canonique et les mêmes événements.

Autoriser des libellés adaptés sans changer le sens

Un client peut lire « étude en cours » pendant que l’interne distingue trois étapes. La projection conserve le mapping versionné et ne promet pas une décision déjà prise. Toute simplification possède une phrase explicative ou une capacité associée.

Les projections sont reconstruisibles. Si leur cache diverge, un replay restaure l’affichage depuis les faits. Une colonne modifiée manuellement sans retour vers le domaine est interdite.

Chaque projection publie sa fraîcheur et la version du dernier fait traité. Une équipe sait ainsi distinguer un dossier réellement bloqué d’une vue en retard. Au-delà du seuil de deux minutes pour une action urgente, l’interface désactive le geste sensible, recharge la source et affiche la raison plutôt que de laisser l’utilisateur décider sur un état périmé.

Relier droits et transitions

Un rôle n’a pas le droit générique de modifier un état. Il peut exécuter certaines commandes sur certaines populations lorsque les préconditions sont vraies. Le domaine répond avec les capacités disponibles et leur motif d’indisponibilité.

Conserver le décideur et la délégation

L’événement porte auteur humain ou système, mandat, date et règle appliquée. Une délégation possède périmètre et échéance. L’automatisation agit comme un acteur identifié, jamais comme une mise à jour sans origine.

Le refus d’autorisation reste distinct du refus métier. Le premier protège l’accès ; le second explique pourquoi l’état ne permet pas la commande. Cette séparation réduit les contournements support.

Conserver dates et chronologie

Date effective, date d’enregistrement et date de réception peuvent différer. Le modèle conserve ces horloges et indique laquelle commande le SLA, le reporting ou la décision. Un événement tardif ne gagne pas seulement parce qu’il arrive dernier.

Mesurer le temps dans chaque état

L’âge commence à l’entrée réelle et se termine à la transition. Les pauses autorisées portent un motif et un responsable. Une moyenne globale ne doit pas masquer vingt dossiers bloqués depuis dix jours derrière mille passages rapides.

Les échéances sont des faits calculés à partir d’une règle versionnée. Si la règle change, les nouveaux dossiers l’appliquent ; les anciens sont migrés par décision explicite ou gardent leur engagement initial.

Traiter exceptions et compensations

Une exception légitime est un chemin métier nommé. Une erreur technique empêche l’exécution d’un chemin valide. Les mélanger dans « bloqué » rend impossible le bon geste et fausse la mesure.

Compenser plutôt que remonter artificiellement le temps

Après un paiement ou un envoi, revenir à l’état précédent ne supprime pas l’effet. La commande d’annulation crée remboursement, retour ou contre-écriture, puis rejoint un nouvel état explicable.

La procédure de reprise contient l’entrée, la sortie, le responsable, les dépendances, le seuil et le repli de chaque scénario. Une correction directe en base reste réservée à une intervention auditée qui produit ensuite les faits manquants.

Quand une panne oblige à décider hors de l’application, le cas du registre de secours montre comment reprendre la décision et l’arrêter si le dossier a changé entre-temps.

Partager le modèle entre services

Le domaine expose commandes, événements et vues plutôt que sa table. Les consommateurs déclarent la version comprise. Les schémas décrivent forme ; le contrat métier décrit sémantique, ordre et garanties.

Garder une autorité unique sans créer un monolithe

Un service possède la décision, mais plusieurs projections peuvent la distribuer. Une API synchrone sert une action immédiate ; des événements alimentent recherche, notifications et reporting. Les deux portent le même identifiant et la même version.

Les dépendances ne se répondent pas par mises à jour circulaires. Si un paiement modifie la capacité du dossier, il émet un fait ; le domaine décide la transition. Cette direction réduit les boucles et rend le replay déterministe.

Le contrat d’intégration contient l’entrée de chaque commande, sa sortie, les erreurs métier, l’idempotence et l’ordre des événements. Le responsable du domaine surveille les rejets, la file et le délai de projection. En cas de rupture, le repli bloque les nouvelles décisions risquées tout en laissant les consultations et les opérations indépendantes continuer.

Rejouer un dossier complet

Dans une recette de commande partiellement expédiée, faites remettre huit unités au transporteur et conservez l’identifiant de remise. Faites accepter un nouveau délai, substituer un produit ou annuler les quatre restantes. Testez le rejet d’une deuxième remise et d’une annulation portant sur les huit déjà expédiées. Le support doit pouvoir justifier les quantités, la promesse révisée et les éventuels remboursements à partir de la commande.

Cas concret : une demande reçoit trois pièces, passe en instruction et obtient une approbation. Le paiement échoue, puis réussit après relance. Entre-temps, une pièce expire et oblige à suspendre l’exécution sans annuler l’approbation.

Préserver chaque décision dans les projections

Le dossier reste approuvé mais non exécutable. Le commercial voit « action client requise », la conformité voit « pièce à renouveler » et la finance voit « paiement confirmé ». Chaque projection explique sa vue depuis les mêmes faits.

Après réception de la pièce, la capacité d’exécuter revient sans refaire l’approbation. Le scénario passe si historique, droits, SLA et reporting concordent, et si le support retrouve la cause de suspension en moins de trois minutes.

Une variante de frontière est aussi rejouée : la pièce expire après le début d’un effet irréversible. Dans ce cas, la suspension interdit la suite mais ne remet pas l’effet à zéro. Une tâche de compensation possède un responsable, une échéance et une preuve. Ce résultat confirme que le modèle raconte le passé autant qu’il commande la prochaine action.

Contrôler les divergences

L’instrumentation suit les transitions refusées, les états impossibles, les projections en retard, les corrections manuelles et les dossiers sans prochaine action. Les alertes portent une population et un responsable, pas seulement une exception technique.

Comparer les décisions entre écrans

Un test synthétique ouvre le même dossier dans plusieurs vues et compare capacités, pas seulement badges. Si le commercial peut annuler alors que le back-office indique un point de non-retour, l’incident est critique même si les textes semblent cohérents.

Le seuil pilote exige zéro invariant violé, 100 % des transitions critiques tracées et moins de 1 % de projection en retard au-delà du SLA. Chaque écart est rejoué avant extension.

Plan d’action et migration

Les entrées sont les écrans, les tables, les règles, les procédures, les incidents et les dossiers représentatifs. Les sorties sont la carte d’objets, les états canoniques, les transitions, les invariants, les projections, les fixtures, la migration et la procédure d’exploitation.

Passer des colonnes au contrat métier

  1. Jours 1 à 5 : inventorier les décisions et les vérités concurrentes.
  2. Jours 6 à 10 : définir objet, faits, invariants et transitions critiques.
  3. Jours 11 à 15 : construire projections, droits et chronologie.
  4. Jours 16 à 20 : rejouer vingt dossiers et qualifier les écarts.
  5. Jours 21 à 25 : migrer une cohorte, observer et exercer le repli.
  6. Jours 26 à 30 : rapprocher les vues, tenir le verdict et étendre.
  • À faire d’abord : les décisions qui engagent argent, droit ou promesse.
  • Ensuite : les projections qui diffusent ces décisions aux équipes.
  • Puis : les automatisations dont les préconditions deviennent enfin stables.
  • À différer : les badges sans conséquence opérationnelle.
  • À refuser : une migration qui ne sait pas expliquer les dossiers existants.

La migration traduit chaque ancien état depuis ses faits disponibles. Les cas ambigus entrent dans une file de décision avec un responsable ; ils ne reçoivent pas un statut par défaut destiné à faire passer le script.

Le pilote commence sur une population bornée et maintient l’ancienne lecture en observation. Les écarts sont classés entre erreur de traduction, règle manquante et donnée absente. Seule la première est corrigée automatiquement.

Le repli restaure les projections et arrête les nouvelles commandes sans supprimer les faits produits. La reprise repart d’un point de coupure prouvé. Les consommateurs accusent la version du modèle qu’ils utilisent.

Le verdict exige des dossiers explicables, des actions cohérentes et une charge support maîtrisée. Si plus de 2 % de la cohorte requiert une décision manuelle non prévue, alors l’extension attend une nouvelle règle.

Éviter les erreurs fréquentes

Modéliser les écrans lie le métier à l’interface. Créer un enum géant mélange les axes. Autoriser le statut libre contourne les invariants. Réécrire l’historique détruit la preuve.

Refuser les raccourcis qui créent une seconde vérité

Calculer dans chaque front multiplie les règles. Confondre erreur et exception déclenche la mauvaise procédure. Migrer par défaut masque les cas ambigus. Mesurer seulement le statut final ignore les blocages.

Le piège inverse est une machine à états pour chaque détail. Les changements éditoriaux ou réversibles restent des attributs. Un état existe lorsqu’il change droits, prochaine action, engagement, délai ou capacité de reprise.

  • Conserver comme attribut : l’information qui n’ouvre ni ne ferme aucune capacité.
  • Modéliser comme état : la situation qui commande une décision durable.
  • Tracer comme événement : le fait daté qui explique la transition.

Relier architecture, statuts et mesure

Le pilier pour cadrer un premier lot d’application métier aide à choisir le dossier et la décision à modéliser en premier. Pour suivre son traitement en exploitation, rapprochez les événements observés avec le dossier métier.

L’architecture d’un workflow métier à fortes exceptions traite orchestration, effets externes et compensations. Le modèle présent se concentre sur la vérité partagée par tous les consommateurs.

Recetter les transitions, puis mesurer l’issue

Testez les transitions invalides, les messages rejoués et les corrections tardives. Pour le pilotage, définissez les sorties réellement abouties à partir de vos états terminaux et des événements reçus.

Ici, l’enjeu est le modèle de données et de décision qui empêche plusieurs écrans de reconstruire un dossier différent. Cette frontière renforce la landing de développement sans dupliquer l’architecture ou le pilotage du workflow.

Lorsque le run doit suivre décisions, exceptions et preuves entre équipes, Ciama peut soutenir la visibilité opérationnelle. L’application métier reste propriétaire des invariants et des transitions.

Conclusion : un état explicable

Attribuez chaque transition à une action, à une condition et à un acteur. Vérifiez que plusieurs vues expliquent le même dossier et distinguent ce qui a été décidé de ce qui reste à faire.

Rejouez le retard, la réponse tardive et la correction d’un fait. Avec le numéro du dossier, le support doit retrouver la décision initiale, ce qui l’a fait évoluer et qui peut encore agir. Ce test fournit un critère pour ouvrir le modèle à un deuxième parcours.

Dawap peut cadrer les états de votre application métier sur des dossiers représentatifs, puis les éprouver avec les équipes qui traitent et reprennent les exceptions.

Portrait de Jérémy Chomel

Modéliser les états d’un même dossier métier

Séparer les faits, les transitions et les projections qui permettent aux équipes d’agir sur le même dossier.

Cadrer mon application métier

Articles recommandés

Architecture d’un workflow métier à fortes exceptions Développement web Architecture d’un workflow métier à fortes exceptions Lire l'article
  • 17 juillet 2026
  • Lecture ~16 min

Un workflow complexe ne se résume pas à une succession d’écrans. Ce guide sépare états, décisions, effets externes, compensations, reprises et preuves. Il aide à choisir une orchestration proportionnée, à traiter les points de non-retour et à donner aux équipes une trajectoire claire pour chaque exception.

Stratégie de test d’un workflow métier à nombreuses exceptions Développement web Tester un workflow complexe sans explosion combinatoire Lire l'article
  • 17 juillet 2026
  • Lecture ~17 min

Testez les états, transitions, invariants, droits, données et reprises qui portent le risque réel, au lieu de multiplier des scénarios impossibles à maintenir. Cette méthode construit une couverture défendable, injecte les pannes utiles et vérifie aussi les compensations, la concurrence et les preuves attendues par le métier.

Une équipe mesure les jalons, abandons, reprises et résultats d’un workflow dans une application métier Développement web Taux d’achèvement métier : mesurer le vrai résultat Lire l'article
  • 23 août 2026
  • Lecture ~17 min

Compter les connexions masque les dossiers jamais terminés et les résultats corrigés hors outil. Ce guide construit un contrat d’achèvement par workflow : population éligible, jalons, sorties, reprises, délai, qualité et contrôles de télémétrie. Vous obtenez une mesure apte à guider le produit sans surveiller les personnes.

Modéliser les états d’un même dossier métier

Séparer les faits, les transitions et les projections qui permettent aux équipes d’agir sur le même dossier.

Cadrer mon application métier