Ajout des commentaires dans le code

app/Views/partials/planning_editor.php

@@ -1,4 +1,17 @@
 <?php
+/**
+ * Écran de saisie du planning — le plus dense de l'application.
+ * Contient les deux modes exclusifs (éditeur de semaine type et saisie semaine
+ * par semaine), le formulaire jour par jour, le tableau de visualisation, le
+ * panneau de quota et les modales de semaine type.
+ * La numérotation des étapes se resserre quand le rôle n'a pas droit aux
+ * semaines types (voir $usesTemplates ci-dessous).
+ * Modules JS : `planning`, `weekTemplates`, `weekTemplateEditor`.
+ *
+ * Partiel de contenu inclus par la vue de page homonyme. Les identifiants HTML
+ * posés ici sont les points d'ancrage du module JS : les renommer casse le
+ * module sans aucune erreur visible.
+ */
 // Les rôles sans droit aux semaines types n'ont qu'un seul mode de saisie :
 // le sélecteur de méthode disparaît et la numérotation des étapes se resserre.
 $usesTemplates = !empty($permissions['can_use_templates']);