V7.10 — Tableau de bord, guide, semaine type et enveloppe de formation

Reprise dans le répertoire de production du travail mené dans le worktree
ux-service-enfance :

- tableau de bord Service Enfance (dashboard.php) et navigation regroupée ;
- guide d'utilisation (faq.php) accessible depuis toute la navigation ;
- éditeur de semaine type mis en avant sur l'écran de saisie ;
- droit à l'enveloppe de formation par agent, en remplacement de la case
  « formation déjà prévue dans la répartition annuelle » ;
- correctif de « [object Object] » sur les cartes de quota du PTA ;
- motif de travail par défaut à la saisie, heures travaillées complètes
  dans les PDF.

Le docker-compose.yml de production est conservé : celui du worktree décrit
une pile de test (conteneurs et volume suffixés « test », ports 9080/9081),
qui aurait fait redémarrer l'application sur un volume MariaDB vide.

Les migrations database/migration_v7_9*.sql sont obligatoires ; le service
db-migrate les applique au déploiement.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

app/Views/layouts/header.php

@@ -1,21 +1,73 @@
 <?php
 /** @var string $pageTitle */
+/** @var string $pageSubtitle */
 /** @var string $activePage */
 /** @var array $allowedPages */
 /** @var array $accessProfile */
+/** @var string $csrfToken */
+
+$isAgent = ($accessProfile['role'] ?? '') === 'AGENT';
 
 $navigation = [
+    'dashboard' => ['dashboard.php', 'Tableau de bord'],
     'planning' => ['planning.php', 'Saisie'],
     'pending' => ['pending.php', 'À valider'],
     'coverage' => ['coverage.php', 'Couverture'],
     'structures' => ['structures.php', 'Par lieu'],
-    'agents' => ['agents.php', ($accessProfile['role'] ?? '') === 'AGENT' ? 'Mon planning' : 'Par agent'],
+    'agents' => ['agents.php', $isAgent ? 'Mon planning' : 'Par agent'],
     'annual' => ['annual.php', 'Vue annuelle'],
     'pta' => ['pta.php', 'PTA détaillé'],
     'teams' => ['teams.php', 'Équipes'],
     'vacations' => ['vacations.php', 'Vacances'],
     'administration' => ['administration.php', 'Administration'],
 ];
+
+/**
+ * Les onze onglets du Service Enfance étaient alignés à plat, sans hiérarchie :
+ * rien ne distinguait une tâche quotidienne d'un référentiel modifié deux fois
+ * par an. Ils sont désormais regroupés par intention. Les rôles qui n'ont que
+ * quelques pages gardent une barre simple, sans titres de groupe.
+ */
+$navigationGroups = [
+    'Piloter' => ['dashboard', 'pending', 'coverage'],
+    'Planifier' => ['planning', 'teams'],
+    'Consulter' => ['agents', 'structures', 'annual', 'pta'],
+    'Paramétrer' => ['vacations', 'administration'],
+];
+
+$visibleGroups = [];
+$grouped = [];
+foreach ($navigationGroups as $groupLabel => $keys) {
+    $visibleKeys = array_values(array_filter(
+        $keys,
+        static fn (string $key): bool => in_array($key, $allowedPages, true) && isset($navigation[$key])
+    ));
+    if ($visibleKeys !== []) {
+        $visibleGroups[$groupLabel] = $visibleKeys;
+        $grouped = array_merge($grouped, $visibleKeys);
+    }
+}
+
+// Filet de sécurité : une page autorisée en base mais oubliée dans les groupes
+// ci-dessus reste accessible plutôt que de disparaître de la navigation.
+$ungrouped = array_values(array_filter(
+    $allowedPages,
+    static fn (string $key): bool => isset($navigation[$key]) && !in_array($key, $grouped, true)
+));
+if ($ungrouped !== []) {
+    $visibleGroups['Autres'] = $ungrouped;
+}
+
+$visiblePageCount = count($grouped) + count($ungrouped);
+$showGroupLabels = $visiblePageCount > 4;
+
+/**
+ * Le guide n'appartient à aucun groupe d'intention : ce n'est pas une étape du
+ * travail mais un secours permanent. Il est volontairement absent de
+ * $navigation — il ne doit apparaître qu'une seule fois, ancré à droite de la
+ * barre, et jamais repêché par le filet « Autres ».
+ */
+$showHelpTab = in_array('faq', $allowedPages, true);
 ?>
 <!doctype html>
 <html lang="fr">
