SquashTM peut-il devenir la mémoire de conception d’une application ?
Les équipes changent, et les raisons des règles métier partent souvent avec elles. À partir d’un seul exemple, cet article montre comment les exigences, les cas de test et leurs versions dans SquashTM peuvent garder la trace de ce que fait une application et de ses raisons — un travail des testeurs qui sert à tous ceux qui maintiennent l’application, pas seulement à la QA.
Par Fanny Velsin
Dans deux ou cinq ans, si toute votre équipe a changé, serez-vous encore capable de comprendre non seulement comment l’application est censée fonctionner, mais aussi pourquoi elle a été conçue ainsi ?
« C’était Mystic Meg qui s’occupait de ce périmètre, c’est elle qui connaissait les règles métier. »
Cela vous dit peut-être quelque chose. Mystic Meg est partie, puis d’autres l’ont suivie. Les développeurs, le Product Owner et les testeurs présents lors de la conception initiale des fonctionnalités sont tous partis, et une partie de leurs connaissances avec eux.
Imaginez qu’une nouvelle équipe découvre une restriction : un client ne peut pas modifier l’adresse de livraison d’une commande une fois celle-ci confirmée. Personne ne sait expliquer pourquoi : après tout, permettre une correction avant l’expédition semblerait rendre service au client.
Un Business Analyst formalise cette évolution, l’équipe la développe, et les tests confirment que la nouvelle adresse est bien enregistrée et affichée sur la commande.
Et puis… c’est la catastrophe. Le colis part à l’ancienne adresse.
L’entrepôt avait reçu l’adresse au moment de la confirmation de la commande ; l’interface entre les deux systèmes ne transmettait pas les modifications ultérieures. La restriction avait justement été mise en place pour que l’adresse affichée au client corresponde toujours à celle utilisée pour l’expédition.
À l’époque, l’équipe avait décidé de conserver cette restriction jusqu’à ce que l’interface puisse évoluer, mais la raison de ce choix n’a jamais été documentée.
Alors, comment conserver à la fois les règles métier et les raisons qui les motivent ? Voyons une démarche en trois étapes pour limiter cette perte de connaissances, sans multiplier les tickets et les documents.
1. Conserver ce que l’application est censée faire
La première étape consiste à rendre explicite le comportement attendu de l’application.
Dans notre exemple fictif, la règle initiale pourrait s’énoncer ainsi : « Un client peut modifier l’adresse de livraison d’une commande tant que celle-ci n’a pas été confirmée. Une fois la commande confirmée, cette modification n’est plus possible. »
Il faut aussi définir le périmètre. Parle-t-on de l’adresse enregistrée dans le compte du client, ou de celle associée à une commande précise ? Ici, la restriction porte sur l’adresse d’une commande confirmée. Modifier son carnet d’adresses pour ses prochains achats est un autre comportement.
Les exigences métier, les règles de gestion et les parcours utilisateurs aident à formaliser ces attentes. Les cas de test servent ensuite à les illustrer et à les vérifier dans des scénarios concrets : modifier une adresse avant la confirmation, constater que la modification est impossible après la confirmation, ou s’assurer qu’une mise à jour du carnet d’adresses n’a pas d’effet sur une commande déjà confirmée.
Par exemple, voici l’exigence :

Et les 2 cas de test :




Dans SquashTM, les exigences et les cas de test qui leur sont associés peuvent servir de base à cette organisation. Une exigence décrit une attente, les tests précisent comment la vérifier.
L’objectif est de permettre à une personne qui découvre la fonctionnalité d’en comprendre le comportement, les conditions et les limites. Reste une question : pourquoi interdire une modification qui semble utile au client ?
2. Documenter les raisons pour lesquelles l’application a été conçue ainsi
Dans notre exemple, le blocage vient d’une limite de l’interface avec l’entrepôt. L’adresse de livraison est transmise à la confirmation de la commande, mais les modifications ultérieures ne sont pas communiquées au système de l’entrepôt.
L’équipe a donc décidé d’interdire ces modifications pour éviter un écart entre l’adresse affichée dans l’application et celle utilisée pour l’expédition.
Cette explication change la lecture de la règle. La restriction répond à une contrainte technique précise. Si l’interface évoluait, il faudrait réexaminer cette décision.
Sans ce contexte, une nouvelle équipe pourrait maintenir la restriction en la prenant pour une exigence métier permanente, ou au contraire la supprimer sans mesurer le risque qu’elle devait prévenir.
Le comportement attendu et sa justification sont deux informations distinctes. Un test peut vérifier qu’une modification est interdite, mais il ne peut pas expliquer pourquoi cette interdiction existe. Même une série de tests réussis ne suffit pas, à elle seule, à retrouver le raisonnement à l’origine de la décision.
Ici, quelques informations clés éclaireraient la situation : la limite de l’interface, le risque d’expédition à une mauvaise adresse, une référence à la décision d’origine et les conditions dans lesquelles la restriction pourrait être réexaminée.
SquashTM propose des descriptions et des champs personnalisés pour les exigences. Une équipe peut s’en servir pour organiser les informations qu’elle souhaite conserver. Les champs personnalisés demandent une configuration, et l’ensemble suppose une convention de documentation partagée. L’outil ne déduit pas automatiquement la raison d’une décision à partir du contenu des tests.
La justification peut être documentée avec l’exigence, ou accompagnée d’un renvoi vers un document source qui fait référence. L’essentiel est qu’elle reste facile à retrouver, sans avoir à répéter la même explication dans chaque scénario.
Cette approche a toutefois une limite : documenter une règle et sa justification ne décrit pas toute l’architecture de l’application. Le fonctionnement détaillé d’une interface avec un entrepôt de données, par exemple, peut être traité ailleurs. Le patrimoine de test doit permettre d’identifier ces sources externes et de comprendre leur lien avec le comportement testé.
Enfin, si une justification est inconnue, il faut la présenter comme telle. Si personne ne sait pourquoi une contrainte existe, mieux vaut la signaler comme une question ouverte que présenter une explication plausible comme une certitude.

