Conformité des modules — méthodologie

Cette partie permet de balayer chaque module composant par composant et de vérifier qu'il respecte les normes de qualité d'Open ENT, telles que définies dans le Guide de contribution OPEN ENT NG.

➡️ Ouvrir le tableau de conformité interactif

Le référentiel

Le guide définit deux ensembles d'exigences, chacune typée Obligatoire (à respecter dès lors qu'elle est applicable) ou Recommandation (dérogation possible, à justifier) :

Catégorie	Réf	Exemples
UX/UI	U1–U11	bonnes pratiques, librairie de composants, thèmes 1D/2D, responsive, accessibilité…
Fonctionnel	F1–F13	notifications, droits, traduction (6 langues), export/import, transition d'année, marquage statistique/DNMA, plan de test…
Technique	T1–T8	timezones, traçabilité, performances, tests de charge, guide d'installation, licence AGPLv3, sécurité…
Accessibilité	A1–A23	navigation clavier, focus visible, hiérarchie des titres, langue par défaut…

Le référentiel complet est dans static/conformite-referentiel.json (transcrit du PDF du guide).

Évaluer un module

La page /conformite permet de :

• sélectionner un module et voir, pour chaque exigence, son statut ;
• filtrer / mettre à l'avant par catégorie (UX/UI, Fonctionnel, Technique, Accessibilité), par type (Obligatoire / Recommandation) et par statut ;
• consulter un score de conformité (part des exigences obligatoires conformes) ;
• ouvrir les tests complémentaires rattachés à une exigence (rapport e2e, recette…).

Statuts d'évaluation

Statut	Sens
conforme	exigence respectée
partiel	partiellement respectée
non-conforme	non respectée
derogation	dérogation justifiée (recommandations uniquement)
na	non applicable au module
a-faire	à évaluer (valeur par défaut)

Saisir une évaluation

Les évaluations sont stockées dans static/conformite-modules.json. Pour chaque module, on ajoute dans evaluations les réf évaluées :

{
  "name": "blog",
  "label": "Blog",
  "repo": "open-ent/blog",
  "evaluations": {
    "F6": {
      "statut": "partiel",
      "note": "Tracking Matomo via proxy ; vérifier resourceType snake_case",
      "tests": ["https://doc.tech.fr/open-ent-test/open-ent/#?q=04_blog"]
    }
  }
}

Une réf non listée est considérée comme a-faire. Le champ tests reçoit des tests complémentaires (liens vers le dashboard e2e, un rapport de recette, etc.) — c'est ainsi qu'on ajoute des tests à une exigence.

Lien avec les tests E2E

Le dashboard des tests E2E couvre la vérification de l'exigence F11 (plan de test) : on y rattache, par exigence, les specs Playwright pertinentes. La conformité (ce tableau) et l'exécution des tests (dashboard e2e) sont complémentaires.