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/Models/PtaModel.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Models;
 
+use App\Core\MotifCategories;
 use DateInterval;
 use DatePeriod;
 use DateTimeImmutable;
@@ -12,12 +13,8 @@ use RuntimeException;
 
 final class PtaModel extends BaseModel
 {
-    private const WORK_CODES = [
-        'TRAVAIL', 'ALP_MATIN', 'RESTAURATION', 'ALP_SOIR',
-        'MERCREDI_PERISCOLAIRE', 'EXTRASCOLAIRE',
-        'PREPARATION_PERISCOLAIRE', 'PREPARATION_EXTRASCOLAIRE',
-        'PREPARATION_LUNDI', 'MENAGE_FOND', 'JOUR_FRACTIONNEMENT',
-    ];
+    /** Référentiel partagé avec les PDF : voir App\Core\MotifCategories. */
+    private const WORK_CODES = MotifCategories::WORK_CODES;
 
     private const PREPARATION_CODES = [
         'PREPARATION_PERISCOLAIRE', 'PREPARATION_EXTRASCOLAIRE', 'PREPARATION_LUNDI',
@@ -148,7 +145,7 @@ final class PtaModel extends BaseModel
             return $pta;
         }
 
-        $training = !empty($agent['formation_repartition_annuelle']) ? 0 : 840;
+        $training = AgentModel::trainingEnvelopeMinutes($agent);
         $insert = $this->pdo->prepare(
             "INSERT INTO pta_annuel (
                 id_agent, date_debut, date_fin, quotite_travail,
@@ -381,7 +378,13 @@ final class PtaModel extends BaseModel
         }
 
         $formationMinutes = $categories['FORMATION'];
-        $formationTarget = !empty($agent['formation_repartition_annuelle']) ? 0 : 840;
+        $formationTarget = AgentModel::trainingEnvelopeMinutes($agent);
+        if (!AgentModel::hasTrainingRight($agent) && $formationMinutes > 0) {
+            $controls[] = $this->control('ALERTE', 'FORMATION_SANS_DROIT', sprintf(
+                'Formation : %s planifiées alors que l’agent n’a pas droit à l’enveloppe de formation. Ces plages sont à retirer.',
+                $this->formatMinutes($formationMinutes)
+            ));
+        }
         if ($formationTarget > 0 && $formationMinutes > $formationTarget) {
             $controls[] = $this->control('ALERTE', 'FORMATION_DEPASSEE', sprintf(
                 'Formation : %s planifiées pour une enveloppe complémentaire de 14 h.',