Couverture automatique

La couverture automatique indique, pour chaque point, s'il est vérifié par un test automatique (Playwright ou PHPUnit) qui passe sur la version testée. Elle évite de retester à la main ce qui est déjà couvert par la machine, et signale au contraire les points à tester en priorité.

D'où vient la couverture

Un développeur relie un test automatique à un point de test (via son repère dérivé de la référence du point). À chaque exécution de l'intégration continue, les résultats sont ingérés dans capTests, qui recalcule la couverture pour la version concernée. Le badge affiché dépend toujours du résultat le plus récent sur la version testée : un test qui passait en 2.0.60 peut échouer en 2.0.65, et le badge le reflète.

Pour la mise en place côté développeur, voir Automatisation.

Les badges de couverture

Dans la todolist, chaque point porte un badge de couverture pour la version sélectionnée :

Badge Signification
Couvert Un test automatique complet passe sur cette version : test manuel optionnel.
Partiel Seule la mécanique de fond est testée : vérifiez le détail à la main.
Régression Un test lié échoue sur cette version : à tester en priorité.
En attente CI Couvert depuis une version antérieure, mais la CI n'a pas encore tourné ici.
Ignoré Le test lié est désactivé : à tester à la main et à réactiver.
Non couvert Aucun test automatique ne couvre ce point.
Manuel Point non automatisable : recette manuelle permanente, hors de cette logique.

Le badge Couvert signifie que le test manuel est optionnel pour ce point sur cette version. Le badge Régression est le plus important à surveiller : il indique qu'un test qui passait auparavant échoue désormais.

La synthèse de couverture

Depuis le tableau de bord ou depuis la todolist, le bouton Couverture ouvre la synthèse de la couverture automatique pour une version. Choisissez la version puis cliquez sur Afficher.

Page de synthèse de couverture avec les compteurs et le détail par badge

La page affiche d'abord trois compteurs :

  • Cas de la campagne : le nombre de points de la campagne pour cette version.
  • Couverts (full) : les points couverts par un test automatique complet.
  • Non couverts : les points sans couverture automatique.

En dessous, un tableau détaille le nombre de points pour chaque badge (Couvert, Partiel, Régression, En attente CI, Ignoré, Non couvert, Manuel). Cette vue donne en un coup d'oeil l'état de la couverture d'une version et oriente l'effort de recette manuelle vers les points qui en ont le plus besoin.

Prêt à livrer par plateforme

La page de couverture comporte aussi un tableau Prêt à livrer par plateforme. Il reprend les verdicts manuels de la campagne (les points "à tester") et les ventile par appareil : Mobile, Tablette, Desktop. Un point sans étiquette de plateforme compte pour tous les appareils (voir Cas de test).

Tableau Prêt à livrer par plateforme avec, pour chaque appareil, les compteurs et l'état

Pour chaque plateforme, le tableau indique le nombre de points Cas, OK, KO, Bloqué et Non testé, puis un état :

  • Aucun bug : zéro KO et zéro Bloqué sur les points de cette plateforme. Le nombre de points encore "non testés" est rappelé à côté, car ils restent du travail en cours.
  • X à corriger : il reste des KO ou des points bloqués (un point bloqué compte comme un défaut, puisqu'il n'a pas pu être vérifié).

C'est cette vue qui permet de décider une mise en production par appareil : vous pouvez livrer un logiciel "zéro bug mobile" même si des points tablette ou desktop restent en échec, dès lors que la colonne Mobile affiche Aucun bug.