feat(heures) : export PDF des heures (vue jour) par sites (#24)

## Résumé
Ajoute un bouton **Exporter** (admin uniquement) à droite du titre « Heures » qui génère un **PDF d'une journée**, regroupé par site, reprenant les colonnes de la vue Jour **sans la colonne « Valider »**.

- Drawer : champ date (préremplit la date affichée) + cases à cocher des sites (préselectionnées sur le filtre courant).
- Portée identique à l'écran : non-conducteurs, sous contrat à la date, sites cochés (lignes vides incluses).
- Jour/Nuit/Total incluent le crédit d'absence et le crédit virtuel férié.

## Implémentation
- Back : `WorkHourDayExport` (ApiResource) + `WorkHourDayExportProvider`, endpoint `GET /work-hours/day-export?workDate=&siteIds=` (ROLE_ADMIN).
- Calcul des cellules mutualisé via `YearlyHoursExportBuilder::buildDayRowsForEmployees` (source unique de vérité).
- Gabarit `templates/work-hour-day-export/print.html.twig` (A4 portrait compact).
- Front : `HoursDayExportDrawer.vue` + câblage dans `pages/hours.vue`.
- Docs : `doc/hours-day-export.md`, `documentation-content.ts`, `CLAUDE.md`.

## Tests
- Test unitaire `YearlyHoursDayRowsTest` ajouté.
- Suite complète verte : 173 tests, 359 assertions.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: #24
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

src/ApiResource/WorkHourDayExport.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\QueryParameter;
+use App\State\WorkHourDayExportProvider;
+
+#[ApiResource(
+    operations: [
+        new Get(
+            uriTemplate: '/work-hours/day-export',
+            provider: WorkHourDayExportProvider::class,
+            parameters: [
+                new QueryParameter(key: 'workDate', required: true),
+                new QueryParameter(key: 'siteIds', required: true),
+            ],
+            security: "is_granted('ROLE_ADMIN')"
+        ),
+    ]
+)]
+final class WorkHourDayExport {}

src/Service/WorkHours/YearlyHoursExportBuilder.php

@@ -11,8 +11,8 @@ use App\Entity\WorkHour;
 use App\Enum\ContractNature;
 use App\Enum\ContractType;
 use App\Enum\TrackingMode;
-use App\Repository\AbsenceRepository;
-use App\Repository\WorkHourRepository;
+use App\Repository\Contract\AbsenceReadRepositoryInterface;
+use App\Repository\Contract\WorkHourReadRepositoryInterface;
 use App\Service\Contracts\EmployeeContractResolver;
 use App\Service\PublicHolidayServiceInterface;
 use DateInterval;
