Validation automatisée

Statut: runbook de validation
Public: testeurs, mainteneurs, sysadmin
Dernière révision: 2026-06-02

Ce document explique comment automatiser la validation sans remplacer le jugement humain nécessaire pour l'acceptabilité, la lisibilité et l'ergonomie.

Commande locale

Depuis la racine du dépôt:

scripts/validate.sh

Cette commande exécute:

compilation Python du backend et des scripts de déploiement;
tests backend;
build frontend;
tests navigateur Playwright;
syntax-check Ansible lorsque ansible-playbook est disponible.

Pour ignorer temporairement les tests navigateur:

SKIP_E2E=1 scripts/validate.sh

Ce qui est automatisé

règles métier testables par code;
contrats de sécurité et de multi-groupe;
présence des protections de concurrence;
cristallisation des rapports;
exposition correcte de l'accès sysadmin;
page publique de sélection des groupes;
accès sysadmin d'instance;
changement du PIN sysadmin;
liens publics Charte, Confidentialité et Découvrir;
build frontend;
validité syntaxique Ansible.

Ce qui doit rester validé par un humain

lisibilité des rapports PDF;
confort de navigation sur petit téléphone;
ton des textes destinés aux membres;
acceptabilité sociale des processus;
clarté des formulaires papier;
compréhension par des membres non techniques.

Ronde de validation recommandée

Exécuter scripts/validate.sh.
Déployer sur une VM vanille.
Exécuter ansible-playbook ansible/verify.yml.
Réinitialiser Groupe Démonstration.
Parcourir les scénarios du plan de validation fonctionnelle.
Noter les écarts avec la page, l'action, le résultat obtenu et le résultat attendu.

Tests Playwright

Les tests Playwright sont dans frontend/e2e.

Ils démarrent automatiquement Vite, simulent les réponses API nécessaires et exécutent les scénarios dans un navigateur mobile et desktop.

Commande directe:

cd frontend
npm run e2e

Pour installer le navigateur Chromium si nécessaire:

cd frontend
npx playwright install chromium

Évolution prévue

La prochaine étape pertinente est d'élargir Playwright vers les parcours authentifiés complets:

sélection de groupe;
connexion membre et sysadmin;
navigation mobile;
rencontre complète;
assemblée complète;
trésorerie;
journal;
captures de rapports PDF.

Ces tests devront être ajoutés progressivement pour éviter une suite fragile.

2.5 KiB Raw Blame History