Ajout des commentaires dans le code

app/Views/pages/administration.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/administration.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/agents.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/agent_overview.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/annual.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/annual_overview.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/coverage.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/coverage_alerts.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/dashboard.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/dashboard.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/faq.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/faq.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/pending.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/pending_validation.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/planning.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/planning_editor.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/pta.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/pta.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/role.php

@@ -1,4 +1,15 @@
 <?php
+/**
+ * Sélecteur de rôle — SEULE vue à ne pas passer par layouts/header.php.
+ *
+ * Elle s'affiche avant qu'un rôle soit choisi, donc avant tout contrôle
+ * d'accès, et ne peut pas afficher la barre de navigation qui en dépend. Elle
+ * porte donc son propre <head> : c'est le TROISIÈME endroit où incrémenter le
+ * `?v=` des assets, avec layouts/header.php et layouts/footer.php.
+ *
+ * Rappel : sélection n'est pas authentification. L'utilisateur choisit
+ * librement son identité (voir App\Core\Access::select()).
+ */
 /** @var string $csrfToken */
 /** @var array $agents */
 /** @var array $structures */

app/Views/pages/structures.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/structure_overview.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/teams.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/teams.php';
 require dirname(__DIR__) . '/layouts/footer.php';

app/Views/pages/vacations.php

@@ -1,4 +1,9 @@
 <?php
+/**
+ * Vue de page : assemble l'en-tête commun, le partiel de contenu et le pied.
+ * Toutes les variables utilisées viennent de PageController::renderPage(), qui
+ * les a extraites dans la portée de ce fichier.
+ */
 require dirname(__DIR__) . '/layouts/header.php';
 require dirname(__DIR__) . '/partials/vacation_calendar.php';
 require dirname(__DIR__) . '/layouts/footer.php';