@@ -22,8 +22,8 @@ use Throwable;
 class YearlyHoursExportBuilder
 {
     public function __construct(
-        private WorkHourRepository $workHourRepository,
-        private AbsenceRepository $absenceRepository,
+        private WorkHourReadRepositoryInterface $workHourRepository,
+        private AbsenceReadRepositoryInterface $absenceRepository,
         private EmployeeContractResolver $contractResolver,
         private AbsenceSegmentsResolver $absenceSegmentsResolver,
         private WorkedHoursCreditPolicy $workedHoursCreditPolicy,
@@ -103,6 +103,133 @@ class YearlyHoursExportBuilder
         return $this->buildForEmployees([$employee], $from, $to);
     }
 
+    /**
+     * Construit une ligne par employé pour une seule journée (vue Jour de l'écran Heures).
+     * Réutilise les helpers de calcul de cellule pour rester l'unique source de vérité.
+     * Les employés sans contrat ce jour sont exclus (comme l'écran).
+     *
+     * @param list<Employee> $employees
+     *
+     * @return list<array{employeeId:int, employeeName:string, statut:?string, statutColor:?string,
+     *   morningFrom:string, morningTo:string, afternoonFrom:string, afternoonTo:string,
+     *   eveningFrom:string, eveningTo:string, dayHours:string, nightHours:string,
+     *   total:string, isWeekend:bool, isHoliday:bool}>
+     */
+    public function buildDayRowsForEmployees(array $employees, DateTimeImmutable $date): array
+    {
+        $ymd  = $date->format('Y-m-d');
+        $days = [$ymd];
+
+        $workHours   = $this->workHourRepository->findByDateRangeAndEmployees($date, $date, $employees);
+        $absences    = $this->absenceRepository->findForPrint($date, $date, $employees);
+        $contractMap = $this->contractResolver->resolveForEmployeesAndDays($employees, $days);
+        $driverMap   = $this->contractResolver->resolveIsDriverForEmployeesAndDays($employees, $days);
+        $workDaysMap = $this->contractResolver->resolveWorkDaysMinutesForEmployeesAndDays($employees, $days);
+        $holidayMap  = $this->buildHolidayMap($date, $date);
+
+        $workHourMap = $this->buildWorkHourMap($workHours);
+        $absenceMap  = $this->buildAbsenceMap($absences, $days);
+
+        $isoDay       = (int) $date->format('N');
+        $isWeekend    = $isoDay >= 6;
+        $holidayLabel = $holidayMap[$ymd] ?? null;
+
+        $rows = [];
+        foreach ($employees as $employee) {
+            $employeeId = $employee->getId();
+            $contract   = $contractMap[$employeeId][$ymd] ?? null;
+
+            // Hors contrat ce jour → exclu (avant embauche / après départ / suspension).
+            if (null === $contract) {
+                continue;
+            }
+
+            $wh          = $workHourMap[$employeeId][$ymd] ?? null;
+            $absenceData = $this->resolveAbsenceDataForEmployee($absenceMap[$employeeId] ?? [], $days, $employee);
+            $hasAbsence  = $absenceData['hasDayAbsence'][$ymd] ?? false;
+
+            $isDriver        = $driverMap[$employeeId][$ymd] ?? false;
+            $mode            = $this->resolveSegmentMode($contract->getTrackingMode(), $isDriver);
+            $creditedMinutes = $absenceData['credited'][$ymd] ?? 0;
+            $virtualMinutes  = $this->holidayVirtualHoursResolver->resolveVirtualCredit(
+                $contract,
+                $date,
+                $hasAbsence,
+                $workDaysMap[$employeeId][$ymd] ?? null,
+            );
+
+            $statut      = $absenceData['labels'][$ymd] ?? null;
+            $statutColor = ($absenceData['colors'][$ymd] ?? '') ?: null;
+            if (null === $statut && null !== $holidayLabel) {
+                // Férié sans absence : badge bleu clair, comme la vue Jour.
+                $statut      = $holidayLabel;
+                $statutColor = '#b3e5fc';
+            }
+
+            $row = [
+                'employeeId'    => $employeeId,
+                'employeeName'  => trim(($employee->getLastName() ?? '').' '.($employee->getFirstName() ?? '')),
+                'statut'        => $statut,
+                'statutColor'   => $statutColor,
+                'morningFrom'   => '',
+                'morningTo'     => '',
+                'afternoonFrom' => '',
+                'afternoonTo'   => '',
+                'eveningFrom'   => '',
+                'eveningTo'     => '',
+                'dayHours'      => '',
+                'nightHours'    => '',
+                'total'         => '',
+                'isWeekend'     => $isWeekend,
+                'isHoliday'     => null !== $holidayLabel,
+            ];
+
+            if ('presence' === $mode) {
+                $absentMorning   = $absenceData['absentMorning'][$ymd] ?? false;
+                $absentAfternoon = $absenceData['absentAfternoon'][$ymd] ?? false;
+                $morning         = (($wh?->getIsPresentMorning() ?? false) && !$absentMorning) ? 0.5 : 0.0;
+                $afternoon       = (($wh?->getIsPresentAfternoon() ?? false) && !$absentAfternoon) ? 0.5 : 0.0;
+                $total           = $morning + $afternoon;
+                $row['total']    = $total > 0 ? (string) $total : '';
+            } elseif ('driver' === $mode) {
+                $dayMin   = $wh?->getDayHoursMinutes() ?? 0;
+                $nightMin = $wh?->getNightHoursMinutes() ?? 0;
+                $workshop = $wh?->getWorkshopHoursMinutes() ?? 0;
+                $totalMin = $dayMin + $nightMin + $workshop + $creditedMinutes;
+                if ($virtualMinutes > $totalMin) {
+                    $totalMin = $virtualMinutes;
+                }
+                $row['dayHours']   = $dayMin > 0 ? $this->formatMinutes($dayMin) : '';
+                $row['nightHours'] = $nightMin > 0 ? $this->formatMinutes($nightMin) : '';
+                $row['total']      = $totalMin > 0 ? $this->formatMinutes($totalMin) : '';
+            } else {
+                $metrics = null !== $wh ? $this->computeMetrics($wh) : new WorkMetrics();
+                $metrics->addCreditedMinutes($creditedMinutes);
+                $dayMin   = $metrics->dayMinutes;
+                $nightMin = $metrics->nightMinutes;
+                $totalMin = $metrics->totalMinutes;
+                if ($virtualMinutes > $totalMin) {
+                    $dayMin += $virtualMinutes - $totalMin;
+                    $totalMin = $virtualMinutes;
+                }
+
+                $row['morningFrom']   = $wh?->getMorningFrom() ?? '';
+                $row['morningTo']     = $wh?->getMorningTo() ?? '';
+                $row['afternoonFrom'] = $wh?->getAfternoonFrom() ?? '';
+                $row['afternoonTo']   = $wh?->getAfternoonTo() ?? '';
+                $row['eveningFrom']   = $wh?->getEveningFrom() ?? '';
+                $row['eveningTo']     = $wh?->getEveningTo() ?? '';
+                $row['dayHours']      = $dayMin > 0 ? $this->formatMinutes($dayMin) : '';
+                $row['nightHours']    = $nightMin > 0 ? $this->formatMinutes($nightMin) : '';
+                $row['total']         = $totalMin > 0 ? $this->formatMinutes($totalMin) : '';
+            }
+
+            $rows[] = $row;
+        }
+
+        return $rows;
+    }
+
     public function buildContractLabel(Employee $employee): ?string
     {
         $contract = $employee->getContract();
@@ -169,12 +296,13 @@ class YearlyHoursExportBuilder
     }
 
     /**
-     * @return array{credited: array<string, int>, labels: array<string, string>, absentMorning: array<string, bool>, absentAfternoon: array<string, bool>, hasDayAbsence: array<string, bool>}
+     * @return array{credited: array<string, int>, labels: array<string, string>, colors: array<string, string>, absentMorning: array<string, bool>, absentAfternoon: array<string, bool>, hasDayAbsence: array<string, bool>}
      */
     private function resolveAbsenceDataForEmployee(array $absences, array $days, Employee $employee): array
     {
         $credited        = [];
         $labels          = [];
+        $colors          = [];
         $absentMorning   = [];
         $absentAfternoon = [];
         $hasDayAbsence   = [];
@@ -195,6 +323,7 @@ class YearlyHoursExportBuilder
                     $absentAfternoon[$date] = ($absentAfternoon[$date] ?? false) || $isAfternoon;
                     if (!isset($labels[$date])) {
                         $labels[$date] = $absence->getType()?->getLabel() ?? '';
+                        $colors[$date] = $absence->getType()?->getColor() ?? '';
                     }
                 }
 
@@ -206,6 +335,7 @@ class YearlyHoursExportBuilder
         return [
             'credited'        => $credited,
             'labels'          => $labels,
+            'colors'          => $colors,
             'absentMorning'   => $absentMorning,
             'absentAfternoon' => $absentAfternoon,
             'hasDayAbsence'   => $hasDayAbsence,

src/State/WorkHourDayExportProvider.php

@@ -0,0 +1,110 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\State;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\Repository\EmployeeRepository;
+use App\Service\WorkHours\YearlyHoursExportBuilder;
+use DateTimeImmutable;
+use Dompdf\Dompdf;
+use Dompdf\Options;
+use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpKernel\Exception\UnprocessableEntityHttpException;
+use Twig\Environment;
+
+class WorkHourDayExportProvider implements ProviderInterface
+{
+    public function __construct(
+        private Environment $twig,
+        private readonly RequestStack $requestStack,
+        private EmployeeRepository $employeeRepository,
+        private YearlyHoursExportBuilder $exportBuilder,
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): Response
+    {
+        $request = $this->requestStack->getCurrentRequest();
+        if (!$request) {
+            return new Response('Missing request.', Response::HTTP_BAD_REQUEST);
+        }
+
+        $workDateRaw = (string) $request->query->get('workDate');
+        if (!preg_match('/^\d{4}-\d{2}-\d{2}$/', $workDateRaw)) {
+            throw new UnprocessableEntityHttpException('workDate must use YYYY-MM-DD format.');
+        }
+        $date = new DateTimeImmutable($workDateRaw);
+
+        $siteIdsRaw = (string) $request->query->get('siteIds', '');
+        $siteIds    = array_values(array_filter(array_map(
+            static fn (string $value): int => (int) trim($value),
+            explode(',', $siteIdsRaw),
+        ), static fn (int $id): bool => $id > 0));
+        if ([] === $siteIds) {
+            throw new UnprocessableEntityHttpException('siteIds is required.');
+        }
+
+        // Feature réservée admin : on charge tous les employés puis on filtre.
+        $employees = $this->employeeRepository->findAll();
+
+        // Regroupement par site (ordre displayOrder), non-conducteurs uniquement.
+        $bySite   = [];
+        $siteMeta = [];
+        foreach ($employees as $employee) {
+            if (true === $employee->getIsDriver()) {
+                continue;
+            }
+            $site = $employee->getSite();
+            if (null === $site || !in_array($site->getId(), $siteIds, true)) {
+                continue;
+            }
+            $siteId            = $site->getId();
+            $bySite[$siteId][] = $employee;
+            $siteMeta[$siteId] ??= [
+                'name'  => $site->getName(),
+                'order' => $site->getDisplayOrder(),
+                'color' => $site->getColor(),
+            ];
+        }
+
+        uasort($siteMeta, static function (array $a, array $b): int {
+            return [$a['order'], $a['name']] <=> [$b['order'], $b['name']];
+        });
+
+        $groups = [];
+        foreach ($siteMeta as $siteId => $meta) {
+            $siteEmployees = $bySite[$siteId];
+            usort($siteEmployees, static fn ($a, $b) => ($a->getLastName() ?? '') <=> ($b->getLastName() ?? ''));
+
+            $rows = $this->exportBuilder->buildDayRowsForEmployees($siteEmployees, $date);
+            if ([] === $rows) {
+                continue;
+            }
+            $groups[] = ['siteName' => $meta['name'], 'siteColor' => $meta['color'], 'rows' => $rows];
+        }
+
+        $options = new Options();
+        $options->set('isRemoteEnabled', true);
+        $dompdf = new Dompdf($options);
+
+        $html = $this->twig->render('work-hour-day-export/print.html.twig', [
+            'groups'     => $groups,
+            'dateLabel'  => $date->format('d/m/Y'),
+            'exportedAt' => new DateTimeImmutable('now')->format('d/m/Y H:i'),
+        ]);
+
+        $dompdf->loadHtml($html);
+        $dompdf->setPaper('A4', 'portrait');
+        $dompdf->render();
+
+        $filename = sprintf('heures_jour_%s.pdf', $date->format('Y-m-d'));
+
+        return new Response($dompdf->output(), Response::HTTP_OK, [
+            'Content-Type'        => 'application/pdf',
+            'Content-Disposition' => sprintf('attachment; filename="%s"', $filename),
+        ]);
+    }
+}