# Notice d'utilisation — AllyNizer > **AllyNizer** est une plateforme de pré-audit automatique RGAA / WCAG. > Elle analyse vos sites web, extraits HTML et documents (PDF, DOCX) et produit un rapport détaillé des problèmes d'accessibilité détectés, classés par sévérité, avec les références normatives correspondantes. > ⚠️ **Pré-audit indicatif.** AllyNizer ne remplace pas un audit RGAA officiel : les tests clavier, lecteur d'écran, contrastes réels et vérifications humaines restent nécessaires. *Notice v3.40 — déclaration d'accessibilité PDF et densité des mots-clés* --- ## Sommaire 1. [Créer un compte et se connecter](#1-créer-un-compte-et-se-connecter) 2. [Lancer un audit de site web ou d'extrait HTML](#2-lancer-un-audit-de-site-web-ou-dextrait-html) 3. [Auditer un site restreint ou protégé](#3-auditer-un-site-restreint-ou-protégé) 4. [Analyser un document PDF ou DOCX](#4-analyser-un-document-pdf-ou-docx) 5. [Lire un rapport](#5-lire-un-rapport) 6. [Qualité Web + Mobile Friendly](#6-qualité-web--mobile-friendly) 7. [Exporter un rapport et générer la grille RGAA](#7-exporter-un-rapport-et-générer-la-grille-rgaa) 8. [Extension navigateur AllyNizer](#8-extension-navigateur-allynizer) 9. [Historique des rapports](#9-historique-des-rapports) 10. [Équipes de travail](#10-équipes-de-travail) 11. [Notes et suivi des corrections](#11-notes-et-suivi-des-corrections) 12. [Comparer deux rapports](#12-comparer-deux-rapports) 13. [Partager un rapport](#13-partager-un-rapport) 14. [Suivi qualité et évolution des scores](#14-suivi-qualité-et-évolution-des-scores) 15. [Grille de suivi et objectifs cible](#15-grille-de-suivi-et-objectifs-cible) 16. [Mon compte et exports globaux](#16-mon-compte-et-exports-globaux) 17. [Administration et configuration](#17-administration-et-configuration) 18. [Ce que l'outil vérifie et ses limites](#18-ce-que-loutil-vérifie-et-ses-limites) --- ## 1. Créer un compte et se connecter Un compte personnel est nécessaire pour utiliser AllyNizer. Vos rapports, fichiers téléversés, objectifs de suivi et exports sont isolés par compte utilisateur. - Si l'inscription publique est activée, cliquez sur **Créer un compte** depuis la page de connexion. - Si l'inscription est fermée, l'administrateur crée votre compte et vous communique vos identifiants. - Un **captcha mathématique** (addition ou soustraction) peut être affiché à la connexion ou à l'inscription. Après connexion, vous accédez à votre **tableau de bord personnel** : derniers rapports, raccourcis, historique, documents, grille de suivi et suivi qualité. ### Modifier son mot de passe Depuis la page **Mon compte**, un formulaire permet de changer son mot de passe à tout moment. Le mot de passe actuel est demandé pour sécuriser l'opération. Le changement est immédiat. ### Avatar et accès rapides personnalisés La page **Mon compte** permet aussi de téléverser un avatar personnel et de choisir les raccourcis affichés sur le tableau de bord. Ces préférences sont enregistrées par profil : chaque utilisateur retrouve son avatar et ses accès rapides selon ses propres choix. --- ## 2. Lancer un audit de site web ou d'extrait HTML Depuis la page d'accueil, renseignez le formulaire **Lancer une vérification** : 1. **Choisissez la source** : **URL** pour auditer une page ou un site, ou **Extrait HTML** pour tester un composant ou un template. 2. **Nommez le projet** *(facultatif)* : facilite la recherche dans l'historique. 3. **Définissez le nombre de pages** : l'outil suit les liens internes du même domaine dans la limite choisie (1 à 50 pages). 4. **Ajoutez les rappels de tests manuels** : utile pour garder une trace des critères non automatisables (clavier, contrastes, pertinence des alternatives). 5. **Lancez l'audit** : le rapport est généré puis enregistré automatiquement dans votre historique. ### Pages JavaScript / SPA Pour les pages dont le contenu est généré par JavaScript, utilisez l'**extension navigateur** et choisissez **Auditer le HTML rendu**. Le navigateur capture le DOM final de la page ouverte et l'envoie à AllyNizer en mode Extrait HTML. > Cette approche ne nécessite pas Playwright côté serveur. Elle fonctionne pour les pages que l'utilisateur peut ouvrir dans son navigateur. ### Audit multi-domaines Pour auditer un écosystème réparti sur plusieurs domaines ou sous-domaines, renseignez les **Domaines supplémentaires autorisés** dans le formulaire URL. Le domaine de départ est toujours inclus. AllyNizer ne suit que les liens dont l'hôte est explicitement autorisé, afin d'éviter un crawl trop large. --- ## 3. Auditer un site restreint ou protégé Pour les sites protégés par une authentification serveur affichée par le navigateur, cochez **Site restreint** dans le formulaire d'audit URL. | Mode | Usage conseillé | |------|----------------| | **Détection automatique cURL** | À tester en premier : cURL négocie le mode disponible. | | **HTTP Basic / LDAP** | Fenêtre d'identification simple, parfois adossée à LDAP. | | **HTTP Digest** | Authentification HTTP Digest selon configuration serveur. | | **NTLM / Active Directory** | Environnements Windows / AD. Identifiant possible : `DOMAINE\login`. | | **Kerberos / Negotiate** | Environnements internes compatibles Negotiate. | > L'identifiant et le mot de passe sont utilisés uniquement pendant l'audit et ne sont jamais enregistrés dans les rapports ou exports. --- ## 4. Analyser un document PDF ou DOCX Depuis la page **PDF / DOCX**, téléversez un document depuis votre compte. | Format | Points vérifiés automatiquement | |--------|--------------------------------| | **PDF** | Balisage, langue déclarée, titre, protection, signets, liens, images et points à vérifier. | | **DOCX** | Titre, langue principale, styles de titres, alternatives aux images, tableaux, liens et structure du document. | Les rapports documentaires apparaissent dans le même historique que les audits de sites, avec un badge **PDF** ou **DOCX**. --- ## 5. Lire un rapport Le rapport s'ouvre automatiquement après l'audit ou depuis l'**Historique**. ### Informations affichées - **Score indicatif /100** — évaluation de l'état général de l'accessibilité. - **Badge de source** — URL, PDF, DOCX ou HTML selon la source analysée. - **Références RGAA / WCAG** — cliquables avec description du critère et exemple de correction. - **Occurrences** — icône trousse de secours pour afficher les extraits HTML disponibles. ### Personnaliser l'ordre des blocs Dans un rapport, le bloc **Ordre des blocs du rapport** permet de choisir ce qui doit apparaître en premier. Les blocs peuvent être déplacés par glisser-déposer ou avec les boutons de réordonnancement. L'ordre est sauvegardé dans la configuration du profil connecté. ### Attribuer l'audit à une équipe Le propriétaire d'un audit peut utiliser le bloc **Equipes** pour donner accès au rapport à une ou plusieurs équipes de travail. Les membres des équipes cochées retrouvent ensuite l'audit dans leur historique, sans devenir propriétaires du rapport. ### Structure de page, landmarks et titres Lorsqu'une page est sélectionnée dans le filtre du rapport, AllyNizer affiche une arborescence dédiée : landmarks, zones principales et titres **H1 à H6**. Les erreurs ou points à vérifier sont marqués directement dans cette arborescence par une icône et une couleur d'alerte. Le panneau peut être réduit ou agrandi pour garder de la place quand la structure est longue. ### Liste détaillée des anomalies La liste des anomalies est paginée dynamiquement (5, 10, 15, 20 lignes ou tout afficher) sans rechargement de page. ### Niveaux de sévérité | Niveau | Signification | |--------|--------------| | 🔴 **Critique** | Problème bloquant ou très pénalisant pour l'accès au contenu. | | 🟠 **Majeur** | Problème important ayant un impact fort sur l'expérience utilisateur. | | 🟡 **Mineur** | Problème secondaire à corriger pour améliorer la qualité. | | 🔵 **Manuel** | Point nécessitant une vérification humaine. | --- ## 6. Qualité Web + Mobile Friendly Quand l'option est activée dans la configuration, les nouveaux audits peuvent intégrer un pré-test complémentaire **Qualité Web + Mobile Friendly**. Il ne remplace pas le score RGAA / WCAG : il ajoute une lecture rapide sur la qualité sémantique, la compatibilité mobile et quelques signaux utiles pour une page plus lisible par les moteurs de recherche. - **Sémantique** — Présence et cohérence du H1, hiérarchie des titres, landmarks et structure HTML. - **Google Friendly** — Titre, description, canonical, robots, liens et signaux techniques de base. - **Mobile Friendly** — Viewport, zoom utilisateur, largeurs fixes et indices de mise en page responsive. - **Performance légère** — Poids indicatif, dimensions d'images, scripts et éléments pouvant ralentir la page. - **Densité mots-clés** — Groupes de 2, 3 et 4 mots les plus présents, avec occurrences, pourcentage, signal faible / équilibré / répétitif et zones repérées. Le bloc affiche un score global sur 100, des sous-scores colorés du rouge au vert, puis des actions prioritaires. Un encadré vert signale les sous-scores à 100/100 ; orange ou rouge indiquent les points à reprendre en priorité. > Cette V1 reste un pré-test automatique : elle ne remplace pas Lighthouse, Google Search Console, un test mobile réel ou une analyse SEO éditoriale complète. --- ## 7. Exporter un rapport et générer la grille RGAA | Export | Contenu | |--------|---------| | **CSV** | Tableau des constatations, importable dans Excel ou LibreOffice. | | **PDF** | Rapport mis en forme, prêt à être partagé. | | **Déclaration d'accessibilité PDF** | Brouillon de déclaration prérempli depuis le rapport : état de conformité, synthèse, contenus non accessibles, tests réalisés et zones à compléter. | | **JSON** | Données brutes structurées. | | **Grille RGAA ODS** | Grille basée sur le modèle fourni : synthèse, critères RGAA, statuts, pages analysées et occurrences. | Statuts ODS : **C** Conforme indicatif · **NC** Non conforme · **NA** Non applicable · **NT** Non testé / manuel. > Pour les audits URL, les pages analysées peuvent être intégrées comme liens cliquables dans la grille ODS. --- ## 8. Extension navigateur AllyNizer L'extension permet d'envoyer l'URL de l'onglet courant ou le HTML déjà rendu par le navigateur vers AllyNizer, sans installer Playwright sur le serveur. Compatible Chrome et Microsoft Edge. **Installation :** 1. Décompressez le ZIP de l'extension dans un emplacement stable sur le poste. 2. Ouvrez `chrome://extensions` ou `edge://extensions` et activez le mode développeur. 3. Cliquez sur **Charger l'extension non empaquetée** et sélectionnez le dossier décompressé. 4. Dans les options de l'extension, renseignez l'adresse de cette instance (ex : `http://localhost:8080` ou votre URL de production). > Le mode HTML rendu lit uniquement la page active au moment du clic. Il sert aux SPA et contenus injectés par JavaScript, mais ne remplace pas les tests humains. **Alternative Firefox : bouton à glisser** Si vous ne souhaitez pas installer d'extension, glissez le bouton bookmarklet dans la barre personnelle du navigateur. Depuis une page web, un clic ouvrira AllyNizer avec l'URL préremplie. --- ## 9. Historique des rapports La page **Historique** liste vos rapports du plus récent au plus ancien. - Chaque rapport affiche un badge **URL**, **PDF** ou **DOCX**. - La carte indique le projet, la source, la date, le score, le nombre de pages ou fichiers et le nombre de points. - Les actions disponibles permettent d'ouvrir, relancer, exporter, télécharger la grille RGAA ou supprimer un rapport. ### Recherche, pagination et suppression multiple Un champ de recherche permet de filtrer les rapports par nom de projet, URL ou type. La liste se pagine dynamiquement sans rechargement de page, ce qui facilite la navigation dans un historique long. Plusieurs rapports peuvent être sélectionnés puis supprimés en une seule action. Le libellé indique clairement le nombre de rapports sélectionnés et une fenêtre de confirmation sécurise la suppression. --- ## 10. Équipes de travail La page **Équipe** permet de créer plusieurs groupes de travail afin de partager les audits avec les bons interlocuteurs. - **Plusieurs équipes** — Un même compte peut créer plusieurs équipes, par exemple par client, projet, service ou campagne d'audit. - **Membres inscrits** — Le moteur de recherche du champ e-mail aide à ajouter des utilisateurs déjà inscrits sur la plateforme. - **Avatar facultatif** — Chaque équipe peut recevoir un avatar ou logo pour être plus facilement identifiable dans l'interface. - **Audits par équipe** — Depuis un rapport, le propriétaire choisit les équipes autorisées à consulter cet audit. ### Renommer ou supprimer une équipe Le propriétaire peut renommer une équipe depuis ses paramètres. Il peut aussi supprimer l'équipe après confirmation : cette action retire les membres de l'équipe, supprime ses accès aux audits et son avatar, mais ne supprime jamais les comptes utilisateurs. ### Droits d'accès Un membre peut appartenir à plusieurs équipes. Il voit les audits dont il est propriétaire et les audits attribués aux équipes dont il fait partie. Seul le propriétaire de l'audit peut modifier les équipes autorisées. > Les données sont stockées dans trois fichiers distincts : `teams.json`, `team_members.json` et `report_team_access.json`. Les avatars d'équipe sont enregistrés dans `storage/team_avatars/`. --- ## 11. Notes et suivi des corrections Depuis un rapport ouvert, deux outils complémentaires permettent de piloter les corrections directement dans AllyNizer. ### Notes libres sur un rapport Un champ de note libre est disponible en bas de chaque rapport. Il permet d'y saisir des observations, des arbitrages ou un contexte utile pour l'équipe. La note est enregistrée côté serveur et reste associée au rapport dans l'historique. Elle est incluse dans l'export PDF du rapport. - La note accepte jusqu'à 4 000 caractères. - Pour effacer une note, videz le champ et enregistrez. ### Marquer une anomalie comme corrigée Dans le tableau des anomalies, chaque ligne dispose d'une case à cocher **Fait**. Cocher une anomalie la marque comme traitée : la ligne est barrée et distinguée visuellement des points restants. Le statut est enregistré dans le rapport JSON et persiste entre les sessions. - Le suivi est propre à chaque rapport : relancer un audit produit un nouveau rapport dont l'état repart à zéro. - Les anomalies marquées **Fait** restent visibles pour garder la trace du travail effectué. - L'état des corrections peut être relu dans l'export JSON du rapport. --- ## 12. Comparer deux rapports Le bouton **Comparer** disponible dans chaque rapport ouvre `compare.php` avec ce rapport pré-sélectionné comme référence. Vous choisissez ensuite un second rapport dans la liste pour lancer la comparaison. | Section | Contenu | |---------|---------| | **Scores côte à côte** | Score, nombre de pages, critiques, majeures, mineures et manuelles des deux rapports avec delta chiffré. | | **Règles corrigées** | Anomalies présentes dans le rapport A et absentes du rapport B : les corrections réalisées entre les deux audits. | | **Règles apparues** | Anomalies nouvelles dans le rapport B, absentes du rapport A : les régressions ou nouveaux problèmes détectés. | | **Règles communes** | Anomalies présentes dans les deux rapports : les points qui restent à corriger. | > La comparaison fonctionne entre n'importe quels rapports de votre historique, même de types différents. Elle est particulièrement utile pour mesurer l'impact d'une campagne de corrections entre deux audits successifs d'un même site. --- ## 13. Partager un rapport Depuis un rapport ouvert, la section **Partage** permet de générer un lien d'accès public en lecture seule. 1. **Générer le lien** — Cliquez sur **Générer un lien de partage**. Un token unique est créé et associé au rapport dans `storage/shared_audits.json`. 2. **Copier et transmettre** — Le lien affiché peut être copié et envoyé à n'importe quel destinataire, même sans compte AllyNizer. 3. **Consultation en lecture seule** — Le destinataire voit le rapport complet (anomalies, score, exports) mais ne peut pas le modifier ni le supprimer. 4. **Importer dans son espace** — Un utilisateur connecté qui consulte un rapport partagé peut cliquer sur **Ajouter à mon espace** pour en faire une copie dans son propre historique. > Un lien de partage ne donne accès qu'à ce rapport précis, en lecture seule. Il ne permet pas d'accéder aux autres rapports ou aux données du compte propriétaire. --- ## 14. Suivi qualité et évolution des scores La page **Suivi qualité** regroupe les audits d'une même source URL pour suivre la progression dans le temps. - **Score initial** — Point de départ de la démarche de correction. - **Score actuel** — Dernier résultat mesuré pour le site. - **Meilleur score** — Meilleure performance obtenue. - **Courbe d'évolution** — Visualisation des audits successifs d'un même site. --- ## 15. Grille de suivi et objectifs cible La page **Grille de suivi** transforme les constats d'audit en plan d'action. Elle affiche un tableau consolidé des rapports, puis les **jalons qualité / objectifs cible par critère** lorsque l'option est activée dans la configuration. La barre de recherche, le tri et la sélection multiple aident à gérer les rapports à suivre. Les suppressions groupées utilisent une confirmation en modal pour éviter les suppressions involontaires. | Champ | Utilité | |-------|---------| | **Objectif cible** | Niveau attendu : court terme, conformité AA, correction avant publication, etc. | | **Échéance** | Date cible de correction. | | **Responsable** | Compte utilisateur chargé du traitement, sélectionné dans une liste déroulante alimentée par les comptes existants. | | **État** | À définir · À planifier · En cours · Corrigé à recontrôler · Validé · Reporté. | | **Note** | Commentaire libre ou arbitrage. | Les objectifs sont sauvegardés par utilisateur et peuvent être intégrés à l'export PDF de la grille de suivi. Si les jalons sont activés mais qu'aucun objectif n'apparaît, lancez ou relancez un audit contenant des anomalies exploitables. --- ## 16. Mon compte et exports globaux La page **Mon compte** affiche vos statistiques consolidées : nombre de rapports, pages analysées, points relevés, meilleur score, derniers rapports et aperçu de progression qualité. | Format | Contenu | |--------|---------| | **ZIP** | Tous vos rapports JSON et CSV, si ZipArchive est disponible. | | **PDF global** | Rapport consolidé de tous vos audits. | | **CSV global** | Toutes les constatations dans un fichier tabulaire unique. | | **JSON global** | Données brutes complètes dans un fichier structuré. | --- ## 17. Administration et configuration Les administrateurs disposent d'un espace de configuration pour adapter l'instance AllyNizer. - Nom de plateforme, logo, mode démo ou production. - Inscription publique, captcha, analyse PDF / DOCX et limites d'upload. - Exports globaux, jalons qualité / objectifs cible, Qualité Web + Mobile Friendly et options de nettoyage des données de test. - Préparation d'une diffusion publique sans comptes, rapports ou uploads locaux. --- ## 18. Ce que l'outil vérifie et ses limites ### Vérifications automatiques AllyNizer analyse : images, liens, boutons, formulaires, titres (h1–h6), langue, landmarks ARIA, lien d'évitement, attributs ARIA, iframes, tableaux, identifiants dupliqués, médias et indices d'accessibilité PDF / DOCX. ### Limites importantes AllyNizer est un **outil de pré-audit indicatif**. Il ne peut pas évaluer : - la pertinence réelle d'un texte alternatif ; - la navigation clavier complète et les composants JavaScript complexes ; - les contrastes réels après rendu CSS ; - l'ordre de lecture réel d'une page ; - les parcours avec authentification applicative ou SSO avancé ; - la conformité RGAA complète sans qualification humaine ; - les résultats Qualité Web et Mobile Friendly (indicatifs uniquement, ne remplacent pas un test sur navigateur, Lighthouse ou Google Search Console). > Pour une démarche de conformité, complétez toujours l'analyse automatique par un test clavier, un test lecteur d'écran, une vérification des contrastes et une revue humaine des critères RGAA. --- *AllyNizer — v3.39.0 — Juin 2026*