@@ -23,15 +75,15 @@ $navigation = [
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title><?= htmlspecialchars($pageTitle) ?> — PTA</title>
-    <link rel="stylesheet" href="assets/style.css?v=7.7">
+    <link rel="stylesheet" href="assets/style.css?v=7.16">
 </head>
 <body>
 <main class="app-shell">
     <header class="page-header">
-        <div>
+        <div class="page-header-identity">
             <p class="eyebrow">PTA</p>
             <h1><?= htmlspecialchars($pageTitle) ?></h1>
-            <p class="subtitle">Planification annuelle, équipes, quotas et contrôles métier des accueils de loisirs.</p>
+            <p class="subtitle"><?= htmlspecialchars($pageSubtitle ?? '') ?></p>
         </div>
         <div class="header-actions">
             <?php if ($activePage === 'planning'): ?>
@@ -40,11 +92,11 @@ $navigation = [
             <div class="access-profile-badge">
                 <span><?= htmlspecialchars((string) ($accessProfile['role_label'] ?? '')) ?></span>
                 <strong><?= htmlspecialchars((string) ($accessProfile['label'] ?? '')) ?></strong>
-                <?php if (!empty($accessProfile['structure_name']) && ($accessProfile['role'] ?? '') === 'AGENT'): ?>
+                <?php if (!empty($accessProfile['structure_name']) && $isAgent): ?>
                     <small><?= htmlspecialchars((string) $accessProfile['structure_name']) ?></small>
                 <?php endif; ?>
             </div>
-            <a class="button button-ghost switch-role-link" href="role.php?action=reset">Changer de rôle</a>
+            <a class="button button-ghost switch-role-link" href="role.php?action=reset&amp;csrf_token=<?= htmlspecialchars(urlencode($csrfToken), ENT_QUOTES) ?>">Changer de rôle</a>
         </div>
     </header>
 
@@ -52,12 +104,29 @@ $navigation = [
         <div class="message message-warning role-access-warning">Cette page n’est pas disponible avec votre rôle actuel.</div>
     <?php endif; ?>
 
-    <nav class="view-tabs" aria-label="Navigation principale">
-        <?php foreach ($navigation as $key => [$href, $label]): ?>
-            <?php if (!in_array($key, $allowedPages, true)) continue; ?>
-            <a class="view-tab<?= $activePage === $key ? ' is-active' : '' ?>" href="<?= htmlspecialchars($href) ?>"<?= $activePage === $key ? ' aria-current="page"' : '' ?>>
-                <?= htmlspecialchars($label) ?>
-                <?php if ($key === 'pending'): ?><span id="pending-validation-tab-badge" class="nav-count-badge" hidden>0</span><?php endif; ?>
-            </a>
+    <nav class="view-tabs<?= $showGroupLabels ? ' view-tabs-grouped' : '' ?>" aria-label="Navigation principale">
+        <?php foreach ($visibleGroups as $groupLabel => $keys): ?>
+            <div class="view-tab-group" role="group"<?= $showGroupLabels ? ' aria-label="' . htmlspecialchars($groupLabel, ENT_QUOTES) . '"' : '' ?>>
+                <?php if ($showGroupLabels): ?>
+                    <span class="view-tab-group-label"><?= htmlspecialchars($groupLabel) ?></span>
+                <?php endif; ?>
+                <div class="view-tab-group-items">
+                    <?php foreach ($keys as $key): ?>
+                        <?php [$href, $label] = $navigation[$key]; ?>
+                        <a class="view-tab<?= $activePage === $key ? ' is-active' : '' ?>" href="<?= htmlspecialchars($href) ?>"<?= $activePage === $key ? ' aria-current="page"' : '' ?>>
+                            <?= htmlspecialchars($label) ?>
+                            <?php if ($key === 'pending'): ?><span id="pending-validation-tab-badge" class="nav-count-badge" hidden>0</span><?php endif; ?>
+                        </a>
+                    <?php endforeach; ?>
+                </div>
+            </div>
         <?php endforeach; ?>
+        <?php if ($showHelpTab): ?>
+            <div class="view-tab-help">
+                <a class="view-tab view-tab-faq<?= $activePage === 'faq' ? ' is-active' : '' ?>" href="faq.php"<?= $activePage === 'faq' ? ' aria-current="page"' : '' ?>>
+                    <span class="view-tab-faq-mark" aria-hidden="true">?</span>
+                    FAQ
+                </a>
+            </div>
+        <?php endif; ?>
     </nav>