Opquast Checker

Analyseur de qualité web basé sur le référentiel Opquast V5 (245 règles)

Disclaimer (afficher une fois par session) :

Opquast Checker n'est pas édité par la société Opquast mais utilise ses contenus et recommandations. Pour approfondir la qualité web : certification Opquast.

Couverture et Limitations

Catégories de règles

DOM Analyzer (Analyse Automatisée)

Le module scripts/dom-analyzer/ vérifie automatiquement 32 règles DOM via Playwright + axe-core:

Usage programmatique:

import { analyze } from './scripts/dom-analyzer/lib/analyzer.js';
const results = await analyze('https://example.com');

Usage CLI:

node scripts/dom-analyzer/index.js https://example.com --json

Bridge Unifié

Le script scripts/bridge.js combine analyse static + DOM:

node scripts/bridge.js https://example.com
# Output: DOM violations + guidance pour règles static

Couverture totale: 193/245 règles (79%) via static + DOM combinés.

Limitation WebFetch (SPAs et contenu dynamique)

Attention : WebFetch récupère uniquement le HTML source initial. Les sites utilisant du rendu côté client (React, Vue, Angular, SPAs) peuvent avoir un contenu incomplet.

Impact sur l'analyse :

• •Les éléments injectés par JavaScript ne seront pas visibles
• •Les données chargées via API (fetch/XHR) ne seront pas analysées
• •Certaines règles "static" peuvent être faussement non-conformes si le contenu réel dépend du JS

Recommandation : Pour les SPAs, demander à l'utilisateur de fournir le HTML rendu (via DevTools > Elements > Copy outer HTML) ou utiliser un outil headless externe.

Ressources

Règles structurées (JSON)

• •rules/opquast-v5.json : 245 règles enrichies avec :
  • •id, title, category, rubrique, tags
  • •objectives : Liste des objectifs de la règle
  • •solution : Solution recommandée
  • •verification : Méthode de vérification
  • •severity : Niveau de sévérité (critical, major, minor)

Niveaux de sévérité

Profils de sites

• •rules/site-profiles.json : Détection et filtrage par type de site

Schéma de sortie

• •schemas/audit-report.json : Schéma JSON pour les rapports d'audit structurés

Règles détaillées (Markdown)

• •references/regles-v5/ : 245 règles individuelles (regle-001.md à regle-245.md)
• •references/V5/ : Fichiers par rubrique et dimension transversale

Rubriques (14)

Dimensions transversales (6)

Commandes

Analyse

Explorateur de règles

Thématiques : accessibilite, seo, securite, privacy, ecoconception, mobile, basics

Rubriques : contenus, donnees-personnelles, e-commerce, formulaires, identification, images, internationalisation, liens, navigation, newsletter, presentation, securite, serveur, structure

Sévérités : critical (156), major (44), minor (45)

Exemples explorateur

Liste paginée (--list)

/opquast --list

# Règles Opquast V5 (1-20 sur 245)

| ID | Titre | Rubrique | Sévérité |
|----|-------|----------|----------|
| 1 | Il est possible de connaître les nouveaux contenus | Contenus | critical |
| 2 | Les droits de copie sont disponibles | Contenus | minor |
| 3 | Métadonnée description présente | Contenus | major |
| ... | ... | ... | ... |

Page 1/13 — `/opquast --list --page 2` pour la suite

Recherche (--search)

/opquast --search formulaire

# 30 règles contenant "formulaire"

| ID | Titre | Sévérité |
|----|-------|----------|
| 67 | Chaque champ est associé à une étiquette | critical |
| 68 | Les étiquettes sont visuellement proches | major |
| 69 | Les champs obligatoires sont indiqués | critical |
| ... | ... | ... |

Par thématique (--theme)

/opquast --theme accessibilite

# 128 règles Accessibilité

| ID | Titre | Rubrique | Sévérité |
|----|-------|----------|----------|
| 4 | Dates en format explicite | Contenus | critical |
| 5 | Abréviations expliquées | Contenus | critical |
| ... | ... | ... | ... |

Par rubrique (--rubrique)

/opquast --rubrique e-commerce

# 39 règles E-Commerce

| ID | Titre | Sévérité |
|----|-------|----------|
| 15 | Prix clairement indiqués | critical |
| 16 | Devise mentionnée | critical |
| 17 | Disponibilité indiquée | major |
| ... | ... | ... |

Intelligence contextuelle

Détection du type de site

Lors de l'analyse, détecter automatiquement le profil du site via rules/site-profiles.json :

