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 DDDPropriété d'assurancePreuve produite
Langage omniprésentExigences, tests et code partagent un même sensDes scénarios exécutables approuvés par les experts du domaine
Agrégat et invariantsLes règles de sécurité appliquées à chaque changementDes tests d'invariants ; un seul endroit, relisible, pour chaque règle
Objet valeurLes valeurs invalides ne peuvent pas existerDes tests unitaires sur la construction et la validation
Événement du domaineChaque 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 connuUn argument de séparation et un périmètre de vérification limité
Carte de contextesLes interfaces entre parties sont explicitesUne 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.