Ajout des commentaires dans le code

app/Views/partials/administration.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * Référentiels : agents, lieux d'affectation, postes, horaires de couverture.
+ * Modules JS : `administration` et `coverage`.
+ *
+ * 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.
+ */
+?>
     <section id="assignment-view" class="app-view page-content">
         <div class="admin-grid">
             <section class="card admin-card">

app/Views/partials/agent_overview.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * Planning mensuel d'un agent, tous lieux confondus.
+ * Module JS : `agentOverview`.
+ *
+ * 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.
+ */
+?>
     <section id="agent-view" class="app-view page-content">
         <section class="card">
             <div class="section-heading">

app/Views/partials/annual_overview.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Calendrier annuel d'un agent et validation de l'année entière.
+ * Le calendrier est intégralement construit côté serveur (AnnualOverviewModel) ;
+ * ce partiel ne fournit que les conteneurs vides.
+ * Module JS : `annualOverview`.
+ *
+ * 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.
+ */
 $currentYear = (int) date('Y');
 ?>
 <section class="page-content annual-overview-page">

app/Views/partials/coverage_alerts.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * Alertes de couverture d'une semaine.
+ * Module JS : `coverage`.
+ *
+ * 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.
+ */
+?>
 <section id="coverage-view" class="app-view page-content">
     <section class="card coverage-header-card">
         <div class="section-heading">

app/Views/partials/dashboard.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * Tableau de bord du Service Enfance : quatre blocs alimentés par un unique
+ * appel à api/dashboard_summary.php.
+ * Module JS : `dashboard`.
+ *
+ * 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.
+ */
 /** @var string $currentWeek */
 ?>
 <section id="dashboard-view" class="app-view page-content dashboard-page">

app/Views/partials/faq.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Guide d'utilisation. Page entièrement STATIQUE : aucun script, aucun appel
+ * API, aucune donnée métier. Elle reste néanmoins soumise à acces_role_page.
+ *
+ * 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.
+ */
 /** @var array $accessProfile */
 /** @var array $allowedPages */
 

app/Views/partials/pending_validation.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * File des plannings en attente de validation.
+ * Module JS : `pendingValidation`.
+ *
+ * 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.
+ */
+?>
 <section id="pending-validation-view" class="app-view page-content">
     <section class="card pending-validation-header-card">
         <div class="section-heading">

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']);

app/Views/partials/pta.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * PTA détaillé d'un agent : contraintes, souhaits de lieux, répartition.
+ * Module JS : `pta`.
+ *
+ * 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.
+ */
+?>
 <section class="page-content pta-page">
     <section class="card">
         <div class="section-heading">

app/Views/partials/structure_overview.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * Planning d'un lieu sur une semaine, en lecture seule.
+ * Module JS : `structureOverview`.
+ *
+ * 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.
+ */
+?>
     <section id="structure-view" class="app-view page-content">
         <section class="card">
             <div class="section-heading">

app/Views/partials/teams.php

@@ -1,3 +1,13 @@
+<?php
+/**
+ * Équipes des mercredis et des vacances.
+ * Module JS : `teams`.
+ *
+ * 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.
+ */
+?>
 <section class="page-content team-page">
     <section class="card">
         <div class="section-heading">

app/Views/partials/vacation_calendar.php

@@ -1,4 +1,14 @@
 <?php
+/**
+ * Périodes de vacances scolaires : aperçu depuis l'API officielle, validation
+ * manuelle, puis enregistrement. Aucune donnée externe n'entre en base sans
+ * relecture humaine.
+ * Module JS : `vacationCalendar`.
+ *
+ * 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.
+ */
 $currentYear = (int) date('Y');
 $currentMonth = (int) date('n');
 $schoolYearStart = $currentMonth >= 8 ? $currentYear : $currentYear - 1;