feat(heures) : export Contingent heures de nuit (liste employés) (#28)

## Résumé Nouvel export PDF **Contingent heures de nuit** dans le drawer Export de la liste employés. - PDF **A4 paysage** : lignes = employés (groupés par site, triés displayOrder/nom/prénom), colonnes = 12 mois civils, chaque mois avec 2 sous-colonnes **H.nuit** et **N.jours**. - Heures de nuit = minutes dans la fenêtre **21h→6h** via un service partagé `NightHoursCalculator` (mutualisé avec `WorkHourWeeklySummaryProvider` et `YearlyHoursExportBuilder` — duplication supprimée, sans changement de comportement). - **Conducteurs inclus** via `WorkHour.nightHoursMinutes`. Statut conducteur résolu par date. - **N.jours** = nb de jours où les minutes de nuit ≥ 240 (4h). Aucun crédit absence/férié. - Périmètre via `EmployeeRepository::findScoped` (admin → tous, chef de site → ses sites), endpoint `GET /night-hours-contingent/print?year=YYYY` (`ROLE_USER`). - Sélecteur d'année (année civile). Colonne Nom calibrée, séparateurs de mois épais. ## Composants - Service `NightHoursCalculator`, builder `NightContingentExportBuilder`, DTO `NightContingentRow` - Provider `NightHoursContingentPrintProvider` + opération API `NightHoursContingentPrint` - Gabarit `templates/night-hours-contingent/print.html.twig` - Option frontend dans `frontend/pages/employees/index.vue` - Docs : `doc/functional-rules.md`, `CLAUDE.md`, `frontend/data/documentation-content.ts` ## Tests - Nouveaux tests unitaires : `NightHoursCalculatorTest` (fenêtre 21h→6h, passage minuit, bornes), `NightContingentExportBuilderTest` (agrégation mensuelle, règle ≥4h=1j, conducteur, cas sans heures) - Suite complète : **208 tests OK** - Rendu PDF validé visuellement (Twig→Dompdf) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: #28 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
2026-06-11 13:02:30 +00:00
parent 49ad6306ea
commit b5bd4db5f1
20 changed files with 1974 additions and 140 deletions
@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html lang="fr">
+<head>
+    <meta charset="utf-8">
+    <style>
+        @page { margin: 16px; }
+        body { font-family: DejaVu Sans, sans-serif; font-size: 10px; color: #000; }
+        h1 { font-size: 15px; margin: 0 0 2px; }
+        .meta { font-size: 9px; color: #555; margin-bottom: 8px; }
+        table { width: 100%; border-collapse: collapse; }
+        th, td { border: 1px solid #999; padding: 2px 1px; text-align: center; }
+        th { background: #d9d9d9; }
+        td.name, th.name { text-align: left; width: 145px; padding-left: 4px; padding-right: 6px; }
+        .sub { font-size: 9px; }
+        td.data, th.data { width: 34px; font-size: 9px; }
+        tr.site-title td { text-align: left; font-weight: bold; }
+        td.hours { white-space: nowrap; }
+        td.month-start, th.month-start { border-left: 2.5px solid #333; }
+    </style>
+</head>
+<body>
+    <h1>Contingent heures de nuit — {{ year }}</h1>
+    <div class="meta">Édité le {{ exportedAt }}</div>
+
+    {% set months = ['Janv', 'Févr', 'Mars', 'Avr', 'Mai', 'Juin', 'Juil', 'Août', 'Sept', 'Oct', 'Nov', 'Déc'] %}
+
+    <table>
+        <thead>
+            <tr>
+                <th class="name" rowspan="2">Nom</th>
+                {% for m in months %}
+                    <th class="month-start" colspan="2">{{ m }}</th>
+                {% endfor %}
+            </tr>
+            <tr>
+                {% for m in months %}
+                    <th class="sub data month-start">H.nuit</th>
+                    <th class="sub data">N.jours</th>
+                {% endfor %}
+            </tr>
+        </thead>
+        <tbody>
+            {% for group in groups %}
+                <tr class="site-title">
+                    <td colspan="25" style="background: {{ group.siteColor|default('#eee') }}">{{ group.siteName }}</td>
+                </tr>
+                {% for row in group.rows %}
+                    <tr>
+                        <td class="name">{{ row.employeeName }}</td>
+                        {% for cell in row.cells %}
+                            <td class="hours data month-start">{{ cell.hours }}</td>
+                            <td class="data">{{ cell.days }}</td>
+                        {% endfor %}
+                    </tr>
+                {% endfor %}
+            {% endfor %}
+        </tbody>
+    </table>
+</body>
+</html>