Filtrage intelligent

Pour chaque profil, le fichier définit :

• •rubriques_prioritaires : rubriques à vérifier en priorité
• •regles_critiques : règles incontournables pour ce type
• •regles_exclues : règles non pertinentes (ex: e-commerce sur un blog)
• •pages_a_analyser : pages recommandées pour l'audit

Utilisation

1. •Analyser le HTML récupéré
2. •Chercher les indicateurs de détection (keywords, elements, urls, meta)
3. •Sélectionner le profil correspondant
4. •Adapter l'audit aux règles pertinentes
5. •Mentionner le profil détecté dans le rapport

Méthodologie

1. Récupération

• •Utiliser WebFetch pour la page principale
• •Explorer : contact, formulaires, panier, mentions légales, CGV

2. Détection du profil

• •Charger rules/site-profiles.json
• •Analyser le HTML pour détecter le type de site
• •Appliquer le profil ou utiliser vitrine par défaut

3. Vérification

Pour chaque règle applicable :

1. •Charger rules/opquast-v5.json pour les métadonnées enrichies
2. •Filtrer par category: "static" (règles vérifiables)
3. •Exclure les regles_exclues du profil détecté
4. •Prioriser les regles_critiques du profil
5. •Utiliser verification pour la méthode de test
6. •Utiliser solution pour les recommandations

4. Pages à analyser

Selon le profil détecté, analyser les pages définies dans pages_a_analyser. Par défaut :

• •Page d'accueil
• •Contact / Identification
• •Mentions légales / CGV / Confidentialité

Format de sortie

# Analyse Opquast : [Nom du site]

**URL** : [url]
**Date** : [date]
**Profil détecté** : [e-commerce|saas|blog|vitrine|institutionnel]
**Scope** : [thématique/rubrique ou "adapté au profil"]

## Couverture

| Statut | Nombre |
|--------|--------|
| Conformes | X |
| Non conformes | Y |
| Non vérifiables (DOM) | Z |
| Non applicables | W |

---

## Quick Wins

> Corrections rapides à fort impact

| Règle | Problème | Solution | Impact |
|-------|----------|----------|--------|
| 191 | Texte justifié détecté | Supprimer `text-align: justify` | Accessibilité |
| 237 | Copie bloquée | Retirer `user-select: none` | Accessibilité |
| 139 | Soulignement sur non-liens | Utiliser autre style que underline | Accessibilité |

---

## Non-conformités par priorité

### Accessibilité (priorité haute)

#### Règle [N] : [Titre]
**Impact** : Accessibilité
**Pages** : [URL 1], [URL 2]
**Solution** : [Extrait du champ solution de la règle]
[Voir la règle](https://checklists.opquast.com/fr/qualite-numerique/[N])

### SEO (priorité moyenne)

#### Règle [N] : [Titre]
...

### UX/Performance (priorité standard)

#### Règle [N] : [Titre]
...

---

## Règles non vérifiables

Les règles suivantes nécessitent une analyse DOM/CSS :
- Règle 182 : Contraste [Nécessite analyse DOM]
- Règle 165 : Focus clavier [Nécessite analyse DOM]

Ordre de priorité

1. •Accessibilité : Impact utilisateurs en situation de handicap
2. •SEO : Impact référencement et découvrabilité
3. •UX/Performance : Impact expérience utilisateur générale

Section Quick Wins

Afficher les règles CSS-détectables avec correction simple :

• •Règles avec static_verification_method dans le JSON
• •Solutions en une ligne (ex: "Supprimer text-align: justify")
• •Toujours en premier pour action immédiate

Règles d'affichage

• •NE PAS afficher les règles conformes
• •NE PAS afficher les règles non applicables
• •Grouper par tag principal (Accessibilité > SEO > autres)
• •Afficher la section "Règles non vérifiables" avec les règles requires_dom
• •Si tout OK : "Toutes les règles sont respectées."

URL inaccessible

Si WebFetch échoue :

1. •Proposer des captures d'écran
2. •Préciser que certaines règles ne pourront pas être vérifiées
3. •Demander de vérifier l'URL

Workflow

1. •Afficher disclaimer (première fois)
2. •Récupérer page avec WebFetch
3. •Détecter le profil via rules/site-profiles.json
4. •Charger rules/opquast-v5.json (règles enrichies)
5. •Filtrer selon profil et scope demandé
6. •Analyser les pages recommandées
7. •Générer rapport avec profil détecté
8. •Proposer analyse complémentaire

Opquast V5 (Qualité Numérique) — 245 règles