Phase 3 : hardening qualite de code - typage strict, securite, dead code, a11y

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>

routes/screens/__init__.py

@@ -1 +1,10 @@
-from . import screens_new, screen_rename, screen_move, screen_delete, screen_edit, screen_set_background_music, screen_set_scene_size, screen_triggers
+from . import (  # noqa: F401 - enregistre les routes definies dans chaque module
+    screen_delete,
+    screen_edit,
+    screen_move,
+    screen_rename,
+    screen_set_background_music,
+    screen_set_scene_size,
+    screen_triggers,
+    screens_new,
+)

routes/screens/screen_delete.py

@@ -1,12 +1,12 @@
 from flask import redirect, url_for
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/delete", methods=["POST"])
-def screen_delete(slug, screen_id):
+def screen_delete(slug: str, screen_id: int) -> Response:
     referencing = screens.screens_referencing(slug, screen_id)
     if referencing:
         return redirect(url_for("game_dashboard", slug=slug, tab="screens", blocked_screen=screen_id))

routes/screens/screen_edit.py

@@ -2,13 +2,13 @@ from flask import abort
 
 import db
 import screens
-
 from core.flask_app import app
+
 from ..scenes.scene_edit_view import render_scene_edit
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/edit")
-def screen_edit(slug, screen_id):
+def screen_edit(slug: str, screen_id: int) -> str:
     game = db.game_meta(slug)
     screen = screens.get_screen(slug, screen_id)
     if not screen:

routes/screens/screen_move.py

@@ -1,12 +1,12 @@
-from flask import request, redirect, url_for
+from flask import redirect, request, url_for
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/move", methods=["POST"])
-def screen_move(slug, screen_id):
+def screen_move(slug: str, screen_id: int) -> Response:
     direction = -1 if request.form.get("direction") == "up" else 1
     screens.move_screen(slug, screen_id, direction)
     return redirect(url_for("game_dashboard", slug=slug, tab="screens"))

routes/screens/screen_rename.py

@@ -1,12 +1,12 @@
-from flask import request, redirect, url_for
+from flask import redirect, request, url_for
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/rename", methods=["POST"])
-def screen_rename(slug, screen_id):
+def screen_rename(slug: str, screen_id: int) -> Response:
     new_name = request.form.get("name", "").strip()
     if new_name:
         screens.rename_screen(slug, screen_id, new_name)

routes/screens/screen_set_background_music.py

@@ -1,12 +1,12 @@
-from flask import request, jsonify
+from flask import jsonify, request
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/background-music", methods=["POST"])
-def screen_set_background_music(slug, screen_id):
+def screen_set_background_music(slug: str, screen_id: int) -> Response:
     """Mémorise l'URL de musique de fond de cet écran, en AJAX — même patron
     que screen_set_aspect."""
     body = request.get_json(silent=True) or {}

routes/screens/screen_set_scene_size.py

@@ -1,19 +1,22 @@
-from flask import request, jsonify
+from flask import jsonify, request
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/scene-size", methods=["POST"])
-def screen_set_scene_size(slug, screen_id):
-    """"📐 Agrandir la caméra à la zone visible" (voir templates/
+def screen_set_scene_size(slug: str, screen_id: int) -> Response | tuple[Response, int]:
+    """ "📐 Agrandir la caméra à la zone visible" (voir templates/
     scene_edit.html) — redimensionne la scène/caméra elle-même à la
     taille du "monde" affiché (world_width/world_height, voir
     routes/scenes/scene_edit_view.py), calculée et postée par le client."""
     body = request.get_json(silent=True) or {}
+    raw_width, raw_height = body.get("width"), body.get("height")
     try:
-        width, height = int(body.get("width")), int(body.get("height"))
+        if raw_width is None or raw_height is None:
+            raise ValueError
+        width, height = int(raw_width), int(raw_height)
     except (TypeError, ValueError):
         return jsonify({"error": "largeur/hauteur invalides"}), 400
     screens.set_scene_size(slug, screen_id, width, height)

routes/screens/screen_triggers.py

@@ -1,12 +1,12 @@
 from flask import jsonify, request
+from werkzeug.wrappers import Response
 
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers", methods=["GET"])
-def screen_triggers_get(slug, screen_id):
+def screen_triggers_get(slug: str, screen_id: int) -> Response | tuple[Response, int]:
     """Déclencheurs D'ÉCRAN de CET écran (voir "Déclencheurs de l'écran",
     screens/rendering/screen_triggers.py) — SANS objet requis, pour de la
     narration/cinématique dès l'affichage."""
