Ajout des commentaires dans le code

app/Views/layouts/footer.php

@@ -1,4 +1,27 @@
 <?php
+/**
+ * Pied de page commun : publication de la configuration JavaScript et injection
+ * des scripts.
+ *
+ * C'EST LE SEUL PONT ENTRE PHP ET LE JAVASCRIPT. Deux objets globaux sont
+ * publiés dans un <script> inline :
+ *  - window.PTA_CONFIG      : jeton CSRF, profil d'accès, permissions et
+ *    référentiel des motifs — données valables pour toute l'application ;
+ *  - window.PTA_PAGE_CONFIG : modules à initialiser et paramètres d'URL déjà
+ *    assainis — données propres à la page courante.
+ * core.js recopie le premier dans `PTA.config` ; page-bootstrap.js consomme le
+ * second.
+ *
+ * Ce <script> porte le nonce de la CSP : sans lui, il serait bloqué et TOUTE
+ * l'interface cesserait de fonctionner. Tout script inline ajouté à une vue doit
+ * faire de même (voir App\Core\Security).
+ *
+ * ORDRE DE CHARGEMENT IMPOSÉ : core.js d'abord (il publie window.PTA), puis les
+ * modules de la page, puis page-bootstrap.js en dernier (il appelle leurs init).
+ *
+ * VERSION DES ASSETS : incrémenter le `?v=` ici, dans layouts/header.php ET
+ * dans Views/pages/role.php après toute modification de JS ou de CSS.
+ */
 /** @var string $csrfToken */
 /** @var array $motifs */
 /** @var array $scripts */