Ci-dessous, dans la description de l’exigence, je complète les règles métier par 3 rubriques : la contrainte identifiée, la décision retenue et la condition de réexamen.
3. Transmettre cette compréhension dans le temps
Retrouvons la situation deux ans plus tard. L’interface avec l’entrepôt peut désormais transmettre les modifications d’adresse et recevoir la confirmation de leur prise en compte. L’équipe envisage d’autoriser les modifications après la validation de la commande, jusqu’au début de sa préparation.
Elle reprend la règle d’origine et sa justification. Elle peut ainsi vérifier si la contrainte précédente a réellement disparu, et définir les nouvelles conditions de modification.
La question dépasse désormais le simple enregistrement d’une adresse dans l’application. Jusqu’à quand l’entrepôt peut-il encore accepter une modification ? Que doit afficher l’application en attendant la confirmation ? Que se passe-t-il si la transmission échoue ?
Les tests doivent tenir compte de ces décisions. Vérifier que la nouvelle adresse s’affiche à l’écran ne suffit pas à démontrer qu’elle sera utilisée pour l’expédition : il faut aussi vérifier qu’elle est bien transmise à l’entrepôt et prise en compte par celui-ci.
SquashTM propose le versionnage des exigences. Plusieurs versions peuvent coexister, chacune avec son contenu, son cycle de vie et ses liens avec les cas de test. À la création d’une nouvelle version, il faut considérer les options de reprise des données existantes : reporter les cas de test les associe à la nouvelle version et les détache de la précédente. Le versionnage ne fournit donc pas un instantané complet et automatique de tout le patrimoine de test.

Pour illustrer cette évolution, je conserve la règle d’origine et sa justification dans la version 1 de l’exigence. Je crée ensuite une version 2, qui décrit les nouvelles conditions de modification de l’adresse et explique pourquoi la restriction précédente peut désormais être assouplie.
Les tests existants restent donc liés à la version 1. Pour vérifier la version 2, il faudra préparer des cas de test correspondant aux nouveaux comportements et les associer à cette version. Le tableau suivant présente les scénarios envisagés.
| Référence | Nom du cas de test |
|---|---|
| CT-LIV-001 | Modifier l’adresse de livraison avant la confirmation de la commande |
| CT-LIV-002 | Modifier l’adresse de livraison après la confirmation de la commande et avant la préparation en entrepôt |
| CT-LIV-003 | Vérifier que l’adresse de livraison ne peut plus être modifiée une fois la préparation en entrepôt commencée |
| CT-LIV-004 | Confirmer la modification d’adresse après l’accusé de réception de l’entrepôt |
| CT-LIV-005 | Gérer une modification d’adresse refusée par l’entrepôt |
| CT-LIV-006 | Gérer l’absence d’accusé de réception de l’entrepôt |
Le test qui vérifiait l’interdiction de modifier l’adresse après la confirmation reste pertinent pour décrire le comportement précédent. Pour le nouveau comportement, il faut notamment vérifier que la modification est autorisée avant le début de la préparation, et interdite ensuite.
La liste des versions permet de suivre les deux états de l’exigence et de comprendre les raisons de leur évolution. Cette structure conserve les descriptions successives et leurs liens avec les tests ; elle ne constitue pas pour autant un instantané automatique de tout le patrimoine de test.
Ce travail de mise à jour doit s’intégrer au quotidien. Qui met à jour la règle ? Qui confirme qu’une contrainte ne s’applique plus ? Qui vérifie les scénarios associés ? Entretenir ces connaissances demande la contribution de ceux qui définissent les exigences, prennent les décisions techniques et conçoivent les tests.
Pour évaluer cette démarche, vous pouvez confier une fonctionnalité à une personne qui ne la connaît pas. Retrouve-t-elle le comportement attendu, comprend-elle la raison d’une restriction initiale, identifie-t-elle ce qui a motivé son évolution ? Chaque question restée sans réponse désigne un point concret à améliorer.
SquashTM peut-il devenir la mémoire de conception d’une application ? Il peut certainement y contribuer, à condition que l’équipe documente les attentes, leurs justifications et leurs liens avec les vérifications, et tienne ces informations à jour.
La question de départ devient ainsi un critère pour la documentation : dans deux ans, une autre équipe pourra-t-elle comprendre cette règle, en saisir les raisons, et décider en connaissance de cause de la conserver ou de la faire évoluer ?