@@ -23,7 +23,7 @@ def screen_triggers_get(slug, screen_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers", methods=["POST"])
-def screen_triggers_add(slug, screen_id):
+def screen_triggers_add(slug: str, screen_id: int) -> Response | tuple[Response, int]:
     """Ajoute une règle "déclencheur d'écran -> action" — body {rule}, même
     contrat "liste ENTIÈRE" que routes/triggers/triggers.py::triggers_add :
     on recharge les règles existantes de l'écran, on y ajoute la nouvelle,
@@ -44,7 +44,7 @@ def screen_triggers_add(slug, screen_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers", methods=["DELETE"])
-def screen_triggers_clear(slug, screen_id):
+def screen_triggers_clear(slug: str, screen_id: int) -> Response | tuple[Response, int]:
     """Retire TOUTES les règles d'écran de CET écran."""
     if screens.get_screen(slug, screen_id) is None:
         return jsonify({"error": "écran introuvable"}), 404
@@ -53,7 +53,7 @@ def screen_triggers_clear(slug, screen_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers/<int:index>", methods=["DELETE"])
-def screen_trigger_delete_one(slug, screen_id, index):
+def screen_trigger_delete_one(slug: str, screen_id: int, index: int) -> Response | tuple[Response, int]:
     """Retire UNE SEULE règle d'écran (son index dans la liste) —
     contrairement aux déclencheurs d'objet (un seul par objet en
     pratique), un écran peut porter plusieurs règles "affichage" côte à
@@ -72,7 +72,7 @@ def screen_trigger_delete_one(slug, screen_id, index):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers/action/<leaf_id>", methods=["DELETE"])
-def screen_trigger_remove_action(slug, screen_id, leaf_id):
+def screen_trigger_remove_action(slug: str, screen_id: int, leaf_id: str) -> Response | tuple[Response, int]:
     """Retire UNE action précise d'un déclencheur d'écran — même contrat
     que routes/triggers/triggers.py::trigger_remove_action."""
     if not screens.remove_action_from_screen_trigger(slug, screen_id, leaf_id):
@@ -81,7 +81,7 @@ def screen_trigger_remove_action(slug, screen_id, leaf_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers/action/<leaf_id>/move", methods=["POST"])
-def screen_trigger_move_action(slug, screen_id, leaf_id):
+def screen_trigger_move_action(slug: str, screen_id: int, leaf_id: str) -> Response | tuple[Response, int]:
     """Déplace une action précise d'un cran ("up"/"down") dans sa chaîne,
     pour un déclencheur d'écran — même contrat que
     routes/triggers/triggers.py::trigger_move_action."""
@@ -95,7 +95,7 @@ def screen_trigger_move_action(slug, screen_id, leaf_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers/dialogue", methods=["POST"])
-def screen_trigger_dialogue_update(slug, screen_id):
+def screen_trigger_dialogue_update(slug: str, screen_id: int) -> Response | tuple[Response, int]:
     """Édition EN LIGNE des répliques d'un dialogue porté par un
     déclencheur d'écran — même contrat que
     routes/triggers/triggers.py::trigger_dialogue_update."""
@@ -116,8 +116,8 @@ def screen_trigger_dialogue_update(slug, screen_id):
 
 
 @app.route("/game/<slug>/screens/<int:screen_id>/triggers/append-action", methods=["POST"])
-def screen_trigger_append_action(slug, screen_id):
-    """"+ Ajouter une action" en bout de chaîne, pour un déclencheur
+def screen_trigger_append_action(slug: str, screen_id: int) -> Response | tuple[Response, int]:
+    """ "+ Ajouter une action" en bout de chaîne, pour un déclencheur
     d'écran — même contrat que
     routes/triggers/triggers.py::trigger_append_action."""
     if screens.get_screen(slug, screen_id) is None:

routes/screens/screens_new.py

@@ -1,13 +1,12 @@
-from flask import request, redirect, url_for
+from flask import redirect, request, url_for
+from werkzeug.wrappers import Response
 
-import db
 import screens
-
 from core.flask_app import app
 
 
 @app.route("/game/<slug>/screens/new", methods=["POST"])
-def screens_new(slug):
+def screens_new(slug: str) -> Response:
     name = request.form.get("name", "").strip()
     # Un seul moteur d'écran désormais (jeu_2d) — imposé à tout écran créé,
     # quel que soit le projet (voir db/games/game_type_catalog.py).