Motif de travail par défaut à la saisie et heures travaillées complètes dans les PDF

La liste des motifs d'une nouvelle plage s'ouvrait sur un placeholder vide « Choisir un motif », alors que le temps de travail est le cas très majoritaire : elle propose désormais « Heure de travail » (code TRAVAIL), avec repli sur le premier motif décomptant le quota si le référentiel ne contient pas ce code. Côté PDF, seul le code générique TRAVAIL était traité comme du temps travaillé. Les motifs ALP matin, ALP soir, restauration, mercredi périscolaire, extrascolaire, préparations et ménage de fond tombaient donc : - dans un total invisible du bilan annuel (ligne « Heures travaillées » à 0 h 00 alors que les heures étaient bien décomptées plus bas) ; - dans la couleur grise « Autre absence » des plannings agent et lieu. La classification est centralisée dans App\Core\MotifCategories, réutilisée par PtaModel (qui portait déjà la même liste) et par les deux services PDF. Un motif inconnu du référentiel est rattaché au temps de travail dès lors qu'il décompte le quota, pour qu'aucun total ne puisse disparaître d'un document. La ligne « Heures travaillées » détaille en outre les motifs regroupés, et le total décompté suit maintenant le drapeau compte_dans_quota comme QuotaModel : il additionnait auparavant les congés, hors quota, en contradiction avec sa propre note de bas de tableau. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 14:45:52 +02:00
parent 13ee16e25d
commit b13b52b22b
8 changed files with 235 additions and 53 deletions
--- a/app/Core/MotifCategories.php
+++ b/app/Core/MotifCategories.php
@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Core;
+
+/**
+ * Classement métier des motifs de planning, partagé par les modèles et les PDF.
+ *
+ * Le référentiel `motif_planning` distingue le temps de travail effectif (ALP matin,
+ * restauration, ALP soir, mercredi périscolaire, extrascolaire, préparations, ménage de fond…)
+ * du temps décompté mais non travaillé (formation, absence) et du temps hors quota
+ * (congé, autre absence, JNT). Tous ces motifs de travail doivent être présentés
+ * comme des heures travaillées, et pas seulement le motif générique `TRAVAIL`.
+ */
+final class MotifCategories
+{
+    public const TRAVAIL = 'TRAVAIL';
+    public const FORMATION = 'FORMATION';
+    public const CONGE = 'CONGE';
+    public const ABSENCE = 'ABSENCE';
+    public const NON_DECOMPTE = 'NON_DECOMPTE';
+
+    /** Motifs comptant comme du temps de travail effectif. */
+    public const WORK_CODES = [
+        'TRAVAIL',
+        'ALP_MATIN',
+        'RESTAURATION',
+        'ALP_SOIR',
+        'MERCREDI_PERISCOLAIRE',
+        'EXTRASCOLAIRE',
+        'PREPARATION_PERISCOLAIRE',
+        'PREPARATION_EXTRASCOLAIRE',
+        'PREPARATION_LUNDI',
+        'MENAGE_FOND',
+        'JOUR_FRACTIONNEMENT',
+    ];
+
+    /** Motifs décomptés du quota sans être du temps de travail effectif. */
+    private const FORMATION_CODES = ['FORMATION'];
+    private const ABSENCE_CODES = ['ABSENCE', 'MALADIE'];
+    private const CONGE_CODES = ['CONGE'];
+    private const NON_DECOMPTE_CODES = ['AUTRE_ABSENCE', 'JNT'];
+
+    public static function normalizeCode(?string $code): string
+    {
+        return strtoupper(trim((string) $code));
+    }
+
+    /**
+     * Un motif inconnu du référentiel est rattaché au temps de travail dès lors qu'il
+     * décompte le quota : c'est le comportement le moins surprenant pour un motif ajouté
+     * en base après coup, et il évite qu'un total disparaisse des documents.
+     */
+    public static function isWork(?string $code, bool $countsInQuota = false): bool
+    {
+        return self::category($code, $countsInQuota) === self::TRAVAIL;
+    }
+
+    /**
+     * @return self::TRAVAIL|self::FORMATION|self::CONGE|self::ABSENCE|self::NON_DECOMPTE
+     */
+    public static function category(?string $code, bool $countsInQuota = false): string
+    {
+        $normalized = self::normalizeCode($code);
+
+        if (in_array($normalized, self::WORK_CODES, true)) {
+            return self::TRAVAIL;
+        }
+        if (in_array($normalized, self::FORMATION_CODES, true)) {
+            return self::FORMATION;
+        }
+        if (in_array($normalized, self::ABSENCE_CODES, true)) {
+            return self::ABSENCE;
+        }
+        if (in_array($normalized, self::CONGE_CODES, true)) {
+            return self::CONGE;
+        }
+        if (in_array($normalized, self::NON_DECOMPTE_CODES, true)) {
+            return self::NON_DECOMPTE;
+        }
+
+        return $countsInQuota ? self::TRAVAIL : self::NON_DECOMPTE;
+    }
+}