10Un langage que l'on peut prouver
Une même phrase comme exigence, test et code ; des règles que le code ne peut pas enfreindre ; des preuves produites sprint après sprint.
Une preuve ne vaut que par la précision de ce qu'elle prouve. Une exigence qui dit « le système doit garantir la compatibilité » ne peut pas être vérifiée ; une exigence qui énonce exactement quel produit peut être donné à quel receveur, et dans quelles conditions, le peut. Le langage omniprésent est ce qui donne cette précision aux exigences, aux tests et au code, et les garde alignés.
Une phrase, trois artefacts
Dans un produit construit avec le DDD, une règle énoncée par un expert du domaine voyage sans traduction. Les mêmes mots apparaissent dans l'élément du backlog, dans le test d'acceptation et dans le code. Prenons une règle du contexte d'administration au lit du patient, écrite sous forme de scénario exécutable :
# language: fr
Scénario: Une poche incompatible est refusée au lit du patient
Étant donné un receveur de groupe sanguin O RhD négatif
Et un concentré de globules rouges de groupe A RhD positif attribué à ce receveur
Quand l'infirmière scanne la poche au lit du patient
Alors l'administration est bloquée
Et un événement « incompatibilité détectée » est enregistré
Un hématologue peut lire et approuver ce scénario. Un développeur peut l'automatiser. Un évaluateur peut le suivre de l'exigence qu'il vérifie jusqu'au code qu'il exerce. Parce que receveur, poche, attribuée et administration ont un seul sens au sein du contexte, il n'y a aucun écart entre ce que l'expert a demandé et ce que le test vérifie.
La traçabilité, que les équipes des secteurs réglementés tiennent souvent à la main dans de grandes matrices, devient bien plus légère quand les noms concordent. Le lien de l'exigence au code n'est plus une ligne de tableur ; c'est le même mot aux deux endroits.
Des règles que le code ne peut pas enfreindre
Les patrons tactiques du DDD, souvent balayés comme du code répétitif, méritent leur place dans les contextes critiques. Un agrégat est l'unité qui fait respecter un ensemble de règles, ses invariants, à chaque changement de son état. Si « une poche ne peut pas être administrée sans contrôle final valide » est un invariant de l'agrégat d'administration, aucun écran, aucun service ni aucun traitement par lots ne peut le contourner, parce qu'il n'existe aucun moyen de changer l'état autrement que par l'agrégat.
Les objets valeur rendent impossible la création de valeurs invalides. Un groupe sanguin qui ne peut être que l'un des groupes définis, ou un identifiant de poche qui valide lui-même son format et sa clé de contrôle, éliminent des catégories entières de défauts avant même qu'un test ne s'exécute. Les événements du domaine, comme « poche délivrée », « poche administrée » ou « réaction signalée », enregistrent ce qui s'est passé en termes métier, avec qui et quand. Dans un domaine qui exige la traçabilité du donneur au receveur, ces événements sont à la fois le mécanisme d'intégration entre contextes et la piste d'audit.
| Élément du DDD | Propriété d'assurance | Preuve produite |
|---|---|---|
| Langage omniprésent | Exigences, tests et code partagent un même sens | Des scénarios exécutables approuvés par les experts du domaine |
| Agrégat et invariants | Les règles de sécurité appliquées à chaque changement | Des tests d'invariants ; un seul endroit, relisible, pour chaque règle |
| Objet valeur | Les valeurs invalides ne peuvent pas exister | Des tests unitaires sur la construction et la validation |
| Événement du domaine | Chaque fait significatif est enregistré | Une piste d'audit en termes métier |
| Contexte délimité | Les règles s'appliquent dans un périmètre connu | Un argument de séparation et un périmètre de vérification limité |
| Carte de contextes | Les interfaces entre parties sont explicites | Une documentation des interfaces et des tests de contrat |
Tableau 6 · Les éléments du DDD lus comme des mécanismes d'assurance.
Des preuves produites sprint après sprint
C'est là que la combinaison avec Scrum porte ses fruits. Quand la preuve est un sous-produit de la façon dont le code est écrit, la Definition of Done peut l'exiger sans grand surcoût : scénarios approuvés, invariants testés, événements documentés, carte de contextes à jour. Le dossier documentaire grandit à chaque incrément au lieu d'être reconstitué avant un audit, ce qui est précisément la discipline que Scrum en apparence seulement désignait comme le vrai défi de Scrum en milieu réglementé.
À retenir de ce chapitre
- Un langage partagé et précis permet à une même phrase de servir d'exigence, de test d'acceptation et de code, et allège beaucoup la traçabilité.
- Les agrégats, les objets valeur et les événements du domaine transforment les règles de sécurité en contraintes que le code ne peut pas contourner, et enregistrent ce qui s'est passé en termes métier.
- Quand la preuve est un sous-produit de la conception, la Definition of Done peut l'exiger à chaque sprint.