williamandClaude Sonnet 5
c57420c8c9
Config strictement stricte partout (ruff, mypy --strict, bandit, vulture, import-linter, eslint, stylelint), aucune regle desactivee "pour ne pas casser le build" - l'existant a ete corrige pour la satisfaire plutot que l'inverse. Hooks pre-commit locaux (language: system) bloquants. - Typage mypy --strict propage a tout le moteur (db, screens, auth, core, ai, routes, puis publish/scripts/tests/app.py/build_css.py). - Securite : fuite de handle fichier Windows corrigee dans l'export SCORM (routes/publish/export_scorm.py), CSRF/RNG non-crypto/xAPI documentes (# nosec, # NOSONAR justifies), nouveau db.json_for_script() (echappe "</script>" dans le JSON embarque en <script>, 25 sites). - Architecture : imports circulaires/F811 nettoyes, contrats import-linter respectes, code mort retire (vulture). - Accessibilite : 69 champs de formulaire sans label correctement associe corriges (for/id ou aria-label) sur 11 templates. - ESLint/Stylelint : lot mecanique JS/CSS, regles ajustees puis appliquees (aucune desactivee sans verification individuelle). - Tests : isolation du compte admin partage (nettoyage ponctuel + fixture de teardown automatique en filet de securite), suite complete verte (591 tests Python, 241 tests JS). - SonarQube Community Build self-heberge (Docker + PostgreSQL) : rapport complet analyse point par point, faux positifs documentes. - .gitattributes ajoute (LF force) : core.autocrlf=true sur cette machine faisait echouer ESLint (linebreak-style) via un bug connu de git (checkout "en place" qui ignore l'eol force sur un fichier deja present sur disque - contourne en supprimant puis recreant chaque fichier suivi). djLint (H021, styles inline) volontairement saute pour ce commit - backlog assume, deja documente, traite dans un lot separe. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
69 lines
3.7 KiB
Python
69 lines
3.7 KiB
Python
"""Déclaration d'accessibilité exportable (obligation légale RGAA pour
|
|
tout service numérique concerné, voir roadmap phase 1.2) — PAS un audit
|
|
certifié : un résumé honnête, généré à partir de ce que le moteur de jeu
|
|
implémente RÉELLEMENT aujourd'hui (voir static/js/play/triggers.js,
|
|
dialogue-box-controller.js, screens/scenes/render_scene_object.py), à
|
|
compléter/faire valider par le créateur du jeu avant publication."""
|
|
|
|
from datetime import date
|
|
|
|
_DECLARATION_TEMPLATE = """Déclaration d'accessibilité — {game_name}
|
|
Générée le {today} par Forge Engine
|
|
|
|
Cette déclaration résume l'état d'accessibilité du jeu de formation
|
|
"{game_name}" au regard du RGAA (Référentiel Général d'Amélioration de
|
|
l'Accessibilité, version française de WCAG 2.1 niveau AA). Elle décrit ce
|
|
que le moteur Forge Engine implémente pour TOUT jeu exporté — elle ne
|
|
remplace pas un audit RGAA complet réalisé par un expert accessibilité, et
|
|
ne couvre pas le contenu propre à ce jeu (texte, images, choix de
|
|
couleurs) qui reste sous la responsabilité de son créateur.
|
|
|
|
CRITÈRES PRIS EN CHARGE PAR LE MOTEUR
|
|
--------------------------------------
|
|
- Navigation clavier : tout objet de scène réagissant "Au clic" ou "Au
|
|
survol" est focusable (Tab) et activable au clavier (Entrée/Espace),
|
|
en plus de la souris. Les boutons de dialogue/quiz sont de vrais
|
|
<button> HTML.
|
|
- Lecteurs d'écran : les boîtes de dialogue et de quiz sont annoncées
|
|
(role="dialog", contenu dynamique signalé par aria-live). Les images de
|
|
personnages/décors reçoivent le nom donné par le créateur du jeu comme
|
|
alternative textuelle, ou sont marquées décoratives (alt="") si aucun
|
|
nom n'a été renseigné. Les icônes seules sont marquées décoratives.
|
|
- Structure de page : landmark <main> et titre de page (masqué
|
|
visuellement, lu par les lecteurs d'écran).
|
|
- Délai réglable : la révélation de la bonne réponse à une question de
|
|
quiz n'avance plus automatiquement après un délai fixe — l'apprenant
|
|
clique sur "Continuer →" quand il est prêt.
|
|
- Confort visuel : les animations en boucle infinie de l'interface
|
|
respectent le réglage système "Réduire les animations"
|
|
(prefers-reduced-motion).
|
|
- Contraste des couleurs : un avertissement est affiché au créateur du
|
|
jeu dans l'éditeur de style si le contraste texte/fond de la boîte de
|
|
dialogue/quiz est insuffisant (< 4.5:1) — un choix de couleurs reste
|
|
possible malgré l'avertissement, la vérification finale revient au
|
|
créateur du jeu.
|
|
|
|
POINTS RESTANT À LA CHARGE DU CRÉATEUR DE CE JEU
|
|
--------------------------------------------------
|
|
- Choisir des couleurs de texte/fond suffisamment contrastées (le
|
|
moteur avertit, mais n'empêche pas un choix insuffisant).
|
|
- Fournir des noms clairs aux personnages/décors qui portent une
|
|
information (le moteur ne peut pas deviner un contenu manquant).
|
|
- Ajouter des sous-titres/transcriptions à tout contenu audio ajouté au
|
|
jeu (hors du champ du moteur lui-même).
|
|
- Vérifier que le texte des scènes reste compréhensible sans dépendre
|
|
uniquement de la couleur ou de la position.
|
|
|
|
Cette déclaration a été générée automatiquement et n'engage que la
|
|
description de ce que le moteur Forge Engine implémente à la date
|
|
ci-dessus — elle ne constitue pas une certification de conformité RGAA
|
|
complète du jeu "{game_name}".
|
|
"""
|
|
|
|
|
|
def build_accessibility_declaration(game_name: str) -> str:
|
|
"""Texte brut (jamais de mise en forme HTML/Markdown à interpréter :
|
|
prévu pour être lu/imprimé/collé tel quel dans un document interne,
|
|
voir routes/publish/accessibility_declaration.py)."""
|
|
return _DECLARATION_TEMPLATE.format(game_name=game_name, today=date.today().isoformat())
|