chore: bump version to v0.1.87

When a week spans two months and has zero worked hours (e.g. RTT
all week), the proportional split by worked minutes gave 0 to both
months. Now falls back to splitting by weekday count.

.claude/settings.local.json

@@ -24,7 +24,10 @@
       "Bash(npx xlsx-cli:*)",
       "Bash(cat /home/m-tristan/.claude/projects/-home-m-tristan-workspace-SIRH/4b53d9d7-d8ae-451f-a5cc-5d4fd55f2eef/tool-results/toolu_019hng9Cu2m9wiNACuC2Wm3F.json | python3 -c \"import json,sys; data=json.load\\(sys.stdin\\); print\\(data[0]['text']\\)\" 2>/dev/null | head -2000)",
       "Bash(pip3 install:*)",
-      "Bash(find:*)"
+      "Bash(find:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(python3:*)"
     ]
   }
 }

.dockerignore

@@ -0,0 +1,23 @@
+.git
+.gitea
+.env.local
+.env.test
+docker/
+deploy/docker/docker-compose.prod.yml
+deploy/docker/deploy.sh
+deploy/docker/.env.example
+frontend/node_modules
+frontend/.nuxt
+frontend/.output
+var/
+LOG/
+docs/
+doc/
+tests/
+*.sql
+*.xlsx
+*.png
+*.md
+!composer.lock
+!symfony.lock
+!frontend/package-lock.json

.env

@@ -38,6 +38,9 @@ DATABASE_URL="postgresql://app:!ChangeMe!@127.0.0.1:5432/app?serverVersion=16&ch
 
 ###> app ###
 RTT_START_DATE=2026-02-23
+# Comma-separated list of public holiday labels to exclude from the government API response
+# (typically the "journée de solidarité" worked in many companies)
+EXCLUDED_PUBLIC_HOLIDAYS="Lundi de Pentecôte"
 ###< app ###
 
 ###> nelmio/cors-bundle ###

.gitea/workflows/build-docker.yml

@@ -0,0 +1,30 @@
+name: Build & Push Docker Image
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Login to Gitea Registry
+        run: |
+          echo "${{ secrets.REGISTRY_TOKEN }}" | docker login gitea.malio.fr -u "${{ gitea.repository_owner }}" --password-stdin
+
+      - name: Build Docker image
+        run: |
+          docker build \
+            -f deploy/docker/Dockerfile.prod \
+            -t gitea.malio.fr/malio-dev/sirh:${{ github.ref_name }} \
+            -t gitea.malio.fr/malio-dev/sirh:latest \
+            .
+
+      - name: Push Docker image
+        run: |
+          docker push gitea.malio.fr/malio-dev/sirh:${{ github.ref_name }}
+          docker push gitea.malio.fr/malio-dev/sirh:latest

.gitea/workflows/release-artefact.yml

@@ -1,65 +0,0 @@
-name: Build Release Artefact
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-
-      - name: Setup PHP
-        uses: shivammathur/setup-php@v2
-        with:
-          php-version: "8.4"
-          extensions: mbstring, intl, pdo_pgsql, xml, curl, zip, gd
-
-      - name: Setup Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: "lts/*"
-
-      - name: Install backend deps (prod)
-        env:
-          APP_ENV: prod
-          APP_DEBUG: "0"
-        run: composer install --no-dev --optimize-autoloader --no-interaction --no-scripts
-
-      - name: Build frontend (static)
-        run: |
-          cd frontend
-          npm ci
-          CI=1 NUXT_TELEMETRY_DISABLED=1 NUXT_PUBLIC_API_BASE=/api NUXT_PUBLIC_APP_BASE=/ npm run generate
-          test -f .output/public/index.html
-
-      - name: Build artefact
-        shell: bash
-        run: |
-          set -euo pipefail
-          mkdir -p release
-          tar -czf "release/sirh-${GITHUB_REF_NAME}.tar.gz" \
-            bin \
-            config \
-            migrations \
-            public \
-            src \
-            templates \
-            vendor \
-            composer.json \
-            composer.lock \
-            symfony.lock \
-            frontend/.output
-
-      - name: Create Release
-        uses: softprops/action-gh-release@v2
-        with:
-          files: release/sirh-${{ github.ref_name }}.tar.gz
-        env:
-          GITHUB_TOKEN: ${{ secrets.RELEASE_TOKEN }}

.idea/data_source_mapping.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="DataSourcePerFileMappings">
-    <file url="file://$APPLICATION_CONFIG_DIR$/consoles/db/9cad43df-2147-4989-b7a4-443067034884/console_3.sql" value="9cad43df-2147-4989-b7a4-443067034884" />
-  </component>
-</project>

.idea/db-forest-config.xml

@@ -1,5 +1,15 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
+  <component name="db-forest-configuration">
+    <data version="2">.
+	----------------------------------------
+	1:0:9cad43df-2147-4989-b7a4-443067034884
+	2:0:ae622167-c834-4e7b-87a5-c1721036f5dc
+	3:0:f407a514-c6b4-4b26-9555-445a85892502
+	4:0:09e221b8-067a-488b-9c1d-4e155a333079
+	5:0:9d8c1ad3-2491-4642-964a-666003c14128
+		.</data>
+  </component>
   <component name="db-tree-configuration">
     <option name="data" value="----------------------------------------&#10;1:0:9cad43df-2147-4989-b7a4-443067034884&#10;2:0:ae622167-c834-4e7b-87a5-c1721036f5dc&#10;3:0:f407a514-c6b4-4b26-9555-445a85892502&#10;4:0:09e221b8-067a-488b-9c1d-4e155a333079&#10;" />
   </component>

.idea/sqldialects.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="SqlDialectMappings">
-    <file url="file://$PROJECT_DIR$/sirh.sql" dialect="GenericSQL" />
-  </component>
-</project>

CLAUDE.md

@@ -2,6 +2,7 @@
 
 ## Mandatory Rules
 - Any functional change MUST update `doc/` in the same intervention
+- Any functional change MUST update the in-app documentation (`frontend/data/documentation-content.ts`) in the same intervention
 - At the end of every feature addition or functional modification, update this CLAUDE.md to reflect new patterns, rules, or conventions introduced
 
 ## Commands
@@ -30,10 +31,19 @@
 - Contract types: FORFAIT, THIRTY_FIVE_HOURS, THIRTY_NINE_HOURS, INTERIM, CUSTOM
 - Contract nature (per period): CDI, CDD, INTERIM
 - Employee contract history: `employee_contract_periods`, resolved by `EmployeeContractResolver`
+- **Planning jours travaillés** (`EmployeeContractPeriod.workDaysHours` : JSON `{iso_day: minutes}`) : obligatoire pour tout contrat TIME **hors 35h/39h/INTERIM** (ex. 4h, 25h, 28h). Somme = `weeklyHours × 60`. Utilisé par `HolidayVirtualHoursResolver` (crédit férié) et `WorkedHoursCreditPolicy` (crédit absence) pour ne créditer que les jours effectivement travaillés. Validation : `EmployeeContractPeriodValidator::assertWorkDaysHours`.
 - Absences: stored per day (auto-split), AM/PM/full day, clear corresponding hour slots
 - Absences with `countAsWorkedHours=true`: credit minutes (TIME) or nothing (PRESENCE)
 - Driver periods (`isDriver=true` on `EmployeeContractPeriod`): separate screen `/driver-hours`, uses `dayHoursMinutes`/`nightHoursMinutes` + meal/overnight flags on `WorkHour`
 
+## Fériés
+- Source : API gouv via `PublicHolidayService` (cache 30j)
+- Exclusions : env `EXCLUDED_PUBLIC_HOLIDAYS` (CSV de libellés), défaut `"Lundi de Pentecôte"`. Le filtre s'applique après le cache, côté service, donc frontend et calculs backend voient la même liste.
+- Écrans Heures / Heures Conducteurs (vue jour) : le nom du férié est affiché en badge `#b3e5fc` avec icône `mdi:calendar-star` dans la colonne Absence (distinct du pill absence). Bouton "Modifier" absence masqué sur férié (comme pour les formations).
+- Création/édition d'absence **autorisée** sur un férié (bouton Modifier visible). En présence d'absence, le crédit d'heures suit `absence.type.countAsWorkedHours` (WorkedHoursCreditPolicy), pas le crédit virtuel férié.
+- Saisie d'heures (ou de jours de présence) autorisée sur un férié
+- **Crédit automatique des heures contractuelles** sur un férié Lun-Ven pour tout contrat hors Forfait, **uniquement en l'absence d'absence déclarée** : le total journalier = `max(saisie + credited_absence, référence_contractuelle)`. Référence : 35h→7h, 39h→8h Lun-Jeu/7h Ven, CUSTOM→weeklyHours/5, INTERIM→idem 35h/39h/custom selon weeklyHours. Aucune ligne BDD créée (crédit virtuel). Drivers : crédité en `dayHoursMinutes`. Impacte directement le total hebdo RTT (tranches 25%/50%). Dès qu'une absence est posée sur le férié, le crédit virtuel saute — c'est le `countAsWorkedHours` du type d'absence qui pilote. Services : `App\Service\WorkHours\HolidayVirtualHoursResolver` + `DailyReferenceMinutesResolver`. Doc complète : `doc/holiday-virtual-hours.md`.
+
 ## Validation Rules
 - `isValid` (RH): locks line for everyone (admin can only untoggle validation)
 - `isSiteValid` (site manager): locks for non-admin, admin can still edit
@@ -43,14 +53,38 @@
 ## Overtime Rules
 - Contracts <= 35h: +25% from 35h to 43h, +50% beyond
 - Contracts >= 39h: +25% from 39h to 43h, +50% beyond
+- CUSTOM contracts (weeklyHours ≠ 35 and ≠ 39, not INTERIM/FORFAIT): reference = actual contractual hours, no 25%/50% bonuses (1h overtime = 1h recovery), deficit doesn't impact balance
 - INTERIM: no overtime bonuses, no recovery time
-- Driver contracts: no overtime calculation
+- Driver contracts: RTT uses `dayHoursMinutes + nightHoursMinutes + workshopHoursMinutes` instead of morning/afternoon/evening time ranges
+- FORFAIT weekend/holiday bonus: each weekend or public holiday day worked gives bonus leave (full day if morning+afternoon, 0.5 if only one). Added to acquired days, no cap. PRESENCE mode only.
+
+## Récap. congés (écran)
+- Accès via sidebar `Récap. congés`, conditionné au flag `User.hasLeaveRecapAccess` (défaut `false`) — activé au create/edit user. Le flag s'applique à tous les profils, y compris admin.
+- Scope : `ROLE_ADMIN` → tous les employés, `ROLE_USER` (chef de site) → employés de ses sites, `ROLE_SELF` → sa ligne
+- Cutoff temporel : fin de la semaine S-2 (dimanche 23:59:59). Formule : `dimanche(lundi_semaine_courante − 14j)`. Pas de gate `isValid`.
+- Helper : `App\Util\LeaveRecapCutoff::resolveCutoff()`
+- Colonnes : Nom, Prénom, Contrat, CP N-1 restant, CP N, Samedis, RTT — identiques au PDF
+- Service partagé : `LeaveRecapRowBuilder` consommé par `LeaveRecapPrintProvider` (as-of today) et `EmployeeLeaveRecapProvider` (as-of cutoff)
+- `EmployeeLeaveSummaryProvider::computeYearSummary()` accepte un `?DateTimeImmutable $asOfDate` qui cappe l'accrual et les absences sur l'année cible (`null` = comportement live inchangé)
+- Pas d'export PDF depuis cet écran
+- Doc détaillée : `doc/leave-recap-screen.md`
 
 ## Frais (MileageAllowance)
 - Onglet "Frais" (anciennement "Frais Kms") sur la fiche employé
 - Validation: mois obligatoire + au moins `kilometers > 0` ou `amount > 0`
 - Les deux champs km et montant sont optionnels individuellement mais au moins un requis
 
+## Formations
+- Onglet "Formation" sur la fiche employé (admin uniquement)
+- Champs : date début, date fin, justificatif PDF optionnel, commentaire
+- Validation: dates obligatoires, `endDate >= startDate`, fichier PDF uniquement
+- Justificatif stocké dans `var/uploads/formations/{année}/{mois}/{uuid}.pdf` (année/mois = startDate)
+- Suppression et remplacement du justificatif nettoient l'ancien fichier disque
+- Tri tableau par `startDate DESC`
+- Affichage écran Heures (jour) : pill "Formation" (indigo) dans la colonne Absence. Quand une formation existe, le bouton "Modifier" de la colonne Absence est masqué (lockdown complet du jour pour la gestion d'absence)
+- Affichage Calendrier : cellule "F" (indigo) si formation seule, ou icône école en coin si formation + absence. Cellules avec formation non cliquables. Légende dédiée. PDF export : code "F" indigo ou astérisque à côté du code d'absence
+- Le CRUD formation est exclusivement géré depuis la fiche employé > onglet Formation
+
 ## Frontend Patterns
 
 ### Table styling (standard across all pages)
@@ -70,12 +104,28 @@
 - File uploads: `deserialize: false` on Post, access file via RequestStack
 - Upload dir: `%kernel.project_dir%/var/uploads`
 
+## Audit Logging
+- All processors that modify entities impacting calculations (heures, absences, contrats, RTT) MUST inject `AuditLogger` and log create/update/delete actions
+- `AuditLogger::log()` persists without flushing — the processor's `flush()` handles both the data change and the audit entry atomically
+- Audit logs are accessible only via `ROLE_SUPER_ADMIN` (hidden role, added manually in DB)
+- Documentation: `doc/audit-logging.md`
+
 ## Backend Conventions
 - Prefer explicit DTOs over associative arrays
 - Business rules in backend (providers/processors/services), frontend is display/interaction only
 - Keep backend PHP DTOs aligned with frontend TS DTOs (`frontend/services/dto/*`)
 - Update unit tests when constructor/service signatures change
 
+## In-App Documentation
+- Content: `frontend/data/documentation-content.ts` — structured TypeScript data with all user-facing documentation
+- Types: `frontend/types/documentation.ts` — DocSection, DocArticle, DocBlock
+- Composable: `frontend/composables/useDocumentation.ts` — role-based filtering (employee < site_manager < admin)
+- Components: `frontend/components/documentation/` — DocumentationPage, DocumentationSection, DocumentationArticle
+- Page: `frontend/pages/documentation.vue`
+- 3 access levels: `employee` (ROLE_SELF), `site_manager` (ROLE_USER), `admin` (ROLE_ADMIN) — cumulative (admin sees everything)
+- Each section/article has a `requiredLevel` that controls visibility
+- When adding or modifying a feature, update the corresponding section in `documentation-content.ts`
+
 ## Language
 - UI is in French
 - User communicates in French

README.md

@@ -1,4 +1,5 @@
 # SIRH
+
 Application de gestion des absences employée
 
 ## Importer un dump de prod en dev
@@ -17,3 +18,10 @@ Remplie la base avec le dump :
 ```shell
 docker compose exec -T db psql -U root -d sirh < sirh.sql
 ```
+
+## Mettre SUPER_ADMIN sur un user
+```sql
+UPDATE users SET roles = '["ROLE_ADMIN","ROLE_SUPER_ADMIN"]' WHERE username = 'emilie';
+```
+sudo -u postgres pg_dump --no-owner --no-privileges --clean --if-exists sirh_prod > /tmp/sirh_prod_$(date +%F).sql
+scp user@<serveur>:/tmp/sirh_prod_2026-04-14.dump ~/workspace/

config/packages/security.yaml

@@ -19,6 +19,7 @@ security:
             pattern: ^/login_check
             stateless: true
             provider: app_user_provider
+            user_checker: App\Security\UserChecker
             json_login:
                 check_path: /login_check
                 username_path: username
@@ -29,6 +30,7 @@ security:
             pattern: ^/api
             stateless: true
             provider: app_user_provider
+            user_checker: App\Security\UserChecker
             jwt: ~
             logout:
                 path: /api/logout

config/services.yaml

@@ -25,6 +25,7 @@ services:
     App\Service\PublicHolidayService:
         arguments:
             $holidayUrl: '%env(HOLIDAY_URL)%'
+            $excludedLabels: '%env(default::EXCLUDED_PUBLIC_HOLIDAYS)%'
 
     App\Service\Rtt\RttRecoveryComputationService:
         arguments:
@@ -37,6 +38,7 @@ services:
     App\Repository\Contract\AbsenceReadRepositoryInterface: '@App\Repository\AbsenceRepository'
     App\Repository\Contract\EmployeeContractPeriodReadRepositoryInterface: '@App\Repository\EmployeeContractPeriodRepository'
     App\Repository\Contract\EmployeeScopedRepositoryInterface: '@App\Repository\EmployeeRepository'
+    App\Repository\Contract\FormationReadRepositoryInterface: '@App\Repository\FormationRepository'
     App\Repository\Contract\WorkHourReadRepositoryInterface: '@App\Repository\WorkHourRepository'
     App\Service\Contracts\EmployeeContractPeriodManagerInterface: '@App\Service\Contracts\EmployeeContractPeriodManager'
 

config/version.yaml

@@ -1,2 +1,2 @@
 parameters:
-    app.version: '0.1.56'
+    app.version: '0.1.87'

deploy/docker/.env.example

@@ -0,0 +1,26 @@
+# Symfony
+APP_ENV=prod
+APP_DEBUG=0
+APP_SECRET=change-me
+
+# Database (use host.docker.internal to reach bare-metal PostgreSQL)
+DATABASE_URL="postgresql://sirh_user:password@host.docker.internal:5432/sirh?serverVersion=16&charset=utf8"
+
+# JWT
+JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
+JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
+JWT_PASSPHRASE=change-me
+JWT_COOKIE_SECURE=1
+JWT_COOKIE_SAMESITE=lax
+JWT_TOKEN_TTL=86400
+JWT_COOKIE_TTL=86400
+
+# CORS
+CORS_ALLOW_ORIGIN='^https?://sirh\.malio-dev\.fr$'
+
+# App
+DEFAULT_URI=https://sirh.malio-dev.fr
+APP_SHARE_DIR=var/share
+RTT_START_DATE=2026-02-23
+HOLIDAY_URL="https://calendrier.api.gouv.fr/jours-feries/"
+EXCLUDED_PUBLIC_HOLIDAYS="Lundi de Pentecôte"

deploy/docker/Dockerfile.prod

@@ -0,0 +1,80 @@
+# --- Stage 1: Build backend ---
+FROM php:8.4-cli AS backend-build
+
+RUN apt-get update && apt-get install -y \
+        libicu-dev libpq-dev libpng-dev libzip-dev libxml2-dev \
+        unzip curl git \
+    && docker-php-ext-install -j$(nproc) intl pdo_pgsql zip gd opcache \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+WORKDIR /app
+COPY composer.json composer.lock symfony.lock ./
+RUN APP_ENV=prod APP_DEBUG=0 composer install --no-dev --optimize-autoloader --no-scripts --no-interaction
+
+COPY bin bin/
+COPY config config/
+COPY migrations migrations/
+COPY public public/
+COPY src src/
+COPY templates templates/
+
+# --- Stage 2: Build frontend ---
+FROM node:lts-alpine AS frontend-build
+
+WORKDIR /app/frontend
+COPY frontend/package.json frontend/package-lock.json ./
+RUN npm ci
+
+COPY frontend/ ./
+ENV CI=1 \
+    NUXT_TELEMETRY_DISABLED=1 \
+    NUXT_PUBLIC_API_BASE=/api \
+    NUXT_PUBLIC_APP_BASE=/
+RUN npm run generate
+
+# --- Stage 3: Production image ---
+FROM php:8.4-fpm AS production
+
+RUN apt-get update && apt-get install -y \
+        libicu-dev libpq-dev libpng-dev libzip-dev libxml2-dev \
+        nginx supervisor \
+    && docker-php-ext-install -j$(nproc) intl pdo_pgsql zip gd opcache \
+    && rm -rf /var/lib/apt/lists/*
+
+# PHP production config
+RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
+
+# PHP-FPM: forward worker output to stderr for docker logs
+RUN echo "catch_workers_output = yes" >> /usr/local/etc/php-fpm.d/www.conf \
+    && echo "decorate_workers_output = no" >> /usr/local/etc/php-fpm.d/www.conf
+
+# Nginx: log to stdout/stderr
+RUN ln -sf /dev/stdout /var/log/nginx/access.log \
+    && ln -sf /dev/stderr /var/log/nginx/error.log
+
+# Remove default nginx site
+RUN rm -f /etc/nginx/sites-enabled/default
+
+# Configs
+COPY deploy/docker/supervisord.conf /etc/supervisor/conf.d/app.conf
+COPY deploy/docker/nginx.conf /etc/nginx/sites-enabled/sirh.conf
+
+# Backend from stage 1
+COPY --from=backend-build /app /var/www/html
+
+# Frontend from stage 2
+COPY --from=frontend-build /app/frontend/.output/public /var/www/html/frontend/.output/public
+
+# Symfony needs a .env file to boot (variables are overridden by env_file in docker-compose)
+RUN echo "APP_ENV=prod" > /var/www/html/.env
+
+# Permissions
+RUN mkdir -p /var/www/html/var \
+    && chown -R www-data:www-data /var/www/html/var
+
+WORKDIR /var/www/html
+EXPOSE 80
+
+CMD ["supervisord", "-n", "-c", "/etc/supervisor/conf.d/app.conf"]

deploy/docker/deploy.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+TAG="${1:-latest}"
+export SIRH_IMAGE_TAG="$TAG"
+
+echo "==> Deploying sirh:${TAG}..."
+
+echo "==> Enabling maintenance mode..."
+touch maintenance.on
+
+echo "==> Pulling image..."
+docker compose pull
+
+echo "==> Starting container..."
+docker compose up -d
+
+echo "==> Waiting for container to be ready..."
+sleep 3
+
+echo "==> Running migrations..."
+docker compose exec -T -u www-data app php bin/console doctrine:migrations:migrate --no-interaction
+
+echo "==> Clearing cache..."
+docker compose exec -T -u www-data app php bin/console cache:clear --env=prod
+docker compose exec -T -u www-data app php bin/console cache:warmup --env=prod
+
+echo "==> Disabling maintenance mode..."
+rm -f maintenance.on
+
+VERSION=$(docker compose exec -T app cat config/version.yaml | grep 'app.version' | awk -F"'" '{print $2}')
+echo "==> Deployed v${VERSION}"

deploy/docker/docker-compose.prod.yml

@@ -0,0 +1,13 @@
+services:
+  app:
+    image: gitea.malio.fr/malio-dev/sirh:${SIRH_IMAGE_TAG:-latest}
+    container_name: sirh-app
+    env_file: .env
+    ports:
+      - "8080:80"
+    volumes:
+      - ./config/jwt:/var/www/html/config/jwt:ro
+      - ./uploads:/var/www/html/var/uploads
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    restart: unless-stopped

deploy/docker/nginx.conf

@@ -0,0 +1,46 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /var/www/html/frontend/.output/public;
+    index index.html;
+
+    access_log /dev/stdout;
+    error_log /dev/stderr;
+
+    location ^~ /api/ {
+        root /var/www/html/public;
+        try_files $uri /index.php?$query_string;
+    }
+
+    location ^~ /bundles/ {
+        root /var/www/html/public;
+        try_files $uri =404;
+    }
+
+    location = /api/login_check {
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME /var/www/html/public/index.php;
+        fastcgi_param DOCUMENT_ROOT /var/www/html/public;
+        fastcgi_param SCRIPT_NAME /index.php;
+        fastcgi_param PATH_INFO /login_check;
+        fastcgi_param REQUEST_URI /login_check;
+        fastcgi_pass 127.0.0.1:9000;
+    }
+
+    location ~ ^/index\.php(/|$) {
+        include fastcgi_params;
+        fastcgi_param SCRIPT_FILENAME /var/www/html/public/index.php;
+        fastcgi_param DOCUMENT_ROOT /var/www/html/public;
+        fastcgi_pass 127.0.0.1:9000;
+        internal;
+    }
+
+    location ~ \.php$ {
+        return 404;
+    }
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+}

deploy/docker/supervisord.conf

@@ -0,0 +1,28 @@
+[supervisord]
+nodaemon=true
+user=root
+logfile=/dev/null
+logfile_maxbytes=0
+pidfile=/var/run/supervisord.pid
+
+[program:php-fpm]
+command=php-fpm -F
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+stopasgroup=true
+stopsignal=QUIT
+
+[program:nginx]
+command=nginx -g "daemon off;"
+autostart=true
+autorestart=true
+stdout_logfile=/dev/stdout
+stdout_logfile_maxbytes=0
+stderr_logfile=/dev/stderr
+stderr_logfile_maxbytes=0
+stopasgroup=true
+stopsignal=QUIT

deploy/maintenance.html

@@ -0,0 +1,50 @@
+<!DOCTYPE html>
+<html lang="fr">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Maintenance en cours</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            background: #f3f4f6;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            min-height: 100vh;
+            color: #1f2937;
+        }
+        .container {
+            text-align: center;
+            padding: 3rem;
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 4px 24px rgba(0, 0, 0, 0.08);
+            max-width: 500px;
+            width: 90%;
+        }
+        .icon {
+            font-size: 4rem;
+            margin-bottom: 1.5rem;
+        }
+        h1 {
+            font-size: 1.5rem;
+            margin-bottom: 0.75rem;
+            color: #111827;
+        }
+        p {
+            font-size: 1rem;
+            color: #6b7280;
+            line-height: 1.6;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="icon">&#128736;</div>
+        <h1>Maintenance en cours</h1>
+        <p>L'application est temporairement indisponible pour mise a jour. Elle sera de retour dans quelques instants.</p>
+    </div>
+</body>
+</html>

deploy/nginx/sirh-docker.conf

@@ -0,0 +1,29 @@
+server {
+    listen 80;
+    server_name sirh.malio-dev.fr;
+
+    root /var/www/sirh/public;
+
+    # Maintenance mode : si le fichier maintenance.on existe, renvoyer la page 503
+    if (-f /var/www/sirh/maintenance.on) {
+        return 503;
+    }
+
+    error_page 503 @maintenance;
+
+    location @maintenance {
+        rewrite ^(.*)$ /maintenance.html break;
+    }
+
+    location = /maintenance.html {
+        internal;
+    }
+
+    location / {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}

doc/audit-logging.md

@@ -0,0 +1,57 @@
+# Journal des actions (Audit Log)
+
+## Objectif
+
+Tracer les actions utilisateurs pour diagnostiquer rapidement les problèmes de calcul signalés.
+Quand un utilisateur signale une incohérence dans ses heures, RTT ou congés, le journal permet de voir
+exactement ce qui a été modifié, par qui, et quand.
+
+## Accès
+
+- **Rôle requis** : `ROLE_SUPER_ADMIN` (rôle caché, non visible dans l'interface de gestion des utilisateurs)
+- **Ajout du rôle** : directement en base de données
+  ```sql
+  UPDATE users SET roles = '["ROLE_ADMIN","ROLE_SUPER_ADMIN"]' WHERE username = 'xxx';
+  ```
+- **Page** : `/audit-logs` (lien "Journal" dans la sidebar, visible uniquement avec le rôle)
+
+## Actions tracées
+
+| Processor | Entité | Actions |
+|---|---|---|
+| `AbsenceWriteProcessor` | Absence | create, delete |
+| `WorkHourBulkUpsertProcessor` | WorkHour | create, update, delete |
+| `WorkHourSiteValidationProcessor` | WorkHour | site_validate |
+| `WorkHourBulkValidationProcessor` | WorkHour | validate |
+| `WorkHourBulkSiteValidationProcessor` | WorkHour | site_validate |
+| `EmployeeWriteProcessor` | Employee | create, update (changement contrat) |
+| `ContractSuspensionWriteProcessor` | ContractSuspension | create, update |
+| `EmployeeRttPaymentProcessor` | EmployeeRttPayment | update |
+| `EmployeeFractionedDaysProcessor` | EmployeeLeaveBalance | update |
+
+## Données stockées
+
+Chaque entrée contient :
+- **employee** : l'employé concerné (FK, nullable)
+- **username** : l'utilisateur qui a effectué l'action
+- **action** : type d'action (create, update, delete, validate, site_validate)
+- **entityType** : type d'entité (work_hour, absence, employee, etc.)
+- **description** : description lisible en français
+- **changes** : diff JSON `{old: {...}, new: {...}}` avec les anciennes/nouvelles valeurs
+- **affectedDate** : date de travail ou début d'absence (pour filtrage par période)
+- **createdAt** : horodatage de l'action
+
+## Filtres disponibles
+
+- Par employé
+- Par plage de dates (date affectée)
+- Par type d'entité
+
+## Pagination
+
+Les résultats sont paginés par 50 entrées. L'API retourne `{items, total, page, perPage}` et accepte un query param `page`.
+
+## Convention
+
+Tout nouveau processor traitant des entités impactant les calculs (heures, absences, contrats, RTT)
+doit intégrer le service `AuditLogger` et logger les actions create/update/delete.

doc/deployment-docker.md

@@ -0,0 +1,363 @@
+# Deploiement Docker — SIRH
+
+## Pre-requis
+
+### Docker
+
+```bash
+# Ubuntu
+sudo apt update
+sudo apt install -y ca-certificates curl gnupg
+sudo install -m 0755 -d /etc/apt/keyrings
+curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
+sudo apt update
+sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
+sudo usermod -aG docker $USER
+```
+
+Se deconnecter/reconnecter pour que le groupe `docker` prenne effet.
+
+### Nginx
+
+```bash
+sudo apt install -y nginx
+sudo systemctl enable nginx
+sudo systemctl start nginx
+```
+
+### PostgreSQL
+
+PostgreSQL tourne dans un conteneur Docker separe (voir le repo `infra-postgres`).
+Il doit etre installe et accessible avant de deployer SIRH.
+
+Creer la base de donnees pour SIRH :
+
+```bash
+cd /var/www/postgres
+docker compose exec postgres psql -U admin
+```
+
+```sql
+-- Si le user n'existe pas encore
+CREATE USER malio WITH PASSWORD 'motdepasse';
+
+-- Creer la base
+CREATE DATABASE sirh_prod OWNER malio;
+\q
+```
+
+---
+
+## Premiere installation (nouvelle machine)
+
+Guide complet pour mettre en ligne SIRH sur une machine vierge. Inclut les pre-requis, la BDD et l'app.
+
+### 1. Installer les pre-requis
+
+Installer Docker, Nginx et PostgreSQL (voir section Pre-requis ci-dessus).
+
+### 2. Creer le dossier de deploiement
+
+```bash
+sudo mkdir -p /var/www/sirh
+sudo chown -R $(whoami):$(whoami) /var/www/sirh
+cd /var/www/sirh
+```
+
+### 3. Se connecter au registry Docker de Gitea
+
+```bash
+docker login gitea.malio.fr
+```
+
+- **Username** : le nom d'utilisateur du compte organisation Gitea `MALIO-DEV`
+- **Password** : le token REGISTRY_TOKEN dispo dans le bitwarden
+
+Le login est sauvegarde dans `~/.docker/config.json`, pas besoin de le refaire a chaque deploiement.
+
+### 4. Creer les fichiers de deploiement
+
+Creer `docker-compose.yml` :
+
+```yaml
+services:
+  app:
+    image: gitea.malio.fr/malio-dev/sirh:${SIRH_IMAGE_TAG:-latest}
+    container_name: sirh-app
+    env_file: .env
+    ports:
+      - "8080:80"
+    volumes:
+      - ./config/jwt:/var/www/html/config/jwt:ro
+      - ./uploads:/var/www/html/var/uploads
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    restart: unless-stopped
+```
+
+Creer `deploy.sh` :
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+TAG="${1:-latest}"
+export SIRH_IMAGE_TAG="$TAG"
+
+echo "==> Deploying sirh:${TAG}..."
+
+echo "==> Pulling image..."
+docker compose pull
+
+echo "==> Starting container..."
+docker compose up -d
+
+echo "==> Waiting for container to be ready..."
+sleep 3
+
+echo "==> Running migrations..."
+docker compose exec -T -u www-data app php bin/console doctrine:migrations:migrate --no-interaction
+
+echo "==> Clearing cache..."
+docker compose exec -T -u www-data app php bin/console cache:clear --env=prod
+docker compose exec -T -u www-data app php bin/console cache:warmup --env=prod
+
+VERSION=$(docker compose exec -T app cat config/version.yaml | grep 'app.version' | awk -F"'" '{print $2}')
+echo "==> Deployed v${VERSION}"
+```
+
+Rendre executable :
+
+```bash
+chmod +x deploy.sh
+```
+
+### 5. Configurer l'environnement
+
+Creer `.env` avec les variables suivantes :
+
+```env
+# Symfony
+APP_ENV=prod
+APP_DEBUG=0
+APP_SECRET=<generer avec: openssl rand -hex 32>
+
+# Database (host.docker.internal = la machine hote, ou le PG tourne en Docker)
+DATABASE_URL="postgresql://malio:password@host.docker.internal:5432/sirh_prod?serverVersion=16&charset=utf8"
+
+# JWT
+JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
+JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
+JWT_PASSPHRASE=<generer avec: openssl rand -hex 32>
+JWT_COOKIE_SECURE=1
+JWT_COOKIE_SAMESITE=lax
+JWT_TOKEN_TTL=86400
+JWT_COOKIE_TTL=86400
+
+# CORS
+CORS_ALLOW_ORIGIN='^https?://sirh\.malio-dev\.fr$'
+
+# App
+DEFAULT_URI=https://sirh.malio-dev.fr
+APP_SHARE_DIR=var/share
+RTT_START_DATE=2026-02-23
+HOLIDAY_URL="https://calendrier.api.gouv.fr/jours-feries/"
+```
+
+### 6. Generer les cles JWT
+
+```bash
+mkdir -p config/jwt
+openssl genpkey -algorithm RSA -out config/jwt/private.pem -pkeyopt rsa_keygen_bits:4096
+openssl rsa -pubout -in config/jwt/private.pem -out config/jwt/public.pem
+```
+
+Rendre les cles lisibles par le conteneur (www-data = uid 33) :
+
+```bash
+sudo chown 33:33 config/jwt/private.pem config/jwt/public.pem
+sudo chmod 644 config/jwt/private.pem config/jwt/public.pem
+```
+
+### 7. Creer le dossier uploads
+
+```bash
+mkdir -p uploads
+```
+
+### 8. Configurer Nginx systeme
+
+Creer `/etc/nginx/sites-available/sirh.conf` :
+
+```nginx
+server {
+    listen 80;
+    server_name sirh.malio-dev.fr;
+
+    root /var/www/sirh/public;
+
+    # Maintenance mode
+    if (-f /var/www/sirh/maintenance.on) {
+        return 503;
+    }
+
+    error_page 503 @maintenance;
+
+    location @maintenance {
+        rewrite ^(.*)$ /maintenance.html break;
+    }
+
+    location = /maintenance.html {
+        internal;
+    }
+
+    location / {
+        proxy_pass http://127.0.0.1:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+Copier la page de maintenance et activer le site :
+
+```bash
+cp deploy/maintenance.html /var/www/sirh/public/maintenance.html
+sudo ln -sf /etc/nginx/sites-available/sirh.conf /etc/nginx/sites-enabled/sirh.conf
+sudo nginx -t && sudo systemctl reload nginx
+```
+
+### 9. Deployer
+
+```bash
+./deploy.sh
+```
+
+### 10. Importer les donnees (optionnel)
+
+Si tu as un dump SQL a importer :
+
+```bash
+# Depuis ton PC, envoyer le dump vers le serveur
+scp sirh.sql user@serveur:/tmp/sirh.sql
+
+# Sur le serveur, vider la base puis importer
+cd /var/www/postgres
+docker compose exec -T postgres psql -U malio sirh_prod -c "DROP SCHEMA public CASCADE; CREATE SCHEMA public;"
+docker compose exec -T postgres psql -U malio sirh_prod < /tmp/sirh.sql
+
+# Creer les tables manquantes (si le dump a des erreurs de syntaxe)
+cd /var/www/sirh
+docker compose exec -u www-data app php bin/console doctrine:schema:update --force --env=prod
+
+# Nettoyer
+rm /tmp/sirh.sql
+```
+
+### Structure finale du dossier
+
+```
+/var/www/sirh/
+├── docker-compose.yml
+├── deploy.sh
+├── .env
+├── config/jwt/
+│   ├── private.pem
+│   └── public.pem
+├── public/
+│   └── maintenance.html
+└── uploads/
+```
+
+---
+
+## Deployer une nouvelle version
+
+Quand l'app est deja installee, deployer une mise a jour :
+
+```bash
+cd /var/www/sirh
+./deploy.sh           # deploie la derniere version (latest)
+./deploy.sh v0.1.61   # deploie une version specifique
+```
+
+Le script active automatiquement la maintenance pendant le deploy et la desactive a la fin.
+
+---
+
+## Maintenance manuelle
+
+Activer la maintenance (sans deployer) :
+
+```bash
+cd /var/www/sirh
+touch maintenance.on
+```
+
+Desactiver :
+
+```bash
+rm maintenance.on
+```
+
+---
+
+## Rollback
+
+### Image seule (pas de changement de schema BDD)
+
+```bash
+./deploy.sh v0.1.60
+```
+
+### Avec rollback de migration
+
+```bash
+# 1. Rollback schema (pendant que la version actuelle tourne encore)
+docker compose exec -T -u www-data app php bin/console doctrine:migrations:migrate prev --no-interaction
+# 2. Deployer l'ancienne version
+./deploy.sh v0.1.60
+```
+
+---
+
+## Voir les logs
+
+```bash
+cd /var/www/sirh
+docker compose logs -f            # tous les logs
+docker compose logs -f --tail=100 # 100 dernieres lignes
+```
+
+Logs Symfony :
+
+```bash
+docker compose exec app cat var/log/prod.log
+```
+
+---
+
+## Migration depuis l'ancien deploiement (tar.gz)
+
+Si l'application tourne deja en bare metal :
+
+1. Installer Docker (voir pre-requis)
+2. Creer le dossier `/var/www/sirh-docker/` (ne pas ecraser l'ancien)
+3. Copier les fichiers existants :
+   ```bash
+   cp /var/www/sirh/.env /var/www/sirh-docker/.env
+   cp -a /var/www/sirh/config/jwt /var/www/sirh-docker/config/jwt
+   cp -a /var/www/sirh/var/uploads /var/www/sirh-docker/uploads
+   ```
+4. Creer `docker-compose.yml` et `deploy.sh` dans `/var/www/sirh-docker/` (voir etape 4 ci-dessus)
+5. Editer `/var/www/sirh-docker/.env` : changer `DATABASE_URL` pour utiliser `host.docker.internal` au lieu de `127.0.0.1`
+6. Se connecter au registry Gitea (voir etape 3 ci-dessus)
+7. Mettre a jour Nginx systeme avec la conf reverse proxy (voir etape 8 ci-dessus)
+8. Arreter l'ancien PHP-FPM : `sudo systemctl stop php8.4-fpm`
+9. Deployer : `cd /var/www/sirh-docker && ./deploy.sh`
+10. Verifier que tout marche, puis renommer le dossier : `mv /var/www/sirh-docker /var/www/sirh`

doc/formations.md

@@ -0,0 +1,58 @@
+# Formations
+
+Onglet **Formation** accessible depuis la fiche employé. Permet de tracer les formations suivies par un salarié.
+
+## Accès
+
+- Réservé aux administrateurs (`ROLE_ADMIN`)
+- Invisible pour les autres rôles
+
+## Champs
+
+| Champ | Type | Obligatoire |
+| --- | --- | --- |
+| Date de début | date | oui |
+| Date de fin | date | oui |
+| Justificatif | fichier PDF | non |
+| Commentaire | texte libre | non |
+
+## Règles de validation
+
+- La date de fin doit être supérieure ou égale à la date de début
+- Seuls les fichiers PDF sont acceptés pour le justificatif
+- Un employé peut avoir plusieurs formations (aucune unicité imposée)
+
+## Stockage
+
+Les justificatifs PDF sont stockés dans `var/uploads/formations/{année}/{mois}/{uuid}.pdf`, où l'année et le mois sont ceux de la date de début de la formation. Le nom d'origine du fichier est conservé en base pour l'affichage et le téléchargement.
+
+Lors de la suppression d'une formation, le fichier associé est automatiquement supprimé du disque. Lors du remplacement d'un justificatif, l'ancien fichier est également supprimé.
+
+## Tri
+
+Les formations sont affichées dans le tableau par **date de début décroissante**.
+
+## Affichage sur les autres écrans
+
+### Écran des heures (vue jour)
+
+Dans la colonne "Absence", lorsqu'un salarié est en formation sur la date sélectionnée, une pastille indigo **Formation** est affichée sous la pastille d'absence éventuelle. Cette pastille est uniquement informative :
+
+- Le bouton **Modifier** de la colonne Absence est masqué : aucune création/modification/suppression d'absence n'est possible sur un jour en formation
+- La gestion CRUD d'une formation se fait exclusivement depuis la fiche employé, onglet **Formation**
+
+### Calendrier
+
+Dans le calendrier mensuel, les formations sont affichées de deux façons :
+
+- **Jour avec formation uniquement** : la cellule est teintée en indigo avec le code `F`
+- **Jour avec absence + formation** : la cellule garde la couleur de l'absence et une icône école est ajoutée en coin supérieur droit
+
+Une entrée "Formation" est visible dans la légende du calendrier. Les cellules contenant une formation sont **non cliquables** (aucune création/édition d'absence possible). La gestion d'une formation se fait exclusivement depuis la fiche employé, onglet **Formation**.
+
+### Export PDF du calendrier
+
+L'impression du calendrier d'absences reprend le même principe :
+
+- **Jour avec formation uniquement** : cellule indigo avec le code `F`
+- **Jour avec absence + formation** : le code de l'absence est suivi d'un astérisque (`*`)

doc/functional-rules.md

@@ -122,6 +122,10 @@ Documents complementaires:
 - Semaine en déficit (heures travaillées < heures contrat):
   - le déficit est déduit du cumul RTT : d'abord des heures à 50%, puis des heures à 25%
   - si aucun solde 50% ni 25%, les heures à 25% deviennent négatives
+- Contrats CUSTOM (heures hebdo ≠ 35h et ≠ 39h, hors INTERIM/FORFAIT):
+  - référence heures sup = heures contractuelles réelles (ex: 4h → référence 4h)
+  - pas de bonus 25% ni 50% : 1 heure sup = 1 heure de récupération
+  - le déficit (travail < contrat) ne génère pas de récup mais n'impacte pas le solde
 - Nature `INTERIM`:
   - pas de bonus 25%
   - pas de bonus 50%
@@ -150,17 +154,21 @@ Documents complementaires:
   - jour/nuit/atelier par jour + indicateurs repas/dîner/nuitée
   - panier de nuit (PN): affiché par jour si (nightMinutes > dayMinutes) OU (nightMinutes >= 240, soit au moins 4h de travail entre 21h et 6h), et total hebdo dans la colonne Jour/Nuit sem.
   - totaux hebdo: jour, nuit, atelier, total, compteurs petit déj/déjeuner/dîner/nuitée
-  - pas de calcul d'heures supplémentaires pour les conducteurs
+  - les conducteurs utilisent `dayHoursMinutes + nightHoursMinutes + workshopHoursMinutes` pour le calcul RTT (au lieu des créneaux morning/afternoon/evening)
 - Le flag `isDriver` est sur `EmployeeContractPeriod` (un employé peut changer de statut chauffeur selon la période)
 - Exposé en API via un getter virtuel sur `Employee` (`employee:read`) qui résout depuis la période active
 
 ## 7) Fériés
 
 - Les jours fériés sont identifiés et affichés
+- Source: API `calendrier.api.gouv.fr/jours-feries/` via `PublicHolidayService` (cache 30j)
+- Exclusions configurables: variable d'env `EXCLUDED_PUBLIC_HOLIDAYS` (liste de libellés séparés par virgules). Par défaut `"Lundi de Pentecôte"` — journée de solidarité généralement travaillée. Le filtre s'applique à tous les consommateurs (frontend + calculs backend) en amont du retour du service.
 - Onglet congés: jours fériés affichés sur le calendrier avec fond `rgb(179, 229, 252)` et nom au survol
+- Écran Heures et Heures Conducteurs (vue jour): le nom du férié est affiché dans la colonne Absence sous forme de pill (fond `#b3e5fc`, icône `mdi:calendar-star`), distinct du pill absence
 - Règle courante:
-  - absences bloquées sur jour férié
-  - saisie d'heures autorisée
+  - absences bloquées sur jour férié (création/édition) — bouton "Modifier" masqué comme pour les formations
+  - saisie d'heures ou de jours de présence autorisée — les heures saisies comptent normalement dans le total hebdo et le calcul RTT
+  - la référence hebdomadaire n'est pas réduite par un férié: un salarié qui ne saisit rien sur un férié est en déficit de la journée correspondante
 
 ## 8) Impression absences (PDF)
 
@@ -190,13 +198,14 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
 - Détail employé:
   - onglet `Suivi contrat` avec affichage de l'historique des périodes de contrat
   - chaque ligne expose: nature (`CDI`/`CDD`/`INTERIM`), contrat/temps de travail, date de début, date de fin (ou "En cours")
-  - action `Clôturer`:
-    - bouton actif uniquement s'il existe un contrat en cours non déjà clôturé à la date du jour
+  - action `Modifier` (clôture/solde de tout compte):
+    - bouton actif s'il existe un contrat en cours non clôturé, ou si le dernier contrat est terminé (sans contrat actif après)
     - ouvre un drawer en lecture seule (type/temps de travail/date de début)
     - champs saisissables:
-      - `contractEndDate` (prérempli à aujourd'hui)
+      - `contractEndDate` (prérempli à aujourd'hui si contrat en cours, à la date de fin existante si contrat terminé)
       - `contractPaidLeaveSettled` (checkbox "Soldé dans le solde de tout compte")
     - backend: en mode clôture, le flag `contractPaidLeaveSettled` est persisté sur la période clôturée
+    - cas du contrat déjà terminé: permet de modifier `paidLeaveSettled` et le commentaire sur le dernier contrat terminé (ex: solde de tout compte CDD)
   - action `Ajouter`:
     - conserve le flux d'ajout d'un nouveau contrat via drawer dédié
     - disponible uniquement s'il n'y a pas de contrat en cours, ou si le contrat en cours a déjà une date de fin
@@ -227,6 +236,7 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
         - en cas de suspension en cours de mois, l'acquisition est proratisée en jours ouvrés (lun-ven hors fériés) travaillés / 22
       - contrat `FORFAIT`:
         - base annuelle: `jours ouvrés de l'exercice (lundi-vendredi, hors jours fériés métropole) - 218`
+        - bonus weekend/férié: chaque jour travaillé un weekend ou jour férié donne 1 jour de congé supplémentaire (journée ≥ 5h = 1.0 jour, demi-journée > 0h et < 5h = 0.5 jour), sans plafond
         - prorata: en cas de démarrage/fin de contrat en cours d'année civile, le calcul ne couvre que l'intervalle actif du contrat dans l'année
         - reste à prendre: `acquis - absences` (toutes absences, demi-journées incluses)
         - pas de samedi (`0`)
@@ -239,6 +249,7 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
       - pour `FORFAIT`:
         - pris: basé sur toutes les absences (demi-journées incluses)
         - restants = acquis - pris (borné à 0)
+        - paiement congés N-1: saisie RH via `PATCH /employees/{id}/paid-leave-days` (body: `paidLeaveDays`, `year`). Stocké dans `employee_leave_balances.paid_leave_days`. Les jours payés réduisent le stock N-1 **avant** l'attribution des jours pris : `disponible_N-1 = max(0, acquis_N-1 - payés)`, puis `pris_N-1 = min(disponible_N-1, total_pris)`, surplus pris basculé sur N. Reste à prendre N-1 = `max(0, disponible_N-1 - pris_N-1)`. Uniquement pour les contrats forfait.
       - report annuel:
         - le reliquat (`restants`) de l'exercice précédent est reporté dans les acquis de l'exercice courant
         - pour `CDI`/`CDD` non forfait: report séparé jours + samedis
@@ -268,8 +279,9 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
       - total mensuel des minutes de récupération
       - compteur global exercice = `report N-1 + acquis N`
     - attribution mensuelle des semaines:
-      - une semaine ISO est affichée une seule fois, dans le mois qui contient le **samedi** de cette semaine
-      - si le weekend tombe en début de mois suivant, c'est le mois suivant qui porte la semaine
+      - une semaine ISO qui chevauche deux mois est affichée dans **les deux mois**, avec les valeurs réparties proportionnellement aux minutes travaillées de chaque portion
+      - le calcul des heures supplémentaires reste hebdomadaire (seuils 35h/39h/43h appliqués sur la semaine entière), seul l'affichage est scindé
+      - exemple: S14 lundi-mardi en mars, mercredi-dimanche en avril → la S14 apparaît en mars (avec la part des heures de lun-mar) et en avril (avec la part mer-dim)
     - logique de calcul:
       - base identique aux calculs d'heures supplémentaires de la vue semaine Heures
       - minutes de récupération hebdomadaires = `HS totales + bonus 25% + bonus 50%`
@@ -318,6 +330,24 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
 | CP N | Forfait: jours acquis année civile. Non-forfait: en cours d'acquisition |
 | RTT | Minutes disponibles (report N-1 + acquis N - payés). Format `X h Y m`. Forfait et INTERIM: `-` |
 
+## 10bis) Écran Récap. congés (tableau)
+
+- Complément de l'export PDF : même logique de calcul, mais accessible aux employés et chefs de site
+- Endpoint: `GET /api/leave-recap`
+- Accès conditionné au flag `User.hasLeaveRecapAccess` (défaut `false`, activé au create/edit user)
+- Le flag s'applique à tous les profils, y compris admin (pas de bypass)
+- Scoping :
+  - `ROLE_ADMIN` : tous les employés
+  - `ROLE_USER` (chef de site) : employés des sites autorisés (`UserSiteRole`)
+  - `ROLE_SELF` : uniquement son employé lié
+- **Cutoff temporel** : le récap est figé à la fin de la semaine S-2 (dimanche 23:59:59)
+  - Formule : `cutoffDate = dimanche(lundi_semaine_courante − 14 jours)`
+  - Exemple : mardi 14/04/2026 (S16) → dimanche 05/04/2026 (fin S14)
+  - `isValid` n'entre PAS en compte : cutoff purement temporel
+  - Les heures et absences postérieures au cutoff sont ignorées dans les calculs
+- Colonnes identiques au PDF (voir §10)
+- Détails techniques : voir `doc/leave-recap-screen.md`
+
 ## 11) Récapitulatif Salaire (PDF mensuel)
 
 - Accessible depuis la page Employés via le bouton "Récap. Salaire" (réservé `ROLE_ADMIN`)
@@ -366,7 +396,26 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
   - Justificatif Montant : upload via `/mileage_allowances/{id}/amount-receipt`, téléchargement via GET même URL
 - La suppression d'un frais supprime les deux fichiers justificatifs du disque
 
-## 13) Notifications
+## 13) Observations
+
+- Onglet "Observation" sur la fiche employé (icône `mdi:note-text-outline`)
+- Entité `Observation` (table `observations`)
+- Champs:
+  - `month` (mois, obligatoire)
+  - `content` (texte d'observation, obligatoire)
+- Contrainte: une seule observation par mois par employé (unique sur `employee_id + month`)
+- Tableau: colonnes Mois | Observation
+- Drawer avec champs mois (`type="month"`) et textarea "Observation"
+- CRUD standard: création, modification, suppression avec confirmation
+
+## 14) Verrouillage utilisateur
+
+- Champ `isLocked` (boolean, default false) sur l'entité `User`
+- Un admin peut verrouiller/déverrouiller un utilisateur depuis la page Utilisateurs (checkbox dans le drawer)
+- Un utilisateur verrouillé ne peut plus se connecter (vérification via `UserChecker` sur les firewalls `login` et `api`)
+- Colonne "Statut" dans le tableau utilisateurs avec label "Actif" (vert) ou "Verrouillé" (rouge)
+
+## 15) Notifications
 
 - Icône cloche en topbar:
   - badge = nombre de notifications non lues
@@ -379,3 +428,31 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
 - Une notification est créée uniquement quand un chef de site termine la validation complète:
   - condition: plus aucune ligne `work_hours` du site à la date concernée avec `isSiteValid = false`
   - destinataires: utilisateurs `ROLE_ADMIN`
+
+## 16) Export PDF des heures annuelles
+
+- Accessible depuis la fiche employé (bouton imprimante à droite du nom)
+- Ouvre un drawer pour choisir l'année (civile, Jan-Déc)
+- Génère un PDF avec le détail jour par jour des heures de l'employé
+- Seuls les jours avec heures saisies ou absence sont affichés
+
+### Colonnes selon le mode de suivi
+
+- **TIME (non-chauffeur)**: Date | Absence | Début matin | Fin matin | Début après-midi | Fin après-midi | Début soir | Fin soir | Total
+- **PRESENCE (forfait)**: Date | Absence | Présence matin | Présence après-midi | Total
+- **Chauffeur**: Date | Absence | Heures jour | Heures nuit | Heures atelier | Total
+
+### Changement de contrat en cours d'année
+
+- Si l'employé change de mode de suivi (TIME/PRESENCE) ou de statut chauffeur en cours d'année, le PDF affiche des sections séparées avec les colonnes adaptées à chaque période
+- Le nom du contrat est affiché en sous-titre de chaque section
+
+### Calcul du total
+
+- TIME non-chauffeur: somme des créneaux matin + après-midi + soir, plus minutes créditées des absences `countAsWorkedHours`
+- Chauffeur: `dayHoursMinutes + nightHoursMinutes + workshopHoursMinutes` + minutes créditées
+- PRESENCE: 0.5 par demi-journée présente (matin/après-midi), max 1.0
+
+### Nom du fichier
+
+- Format: `{nom}_{prenom}_{annee}.pdf`

doc/holiday-virtual-hours.md

@@ -0,0 +1,110 @@
+# Crédit automatique des heures sur jour férié (Lun-Ven)
+
+## Règle
+
+Tout jour férié du **lundi au vendredi** crédite automatiquement les **heures contractuelles attendues** pour ce jour, pour tout contrat **autre que Forfait** (`trackingMode` ≠ `PRESENCE`). Les heures ainsi créditées sont dites *virtuelles* : aucune ligne n'est créée dans `work_hours`, elles sont injectées à l'affichage et au calcul.
+
+### Référence contractuelle par jour
+
+| Contrat         | Lun-Jeu | Ven   | Sam-Dim |
+|-----------------|---------|-------|---------|
+| 35h             | 7h      | 7h    | 0       |
+| 39h             | 8h      | 7h    | 0       |
+| CUSTOM (avec planning `workDaysHours`) | minutes du jour programmé, 0 sinon | idem | 0 |
+| INTERIM 35h     | 7h      | 7h    | 0       |
+| FORFAIT         | —       | —     | —       |
+
+La référence par jour est calculée par `App\Service\WorkHours\DailyReferenceMinutesResolver`.
+
+### Planning `workDaysHours`
+
+Tout contrat TIME **hors 35h/39h/INTERIM** (ex. 4h, 25h, 28h) doit déclarer un planning précis sur sa `EmployeeContractPeriod` : colonne JSON `work_days_hours = {"1": 120, "4": 120}` (iso day → minutes). La somme doit égaler `weeklyHours × 60`.
+
+- **Sur un jour du planning** : crédit férié = minutes programmées (ex. Ewa Lun → 120 min).
+- **Sur un jour hors planning** : crédit férié = 0 (elle n'aurait pas travaillé).
+- Même logique appliquée par `WorkedHoursCreditPolicy::resolveContractDayMinutes` pour les crédits d'absence — un 4h en absence mardi (non programmée) = 0 crédit.
+
+Validation à l'écriture : `EmployeeContractPeriodValidator::assertWorkDaysHours`. Le frontend expose un bloc « Jours travaillés » (cases Lun-Ven + input `HH:MM`) sur les formulaires de création employé + d'ajout de contrat, visible uniquement quand le contrat le requiert.
+
+**Limitation actuelle** : l'édition in-place d'un schedule sur une période active existante n'est **pas exposée** via l'UI. Le drawer « Modifier le contrat » affiche le schedule en lecture seule à titre informatif. Pour corriger un schedule, la démarche est : clôturer le contrat en cours + créer un nouveau contrat avec le schedule corrigé. Si un besoin d'édition directe émerge, ajouter `workDaysHours` dans `EmployeeContractChangeRequest::hasPeriodChangeRequest()` et la logique d'update dans `EmployeeContractPeriodManager`.
+
+### Fériés exclus
+
+Les fériés listés dans l'env `EXCLUDED_PUBLIC_HOLIDAYS` (par défaut `Lundi de Pentecôte` — journée de solidarité) **ne donnent pas** de crédit virtuel : le `PublicHolidayService` les filtre en amont, donc `HolidayVirtualHoursResolver` ne les voit pas comme fériés.
+
+### Interaction avec saisie
+
+Quand l'employé saisit des heures ce jour-là :
+
+- `heures finales = max(heures saisies + crédit d'absence éventuel, heures contractuelles de référence)`
+
+Exemples avec un contrat 39h et un férié un lundi :
+
+| Saisie employé   | Total affiché | Interprétation |
+|------------------|---------------|----------------|
+| Aucune           | 8h            | Crédit 100% virtuel |
+| Matin 09:00-13:00 (4h) | 8h       | Le minimum contractuel l'emporte |
+| 09:00-12:00 + 13:00-19:00 (9h) | 9h | Les heures saisies l'emportent |
+
+### Interaction avec absences
+
+La création d'absence sur un férié Lun-Ven est **autorisée** (bouton Modifier visible). Dès qu'une absence est déclarée sur le jour (matin et/ou après-midi), le crédit virtuel férié **est désactivé** pour ce jour : c'est `absence.type.countAsWorkedHours` qui pilote le crédit d'heures, via `WorkedHoursCreditPolicy`.
+
+- `countAsWorkedHours = true` (ex. maladie payée) : crédit calculé normalement (7h/8h selon contrat × halfUnits/2). Même quantité que la référence virtuelle si journée complète, donc résultat identique — mais la source du crédit est l'absence, pas le férié.
+- `countAsWorkedHours = false` (ex. congé sans solde) : crédit = 0. Le férié ne compense pas.
+
+Cette règle évite le double-crédit (absence + férié virtuel) et respecte le paramétrage fonctionnel du type d'absence.
+
+## Impact technique
+
+### Affichage
+
+- **Écran Heures (vue jour)** : sur un férié Lun-Ven non-Forfait, la colonne Total affiche la valeur effective (référence ou saisie, selon max). Un chip "Férié : Xh comptées" apparaît sous le pill bleu du férié.
+- **Écran Heures Conducteurs (vue jour)** : idem, plus un indicateur `= Xh (férié)` sous l'input "Heures jour" pour signaler que le crédit est imputé au bucket jour.
+- **Vues semaine** : les totaux hebdomadaires intègrent les minutes virtuelles. Un marqueur `F + Xh` apparaît dans la cellule du jour férié.
+- **Onglet RTT** : les semaines contenant un férié Lun-Ven gagnent du temps crédité, ce qui peut générer des heures sup (25% / 50%) là où l'ancienne règle produisait un déficit.
+
+### Calcul RTT
+
+Le service `App\Service\WorkHours\HolidayVirtualHoursResolver` est injecté dans `RttRecoveryComputationService::computeRecoveryByWeek()`. Pour chaque jour ouvré :
+
+```
+effectiveMinutes = resolveEffectiveDailyMinutes(contract, date, metrics.totalMinutes + credited)
+weeklyTotalMinutes += effectiveMinutes
+```
+
+Le reste du calcul (tranches +25%, +50%, base 25% à partir de 35h/39h) demeure inchangé ; seul le total hebdo injecté a évolué.
+
+### Calcul hebdomadaire d'affichage
+
+`WorkHourWeeklySummaryProvider` applique la même substitution sur `weeklyDayMinutes` et `weeklyTotalMinutes`. Le DTO `WeeklyDaySummary` expose désormais un champ `virtualHolidayMinutes` utilisé par les vues semaine.
+
+### Contexte jour
+
+`WorkHourDayContextProvider` expose `virtualHolidayMinutes` dans `DayContextRow` pour permettre au frontend de calculer le total journalier en temps réel pendant la saisie (sans aller-retour).
+
+### Frontend
+
+Le composable `frontend/composables/useHolidayVirtualHours.ts` réplique la règle côté client et est consommé par `useHoursPage.ts::getRowMetrics` et `useDriverHoursPage.ts::getRowMetrics`.
+
+## Impact historique
+
+La règle est appliquée **à chaque lecture** depuis les `WorkHour` — donc l'exercice courant et tout exercice recalculé live bénéficient automatiquement de la nouvelle règle sans migration.
+
+Les reports N-1 stockés dans `employee_rtt_balances.opening_*_minutes` ont été saisis manuellement par la RH (valeurs officielles) et ne sont **pas recalculés** : ces snapshots restent la source de vérité pour les soldes d'ouverture.
+
+## Services impliqués
+
+| Composant | Rôle |
+|-----------|------|
+| `DailyReferenceMinutesResolver` | Résolution "minutes contractuelles par jour" (logique partagée, anciennement dupliquée). |
+| `HolidayVirtualHoursResolver` | Décide si la règle s'applique et renvoie le crédit virtuel ou la valeur effective. |
+| `RttRecoveryComputationService` | Applique la substitution dans le calcul hebdo RTT. |
+| `WorkHourWeeklySummaryProvider` | Applique la substitution dans les totaux hebdo UI. |
+| `WorkHourDayContextProvider` | Expose `virtualHolidayMinutes` par salarié/jour. |
+| `useHolidayVirtualHours.ts` (frontend) | Réplique la règle en live côté client. |
+
+## Tests
+
+- `tests/Service/WorkHours/HolidayVirtualHoursResolverTest.php` couvre les scénarios par contrat + jours ouvrés/chômés.
+- `make test` (PHPUnit) valide l'intégration RTT / hebdo / contexte jour.

doc/leave-recap-screen.md

@@ -0,0 +1,73 @@
+# Écran Récap. congés
+
+## Objet
+
+Vue tableau des soldes de congés par employé, figée à un cutoff temporel (fin de semaine S-2).
+Complémentaire à l'export PDF admin : mêmes colonnes, accès étendu aux employés et chefs de site.
+
+## Cutoff
+
+La formule est : `cutoffDate = dimanche de (lundi de la semaine courante − 14 jours)`.
+
+Exemple : mardi 14/04/2026 (S16) → **dimanche 05/04/2026 23:59:59** (fin S14).
+
+Le cutoff est purement temporel : l'état `isValid` des heures n'entre pas en compte. Les heures
+et absences postérieures au cutoff sont ignorées dans le calcul des soldes.
+
+Implémentation : `App\Util\LeaveRecapCutoff::resolveCutoff()` côté backend, helper `parseYmd` +
+`getIsoWeekNumber` côté frontend pour l'affichage du badge.
+
+## Colonnes
+
+Identiques au PDF :
+
+- Nom
+- Prénom
+- Contrat
+- CP N-1 restant
+- CP N
+- Samedis acquis
+- RTT
+
+Pour les admins et chefs de site, une colonne **Site** est ajoutée à gauche.
+
+## Scoping
+
+| Profil        | Données visibles                        |
+|---------------|-----------------------------------------|
+| `ROLE_ADMIN`  | Tous les employés actifs, tous sites    |
+| `ROLE_USER` (chef de site) | Employés actifs des sites autorisés via `UserSiteRole` |
+| `ROLE_SELF`   | Uniquement l'employé lié à son compte   |
+
+## Flag d'accès
+
+Le champ `User.hasLeaveRecapAccess` (boolean, défaut `false`) conditionne :
+
+- L'affichage de l'entrée "Récap. congés" dans la sidebar
+- L'accès à la route `/leave-recap` (middleware `leave-recap-access.ts`)
+- L'endpoint API `GET /api/leave-recap` (le provider renvoie `403` si le flag est faux)
+
+Le flag s'applique même aux admins : un admin sans le flag ne voit pas l'écran. Il se configure
+dans le drawer de création/édition d'un utilisateur.
+
+## Service partagé
+
+`App\Service\Leave\LeaveRecapRowBuilder::build(Employee $employee, DateTimeImmutable $asOfDate)`
+construit une ligne de récap. Il est utilisé par :
+
+- `LeaveRecapPrintProvider` (PDF admin) avec `$asOfDate = today`
+- `EmployeeLeaveRecapProvider` (écran) avec `$asOfDate = cutoff`
+
+## Propagation du cutoff dans les calculs
+
+`EmployeeLeaveSummaryProvider::computeYearSummary()` accepte un `?DateTimeImmutable $asOfDate`.
+Lorsqu'il est fourni et appliqué à l'année cible, il remplace "today" dans :
+
+- `resolveAccrualCalculationEndDate()` — la borne d'accrual devient le dernier jour du mois
+  précédant `asOfDate` (au lieu du mois précédent today).
+- `resolveTakenCalculationEndDate()` — les absences postérieures à `asOfDate` sont ignorées.
+
+Pour les années antérieures (carry forward), le comportement reste inchangé (pas de cap).
+
+Le RTT est capé via `RttRecoveryComputationService::computeTotalRecoveryForExercise(..., $limitDate)`
+qui existait déjà, en passant `cutoff` comme date de référence.

doc/rtt-rollover.md

@@ -32,9 +32,9 @@ Principe:
 
 ## 4) Attribution mensuelle des semaines
 
-- une semaine ISO est affichee une seule fois, dans le mois qui contient le **samedi** de cette semaine
-- si le weekend tombe en debut du mois suivant, c'est ce mois qui porte la semaine
-- pas de prorata: la totalite des minutes de recuperation de la semaine est comptee dans un seul mois
+- une semaine ISO qui chevauche deux mois est affichee dans **les deux mois**, avec les valeurs reparties proportionnellement aux minutes travaillees de chaque portion
+- le calcul des heures supplementaires reste hebdomadaire (seuils 35h/39h/43h appliques sur la semaine entiere), seul l'affichage est scinde
+- exemple: S14 lundi-mardi en mars, mercredi-dimanche en avril → la S14 apparait en mars (part lun-mar) et en avril (part mer-dim)
 
 ## 5) Table cible
 

frontend/components/AppDrawer.vue

@@ -4,13 +4,13 @@
       <div class="absolute inset-0 bg-black/40" @click="close" />
     </Transition>
     <Transition name="drawer-panel">
-      <div class="absolute right-0 top-0 h-full w-full max-w-md bg-white shadow-xl">
-        <div class="flex items-center justify-between px-[20px] pt-8 pb-8">
+      <div class="absolute right-0 top-0 h-full w-full max-w-md bg-white shadow-xl flex flex-col">
+        <div class="shrink-0 flex items-center justify-between px-[20px] pt-8 pb-8">
           <h2 class="text-[32px] font-semibold text-primary-500">
             {{ title }}
           </h2>
         </div>
-        <div class="overflow-y-auto px-[20px]" style="max-height: calc(100% - 65px)">
+        <div class="min-h-0 flex-1 overflow-y-auto px-[20px] pb-4">
           <slot />
         </div>
       </div>

frontend/components/CalendarGrid.vue

@@ -45,9 +45,9 @@
                             <button
                                 type="button"
                                 class="relative flex h-8 w-full items-center justify-center overflow-hidden rounded-md border border-neutral-200 text-[11px] font-semibold text-neutral-800"
-                                :class="isHolidayDate(day.date) ? 'cursor-not-allowed opacity-80' : ''"
+                                :class="isHolidayDate(day.date) || getCellInfo(employee.id, day.date)?.hasFormation ? 'cursor-not-allowed opacity-80' : ''"
                                 :style="getCellStyle(employee.id, day.date)"
-                                :disabled="isHolidayDate(day.date)"
+                                :disabled="isHolidayDate(day.date) || getCellInfo(employee.id, day.date)?.hasFormation"
                                 @click="handleCellClick(employee, day.date)"
                             >
                                 <span v-if="!getCellInfo(employee.id, day.date)?.halfLabel">
@@ -67,6 +67,13 @@
                                         {{ getCellInfo(employee.id, day.date)?.code }}
                                     </span>
                                 </template>
+                                <Icon
+                                    v-if="getCellInfo(employee.id, day.date)?.hasFormation && getCellInfo(employee.id, day.date)?.code !== 'F'"
+                                    name="mdi:school"
+                                    size="12"
+                                    class="absolute top-0 right-0 text-indigo-600 bg-white rounded-bl-md p-0.5"
+                                    title="Formation"
+                                />
                             </button>
                         </template>
                         <template v-else>
@@ -107,7 +114,7 @@ const props = defineProps<{
     visibleEmployees: Employee[]
     gridStyle: Record<string, string>
     getCellStyle: (employeeId: number, date: string) => Record<string, string> | undefined
-    getCellInfo: (employeeId: number, date: string) => { id: number; code: string; color: string; halfLabel?: HalfDay; textColor?: string } | null
+    getCellInfo: (employeeId: number, date: string) => { id: number; code: string; color: string; halfLabel?: HalfDay; textColor?: string; hasFormation?: boolean } | null
     formatEmployeeName: (employee: Employee) => string
     isHolidayDate: (date: string) => boolean
 }>()

frontend/components/EmployeeYearlyHoursDrawer.vue

@@ -0,0 +1,67 @@
+<template>
+    <AppDrawer v-model="drawerOpen" title="Export heures annuelles">
+        <form class="space-y-4" @submit.prevent="handleSubmit">
+            <div>
+                <label class="text-md font-semibold text-neutral-700" for="yearly-hours-year">
+                    Année <span class="text-red-600">*</span>
+                </label>
+                <select
+                    id="yearly-hours-year"
+                    v-model="selectedYear"
+                    :class="selectFieldClass"
+                >
+                    <option v-for="y in years" :key="y" :value="y">{{ y }}</option>
+                </select>
+            </div>
+
+            <div class="flex justify-center pt-2">
+                <button
+                    type="submit"
+                    class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500"
+                >
+                    Imprimer
+                </button>
+            </div>
+        </form>
+    </AppDrawer>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from 'vue'
+import AppDrawer from '~/components/AppDrawer.vue'
+
+const props = defineProps<{
+    modelValue: boolean
+    employeeId: number
+}>()
+
+const emit = defineEmits<{
+    (event: 'update:modelValue', value: boolean): void
+    (event: 'submit', year: number): void
+}>()
+
+const drawerOpen = computed({
+    get: () => props.modelValue,
+    set: (value: boolean) => emit('update:modelValue', value)
+})
+
+const currentYear = new Date().getFullYear()
+const years = Array.from({ length: 6 }, (_, i) => currentYear - i)
+const selectedYear = ref(currentYear)
+
+const baseInputClass = 'mt-2 w-full rounded-md border px-3 py-2 text-md text-neutral-900'
+const selectFieldClass = computed(() => `${baseInputClass} border-neutral-300`)
+
+const handleSubmit = () => {
+    emit('submit', selectedYear.value)
+}
+
+watch(
+    () => props.modelValue,
+    (isOpen) => {
+        if (!isOpen) {
+            selectedYear.value = currentYear
+        }
+    }
+)
+</script>

frontend/components/documentation/DocumentationArticle.vue

@@ -0,0 +1,26 @@
+<template>
+    <article :id="`doc-${article.id}`" class="scroll-mt-6">
+        <h3 class="text-lg font-bold text-primary-500 mb-3">{{ article.title }}</h3>
+        <div class="space-y-3">
+            <template v-for="(block, idx) in article.blocks" :key="idx">
+                <p v-if="block.type === 'paragraph'" class="text-sm text-neutral-700 leading-relaxed">
+                    {{ block.content }}
+                </p>
+                <ul v-else-if="block.type === 'list'" class="list-disc list-inside space-y-1 text-sm text-neutral-700 pl-2">
+                    <li v-for="(item, i) in block.content.split('\n')" :key="i">{{ item }}</li>
+                </ul>
+                <div v-else-if="block.type === 'note'" class="bg-tertiary-500 border-l-4 border-primary-500 p-3 rounded-r-md">
+                    <p class="text-sm text-neutral-700 leading-relaxed">{{ block.content }}</p>
+                </div>
+            </template>
+        </div>
+    </article>
+</template>
+
+<script setup lang="ts">
+import type { DocArticle } from '~/types/documentation'
+
+defineProps<{
+    article: DocArticle
+}>()
+</script>

frontend/components/documentation/DocumentationPage.vue

@@ -0,0 +1,67 @@
+<template>
+    <div class="h-full flex gap-8">
+        <!-- Table des matières -->
+        <nav class="w-64 flex-shrink-0 overflow-y-auto pr-4 border-r border-neutral-200">
+            <h1 class="text-xl font-bold text-primary-500 mb-6">Documentation</h1>
+            <div v-for="section in visibleSections" :key="section.id" class="mb-4">
+                <div class="flex items-center gap-2 mb-1">
+                    <Icon :name="section.icon" size="18" class="text-neutral-500"/>
+                    <span class="text-sm font-semibold text-neutral-700">{{ section.title }}</span>
+                </div>
+                <ul class="pl-7 space-y-0.5">
+                    <li v-for="article in section.articles" :key="article.id">
+                        <button
+                            class="text-xs text-neutral-500 hover:text-primary-500 text-left w-full py-0.5 transition-colors"
+                            :class="activeArticleId === article.id ? 'text-primary-500 font-bold' : ''"
+                            @click="scrollToArticle(article.id)"
+                        >
+                            {{ article.title }}
+                        </button>
+                    </li>
+                </ul>
+            </div>
+        </nav>
+
+        <!-- Contenu -->
+        <div ref="contentRef" class="flex-1 overflow-y-auto pr-4">
+            <DocumentationSection
+                v-for="section in visibleSections"
+                :key="section.id"
+                :section="section"
+            />
+        </div>
+    </div>
+</template>
+
+<script setup lang="ts">
+const { visibleSections, activeArticleId, scrollToArticle } = useDocumentation()
+const contentRef = ref<HTMLElement | null>(null)
+
+onMounted(() => {
+    if (!contentRef.value) return
+
+    const observer = new IntersectionObserver(
+        (entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting) {
+                    const id = entry.target.id.replace('doc-', '')
+                    activeArticleId.value = id
+                    break
+                }
+            }
+        },
+        {
+            root: contentRef.value,
+            rootMargin: '-10% 0px -80% 0px',
+            threshold: 0,
+        },
+    )
+
+    nextTick(() => {
+        const articles = contentRef.value?.querySelectorAll('[id^="doc-"]')
+        articles?.forEach(el => observer.observe(el))
+    })
+
+    onUnmounted(() => observer.disconnect())
+})
+</script>

frontend/components/documentation/DocumentationSection.vue

@@ -0,0 +1,23 @@
+<template>
+    <section class="mb-10">
+        <div class="flex items-center gap-3 border-b-2 border-primary-500 pb-3 mb-6">
+            <Icon :name="section.icon" size="28" class="text-primary-500"/>
+            <h2 class="text-xl font-bold text-primary-500">{{ section.title }}</h2>
+        </div>
+        <div class="space-y-8 pl-2">
+            <DocumentationArticle
+                v-for="article in section.articles"
+                :key="article.id"
+                :article="article"
+            />
+        </div>
+    </section>
+</template>
+
+<script setup lang="ts">
+import type { DocSection } from '~/types/documentation'
+
+defineProps<{
+    section: DocSection
+}>()
+</script>

frontend/components/driver-hours/DriverHoursDayView.vue

@@ -25,19 +25,7 @@
               @change="onBulkValidationChange"
           />
         </span>
-                <span v-else-if="isSiteManager" class="inline-flex items-center gap-2">
-          <span>Site</span>
-          <input
-              ref="bulkSiteValidationInput"
-              :checked="isBulkSiteValidationChecked"
-              type="checkbox"
-              class="h-4 w-4"
-              :class="canBulkToggleSiteValidation ? 'cursor-pointer' : 'cursor-not-allowed opacity-50'"
-              :disabled="!canBulkToggleSiteValidation"
-              @change="onBulkSiteValidationChange"
-          />
-        </span>
-                <span v-else>Site <Icon name="mdi:check-bold" class="ml-1"/></span>
+                <span v-else-if="!isSiteManager">Site <Icon name="mdi:check-bold" class="ml-1"/></span>
                 <span v-if="!isAdmin">RH <Icon name="mdi:check-bold" class="ml-1"/></span>
             </div>
 
@@ -68,19 +56,30 @@
                         </p>
                     </div>
                     <div class="pl-2 min-w-0 self-stretch flex flex-col gap-1 justify-between py-0.5">
-                        <p
-                            class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate"
-                            :class="getRowAbsenceLabel(employee.id) ? 'text-white' : 'invisible'"
-                            :title="getRowAbsenceLabel(employee.id) || ''"
-                            :style="getRowAbsenceStyle(employee.id)"
-                        >
-                            {{ getRowAbsenceLabel(employee.id) || '—' }}
-                        </p>
+                        <div class="flex flex-col gap-1 min-w-0">
+                            <p
+                                class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate"
+                                :class="getRowAbsenceLabel(employee.id) ? 'text-white' : 'invisible'"
+                                :title="getRowAbsenceLabel(employee.id) || ''"
+                                :style="getRowAbsenceStyle(employee.id)"
+                            >
+                                {{ getRowAbsenceLabel(employee.id) || '—' }}
+                            </p>
+                            <p
+                                v-if="isHoliday"
+                                class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate text-sky-900 inline-flex items-center gap-1"
+                                style="background-color: #b3e5fc"
+                                :title="holidayLabel || 'Férié'"
+                            >
+                                <Icon name="mdi:calendar-star" size="14" class="shrink-0"/>
+                                <span class="truncate">{{ holidayLabel || 'Férié' }}</span>
+                            </p>
+                        </div>
                         <button
                             type="button"
                             class="self-start text-left text-xs font-semibold underline"
-                            :class="isHoliday || isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id) ? 'text-neutral-400 cursor-not-allowed' : 'text-primary-500 cursor-pointer'"
-                            :disabled="isHoliday || isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id)"
+                            :class="isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id) ? 'text-neutral-400 cursor-not-allowed' : 'text-primary-500 cursor-pointer'"
+                            :disabled="isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id)"
                             @click="onAbsenceClick(employee.id)"
                         >
                             Modifier
@@ -91,6 +90,12 @@
                             v-model="rows[employee.id].dayHours"
                             :disabled="!hasContractAtSelectedDate(employee.id) || isRowLocked(employee.id)"
                         />
+                        <p
+                            v-if="isHoliday && getRowMetrics(employee.id).virtualHolidayMinutes > 0"
+                            class="mt-1 text-xs font-semibold text-sky-700"
+                        >
+                            = {{ formatMinutes(getRowMetrics(employee.id).dayMinutes) }} (férié)
+                        </p>
                     </div>
                     <div class="pl-2">
                         <TimeSelect
@@ -147,16 +152,8 @@
                             @change="onToggleValidation(employee.id, ($event.target as HTMLInputElement).checked)"
                         />
                     </div>
-                    <div v-else class="text-right p-5">
-                        <input
-                            v-if="isSiteManager"
-                            :checked="rows[employee.id]?.isSiteValid ?? false"
-                            type="checkbox"
-                            class="h-4 w-4 cursor-pointer"
-                            :disabled="(!canToggleSiteValidation(employee.id) && !canCreateSiteValidationRowFromAbsence(employee.id)) || isSiteValidationPending(employee.id)"
-                            @change="onToggleSiteValidation(employee.id, ($event.target as HTMLInputElement).checked)"
-                        />
-                        <span v-else-if="rows[employee.id]?.isSiteValid" class="text-xs font-semibold text-neutral-700">Validé</span>
+                    <div v-else-if="!isSiteManager" class="text-right p-5">
+                        <span v-if="rows[employee.id]?.isSiteValid" class="text-xs font-semibold text-neutral-700">Validé</span>
                         <span v-else class="text-xs text-neutral-500">-</span>
                     </div>
                     <div v-if="!isAdmin">
@@ -184,6 +181,7 @@ const props = defineProps<{
     isSiteManager: boolean
     dayGridCols: string
     isHoliday: boolean
+    holidayLabel: string
     contractLabel: (employee: Employee) => string
     isRowLocked: (employeeId: number) => boolean
     hasContractAtSelectedDate: (employeeId: number) => boolean
@@ -201,7 +199,7 @@ const props = defineProps<{
     onToggleSiteValidation: (employeeId: number, checked: boolean) => void
     onToggleValidationBulk: (checked: boolean) => Promise<void> | void
     onToggleSiteValidationBulk: (checked: boolean) => Promise<void> | void
-    getRowMetrics: (employeeId: number) => { dayMinutes: number; nightMinutes: number; totalMinutes: number }
+    getRowMetrics: (employeeId: number) => { dayMinutes: number; nightMinutes: number; workshopMinutes: number; totalMinutes: number; virtualHolidayMinutes: number }
     getRowAbsenceLabel: (employeeId: number) => string
     getRowAbsenceStyle: (employeeId: number) => { backgroundColor: string } | undefined
     getRowUpdatedAt: (employeeId: number) => string

frontend/components/employees/ContractTab.vue

@@ -108,6 +108,13 @@
           <p v-if="showContractEndDateError" class="mt-1 text-sm text-red-600">La date de fin est obligatoire.</p>
         </div>
 
+        <WorkDaysHoursInput
+          v-if="contractForm.workDaysHours"
+          :model-value="contractForm.workDaysHours"
+          :contract-weekly-hours="contractForm.weeklyHours ?? null"
+          disabled
+        />
+
         <div>
           <label class="text-md font-semibold text-neutral-700" for="contract-comment">
             Commentaire
@@ -252,7 +259,13 @@
           </label>
         </div>
 
-        <div class="flex justify-center pt-2">
+        <WorkDaysHoursInput
+          v-if="requiresCreateWorkDaysHours"
+          v-model="createContractForm.workDaysHours"
+          :contract-weekly-hours="selectedCreateContract?.weeklyHours ?? null"
+        />
+
+        <div class="sticky bottom-0 -mx-[20px] bg-white px-[20px] py-3 flex justify-center">
           <button
             type="submit"
             class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:cursor-not-allowed disabled:opacity-50"
@@ -269,6 +282,7 @@
 <script setup lang="ts">
 import type { Contract } from '~/services/dto/contract'
 import type { ContractHistoryItem } from '~/services/dto/employee'
+import WorkDaysHoursInput from '~/components/employees/WorkDaysHoursInput.vue'
 
 type SuspensionForm = {
   id: number | null
@@ -286,6 +300,7 @@ type ContractForm = {
   endDate: string
   paidLeaveSettled: boolean
   comment: string
+  workDaysHours: Record<number, number> | null
 }
 
 type CreateContractForm = {
@@ -294,6 +309,7 @@ type CreateContractForm = {
   startDate: string
   endDate: string
   isDriver: boolean
+  workDaysHours: Record<number, number> | null
 }
 
 const props = defineProps<{
@@ -322,6 +338,8 @@ const props = defineProps<{
   requiresCreateContractEndDate: boolean
   createContractEndDateFieldClass: string
   isCreateContractFormValid: boolean
+  requiresCreateWorkDaysHours: boolean
+  selectedCreateContract: Contract | null
   onOpenCloseContractDrawer: () => void
   onOpenCreateContractDrawer: () => void
   onUpdateContractDrawerOpen: (open: boolean) => void

frontend/components/employees/FormationTab.vue

@@ -0,0 +1,251 @@
+<template>
+    <section class="mt-8">
+        <div class="overflow-hidden bg-white">
+            <div
+                class="grid grid-cols-4 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md">
+                <p>Date de début</p>
+                <p>Date de fin</p>
+                <p>Justificatif</p>
+                <p>Commentaire</p>
+            </div>
+            <div v-if="formations.length === 0" class="px-6 py-4 text-[20px] font-bold text-primary-500 border-x border-b border-primary-500 rounded-b-md">
+                Aucune formation.
+            </div>
+            <div v-else class="border-x border-b border-primary-500 rounded-b-md">
+                <div
+                    v-for="item in formations"
+                    :key="item.id"
+                    class="grid grid-cols-4 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0 cursor-pointer hover:bg-tertiary-500"
+                    @click="onOpenEditDrawer(item)"
+                >
+                    <p>{{ formatDate(item.startDate) }}</p>
+                    <p>{{ formatDate(item.endDate) }}</p>
+                    <p class="min-w-0">
+                        <a
+                            v-if="item.justificatifPath"
+                            :href="getFormationJustificatifUrl(props.apiBase, item.id)"
+                            target="_blank"
+                            class="text-primary-500 hover:text-secondary-500 flex gap-2 items-center"
+                            @click.stop
+                        >
+                            <Icon name="mdi:file-download-outline" size="20" class="shrink-0"/>
+                            <span class="truncate">{{ item.justificatifName ?? 'Télécharger' }}</span>
+                        </a>
+                        <span v-else>-</span>
+                    </p>
+                    <p class="truncate">{{ item.comment ?? '-' }}</p>
+                </div>
+            </div>
+        </div>
+        <div class="flex justify-center mb-4 mt-8">
+            <button
+                type="button"
+                class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md text-white disabled:cursor-not-allowed disabled:opacity-50"
+                @click="onOpenCreateDrawer"
+            >
+                + Ajouter
+            </button>
+        </div>
+
+        <AppDrawer v-model="isDrawerOpen" title="Formation">
+            <form class="space-y-4" @submit.prevent="onSubmit">
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="formation-start-date">
+                        Date de début <span class="text-red-600">*</span>
+                    </label>
+                    <input
+                        id="formation-start-date"
+                        v-model="form.startDate"
+                        type="date"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                    />
+                </div>
+
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="formation-end-date">
+                        Date de fin <span class="text-red-600">*</span>
+                    </label>
+                    <input
+                        id="formation-end-date"
+                        v-model="form.endDate"
+                        type="date"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                    />
+                    <p v-if="isDateRangeInvalid" class="mt-1 text-sm text-red-600">La date de fin doit être postérieure ou égale à la date de début.</p>
+                </div>
+
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="formation-justificatif">
+                        Justificatif
+                    </label>
+                    <div v-if="isEditing && editingItem?.justificatifName" class="mt-1 text-sm text-neutral-500">
+                        Fichier actuel : {{ editingItem.justificatifName }}
+                    </div>
+                    <input
+                        id="formation-justificatif"
+                        ref="justificatifInput"
+                        type="file"
+                        accept="application/pdf"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 file:mr-3 file:rounded file:border-0 file:bg-primary-500 file:px-3 file:py-1 file:text-sm file:text-white"
+                        @change="onJustificatifChange"
+                    />
+                    <p v-if="justificatifError" class="mt-1 text-sm text-red-600">{{ justificatifError }}</p>
+                    <p v-else class="mt-1 text-sm text-neutral-500">Fichier au format pdf</p>
+                </div>
+
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="formation-comment">
+                        Commentaire
+                    </label>
+                    <textarea
+                        id="formation-comment"
+                        v-model="form.comment"
+                        rows="3"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                        placeholder="Commentaire..."
+                    />
+                </div>
+
+                <div v-if="isEditing" class="grid grid-cols-2 gap-3 pt-2">
+                    <button
+                        type="button"
+                        class="flex items-center justify-center rounded-md bg-red-500 px-4 py-2 text-md font-semibold text-white hover:bg-red-600"
+                        @click="onDelete"
+                    >
+                        Supprimer
+                    </button>
+                    <button
+                        type="submit"
+                        class="flex items-center justify-center rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:cursor-not-allowed disabled:opacity-50"
+                        :disabled="!isFormValid"
+                    >
+                        Modifier
+                    </button>
+                </div>
+                <div v-else class="flex justify-center pt-2">
+                    <button
+                        type="submit"
+                        class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:cursor-not-allowed disabled:opacity-50"
+                        :disabled="!isFormValid"
+                    >
+                        + Ajouter
+                    </button>
+                </div>
+            </form>
+        </AppDrawer>
+    </section>
+</template>
+
+<script setup lang="ts">
+import type {Formation} from '~/services/dto/formation'
+import {getFormationJustificatifUrl} from '~/services/formations'
+import AppDrawer from '~/components/AppDrawer.vue'
+
+const props = defineProps<{
+    formations: Formation[]
+    apiBase: string
+}>()
+
+const emit = defineEmits<{
+    (event: 'create', data: { startDate: string; endDate: string; comment?: string }, justificatifFile?: File): void
+    (event: 'update', id: number, data: { startDate: string; endDate: string; comment?: string }, justificatifFile?: File): void
+    (event: 'delete', id: number): void
+}>()
+
+const isDrawerOpen = ref(false)
+const isEditing = ref(false)
+const editingItem = ref<Formation | null>(null)
+const selectedJustificatif = ref<File | undefined>(undefined)
+const justificatifInput = ref<HTMLInputElement | null>(null)
+const justificatifError = ref('')
+
+const form = reactive({
+    startDate: '',
+    endDate: '',
+    comment: ''
+})
+
+const isDateRangeInvalid = computed(() => {
+    if (!form.startDate || !form.endDate) return false
+    return form.endDate < form.startDate
+})
+
+const isFormValid = computed(() => {
+    return Boolean(form.startDate) && Boolean(form.endDate) && !isDateRangeInvalid.value && !justificatifError.value
+})
+
+const formatDate = (dateStr: string): string => {
+    if (!dateStr) return '-'
+    const date = new Date(dateStr)
+    if (Number.isNaN(date.getTime())) return dateStr
+    return date.toLocaleDateString('fr-FR')
+}
+
+const resetForm = () => {
+    form.startDate = ''
+    form.endDate = ''
+    form.comment = ''
+    selectedJustificatif.value = undefined
+    justificatifError.value = ''
+    if (justificatifInput.value) {
+        justificatifInput.value.value = ''
+    }
+}
+
+const onOpenCreateDrawer = () => {
+    isEditing.value = false
+    editingItem.value = null
+    resetForm()
+    isDrawerOpen.value = true
+}
+
+const onOpenEditDrawer = (item: Formation) => {
+    isEditing.value = true
+    editingItem.value = item
+    form.startDate = item.startDate
+    form.endDate = item.endDate
+    form.comment = item.comment ?? ''
+    selectedJustificatif.value = undefined
+    justificatifError.value = ''
+    if (justificatifInput.value) {
+        justificatifInput.value.value = ''
+    }
+    isDrawerOpen.value = true
+}
+
+const onJustificatifChange = (event: Event) => {
+    const target = event.target as HTMLInputElement
+    const file = target.files?.[0]
+    if (file && file.type !== 'application/pdf') {
+        justificatifError.value = 'Seuls les fichiers PDF sont acceptés.'
+        selectedJustificatif.value = undefined
+        target.value = ''
+        return
+    }
+    justificatifError.value = ''
+    selectedJustificatif.value = file ?? undefined
+}
+
+const onSubmit = () => {
+    const data = {
+        startDate: form.startDate,
+        endDate: form.endDate,
+        comment: form.comment || undefined
+    }
+
+    if (isEditing.value && editingItem.value) {
+        emit('update', editingItem.value.id, data, selectedJustificatif.value)
+    } else {
+        emit('create', data, selectedJustificatif.value)
+    }
+    isDrawerOpen.value = false
+}
+
+const onDelete = () => {
+    if (!editingItem.value) return
+    const ok = window.confirm('Supprimer cette formation ?')
+    if (!ok) return
+    emit('delete', editingItem.value.id)
+    isDrawerOpen.value = false
+}
+</script>

frontend/components/employees/LeaveTab.vue

@@ -32,6 +32,18 @@
             <p v-if="isForfaitRule" class="col-start-3 p-[10px] border-r-primary-500 bg-primary-500 text-white"><span class="uppercase font-semibold">Reste à prendre :</span>
                 {{ formatCount(summary?.previousYearRemainingDays) }} Jours
             </p>
+            <div v-if="isForfaitRule" class="col-start-4 p-[10px] flex gap-7 items-center">
+                <div>
+                    <span class="uppercase font-semibold">Année n-1 payés : </span>
+                    <span> {{ formatCount(summary?.previousYearPaidDays) }} Jours</span>
+                </div>
+                <button
+                    class="flex items-center"
+                    @click="openPaidLeaveDrawer"
+                >
+                    <Icon name="mdi:edit-box" size="24"/>
+                </button>
+            </div>
             <div v-if="!isForfaitRule" class="col-start-4 p-[10px] flex gap-7 items-center">
                 <div>
                     <span class="uppercase font-semibold">Fractionné acquis : </span>
@@ -112,6 +124,39 @@
                 </div>
             </form>
         </AppDrawer>
+        <AppDrawer v-model="isPaidLeaveDrawerOpen" title="Congés N-1 payés">
+            <form class="space-y-4" @submit.prevent="handleSubmitPaidLeave">
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="paid-leave-days">
+                        Nombre de jours <span class="text-red-600">*</span>
+                    </label>
+                    <input
+                        id="paid-leave-days"
+                        v-model="paidLeaveForm.days"
+                        type="number"
+                        step="0.5"
+                        min="0"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-md text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                    />
+                </div>
+
+                <div class="flex justify-end gap-3 pt-2">
+                    <button
+                        type="button"
+                        class="rounded-lg border border-neutral-200 px-4 py-2 text-md font-semibold text-neutral-700 hover:bg-neutral-100"
+                        @click="isPaidLeaveDrawerOpen = false"
+                    >
+                        Annuler
+                    </button>
+                    <button
+                        type="submit"
+                        class="rounded-lg bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500"
+                    >
+                        Enregistrer
+                    </button>
+                </div>
+            </form>
+        </AppDrawer>
     </section>
 </template>
 
@@ -136,11 +181,15 @@ const props = defineProps<{
 
 const emit = defineEmits<{
     (event: 'update-fractioned-days', days: number): void
+    (event: 'update-paid-leave-days', days: number): void
 }>()
 
 const isFractionedDrawerOpen = ref(false)
 const fractionedForm = reactive({days: 0})
 
+const isPaidLeaveDrawerOpen = ref(false)
+const paidLeaveForm = reactive({days: 0})
+
 const openFractionedDrawer = () => {
     fractionedForm.days = props.summary?.fractionedDays ?? 0
     isFractionedDrawerOpen.value = true
@@ -153,6 +202,18 @@ const handleSubmitFractioned = () => {
     isFractionedDrawerOpen.value = false
 }
 
+const openPaidLeaveDrawer = () => {
+    paidLeaveForm.days = props.summary?.previousYearPaidDays ?? 0
+    isPaidLeaveDrawerOpen.value = true
+}
+
+const handleSubmitPaidLeave = () => {
+    const value = Number(paidLeaveForm.days)
+    if (Number.isNaN(value) || value < 0) return
+    emit('update-paid-leave-days', value)
+    isPaidLeaveDrawerOpen.value = false
+}
+
 const monthLabels = [
     'Janvier',
     'Fevrier',

frontend/components/employees/ObservationTab.vue

@@ -0,0 +1,187 @@
+<template>
+    <section class="mt-8">
+        <div class="overflow-hidden bg-white">
+            <div
+                class="grid grid-cols-2 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md">
+                <p>Mois</p>
+                <p>Observation</p>
+            </div>
+            <div v-if="observations.length === 0" class="px-6 py-4 text-[20px] font-bold text-primary-500 border-x border-b border-primary-500 rounded-b-md">
+                Aucune observation.
+            </div>
+            <div v-else class="border-x border-b border-primary-500 rounded-b-md">
+                <div
+                    v-for="item in observations"
+                    :key="item.id"
+                    class="grid grid-cols-2 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0 cursor-pointer hover:bg-tertiary-500"
+                    @click="onOpenEditDrawer(item)"
+                >
+                    <p>{{ formatMonth(item.month) }}</p>
+                    <p class="truncate">{{ item.content }}</p>
+                </div>
+            </div>
+        </div>
+        <div class="flex justify-center mb-4 mt-8">
+            <button
+                type="button"
+                class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md text-white disabled:cursor-not-allowed disabled:opacity-50"
+                @click="onOpenCreateDrawer"
+            >
+                + Ajouter
+            </button>
+        </div>
+
+        <AppDrawer v-model="isDrawerOpen" :title="isEditing ? 'Modification observation' : 'Nouvelle observation'">
+            <form class="space-y-4" @submit.prevent="onSubmit">
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="observation-month">
+                        Mois <span class="text-red-600">*</span>
+                    </label>
+                    <input
+                        id="observation-month"
+                        v-model="form.month"
+                        type="month"
+                        class="capitalize mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                    />
+                </div>
+
+                <div>
+                    <label class="text-md font-semibold text-neutral-700" for="observation-content">
+                        Observation <span class="text-red-600">*</span>
+                    </label>
+                    <textarea
+                        id="observation-content"
+                        v-model="form.content"
+                        rows="5"
+                        class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-base text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+                        placeholder="Observation..."
+                    />
+                </div>
+
+                <div v-if="isEditing" class="grid grid-cols-2 gap-3 pt-2">
+                    <button
+                        type="button"
+                        class="flex items-center justify-center rounded-md bg-red-500 px-4 py-2 text-md font-semibold text-white hover:bg-red-600"
+                        @click="onDelete"
+                    >
+                        Supprimer
+                    </button>
+                    <button
+                        type="submit"
+                        class="flex items-center justify-center rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:cursor-not-allowed disabled:opacity-50"
+                        :disabled="!isFormValid"
+                    >
+                        Modifier
+                    </button>
+                </div>
+                <div v-else class="flex justify-center pt-2">
+                    <button
+                        type="submit"
+                        class="flex w-[200px] items-center justify-center gap-2 rounded-md bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:cursor-not-allowed disabled:opacity-50"
+                        :disabled="!isFormValid"
+                    >
+                        + Ajouter
+                    </button>
+                </div>
+            </form>
+        </AppDrawer>
+    </section>
+</template>
+
+<script setup lang="ts">
+import type { Observation } from '~/services/dto/observation'
+import AppDrawer from '~/components/AppDrawer.vue'
+
+const props = defineProps<{
+    observations: Observation[]
+}>()
+
+const emit = defineEmits<{
+    (event: 'create', data: { month: string; content: string }): void
+    (event: 'update', id: number, data: { month: string; content: string }): void
+    (event: 'delete', id: number): void
+}>()
+
+const isDrawerOpen = ref(false)
+const isEditing = ref(false)
+const editingItem = ref<Observation | null>(null)
+
+const currentYearMonth = () => {
+    const now = new Date()
+    return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`
+}
+
+const form = reactive({
+    month: currentYearMonth(),
+    content: ''
+})
+
+const isFormValid = computed(() => {
+    return form.month && form.content.trim().length > 0
+})
+
+const monthLabels: Record<number, string> = {
+    1: 'Janvier',
+    2: 'Février',
+    3: 'Mars',
+    4: 'Avril',
+    5: 'Mai',
+    6: 'Juin',
+    7: 'Juillet',
+    8: 'Août',
+    9: 'Septembre',
+    10: 'Octobre',
+    11: 'Novembre',
+    12: 'Décembre'
+}
+
+const formatMonth = (dateStr: string): string => {
+    const date = new Date(dateStr)
+    if (Number.isNaN(date.getTime())) return dateStr
+    const month = date.getMonth() + 1
+    const year = date.getFullYear()
+    return `${monthLabels[month]} ${year}`
+}
+
+const resetForm = () => {
+    form.month = currentYearMonth()
+    form.content = ''
+}
+
+const onOpenCreateDrawer = () => {
+    isEditing.value = false
+    editingItem.value = null
+    resetForm()
+    isDrawerOpen.value = true
+}
+
+const onOpenEditDrawer = (item: Observation) => {
+    isEditing.value = true
+    editingItem.value = item
+    form.month = item.month.substring(0, 7)
+    form.content = item.content
+    isDrawerOpen.value = true
+}
+
+const onSubmit = () => {
+    const data = {
+        month: `${form.month}-01`,
+        content: form.content
+    }
+
+    if (isEditing.value && editingItem.value) {
+        emit('update', editingItem.value.id, data)
+    } else {
+        emit('create', data)
+    }
+    isDrawerOpen.value = false
+}
+
+const onDelete = () => {
+    if (!editingItem.value) return
+    const ok = window.confirm('Supprimer cette observation ?')
+    if (!ok) return
+    emit('delete', editingItem.value.id)
+    isDrawerOpen.value = false
+}
+</script>

frontend/components/employees/RttTab.vue

@@ -30,7 +30,7 @@
                 class="rounded-md bg-primary-500 px-8 py-2 font-bold text-white hover:bg-primary-600"
                 @click="openPaymentDrawer"
             >
-                + Payer les RRT
+                + Payer les RTT
             </button>
         </div>
     </div>

frontend/components/hours/HoursDayView.vue

@@ -26,19 +26,7 @@
               @change="onBulkValidationChange"
           />
         </span>
-                <span v-else-if="isSiteManager" class="inline-flex items-center gap-2">
-          <span>Site</span>
-          <input
-              ref="bulkSiteValidationInput"
-              :checked="isBulkSiteValidationChecked"
-              type="checkbox"
-              class="h-4 w-4"
-              :class="canBulkToggleSiteValidation ? 'cursor-pointer' : 'cursor-not-allowed opacity-50'"
-              :disabled="!canBulkToggleSiteValidation"
-              @change="onBulkSiteValidationChange"
-          />
-        </span>
-                <span v-else>Site <Icon name="mdi:check-bold" class="ml-1"/></span>
+                <span v-else-if="!isSiteManager">Site <Icon name="mdi:check-bold" class="ml-1"/></span>
                 <span v-if="!isAdmin">RH  <Icon name="mdi:check-bold" class="ml-1"/></span>
             </div>
 
@@ -69,19 +57,39 @@
                     </p>
                 </div>
                 <div class="pl-2 min-w-0 self-stretch flex flex-col gap-1 justify-between py-0.5">
-                    <p
-                        class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate"
-                        :class="getRowAbsenceLabel(employee.id) ? 'text-white' : 'invisible'"
-                        :title="getRowAbsenceLabel(employee.id) || ''"
-                        :style="getRowAbsenceStyle(employee.id)"
-                    >
-                        {{ getRowAbsenceLabel(employee.id) || '—' }}
-                    </p>
+                    <div class="flex flex-col gap-1 min-w-0">
+                        <p
+                            class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate"
+                            :class="getRowAbsenceLabel(employee.id) ? 'text-white' : 'invisible'"
+                            :title="getRowAbsenceLabel(employee.id) || ''"
+                            :style="getRowAbsenceStyle(employee.id)"
+                        >
+                            {{ getRowAbsenceLabel(employee.id) || '—' }}
+                        </p>
+                        <p
+                            v-if="isHoliday"
+                            class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate text-sky-900 inline-flex items-center gap-1"
+                            style="background-color: #b3e5fc"
+                            :title="holidayLabel || 'Férié'"
+                        >
+                            <Icon name="mdi:calendar-star" size="14" class="shrink-0"/>
+                            <span class="truncate">{{ holidayLabel || 'Férié' }}</span>
+                        </p>
+                        <p
+                            v-if="hasRowFormation(employee.id)"
+                            class="w-full min-w-0 rounded-md px-2 py-1 text-xs truncate text-white bg-indigo-500 inline-flex items-center gap-1"
+                            :title="getRowFormationLabel(employee.id)"
+                        >
+                            <Icon name="mdi:school-outline" size="14" class="shrink-0"/>
+                            <span class="truncate">{{ getRowFormationLabel(employee.id) }}</span>
+                        </p>
+                    </div>
                     <button
+                        v-if="!hasRowFormation(employee.id)"
                         type="button"
                         class="self-start text-left text-xs font-semibold underline"
-                        :class="isHoliday || isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id) ? 'text-neutral-400 cursor-not-allowed' : 'text-primary-500 cursor-pointer'"
-                        :disabled="isHoliday || isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id)"
+                        :class="isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id) ? 'text-neutral-400 cursor-not-allowed' : 'text-primary-500 cursor-pointer'"
+                        :disabled="isRowLocked(employee.id) || !hasContractAtSelectedDate(employee.id)"
                         @click="onAbsenceClick(employee.id)"
                     >
                         Modifier
@@ -170,16 +178,8 @@
                         @change="onToggleValidation(employee.id, ($event.target as HTMLInputElement).checked)"
                     />
                 </div>
-                <div v-else class="text-right p-5">
-                    <input
-                        v-if="isSiteManager"
-                        :checked="rows[employee.id]?.isSiteValid ?? false"
-                        type="checkbox"
-                        class="h-4 w-4 cursor-pointer"
-                        :disabled="(!canToggleSiteValidation(employee.id) && !canCreateSiteValidationRowFromAbsence(employee.id)) || isSiteValidationPending(employee.id)"
-                        @change="onToggleSiteValidation(employee.id, ($event.target as HTMLInputElement).checked)"
-                    />
-                    <span v-else-if="rows[employee.id]?.isSiteValid" class="text-xs font-semibold text-neutral-700">Validé</span>
+                <div v-else-if="!isSiteManager" class="text-right p-5">
+                    <span v-if="rows[employee.id]?.isSiteValid" class="text-xs font-semibold text-neutral-700">Validé</span>
                     <span v-else class="text-xs text-neutral-500">-</span>
                 </div>
                 <div v-if="!isAdmin">
@@ -207,6 +207,7 @@ const props = defineProps<{
     isSiteManager: boolean
     dayGridCols: string
     isHoliday: boolean
+    holidayLabel: string
     contractLabel: (employee: Employee) => string
     isTimeTracking: (employee: Employee) => boolean
     isPresenceTracking: (employee: Employee) => boolean
@@ -228,9 +229,11 @@ const props = defineProps<{
     onToggleSiteValidation: (employeeId: number, checked: boolean) => void
     onToggleValidationBulk: (checked: boolean) => Promise<void> | void
     onToggleSiteValidationBulk: (checked: boolean) => Promise<void> | void
-    getRowMetrics: (employeeId: number) => { dayMinutes: number; nightMinutes: number; totalMinutes: number }
+    getRowMetrics: (employeeId: number) => { dayMinutes: number; nightMinutes: number; totalMinutes: number; virtualHolidayMinutes: number }
     getRowAbsenceLabel: (employeeId: number) => string
     getRowAbsenceStyle: (employeeId: number) => { backgroundColor: string } | undefined
+    hasRowFormation: (employeeId: number) => boolean
+    getRowFormationLabel: (employeeId: number) => string
     getRowUpdatedAt: (employeeId: number) => string
     getPresenceDayValue: (employeeId: number) => string
     onAbsenceClick: (employeeId: number) => void

frontend/composables/useDocumentation.ts

@@ -0,0 +1,39 @@
+import { documentationSections } from '~/data/documentation-content'
+import type { DocAccessLevel, DocSection } from '~/types/documentation'
+
+const LEVEL_HIERARCHY: Record<DocAccessLevel, number> = {
+  employee: 0,
+  site_manager: 1,
+  admin: 2,
+}
+
+function getUserLevel(roles: string[]): number {
+  if (roles.includes('ROLE_ADMIN') || roles.includes('ROLE_SUPER_ADMIN')) return 2
+  if (roles.includes('ROLE_USER')) return 1
+  return 0
+}
+
+export function useDocumentation() {
+  const auth = useAuthStore()
+  const userLevel = computed(() => getUserLevel(auth.user?.roles ?? []))
+
+  const visibleSections = computed<DocSection[]>(() => {
+    return documentationSections
+      .filter(s => LEVEL_HIERARCHY[s.requiredLevel] <= userLevel.value)
+      .map(s => ({
+        ...s,
+        articles: s.articles.filter(a => LEVEL_HIERARCHY[a.requiredLevel] <= userLevel.value),
+      }))
+      .filter(s => s.articles.length > 0)
+  })
+
+  const activeArticleId = ref<string | null>(null)
+
+  const scrollToArticle = (articleId: string) => {
+    activeArticleId.value = articleId
+    const el = document.getElementById(`doc-${articleId}`)
+    el?.scrollIntoView({ behavior: 'smooth', block: 'start' })
+  }
+
+  return { visibleSections, activeArticleId, scrollToArticle }
+}

frontend/composables/useDriverHoursPage.ts

@@ -71,7 +71,7 @@ export const useDriverHoursPage = () => {
 
   const dayGridCols = computed(() => {
     const metricCol = '0.4fr'
-    const validationCols = isAdmin.value ? `${metricCol}` : `${metricCol} ${metricCol}`
+    const validationCols = isAdmin.value || isSiteManager.value ? `${metricCol}` : `${metricCol} ${metricCol}`
     return `1.2fr 0.6fr 0.8fr 0.8fr 0.8fr ${metricCol} ${metricCol} ${metricCol} ${metricCol} ${metricCol} ${validationCols}`
   })
 
@@ -368,12 +368,23 @@ export const useDriverHoursPage = () => {
 
   const getRowMetrics = (employeeId: number) => {
     const row = rows.value[employeeId] ?? emptyRow()
-    const credited = dayContextByEmployeeId.value.get(employeeId)?.creditedMinutes ?? 0
-    const dayMinutes = toMinutes(row.dayHours) + credited
+    const dayRow = dayContextByEmployeeId.value.get(employeeId)
+    const credited = dayRow?.creditedMinutes ?? 0
+    let dayMinutes = toMinutes(row.dayHours) + credited
     const nightMinutes = toMinutes(row.nightHours)
     const workshopMinutes = toMinutes(row.workshopHours)
-    const totalMinutes = dayMinutes + nightMinutes + workshopMinutes
-    return { dayMinutes, nightMinutes, workshopMinutes, totalMinutes }
+    let totalMinutes = dayMinutes + nightMinutes + workshopMinutes
+
+    // Virtual holiday credit: backend already applies the contract-period
+    // schedule and absence-override rule; consume the value as-is.
+    const virtualHolidayMinutes = dayRow?.virtualHolidayMinutes ?? 0
+    if (virtualHolidayMinutes > totalMinutes) {
+      const delta = virtualHolidayMinutes - totalMinutes
+      dayMinutes += delta
+      totalMinutes = virtualHolidayMinutes
+    }
+
+    return { dayMinutes, nightMinutes, workshopMinutes, totalMinutes, virtualHolidayMinutes }
   }
 
   const getRowAbsenceLabel = (employeeId: number) => {
@@ -381,7 +392,6 @@ export const useDriverHoursPage = () => {
     if (dayRow && dayRow.hasContractAtDate === false) {
       return 'Contrat non démarré'
     }
-    if (isSelectedDateHoliday.value) return 'Férié'
     if (!dayRow?.absenceLabel) return ''
     if (dayRow.absenceHalf === 'AM' || dayRow.absenceHalf === 'PM') {
       const halfLabel = dayRow.absenceHalf === 'AM' ? 'Matin' : 'ap.-m.'
@@ -467,7 +477,6 @@ export const useDriverHoursPage = () => {
 
   const openAbsenceDrawer = (employeeId: number) => {
     if (!hasContractAtSelectedDate(employeeId)) return
-    if (isSelectedDateHoliday.value) return
 
     const existing = absences.value.find((absence) => {
       if (absence.employee?.id !== employeeId) return false
@@ -941,6 +950,7 @@ export const useDriverHoursPage = () => {
     saveButtonClass,
     formattedSelectedDate,
     isSelectedDateHoliday,
+    selectedHolidayLabel,
     weekDayHeaders,
     shortcutButtonClass,
     weekShortcutButtonClass,

frontend/composables/useEmployeeContract.ts

@@ -5,7 +5,7 @@ import { listContracts } from '~/services/contracts'
 import { updateEmployee } from '~/services/employees'
 import { createSuspension, updateSuspension } from '~/services/contractSuspensions'
 import { formatNullableYmdToFr, getTodayYmd, shiftYmd } from '~/utils/date'
-import { contractNatureLabel, isContractNature, requiresContractEndDate, showsContractEndDate } from '~/utils/contract'
+import { contractNatureLabel, formatWorkDaysHoursSummary, isContractNature, requiresContractEndDate, requiresWorkDaysHours, showsContractEndDate } from '~/utils/contract'
 
 type SuspensionForm = {
   id: number | null
@@ -32,7 +32,8 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     startDate: '',
     endDate: '',
     paidLeaveSettled: false,
-    comment: ''
+    comment: '',
+    workDaysHours: null as Record<number, number> | null
   })
 
   const validationTouched = reactive({
@@ -44,7 +45,8 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     contractNature: 'CDI' as 'CDI' | 'CDD' | 'INTERIM',
     startDate: '',
     endDate: '',
-    isDriver: false
+    isDriver: false,
+    workDaysHours: null as Record<number, number> | null
   })
 
   const createValidationTouched = reactive({
@@ -59,10 +61,11 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
   const formatDate = (value?: string | null) => formatNullableYmdToFr(value)
 
   const contractHistoryLabel = (item: ContractHistoryItem) => {
-    if (item.weeklyHours !== null && item.weeklyHours !== undefined) {
-      return `${item.weeklyHours} heures`
-    }
-    return item.contractName ?? '-'
+    const base = item.weeklyHours !== null && item.weeklyHours !== undefined
+      ? `${item.weeklyHours} heures`
+      : (item.contractName ?? '-')
+    const scheduleSummary = formatWorkDaysHoursSummary(item.workDaysHours)
+    return scheduleSummary ? `${base} (${scheduleSummary})` : base
   }
 
   const currentActiveContractPeriod = computed(() => {
@@ -71,6 +74,17 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     return history.find((item) => item.startDate <= today && (!item.endDate || item.endDate >= today)) ?? null
   })
 
+  const lastEndedContractPeriod = computed(() => {
+    if (currentActiveContractPeriod.value) return null
+    const today = getTodayYmd()
+    const history = employee.value?.contractHistory ?? []
+    const ended = history.filter((item) => item.endDate && item.endDate < today)
+    if (ended.length === 0) return null
+    return ended.reduce((latest, item) => (item.endDate! > latest.endDate! ? item : latest))
+  })
+
+  const editableContractPeriod = computed(() => currentActiveContractPeriod.value ?? lastEndedContractPeriod.value)
+
   const currentActiveContractPeriodId = computed<number | null>(() => {
     const period = currentActiveContractPeriod.value
     return period?.periodId ?? null
@@ -78,13 +92,15 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
 
   const canCloseCurrentContract = computed(() => {
     const active = currentActiveContractPeriod.value
-    if (!active) return false
-    if (!active.endDate) return true
-    return active.endDate > getTodayYmd()
+    if (active) {
+      if (!active.endDate) return true
+      return active.endDate > getTodayYmd()
+    }
+    return !!lastEndedContractPeriod.value
   })
 
   const canCreateContract = computed(() => {
-    const active = currentActiveContractPeriod.value
+    const active = editableContractPeriod.value
     if (!active) return true
     return !!active.endDate
   })
@@ -98,11 +114,27 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
   const isCreateContractNatureValid = computed(() => isContractNature(createContractForm.contractNature))
   const isCreateContractStartDateValid = computed(() => createContractForm.startDate !== '')
   const isCreateContractEndDateValid = computed(() => !requiresCreateContractEndDate.value || createContractForm.endDate !== '')
+  const selectedCreateContract = computed<Contract | null>(() =>
+    contracts.value.find((c) => c.id === Number(createContractForm.contractId)) ?? null
+  )
+  const requiresCreateWorkDaysHours = computed(() =>
+    requiresWorkDaysHours(selectedCreateContract.value, createContractForm.contractNature)
+  )
+  const createScheduleTotalMinutes = computed(() => {
+    const raw = createContractForm.workDaysHours ?? {}
+    return Object.values(raw).reduce((s, n) => s + (Number(n) || 0), 0)
+  })
+  const isCreateScheduleValid = computed(() => {
+    if (!requiresCreateWorkDaysHours.value) return true
+    const expected = (selectedCreateContract.value?.weeklyHours ?? 0) * 60
+    return expected > 0 && createScheduleTotalMinutes.value === expected
+  })
   const isCreateContractFormValid = computed(() =>
     isCreateContractValid.value &&
     isCreateContractNatureValid.value &&
     isCreateContractStartDateValid.value &&
-    isCreateContractEndDateValid.value
+    isCreateContractEndDateValid.value &&
+    isCreateScheduleValid.value
   )
 
   const baseInputClass =
@@ -135,17 +167,18 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
 
   const hydrateContractFormFromCurrent = () => {
     const current = employee.value
-    const active = currentActiveContractPeriod.value
-    if (!current || !active) return
+    const period = editableContractPeriod.value
+    if (!current || !period) return
 
-    contractForm.contractId = active.contractId ?? current.contract?.id ?? ''
-    contractForm.contractName = active.contractName ?? current.contract?.name ?? ''
-    contractForm.weeklyHours = active.weeklyHours ?? current.contract?.weeklyHours ?? null
-    contractForm.contractNature = active.contractNature
-    contractForm.startDate = active.startDate
-    contractForm.endDate = getTodayYmd()
+    contractForm.contractId = period.contractId ?? current.contract?.id ?? ''
+    contractForm.contractName = period.contractName ?? current.contract?.name ?? ''
+    contractForm.weeklyHours = period.weeklyHours ?? current.contract?.weeklyHours ?? null
+    contractForm.contractNature = period.contractNature
+    contractForm.startDate = period.startDate
+    contractForm.endDate = period.endDate ?? getTodayYmd()
     contractForm.paidLeaveSettled = false
     contractForm.comment = ''
+    contractForm.workDaysHours = period.workDaysHours ?? null
   }
 
   const openCloseContractDrawer = () => {
@@ -173,8 +206,9 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     createContractForm.contractNature = 'CDI'
     createContractForm.endDate = ''
     createContractForm.isDriver = false
-    createContractForm.startDate = currentActiveContractPeriod.value?.endDate
-      ? (shiftYmd(currentActiveContractPeriod.value.endDate, 1) ?? currentActiveContractPeriod.value.endDate)
+    createContractForm.workDaysHours = null
+    createContractForm.startDate = editableContractPeriod.value?.endDate
+      ? (shiftYmd(editableContractPeriod.value.endDate, 1) ?? editableContractPeriod.value.endDate)
       : getTodayYmd()
     resetCreateValidation()
     isCreateContractDrawerOpen.value = true
@@ -185,15 +219,16 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
   }
 
   const submitContractUpdate = async () => {
-    if (!employee.value || isContractSubmitting.value || !currentActiveContractPeriod.value) return
+    const period = editableContractPeriod.value
+    if (!employee.value || isContractSubmitting.value || !period) return
 
     validationTouched.endDate = true
     if (!isContractEndDateValid.value) return
 
-    if (contractForm.endDate < currentActiveContractPeriod.value.startDate) {
+    if (contractForm.endDate < period.startDate) {
       toast.error({
         title: 'Erreur',
-        message: `La date de fin doit être postérieure au ${formatDate(currentActiveContractPeriod.value.startDate)}.`
+        message: `La date de fin doit être postérieure au ${formatDate(period.startDate)}.`
       })
       return
     }
@@ -226,8 +261,8 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     createValidationTouched.endDate = true
     if (!isCreateContractFormValid.value) return
 
-    if (currentActiveContractPeriod.value?.endDate) {
-      const minStartDate = shiftYmd(currentActiveContractPeriod.value.endDate, 1) ?? currentActiveContractPeriod.value.endDate
+    if (editableContractPeriod.value?.endDate) {
+      const minStartDate = shiftYmd(editableContractPeriod.value.endDate, 1) ?? editableContractPeriod.value.endDate
       if (createContractForm.startDate < minStartDate) {
         toast.error({
           title: 'Erreur',
@@ -247,7 +282,8 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
         contractNature: createContractForm.contractNature,
         contractStartDate: createContractForm.startDate,
         contractEndDate: createContractForm.endDate || null,
-        isDriverInput: createContractForm.isDriver
+        isDriverInput: createContractForm.isDriver,
+        workDaysHoursInput: requiresCreateWorkDaysHours.value ? createContractForm.workDaysHours : null
       })
       isCreateContractDrawerOpen.value = false
       await reloadEmployee()
@@ -305,6 +341,12 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     }
   })
 
+  watch(requiresCreateWorkDaysHours, (required) => {
+    if (!required) {
+      createContractForm.workDaysHours = null
+    }
+  })
+
   return {
     contracts,
     contractHistory,
@@ -328,6 +370,8 @@ export const useEmployeeContract = (employee: Ref<Employee | null>, reloadEmploy
     requiresCreateContractEndDate,
     createContractEndDateFieldClass,
     isCreateContractFormValid,
+    requiresCreateWorkDaysHours,
+    selectedCreateContract,
     contractNatureLabel,
     contractHistoryLabel,
     formatDate,

frontend/composables/useEmployeeDetailPage.ts

@@ -6,7 +6,7 @@ export const useEmployeeDetailPage = () => {
   const route = useRoute()
   const employee = ref<Employee | null>(null)
   const isLoading = ref(false)
-  const activeTab = ref<'contract' | 'leave' | 'rtt' | 'mileage' | 'bonus'>('contract')
+  const activeTab = ref<'contract' | 'leave' | 'rtt' | 'mileage' | 'formation' | 'bonus' | 'observation'>('contract')
 
   const showLeaveTab = computed(() => employee.value?.currentContractNature !== 'INTERIM')
   const showRttTab = computed(() => employee.value?.contract?.type !== CONTRACT_TYPES.FORFAIT)
@@ -39,7 +39,9 @@ export const useEmployeeDetailPage = () => {
       leave.resetLoaded()
       rtt.resetLoaded()
       mileage.resetLoaded()
+      formation.resetLoaded()
       bonus.resetLoaded()
+      observation.resetLoaded()
 
       if (activeTab.value === 'leave' && showLeaveTab.value) {
         await leave.loadLeaveData()
@@ -47,8 +49,12 @@ export const useEmployeeDetailPage = () => {
         await rtt.loadRttData()
       } else if (activeTab.value === 'mileage') {
         await mileage.loadMileageData()
+      } else if (activeTab.value === 'formation') {
+        await formation.loadFormationData()
       } else if (activeTab.value === 'bonus') {
         await bonus.loadBonusData()
+      } else if (activeTab.value === 'observation') {
+        await observation.loadObservationData()
       }
     } finally {
       isLoading.value = false
@@ -59,7 +65,9 @@ export const useEmployeeDetailPage = () => {
   const leave = useEmployeeLeave(employee, loadEmployee)
   const rtt = useEmployeeRtt(employee, loadEmployee)
   const mileage = useEmployeeMileage(employee, loadEmployee)
+  const formation = useEmployeeFormation(employee, loadEmployee)
   const bonus = useEmployeeBonus(employee, loadEmployee)
+  const observation = useEmployeeObservation(employee, loadEmployee)
 
   watch(activeTab, (tab) => {
     if (tab === 'leave' && !leave.leaveDataLoaded.value && showLeaveTab.value) {
@@ -68,8 +76,12 @@ export const useEmployeeDetailPage = () => {
       rtt.loadRttData()
     } else if (tab === 'mileage' && !mileage.mileageDataLoaded.value) {
       mileage.loadMileageData()
+    } else if (tab === 'formation' && !formation.formationDataLoaded.value) {
+      formation.loadFormationData()
     } else if (tab === 'bonus' && !bonus.bonusDataLoaded.value) {
       bonus.loadBonusData()
+    } else if (tab === 'observation' && !observation.observationDataLoaded.value) {
+      observation.loadObservationData()
     }
   })
 
@@ -89,6 +101,8 @@ export const useEmployeeDetailPage = () => {
     ...leave,
     ...rtt,
     ...mileage,
-    ...bonus
+    ...formation,
+    ...bonus,
+    ...observation
   }
 }

frontend/composables/useEmployeeFormation.ts

@@ -0,0 +1,73 @@
+import type { Ref } from 'vue'
+import type { Formation } from '~/services/dto/formation'
+import type { Employee } from '~/services/dto/employee'
+import {
+  listFormations,
+  createFormation,
+  updateFormation,
+  deleteFormation,
+  uploadFormationJustificatif
+} from '~/services/formations'
+
+export const useEmployeeFormation = (employee: Ref<Employee | null>, reloadEmployee: () => Promise<void>) => {
+  const config = useRuntimeConfig()
+  const apiBase = (config.public.apiBase as string) ?? '/api'
+
+  const formations = ref<Formation[]>([])
+  const isFormationLoading = ref(false)
+  const formationDataLoaded = ref(false)
+
+  const loadFormationData = async () => {
+    if (!employee.value || isFormationLoading.value) return
+    isFormationLoading.value = true
+    try {
+      formations.value = await listFormations(employee.value.id)
+      formationDataLoaded.value = true
+    } finally {
+      isFormationLoading.value = false
+    }
+  }
+
+  const resetLoaded = () => {
+    formationDataLoaded.value = false
+  }
+
+  const submitCreateFormation = async (data: { startDate: string; endDate: string; comment?: string }, justificatifFile?: File) => {
+    if (!employee.value) return
+    const result = await createFormation({
+      employeeId: employee.value.id,
+      startDate: data.startDate,
+      endDate: data.endDate,
+      comment: data.comment
+    })
+    if (result?.id && justificatifFile) {
+      await uploadFormationJustificatif(apiBase, result.id, justificatifFile)
+    }
+    await reloadEmployee()
+  }
+
+  const submitUpdateFormation = async (id: number, data: { startDate: string; endDate: string; comment?: string }, justificatifFile?: File) => {
+    await updateFormation(id, data)
+    if (justificatifFile) {
+      await uploadFormationJustificatif(apiBase, id, justificatifFile)
+    }
+    await reloadEmployee()
+  }
+
+  const submitDeleteFormation = async (id: number) => {
+    await deleteFormation(id)
+    await reloadEmployee()
+  }
+
+  return {
+    formations,
+    isFormationLoading,
+    formationDataLoaded,
+    formationApiBase: apiBase,
+    loadFormationData,
+    resetLoaded,
+    submitCreateFormation,
+    submitUpdateFormation,
+    submitDeleteFormation
+  }
+}

frontend/composables/useEmployeeLeave.ts

@@ -4,7 +4,7 @@ import type { EmployeeLeaveSummary } from '~/services/dto/employee-leave-summary
 import type { Employee } from '~/services/dto/employee'
 import { CONTRACT_TYPES } from '~/services/dto/contract'
 import { listAbsences } from '~/services/absences'
-import { getEmployeeLeaveSummary, updateFractionedDays } from '~/services/employee-leave-summary'
+import { getEmployeeLeaveSummary, updateFractionedDays, updatePaidLeaveDays } from '~/services/employee-leave-summary'
 import { listPublicHolidays } from '~/services/public-holidays'
 
 export const useEmployeeLeave = (employee: Ref<Employee | null>, reloadEmployee: () => Promise<void>) => {
@@ -57,6 +57,13 @@ export const useEmployeeLeave = (employee: Ref<Employee | null>, reloadEmployee:
     await reloadEmployee()
   }
 
+  const submitPaidLeaveDays = async (days: number) => {
+    if (!employee.value) return
+    const year = leaveSummary.value?.year ?? undefined
+    await updatePaidLeaveDays(employee.value.id, days, year)
+    await reloadEmployee()
+  }
+
   return {
     employeeAbsences,
     leaveSummary,
@@ -65,6 +72,7 @@ export const useEmployeeLeave = (employee: Ref<Employee | null>, reloadEmployee:
     leaveDataLoaded,
     loadLeaveData,
     resetLoaded,
-    submitFractionedDays
+    submitFractionedDays,
+    submitPaidLeaveDays
   }
 }

frontend/composables/useEmployeeObservation.ts

@@ -0,0 +1,61 @@
+import type { Ref } from 'vue'
+import type { Observation } from '~/services/dto/observation'
+import type { Employee } from '~/services/dto/employee'
+import {
+  listObservations,
+  createObservation,
+  updateObservation,
+  deleteObservation
+} from '~/services/observations'
+
+export const useEmployeeObservation = (employee: Ref<Employee | null>, reloadEmployee: () => Promise<void>) => {
+  const observations = ref<Observation[]>([])
+  const isObservationLoading = ref(false)
+  const observationDataLoaded = ref(false)
+
+  const loadObservationData = async () => {
+    if (!employee.value || isObservationLoading.value) return
+    isObservationLoading.value = true
+    try {
+      observations.value = await listObservations(employee.value.id)
+      observationDataLoaded.value = true
+    } finally {
+      isObservationLoading.value = false
+    }
+  }
+
+  const resetLoaded = () => {
+    observationDataLoaded.value = false
+  }
+
+  const submitCreateObservation = async (data: { month: string; content: string }) => {
+    if (!employee.value) return
+    await createObservation({
+      employeeId: employee.value.id,
+      month: data.month,
+      content: data.content
+    })
+    await reloadEmployee()
+  }
+
+  const submitUpdateObservation = async (id: number, data: { month: string; content: string }) => {
+    await updateObservation(id, data)
+    await reloadEmployee()
+  }
+
+  const submitDeleteObservation = async (id: number) => {
+    await deleteObservation(id)
+    await reloadEmployee()
+  }
+
+  return {
+    observations,
+    isObservationLoading,
+    observationDataLoaded,
+    loadObservationData,
+    resetLoaded,
+    submitCreateObservation,
+    submitUpdateObservation,
+    submitDeleteObservation
+  }
+}

frontend/composables/useHoursPage.ts

@@ -73,7 +73,7 @@ export const useHoursPage = () => {
 
   const dayGridCols = computed(() => {
     const metricCol = '0.4fr'
-    const validationCols = isAdmin.value ? `${metricCol}` : `${metricCol} ${metricCol}`
+    const validationCols = isAdmin.value || isSiteManager.value ? `${metricCol}` : `${metricCol} ${metricCol}`
     return `1.2fr 0.6fr repeat(6, 0.8fr) ${metricCol} ${metricCol} ${metricCol} ${validationCols}`
   })
 
@@ -447,10 +447,21 @@ export const useHoursPage = () => {
       nightMinutes += nightIntervalMinutes(from, to)
     }
 
-    const creditedMinutes = dayContextByEmployeeId.value.get(employeeId)?.creditedMinutes ?? 0
+    const dayRow = dayContextByEmployeeId.value.get(employeeId)
+    const creditedMinutes = dayRow?.creditedMinutes ?? 0
     totalMinutes += creditedMinutes
-    const dayMinutes = Math.max(0, totalMinutes - nightMinutes)
-    return { dayMinutes, nightMinutes, totalMinutes }
+    let dayMinutes = Math.max(0, totalMinutes - nightMinutes)
+
+    // Virtual holiday credit: the backend already applies the contract-period
+    // schedule (workDaysHours) and the absence-override rule, so just use the
+    // computed value instead of recomputing on the client.
+    const virtualHolidayMinutes = dayRow?.virtualHolidayMinutes ?? 0
+    if (virtualHolidayMinutes > totalMinutes) {
+      dayMinutes += virtualHolidayMinutes - totalMinutes
+      totalMinutes = virtualHolidayMinutes
+    }
+
+    return { dayMinutes, nightMinutes, totalMinutes, virtualHolidayMinutes }
   }
 
   const getRowAbsenceLabel = (employeeId: number) => {
@@ -458,7 +469,6 @@ export const useHoursPage = () => {
     if (dayRow && dayRow.hasContractAtDate === false) {
       return 'Contrat non démarré'
     }
-    if (isSelectedDateHoliday.value) return 'Férié'
     if (!dayRow?.absenceLabel) return ''
     if (dayRow.absenceHalf === 'AM' || dayRow.absenceHalf === 'PM') {
       const halfLabel = dayRow.absenceHalf === 'AM' ? 'Matin' : 'ap.-m.'
@@ -476,6 +486,14 @@ export const useHoursPage = () => {
     return { backgroundColor: dayRow.absenceColor || '#dc2626' }
   }
 
+  const hasRowFormation = (employeeId: number): boolean => {
+    return dayContextByEmployeeId.value.get(employeeId)?.hasFormation === true
+  }
+
+  const getRowFormationLabel = (employeeId: number): string => {
+    return dayContextByEmployeeId.value.get(employeeId)?.formationLabel ?? ''
+  }
+
   const getRowUpdatedAt = (employeeId: number): string => {
     const raw = rows.value[employeeId]?.updatedAt
     if (!raw) return ''
@@ -576,7 +594,6 @@ export const useHoursPage = () => {
 
   const openAbsenceDrawer = (employeeId: number) => {
     if (!hasContractAtSelectedDate(employeeId)) return
-    if (isSelectedDateHoliday.value) return
 
     const existing = absences.value.find((absence) => {
       if (absence.employee?.id !== employeeId) return false
@@ -1119,6 +1136,7 @@ export const useHoursPage = () => {
     saveButtonClass,
     formattedSelectedDate,
     isSelectedDateHoliday,
+    selectedHolidayLabel,
     weekDayHeaders,
     shortcutButtonClass,
     weekShortcutButtonClass,
@@ -1154,6 +1172,8 @@ export const useHoursPage = () => {
     getRowMetrics,
     getRowAbsenceLabel,
     getRowAbsenceStyle,
+    hasRowFormation,
+    getRowFormationLabel,
     getRowUpdatedAt,
     getPresenceDayValue,
     openAbsenceDrawer,

frontend/data/documentation-content.ts

@@ -0,0 +1,593 @@
+import type { DocSection } from '~/types/documentation'
+
+export const documentationSections: DocSection[] = [
+  // ============================================================
+  // EMPLOYEE LEVEL
+  // ============================================================
+  {
+    id: 'connexion',
+    title: 'Connexion et navigation',
+    requiredLevel: 'employee',
+    icon: 'mdi:login',
+    articles: [
+      {
+        id: 'login',
+        title: 'Se connecter',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Pour accéder à l\'application, rendez-vous sur la page de connexion et saisissez vos identifiants.' },
+          { type: 'list', content: 'Saisissez votre nom d\'utilisateur\nSaisissez votre mot de passe\nCliquez sur le bouton "Connexion"' },
+          { type: 'note', content: 'Si vous ne parvenez pas à vous connecter, contactez votre administrateur RH. Votre compte a peut-être été verrouillé.' },
+        ],
+      },
+      {
+        id: 'navigation',
+        title: 'Naviguer dans la vue jour',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'La vue jour est votre écran principal. Elle affiche les heures de travail pour une date donnée.' },
+          { type: 'list', content: 'Boutons "Hier" / "Aujourd\'hui" / "Demain" pour naviguer rapidement\nSélecteur de date pour choisir une date spécifique\nFiltrage par site si vous avez accès à plusieurs sites' },
+          { type: 'paragraph', content: 'Seuls les employés ayant un contrat actif à la date sélectionnée sont affichés.' },
+        ],
+      },
+      {
+        id: 'perimetre',
+        title: 'Périmètre d\'accès',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Votre accès dépend du rôle qui vous a été attribué par l\'administrateur.' },
+          { type: 'list', content: 'Employé : accès à la saisie de ses propres heures uniquement\nChef de site : accès aux heures des employés de ses sites autorisés + validation\nAdministrateur : accès complet à toutes les fonctionnalités' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'saisie-heures',
+    title: 'Saisie des heures',
+    requiredLevel: 'employee',
+    icon: 'mdi:clock-time-four-outline',
+    articles: [
+      {
+        id: 'saisie-time',
+        title: 'Mode horaire (TIME)',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'En mode horaire, vous saisissez vos heures via des créneaux matin, après-midi et soir.' },
+          { type: 'list', content: 'Matin : heure de début et heure de fin\nAprès-midi : heure de début et heure de fin\nSoir : heure de début et heure de fin' },
+          { type: 'paragraph', content: 'Le sélecteur de temps fonctionne par tranches de 15 minutes (00, 15, 30, 45). La saisie libre est possible mais sera corrigée automatiquement.' },
+          { type: 'note', content: 'Les calculs sont mis à jour automatiquement : heures de jour (06:00–21:00), heures de nuit (00:00–06:00 et 21:00–24:00) et total.' },
+          { type: 'note', content: 'Jours fériés : le nom du férié apparaît en badge bleu dans la colonne Absence. La saisie d\'heures (ou de jours de présence) et la création d\'absences sont autorisées.' },
+          { type: 'note', content: 'Crédit automatique sur jour férié Lun-Ven : pour tout contrat hors Forfait et s\'il n\'y a pas d\'absence déclarée, un jour férié compte au minimum les heures contractuelles attendues (35h → 7h, 39h → 8h Lun-Jeu / 7h Ven). Si vous saisissez des heures supérieures à cette référence, ce sont vos heures qui sont comptées ; sinon c\'est la référence. Les conducteurs reçoivent ce crédit dans leur bucket "Heures jour". **Si une absence est posée sur le férié**, c\'est le paramétrage du type d\'absence (compte les heures oui/non) qui pilote les heures comptées, le crédit virtuel férié ne s\'applique plus.' },
+          { type: 'note', content: 'Contrats non-standards (4h, 25h, 28h, etc.) : un planning par jour travaillé doit être saisi à la création/modification du contrat (bloc « Jours travaillés » avec case à cocher + horaire par jour). Le crédit férié et le crédit d\'absence ne s\'appliquent que sur les jours programmés, avec les heures programmées. Ex. un 4h Lundi 2h + Jeudi 2h : férié le lundi → +2h, férié le mardi → 0h.' },
+        ],
+      },
+      {
+        id: 'saisie-presence',
+        title: 'Mode présence (PRESENCE)',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'En mode présence (contrats forfait), vous indiquez simplement si vous étiez présent le matin et/ou l\'après-midi.' },
+          { type: 'list', content: 'Cochez "Présent matin" pour indiquer une demi-journée de travail le matin\nCochez "Présent après-midi" pour indiquer une demi-journée l\'après-midi\nChaque demi-journée cochée compte pour 0.5 jour de présence' },
+        ],
+      },
+      {
+        id: 'comprendre-calculs',
+        title: 'Comprendre les calculs affichés',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Les colonnes de calcul sont mises à jour automatiquement en fonction de votre saisie.' },
+          { type: 'list', content: 'Jour : total des heures dans la plage 06:00–21:00\nNuit : total des heures dans les plages 00:00–06:00 et 21:00–24:00\nTotal : somme des heures de jour et de nuit' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'saisie-conducteurs',
+    title: 'Saisie conducteurs',
+    requiredLevel: 'employee',
+    icon: 'mdi:truck-outline',
+    articles: [
+      {
+        id: 'conducteur-heures',
+        title: 'Saisie des heures conducteur',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Les conducteurs disposent d\'un écran dédié accessible via le menu "Heures Conducteurs". Ils n\'apparaissent pas sur l\'écran classique des heures.' },
+          { type: 'list', content: 'Heures de jour : durée au format HH:MM\nHeures de nuit : durée au format HH:MM\nHeures atelier : durée au format HH:MM\nTotal : calculé automatiquement (jour + nuit + atelier)' },
+        ],
+      },
+      {
+        id: 'conducteur-indemnites',
+        title: 'Indemnités conducteur',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'En plus des heures, vous pouvez cocher les indemnités correspondant à votre journée.' },
+          { type: 'list', content: 'Petit déjeuner\nDéjeuner\nDîner\nNuitée' },
+          { type: 'paragraph', content: 'La même logique de validation s\'applique que pour les heures classiques.' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'absences-validations',
+    title: 'Absences et validations',
+    requiredLevel: 'employee',
+    icon: 'mdi:information-outline',
+    articles: [
+      {
+        id: 'comprendre-absences',
+        title: 'Comprendre les absences affichées',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Quand une absence est posée sur votre journée, elle apparaît dans la colonne dédiée avec un fond coloré selon le type d\'absence.' },
+          { type: 'list', content: 'Absence du matin (AM) : verrouille le créneau matin\nAbsence de l\'après-midi (PM) : verrouille les créneaux après-midi et soir\nAbsence journée complète : verrouille tous les créneaux' },
+          { type: 'note', content: 'Vous ne pouvez pas modifier les créneaux horaires verrouillés par une absence. Seul un administrateur peut retirer ou modifier l\'absence.' },
+        ],
+      },
+      {
+        id: 'comprendre-validations',
+        title: 'Comprendre les validations',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'Vos heures passent par un processus de double validation avant d\'être définitivement enregistrées.' },
+          { type: 'list', content: 'Validation chef de site : votre chef de site vérifie et valide vos heures. La ligne est alors verrouillée pour vous.\nValidation RH : l\'administrateur RH valide définitivement. La ligne est complètement verrouillée.' },
+          { type: 'paragraph', content: 'Une fois validée, vous ne pouvez plus modifier la ligne. Si une correction est nécessaire, contactez votre chef de site ou l\'administrateur RH.' },
+          { type: 'note', content: 'Toute vraie modification effectuée par un administrateur remet automatiquement les deux validations à zéro.' },
+        ],
+      },
+    ],
+  },
+
+  // ============================================================
+  // SITE MANAGER LEVEL
+  // ============================================================
+  {
+    id: 'validation-site',
+    title: 'Validation de site',
+    requiredLevel: 'site_manager',
+    icon: 'mdi:check-decagram-outline',
+    articles: [
+      {
+        id: 'role-chef-site',
+        title: 'Rôle du chef de site',
+        requiredLevel: 'site_manager',
+        blocks: [
+          { type: 'paragraph', content: 'En tant que chef de site, vous êtes responsable de la vérification et de la validation des heures saisies par les employés de votre site.' },
+          { type: 'paragraph', content: 'Le workflow de validation suit un circuit en 3 étapes : l\'employé saisit ses heures → le chef de site valide → l\'admin RH valide définitivement.' },
+        ],
+      },
+      {
+        id: 'validation-individuelle',
+        title: 'Validation individuelle',
+        requiredLevel: 'site_manager',
+        blocks: [
+          { type: 'paragraph', content: 'Pour valider une ligne d\'heures individuellement :' },
+          { type: 'list', content: 'Cochez la case de validation site sur la ligne de l\'employé\nLa ligne est immédiatement verrouillée pour l\'employé\nL\'administrateur RH peut toujours corriger une ligne que vous avez validée' },
+        ],
+      },
+      {
+        id: 'validation-masse',
+        title: 'Validation en masse',
+        requiredLevel: 'site_manager',
+        blocks: [
+          { type: 'paragraph', content: 'Pour gagner du temps, vous pouvez valider toutes les lignes en une seule action.' },
+          { type: 'list', content: 'Cliquez sur le bouton de validation en masse\nToutes les lignes de la date affichée sont validées d\'un coup\nUtile quand toutes les saisies sont correctes' },
+          { type: 'note', content: 'Quand toutes les lignes de votre site sont validées pour une date donnée, les administrateurs RH reçoivent automatiquement une notification.' },
+        ],
+      },
+      {
+        id: 'difference-validations',
+        title: 'Validation site vs validation RH',
+        requiredLevel: 'site_manager',
+        blocks: [
+          { type: 'paragraph', content: 'Il est important de comprendre la différence entre les deux niveaux de validation.' },
+          { type: 'list', content: 'Validation site : verrouille la ligne pour les employés, mais l\'admin RH peut encore modifier\nValidation RH : verrouillage complet, seul l\'admin peut retirer cette validation\nLe chef de site ne voit pas et ne peut pas agir sur la validation RH' },
+        ],
+      },
+    ],
+  },
+
+  // ============================================================
+  // ADMIN LEVEL
+  // ============================================================
+  {
+    id: 'administration',
+    title: 'Administration',
+    requiredLevel: 'admin',
+    icon: 'mdi:cog-outline',
+    articles: [
+      {
+        id: 'gestion-sites',
+        title: 'Gestion des sites',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les sites organisent les employés et les accès dans l\'application. Chaque site possède un nom et une couleur utilisée dans toute l\'interface.' },
+          { type: 'list', content: 'Créer, modifier ou supprimer un site depuis le menu "Sites"\nL\'ordre d\'affichage est modifiable par glisser-déposer\nLa couleur du site est utilisée pour identifier visuellement les employés' },
+        ],
+      },
+      {
+        id: 'gestion-types-absence',
+        title: 'Gestion des types d\'absence',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les types d\'absence définissent les catégories disponibles lors de la pose d\'une absence.' },
+          { type: 'list', content: 'Code : identifiant court (max 10 caractères), ex: C, M, AT\nLibellé : nom affiché, ex: Congé, Maladie, Accident du travail\nCouleur : code couleur pour le calendrier et la vue jour\nOption "Compté comme travaillé" : si activé, l\'absence crédite des heures en mode TIME' },
+          { type: 'note', content: 'L\'option "Compté comme travaillé" impacte le calcul des heures supplémentaires. En mode TIME, les minutes sont créditées selon le contrat. En mode PRESENCE, aucun crédit n\'est appliqué.' },
+        ],
+      },
+      {
+        id: 'gestion-utilisateurs',
+        title: 'Gestion des utilisateurs',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Chaque personne qui se connecte à l\'application a un compte utilisateur distinct de sa fiche employé.' },
+          { type: 'list', content: 'Nom d\'utilisateur : unique, sert de login\nMot de passe : défini à la création, modifiable\nRôle : Admin (accès complet), User (chef de site), Self (employé)\nSites autorisés : pour les chefs de site, définit leur périmètre\nAssociation employé : lie le compte à une fiche employé\nVerrouillage : un compte verrouillé ne peut plus se connecter' },
+          { type: 'note', content: 'Il n\'est pas possible de supprimer un utilisateur (sécurité). Pour bloquer l\'accès, utilisez le verrouillage de compte.' },
+        ],
+      },
+      {
+        id: 'taches-automatiques',
+        title: 'Tâches automatiques (crons)',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Deux tâches automatiques s\'exécutent quotidiennement pour gérer le report des compteurs.' },
+          { type: 'list', content: 'Report congés (02h10) : déclenche le report des congés payés le 1er juin (CDI/CDD) et le 1er janvier (forfait)\nReport RTT (02h15) : déclenche le report du solde RTT le 1er juin' },
+          { type: 'note', content: 'Ces tâches sont idempotentes : si elles s\'exécutent plusieurs fois, aucun doublon n\'est créé.' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'employes-contrats',
+    title: 'Employés et contrats',
+    requiredLevel: 'admin',
+    icon: 'mdi:account-group-outline',
+    articles: [
+      {
+        id: 'liste-employes',
+        title: 'Liste et recherche d\'employés',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'La page Employés affiche tous les employés sous forme de cartes.' },
+          { type: 'list', content: 'Recherche par nom\nFiltrage par site (multi-sélection)\nFiltrage par statut de contrat : "Avec contrat" (défaut), "Sans contrat", "Tous"\n"Avec contrat" = employés ayant une période de contrat active à la date du jour' },
+        ],
+      },
+      {
+        id: 'creation-employe',
+        title: 'Créer un employé',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'La création d\'un employé se fait via le drawer d\'ajout.' },
+          { type: 'list', content: 'Champs : prénom, nom, site\nNature du contrat : CDI, CDD ou INTERIM\nType de contrat / temps de travail (Forfait, 35h, 39h, etc.)\nDate de début (obligatoire)\nDate de fin (obligatoire pour CDD et INTERIM)' },
+        ],
+      },
+      {
+        id: 'types-contrat',
+        title: 'Types de contrat',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Le type de contrat détermine le mode de suivi et les règles de calcul appliquées.' },
+          { type: 'list', content: 'FORFAIT : suivi en jours (mode PRESENCE), base 218 jours/an\n35 HEURES : suivi horaire (mode TIME), 35h/semaine\n39 HEURES : suivi horaire (mode TIME), 39h/semaine\nCUSTOM : heures personnalisées (ex: 4h, 20h), 1h sup = 1h récup sans bonus\nINTERIM : travail temporaire, pas de récupération ni de congés gérés' },
+          { type: 'note', content: 'Le mode de suivi (TIME ou PRESENCE) est lié au type de contrat et ne peut pas être modifié indépendamment.' },
+        ],
+      },
+      {
+        id: 'suivi-contrat',
+        title: 'Suivi contrat et historique',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'L\'onglet "Suivi contrat" sur la fiche employé affiche l\'historique complet des périodes de contrat.' },
+          { type: 'list', content: 'Chaque ligne : nature (CDI/CDD/INTERIM), type de contrat, date début, date fin ou "En cours"\nAjouter un contrat : disponible uniquement si le contrat en cours est clôturé\nClôturer un contrat : définir la date de fin + option "Solde de tout compte"\nSuspension : ajouter une période de suspension avec dates et commentaire' },
+          { type: 'note', content: 'La case "Soldé dans le solde de tout compte" remet le report des congés à 0 pour l\'exercice suivant.' },
+        ],
+      },
+      {
+        id: 'statut-conducteur',
+        title: 'Statut conducteur',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Le statut conducteur est un flag activé sur une période de contrat. Un employé peut changer de statut conducteur selon la période.' },
+          { type: 'paragraph', content: 'Un employé conducteur apparaît uniquement sur l\'écran "Heures Conducteurs" et non sur l\'écran "Heures" classique.' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'double-validation',
+    title: 'Saisie et double validation',
+    requiredLevel: 'admin',
+    icon: 'mdi:shield-check-outline',
+    articles: [
+      {
+        id: 'validation-rh',
+        title: 'Validation RH',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'La validation RH est le niveau de validation le plus élevé, réservé aux administrateurs.' },
+          { type: 'list', content: 'Verrouille complètement la ligne (heures et absences)\nSeul un administrateur peut retirer cette validation\nPeut être appliquée individuellement ou en masse' },
+        ],
+      },
+      {
+        id: 'regles-reinitialisation',
+        title: 'Règles de réinitialisation',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les validations sont automatiquement réinitialisées dans certaines conditions.' },
+          { type: 'list', content: 'Toute vraie modification d\'une ligne remet les deux validations (site et RH) à faux\nUn enregistrement sans changement réel préserve les validations existantes\nLa date de modification est mise à jour uniquement quand un employé modifie ses propres heures' },
+          { type: 'note', content: 'La date de modification est visible uniquement par les administrateurs, sous le nom de l\'employé dans la vue jour.' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'vue-semaine-hs',
+    title: 'Vue semaine et heures supplémentaires',
+    requiredLevel: 'admin',
+    icon: 'mdi:calendar-week',
+    articles: [
+      {
+        id: 'vue-semaine',
+        title: 'Vue semaine',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'La vue semaine est réservée aux administrateurs. Elle affiche une synthèse hebdomadaire par employé avec les heures supplémentaires calculées.' },
+          { type: 'list', content: 'Filtrage par site et par employé\nDétail par jour avec totaux hebdomadaires\nColonnes de calcul : base, heures sup 25%, heures sup 50%, total récupération' },
+        ],
+      },
+      {
+        id: 'calcul-hs',
+        title: 'Calcul des heures supplémentaires',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les règles de calcul des heures supplémentaires dépendent du type de contrat.' },
+          { type: 'list', content: 'Contrats ≤ 35h : +25% de 35h à 43h, +50% au-delà de 43h\nContrats ≥ 39h : +25% de 39h à 43h, +50% au-delà de 43h\nContrats CUSTOM (4h, 25h, etc.) : 1h supplémentaire = 1h de récupération, pas de bonus\nINTERIM : aucune récupération, aucun bonus' },
+          { type: 'note', content: 'En cas de déficit hebdomadaire (heures travaillées < heures contrat), le déficit est déduit du cumul RTT : d\'abord des heures à 50%, puis des heures à 25%.' },
+        ],
+      },
+      {
+        id: 'vue-semaine-conducteurs',
+        title: 'Vue semaine conducteurs',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'La vue semaine conducteurs affiche des colonnes spécifiques.' },
+          { type: 'list', content: 'Totaux jour / nuit / atelier par jour et par semaine\nPanier de nuit (PN) : affiché quand heures nuit > heures jour OU nuit ≥ 4h\nCompteurs hebdomadaires : petit déjeuner, déjeuner, dîner, nuitée\nRTT calculé sur jour + nuit + atelier (au lieu des créneaux classiques)' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'absences-calendrier',
+    title: 'Absences et calendrier',
+    requiredLevel: 'admin',
+    icon: 'mdi:calendar-blank',
+    articles: [
+      {
+        id: 'poser-absence',
+        title: 'Poser une absence',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les absences peuvent être posées depuis la vue jour des heures ou depuis le calendrier.' },
+          { type: 'list', content: 'Journée complète : efface toutes les plages horaires\nDemi-journée matin (AM) : efface le créneau matin\nDemi-journée après-midi (PM) : efface les créneaux après-midi et soir' },
+          { type: 'paragraph', content: 'Les absences sont stockées par jour : une absence de plusieurs jours est automatiquement découpée en entrées quotidiennes.' },
+        ],
+      },
+      {
+        id: 'effet-absences-heures',
+        title: 'Effet sur les heures',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'L\'impact d\'une absence sur les heures dépend du type d\'absence et du mode de suivi.' },
+          { type: 'list', content: 'Standard : efface les créneaux horaires correspondants\nSi "Compté comme travaillé" en mode TIME : crédite des minutes selon le contrat actif\nSi "Compté comme travaillé" en mode PRESENCE : aucun crédit (seules les cases cochées comptent)' },
+          { type: 'note', content: 'Les absences comptées comme travaillées impactent le calcul des heures supplémentaires et du RTT.' },
+        ],
+      },
+      {
+        id: 'calendrier-mensuel',
+        title: 'Calendrier mensuel',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Le calendrier offre une vue d\'ensemble mensuelle des absences de tous les employés.' },
+          { type: 'list', content: 'Code couleur par type d\'absence\nDemi-journée : affichage en dégradé diagonal\nJournée complète : fond plein\nJours fériés : fond bleu clair\nFiltres par site et par employé\nNavigation par mois (précédent / suivant)' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'conges-payes',
+    title: 'Congés payés',
+    requiredLevel: 'admin',
+    icon: 'mdi:umbrella-beach-outline',
+    articles: [
+      {
+        id: 'regles-cdi-cdd',
+        title: 'Règles CDI/CDD non-forfait',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Pour les contrats CDI et CDD (hors forfait), l\'exercice de congés va du 1er juin (N-1) au 31 mai (N).' },
+          { type: 'list', content: 'Acquisition annuelle : 25 jours + 5 samedis\nAcquisition mensuelle : 2,08 jours + 0,42 samedi par mois\nProratisation en cas de début/fin ou suspension en cours de mois\nContrat 4h : 10 jours annuels, 0 samedi, 0,83 jour/mois' },
+        ],
+      },
+      {
+        id: 'regles-forfait',
+        title: 'Règles FORFAIT',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Pour les contrats forfait, l\'exercice suit l\'année civile (1er janvier au 31 décembre).' },
+          { type: 'list', content: 'Calcul : jours ouvrés de l\'année − 218 + bonus weekend/férié\nBonus : 1 jour par jour travaillé un weekend ou jour férié (0.5 si demi-journée)\nPas de samedis\nPas de jours en cours d\'acquisition' },
+        ],
+      },
+      {
+        id: 'maladie-longue',
+        title: 'Arrêt maladie long',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'En cas d\'arrêt maladie de plus d\'un mois, les règles d\'acquisition sont modifiées.' },
+          { type: 'list', content: 'Premier mois de maladie : acquisition normale\nAprès le premier mois : acquisition réduite (facteur 0,80)\nDétection automatique à partir des absences MALADIE consécutives (tolérance de gap ≤ 3 jours)' },
+        ],
+      },
+      {
+        id: 'report-conges',
+        title: 'Report annuel et rollover',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Le reliquat de congés de l\'exercice précédent est automatiquement reporté dans les acquis du nouvel exercice.' },
+          { type: 'list', content: 'Report automatique le 1er juin (CDI/CDD non-forfait) ou 1er janvier (forfait)\nSi "Solde de tout compte" coché sur le contrat clôturé : report remis à 0\nJours fractionnés : saisie manuelle par la RH, ajoutés aux acquis' },
+        ],
+      },
+      {
+        id: 'consommation-conges',
+        title: 'Règle de consommation',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Les absences s\'imputent selon un ordre précis.' },
+          { type: 'list', content: 'D\'abord sur les acquis (report N-1)\nPuis sur les jours en cours d\'acquisition\nEn cours d\'acquisition peut devenir négatif temporairement (se reconstitue avec les acquisitions suivantes)' },
+          { type: 'paragraph', content: 'Compteurs visibles sur l\'onglet Congé de la fiche employé : acquis, en cours d\'acquisition, pris, restant.' },
+        ],
+      },
+      {
+        id: 'ecran-recap-conges',
+        title: 'Écran Récap. congés',
+        requiredLevel: 'employee',
+        blocks: [
+          { type: 'paragraph', content: 'L\'écran "Récap. congés" affiche un tableau figé des soldes de congés et RTT par employé. Il est accessible via la sidebar lorsque l\'accès a été activé sur le compte utilisateur.' },
+          { type: 'list', content: 'Employé : voit uniquement sa propre ligne\nChef de site : voit les employés des sites qui lui sont rattachés\nAdmin : voit tous les employés, groupés par site' },
+          { type: 'note', content: 'Le récap est arrêté à la fin de la semaine S-2 (dimanche). Exemple : un mardi en S16, les soldes sont calculés jusqu\'au dimanche de la S14 inclus. Les heures et absences postérieures ne sont pas comptées.' },
+          { type: 'paragraph', content: 'Les colonnes affichées sont identiques à l\'export PDF admin (Nom, Prénom, Contrat, CP N-1 restant, CP N, Samedis, RTT). L\'accès à cet écran est géré par un flag sur l\'utilisateur, activé depuis le drawer de création/édition d\'un utilisateur par un admin.' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'rtt',
+    title: 'RTT (Récupération de Temps de Travail)',
+    requiredLevel: 'admin',
+    icon: 'mdi:timer-sand',
+    articles: [
+      {
+        id: 'rtt-principe',
+        title: 'Principe et exercice RTT',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Le RTT correspond aux heures supplémentaires accumulées, converties en temps de récupération. L\'exercice RTT va du 1er juin (N-1) au 31 mai (N).' },
+          { type: 'paragraph', content: 'L\'onglet RTT sur la fiche employé affiche le détail hebdomadaire regroupé par mois, avec un compteur global en heures (1 jour = 7h = 420 minutes).' },
+        ],
+      },
+      {
+        id: 'rtt-compteurs',
+        title: 'Compteurs RTT',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'list', content: 'Report N-1 : solde de l\'exercice précédent\nAcquis : cumul des heures supplémentaires de l\'exercice en cours\nDisponible : report + acquis − payé\nPayé : RTT convertis en salaire (soustraits du disponible)' },
+          { type: 'note', content: 'Les contrats INTERIM et le mode PRESENCE n\'accumulent pas de RTT (affiché à 0).' },
+        ],
+      },
+      {
+        id: 'rtt-paiement',
+        title: 'Paiement RTT',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'L\'administrateur RH peut enregistrer un paiement RTT depuis l\'onglet RTT de la fiche employé.' },
+          { type: 'list', content: 'Saisie : mois, nombre de minutes, taux (25% ou 50%)\nPlusieurs paiements possibles par mois\nLes heures payées sont soustraites du solde disponible' },
+        ],
+      },
+      {
+        id: 'rtt-semaines-mois',
+        title: 'Attribution des semaines aux mois',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Chaque semaine ISO est attribuée à un seul mois dans le tableau RTT.' },
+          { type: 'list', content: 'Une semaine est attribuée au mois qui contient son samedi\nSi le samedi tombe en début de mois suivant, la semaine est dans ce mois suivant' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'frais-primes-observations',
+    title: 'Frais, primes et observations',
+    requiredLevel: 'admin',
+    icon: 'mdi:account-cash-outline',
+    articles: [
+      {
+        id: 'frais',
+        title: 'Onglet Frais',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'L\'onglet Frais sur la fiche employé permet de saisir les frais kilométriques et les montants associés.' },
+          { type: 'list', content: 'Mois : obligatoire\nKilomètres : nombre de km (optionnel)\nMontant : en euros (optionnel)\nCommentaire : optionnel\nDeux justificatifs PDF distincts : un pour les km, un pour le montant' },
+          { type: 'note', content: 'Au moins un des deux champs (kilomètres ou montant) doit être supérieur à 0. Un seul enregistrement par mois par employé.' },
+        ],
+      },
+      {
+        id: 'formation',
+        title: 'Onglet Formation',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'L\'onglet Formation sur la fiche employé permet de tracer les formations suivies par le salarié.' },
+          { type: 'list', content: 'Date de début : obligatoire\nDate de fin : obligatoire (doit être postérieure ou égale à la date de début)\nJustificatif PDF : optionnel\nCommentaire : optionnel' },
+          { type: 'note', content: 'Les formations sont triées par date de début décroissante. Cliquer sur une ligne permet de la modifier ou la supprimer.' },
+          { type: 'paragraph', content: 'Les formations sont également affichées en consultation sur l\'écran des heures (pastille indigo "Formation" dans la colonne Absence, sans bouton Modifier) et dans le calendrier (cellule "F" indigo ou icône école si couplée à une absence, cellule non cliquable). La modification et la suppression d\'une formation se font exclusivement depuis cet onglet.' },
+        ],
+      },
+      {
+        id: 'primes',
+        title: 'Onglet Prime',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'list', content: 'Mois : obligatoire\nMontant en euros : obligatoire\nCommentaire : optionnel\nUne seule prime par mois par employé' },
+        ],
+      },
+      {
+        id: 'observations',
+        title: 'Onglet Observation',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'list', content: 'Mois : obligatoire\nTexte d\'observation : obligatoire\nUne seule observation par mois par employé\nNote libre pour le suivi RH' },
+        ],
+      },
+    ],
+  },
+  {
+    id: 'exports',
+    title: 'Exports et impressions',
+    requiredLevel: 'admin',
+    icon: 'mdi:file-pdf-box',
+    articles: [
+      {
+        id: 'export-recap-conges',
+        title: 'Export récap. congés',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Génère un PDF A4 portrait récapitulant les congés de tous les employés actifs.' },
+          { type: 'list', content: 'Accessible depuis la page Employés (bouton "Export récap. congés")\nGénère un PDF à la date du jour\nDonnées groupées par site\nColonnes : nom, contrat, CP N-1 restant, samedi restant, CP N, RTT' },
+        ],
+      },
+      {
+        id: 'export-recap-salaire',
+        title: 'Récapitulatif salaire',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Génère un PDF A4 paysage avec le détail mensuel pour la paie.' },
+          { type: 'list', content: 'Sélecteur de mois (défaut = mois courant)\nDonnées groupées par site\nColonnes : nom, base contrat, jours de présence cadre, heures de nuit, panier de nuit, heures RTT payées, congés (nombre + dates), maladie/AT (nombre + dates), primes conducteur (PDJ, repas, nuitée, samedi), observations' },
+        ],
+      },
+      {
+        id: 'impression-absences',
+        title: 'Impression absences',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Génère un PDF A3 paysage du calendrier d\'absences avec des filtres.' },
+          { type: 'list', content: 'Filtres : période (du/au), sites, nature de contrat, type de contrat\nTous les filtres sont cochés par défaut\nCalendrier coloré par type d\'absence' },
+        ],
+      },
+      {
+        id: 'export-heures-annuelles',
+        title: 'Export heures annuelles',
+        requiredLevel: 'admin',
+        blocks: [
+          { type: 'paragraph', content: 'Génère un PDF par employé avec le détail jour par jour de ses heures sur une année.' },
+          { type: 'list', content: 'Accessible depuis la fiche employé (bouton imprimante)\nChoix de l\'année civile (janvier à décembre)\nColonnes adaptées au mode de suivi (TIME, PRESENCE, conducteur)\nSections séparées en cas de changement de contrat en cours d\'année' },
+        ],
+      },
+    ],
+  },
+]

frontend/i18n/locales/fr.json

@@ -42,10 +42,23 @@
             "update": "Impossible de mettre à jour le frais kilométrique.",
             "delete": "Impossible de supprimer le frais kilométrique."
         },
+        "formation": {
+            "create": "Impossible de créer la formation.",
+            "update": "Impossible de mettre à jour la formation.",
+            "delete": "Impossible de supprimer la formation."
+        },
         "bonus": {
             "create": "Impossible de créer la prime.",
             "update": "Impossible de mettre à jour la prime.",
             "delete": "Impossible de supprimer la prime."
+        },
+        "observation": {
+            "create": "Impossible de créer l'observation.",
+            "update": "Impossible de mettre à jour l'observation.",
+            "delete": "Impossible de supprimer l'observation."
+        },
+        "leaveRecap": {
+            "load": "Impossible de charger le récap des congés."
         }
     },
     "success": {
@@ -83,10 +96,20 @@
             "update": "Frais kilométrique mis à jour.",
             "delete": "Frais kilométrique supprimé."
         },
+        "formation": {
+            "create": "Formation créée.",
+            "update": "Formation mise à jour.",
+            "delete": "Formation supprimée."
+        },
         "bonus": {
             "create": "Prime créée.",
             "update": "Prime mise à jour.",
             "delete": "Prime supprimée."
+        },
+        "observation": {
+            "create": "Observation créée.",
+            "update": "Observation mise à jour.",
+            "delete": "Observation supprimée."
         }
     }
 }

frontend/layouts/default.vue

@@ -19,6 +19,7 @@
                         </NuxtLink>
                     </template>
                     <NuxtLink
+                        v-if="isAdmin || !isDriver"
                         to="/hours"
                         class="flex items-center gap-2 py-2 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
                         :class="[
@@ -30,12 +31,13 @@
                         <p>Heures</p>
                     </NuxtLink>
                     <NuxtLink
-                        v-if="isAdmin"
+                        v-if="isAdmin || isDriver"
                         to="/driver-hours"
                         class="flex items-center gap-2 py-2 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
-                        :class="route.path.startsWith('/driver-hours')
-                            ? 'bg-tertiary-500 text-primary-500 font-bold'
-                            : ''"
+                        :class="[
+                            route.path.startsWith('/driver-hours') ? 'bg-tertiary-500 text-primary-500 font-bold' : '',
+                            !isAdmin && isDriver ? 'border-t border-secondary-500 pt-3' : ''
+                        ]"
                     >
                         <Icon name="mdi:truck-outline" size="24"/>
                         <p>Heures Conducteurs</p>
@@ -51,6 +53,17 @@
                             <Icon name="mdi:account-group-outline" size="24"/>
                             <p>Employés</p>
                         </NuxtLink>
+                        <NuxtLink
+                            v-if="hasLeaveRecapAccess"
+                            to="/leave-recap"
+                            class="flex items-center gap-2 py-3 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
+                            :class="route.path.startsWith('/leave-recap')
+                            ? 'bg-tertiary-500 text-primary-500 font-bold'
+                            : ''"
+                        >
+                            <Icon name="mdi:beach" size="24"/>
+                            <p>Récap. congés</p>
+                        </NuxtLink>
                         <NuxtLink
                             to="/sites"
                             class="flex items-center gap-2 py-3 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
@@ -82,6 +95,36 @@
                             <p>Utilisateurs</p>
                         </NuxtLink>
                     </template>
+                    <NuxtLink
+                        v-if="hasLeaveRecapAccess && !isAdmin"
+                        to="/leave-recap"
+                        class="flex items-center gap-2 py-3 text-md text-black hover:bg-tertiary-500 hover:text-primary-500 pt-3"
+                        :class="route.path.startsWith('/leave-recap') ? 'bg-tertiary-500 text-primary-500 font-bold' : ''"
+                    >
+                        <Icon name="mdi:beach" size="24"/>
+                        <p>Récap. congés</p>
+                    </NuxtLink>
+                    <NuxtLink
+                        v-if="isSuperAdmin"
+                        to="/audit-logs"
+                        class="flex items-center gap-2 py-3 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
+                        :class="route.path.startsWith('/audit-logs')
+                            ? 'bg-tertiary-500 text-primary-500 font-bold'
+                            : ''"
+                    >
+                        <Icon name="mdi:clipboard-text-clock-outline" size="24"/>
+                        <p>Journal</p>
+                    </NuxtLink>
+                    <NuxtLink
+                        to="/documentation"
+                        class="flex items-center gap-2 py-3 text-md text-black hover:bg-tertiary-500 hover:text-primary-500"
+                        :class="route.path.startsWith('/documentation')
+                            ? 'bg-tertiary-500 text-primary-500 font-bold'
+                            : ''"
+                    >
+                        <Icon name="mdi:book-open-page-variant-outline" size="24"/>
+                        <p>Documentation</p>
+                    </NuxtLink>
                 </nav>
 
                 <div class="flex flex-col gap-2 items-center p-4">
@@ -103,5 +146,8 @@
 const auth = useAuthStore()
 const {version} = useAppVersion()
 const isAdmin = computed(() => auth.user?.roles?.includes('ROLE_ADMIN') ?? false)
+const isSuperAdmin = computed(() => auth.user?.roles?.includes('ROLE_SUPER_ADMIN') ?? false)
+const isDriver = computed(() => auth.user?.isDriver ?? false)
+const hasLeaveRecapAccess = computed(() => auth.user?.hasLeaveRecapAccess ?? false)
 const route = useRoute()
 </script>

frontend/middleware/leave-recap-access.ts

@@ -0,0 +1,11 @@
+export default defineNuxtRouteMiddleware(async () => {
+  const auth = useAuthStore()
+
+  if (!auth.checked) {
+    await auth.ensureSession()
+  }
+
+  if (!auth.user?.hasLeaveRecapAccess) {
+    return navigateTo('/')
+  }
+})

frontend/middleware/super-admin.ts

@@ -0,0 +1,12 @@
+export default defineNuxtRouteMiddleware(async () => {
+  const auth = useAuthStore()
+
+  if (!auth.checked) {
+    await auth.ensureSession()
+  }
+
+  const isSuperAdmin = auth.user?.roles?.includes('ROLE_SUPER_ADMIN')
+  if (!isSuperAdmin) {
+    return navigateTo('/')
+  }
+})

frontend/pages/audit-logs.vue

@@ -0,0 +1,254 @@
+<template>
+  <div class="h-full flex flex-col overflow-hidden">
+    <h1 class="text-4xl font-bold text-primary-500 pb-6">Journal des actions</h1>
+
+    <div class="flex items-end gap-4 pb-6 flex-wrap">
+      <div>
+        <label class="text-md font-semibold text-neutral-700">Employé</label>
+        <select
+          v-model="filters.employeeId"
+          class="mt-2 h-[42px] w-full rounded-md border border-neutral-300 px-3 py-2 text-md text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+        >
+          <option :value="undefined">Tous</option>
+          <option v-for="emp in employees" :key="emp.id" :value="emp.id">
+            {{ emp.lastName }} {{ emp.firstName }}
+          </option>
+        </select>
+      </div>
+      <div>
+        <label class="text-md font-semibold text-neutral-700">Du</label>
+        <input
+          v-model="filters.from"
+          type="date"
+          class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-md text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+        />
+      </div>
+      <div>
+        <label class="text-md font-semibold text-neutral-700">Au</label>
+        <input
+          v-model="filters.to"
+          type="date"
+          class="mt-2 w-full rounded-md border border-neutral-300 px-3 py-2 text-md text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+        />
+      </div>
+      <div>
+        <label class="text-md font-semibold text-neutral-700">Type</label>
+        <select
+          v-model="filters.entityType"
+          class="mt-2 h-[42px] w-full rounded-md border border-neutral-300 px-3 py-2 text-md text-neutral-900 focus:border-primary-500 focus:outline-none focus:ring-2 focus:ring-secondary-500/20"
+        >
+          <option :value="undefined">Tous</option>
+          <option value="work_hour">Heures</option>
+          <option value="absence">Absences</option>
+          <option value="employee">Employé</option>
+          <option value="contract_suspension">Suspension</option>
+          <option value="rtt_payment">Paiement RTT</option>
+          <option value="fractioned_days">Jours fractionnés</option>
+          <option value="paid_leave_days">Congés N-1 payés</option>
+        </select>
+      </div>
+      <button
+        type="button"
+        class="h-[42px] rounded-lg bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500"
+        @click="search"
+      >
+        Rechercher
+      </button>
+    </div>
+
+    <div v-if="isLoading" class="rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600">
+      Chargement...
+    </div>
+
+    <div v-else-if="logs.length === 0" class="rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600">
+      Aucune entrée trouvée.
+    </div>
+
+    <template v-else>
+      <div class="min-h-0 flex-1 overflow-auto rounded-md bg-white">
+        <div class="grid grid-cols-[140px_110px_90px_100px_150px_1fr_130px] gap-4 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md sticky top-0 z-10">
+          <span>Date action</span>
+          <span>Utilisateur</span>
+          <span>Action</span>
+          <span>Type</span>
+          <span>Employé</span>
+          <span>Description</span>
+          <span>Date affectée</span>
+        </div>
+        <div class="border-x border-b border-primary-500 rounded-b-md">
+          <template v-for="log in logs" :key="log.id">
+            <div
+              class="grid grid-cols-[140px_110px_90px_100px_150px_1fr_130px] items-center gap-4 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0 cursor-pointer hover:bg-tertiary-500"
+              @click="toggleExpand(log.id)"
+            >
+              <span>{{ formatDateTime(log.createdAt) }}</span>
+              <span>{{ log.username }}</span>
+              <span>
+                <span class="rounded px-2 py-0.5 text-xs font-bold text-white" :class="actionClass(log.action)">
+                  {{ actionLabel(log.action) }}
+                </span>
+              </span>
+              <span>{{ entityTypeLabel(log.entityType) }}</span>
+              <span>{{ log.employeeName ?? '-' }}</span>
+              <span class="truncate font-normal" :title="log.description">{{ log.description }}</span>
+              <span>{{ log.affectedDate ? formatDate(log.affectedDate) : '-' }}</span>
+            </div>
+
+            <div
+              v-if="expandedIds.has(log.id)"
+              class="border-b border-primary-500 px-6 py-4 bg-neutral-50"
+            >
+              <div v-if="log.changes" class="grid grid-cols-2 gap-6 text-sm font-mono">
+                <div v-if="log.changes.old">
+                  <p class="font-bold text-red-600 mb-2">Ancien</p>
+                  <pre class="whitespace-pre-wrap text-neutral-700">{{ JSON.stringify(log.changes.old, null, 2) }}</pre>
+                </div>
+                <div v-if="log.changes.new">
+                  <p class="font-bold text-green-600 mb-2">Nouveau</p>
+                  <pre class="whitespace-pre-wrap text-neutral-700">{{ JSON.stringify(log.changes.new, null, 2) }}</pre>
+                </div>
+              </div>
+              <p v-else class="text-md text-neutral-400">Pas de détail disponible.</p>
+            </div>
+          </template>
+        </div>
+      </div>
+
+      <div class="flex items-center justify-between pt-4">
+        <p class="text-md text-neutral-500">
+          {{ total }} résultat{{ total > 1 ? 's' : '' }} — page {{ currentPage }}/{{ totalPages }}
+        </p>
+        <div class="flex gap-3">
+          <button
+            type="button"
+            :disabled="currentPage <= 1"
+            class="rounded-lg border border-primary-500 px-4 py-2 text-md font-semibold text-primary-500 hover:bg-tertiary-500 disabled:opacity-30 disabled:cursor-not-allowed"
+            @click="goToPage(currentPage - 1)"
+          >
+            Précédent
+          </button>
+          <button
+            type="button"
+            :disabled="currentPage >= totalPages"
+            class="rounded-lg bg-primary-500 px-4 py-2 text-md font-semibold text-white hover:bg-secondary-500 disabled:opacity-30 disabled:cursor-not-allowed"
+            @click="goToPage(currentPage + 1)"
+          >
+            Suivant
+          </button>
+        </div>
+      </div>
+    </template>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, reactive, computed, onMounted } from 'vue'
+import type { AuditLog } from '~/services/dto/audit-log'
+import type { Employee } from '~/services/dto/employee'
+import { fetchAuditLogs } from '~/services/audit-logs'
+import { listEmployees } from '~/services/employees'
+
+definePageMeta({
+  middleware: 'super-admin'
+})
+
+useHead({ title: 'Journal des actions' })
+
+const logs = ref<AuditLog[]>([])
+const employees = ref<Employee[]>([])
+const isLoading = ref(false)
+const expandedIds = ref(new Set<number>())
+const total = ref(0)
+const currentPage = ref(1)
+const perPage = ref(50)
+
+const totalPages = computed(() => Math.max(1, Math.ceil(total.value / perPage.value)))
+
+const filters = reactive<{
+  employeeId?: number
+  from?: string
+  to?: string
+  entityType?: string
+}>({})
+
+const loadLogs = async (page = 1) => {
+  isLoading.value = true
+  try {
+    const result = await fetchAuditLogs({ ...filters, page })
+    logs.value = result.items
+    total.value = result.total
+    currentPage.value = result.page
+    perPage.value = result.perPage
+    expandedIds.value.clear()
+  } finally {
+    isLoading.value = false
+  }
+}
+
+const search = () => {
+  loadLogs(1)
+}
+
+const goToPage = (page: number) => {
+  if (page >= 1 && page <= totalPages.value) {
+    loadLogs(page)
+  }
+}
+
+const toggleExpand = (id: number) => {
+  if (expandedIds.value.has(id)) {
+    expandedIds.value.delete(id)
+  } else {
+    expandedIds.value.add(id)
+  }
+}
+
+const formatDateTime = (dt: string) => {
+  const d = new Date(dt)
+  return d.toLocaleDateString('fr-FR') + ' ' + d.toLocaleTimeString('fr-FR', { hour: '2-digit', minute: '2-digit' })
+}
+
+const formatDate = (d: string) => {
+  return d.split('-').reverse().join('/')
+}
+
+const actionLabel = (action: string): string => {
+  const map: Record<string, string> = {
+    create: 'Créer',
+    update: 'Modifier',
+    delete: 'Suppr.',
+    validate: 'Valid.',
+    site_validate: 'Valid. site',
+  }
+  return map[action] ?? action
+}
+
+const actionClass = (action: string): string => {
+  const map: Record<string, string> = {
+    create: 'bg-green-500',
+    update: 'bg-blue-500',
+    delete: 'bg-red-500',
+    validate: 'bg-purple-500',
+    site_validate: 'bg-indigo-500',
+  }
+  return map[action] ?? 'bg-neutral-500'
+}
+
+const entityTypeLabel = (type: string): string => {
+  const map: Record<string, string> = {
+    work_hour: 'Heures',
+    absence: 'Absence',
+    employee: 'Employé',
+    contract_suspension: 'Suspension',
+    rtt_payment: 'RTT',
+    fractioned_days: 'Fract.',
+    paid_leave_days: 'Congés payés',
+  }
+  return map[type] ?? type
+}
+
+onMounted(async () => {
+  employees.value = await listEmployees()
+  await loadLogs()
+})
+</script>

frontend/pages/calendar.vue

@@ -49,6 +49,10 @@
                     <div :style="{ backgroundColor: type.color }" class="h-4 w-4 rounded"></div>
                     <p>{{ type.label }}</p>
                 </div>
+                <div class="flex items-center gap-2">
+                    <div class="h-4 w-4 rounded bg-indigo-500"></div>
+                    <p>FORMATION</p>
+                </div>
             </div>
         </div>
 
@@ -99,6 +103,8 @@ import {HALF_DAYS} from '~/services/dto/half-day'
 import {listEmployees, updateEmployeeOrder} from '~/services/employees'
 import {listAbsenceTypes} from '~/services/absence-types'
 import {createAbsence, deleteAbsence, listAbsences, updateAbsence} from '~/services/absences'
+import {listFormationsByDateRange} from '~/services/formations'
+import type {Formation} from '~/services/dto/formation'
 import {listPublicHolidays} from '~/services/public-holidays'
 import {getDaysInMonth, normalizeDate, parseYmd, toYmd} from '~/utils/date'
 import {compareEmployeesInSite, sortEmployeesBySiteAndOrder} from '~/utils/employee'
@@ -163,6 +169,7 @@ const visibleEmployees = computed(() => {
 // Données de référence et absences du mois affiché.
 const absenceTypes = ref<AbsenceType[]>([])
 const absences = ref<Absence[]>([])
+const formations = ref<Formation[]>([])
 const publicHolidays = ref<Record<string, string>>({})
 
 // États UI.
@@ -384,12 +391,18 @@ const loadAbsences = async () => {
     })
 }
 
+const loadFormations = async () => {
+    const monthStart = toYmd(selectedYear.value, selectedMonth.value, 1)
+    const monthEnd = toYmd(selectedYear.value, selectedMonth.value + 1, 0)
+    formations.value = await listFormationsByDateRange(monthStart, monthEnd)
+}
+
 onMounted(async () => {
-    await Promise.all([loadEmployees(), loadAbsenceTypes(), loadPublicHolidays(), loadAbsences()])
+    await Promise.all([loadEmployees(), loadAbsenceTypes(), loadPublicHolidays(), loadAbsences(), loadFormations()])
 })
 
 watch([selectedMonth, selectedYear, selectedSiteIds], async () => {
-    await loadAbsences()
+    await Promise.all([loadAbsences(), loadFormations()])
 })
 
 watch(selectedYear, async () => {
@@ -441,6 +454,42 @@ const cellAbsenceMap = computed(() => {
     return map
 })
 
+// Indexation des formations par cellule pour un lookup O(1).
+const cellFormationMap = computed(() => {
+    const set = new Set<string>()
+    const monthStart = monthStartDate.value
+    const monthEnd = monthEndDate.value
+
+    for (const formation of formations.value) {
+        const employeeId = formation.employee?.id
+        if (!employeeId) continue
+        const startDate = normalizeDate(formation.startDate)
+        const endDate = normalizeDate(formation.endDate)
+        const start = parseYmd(startDate)
+        const end = parseYmd(endDate)
+        if (!start || !end) continue
+
+        const rangeStart = start < monthStart ? monthStart : start
+        const rangeEnd = end > monthEnd ? monthEnd : end
+        if (rangeEnd < rangeStart) continue
+
+        for (
+            let currentDate = new Date(rangeStart.getTime());
+            currentDate <= rangeEnd;
+            currentDate.setDate(currentDate.getDate() + 1)
+        ) {
+            const dateKey = toYmd(currentDate.getFullYear(), currentDate.getMonth(), currentDate.getDate())
+            set.add(`${employeeId}-${dateKey}`)
+        }
+    }
+
+    return set
+})
+
+const hasFormationOn = (employeeId: number, date: string): boolean => {
+    return cellFormationMap.value.has(`${employeeId}-${date}`)
+}
+
 // Jours fériés (interdit pour la création).
 const isHolidayDate = (date: string) => {
     return Boolean(publicHolidays.value[date])
@@ -457,7 +506,16 @@ const getCellAbsence = (employeeId: number, date: string) => {
         }
     }
     const absence = cellAbsenceMap.value.get(`${employeeId}-${date}`)
-    if (absence) return absence
+    if (absence) return { ...absence, hasFormation: hasFormationOn(employeeId, date) }
+    if (hasFormationOn(employeeId, date)) {
+        return {
+            id: 0,
+            code: 'F',
+            color: '#6366f1',
+            textColor: '#fff',
+            hasFormation: true
+        }
+    }
     return null
 }
 

frontend/pages/documentation.vue

@@ -0,0 +1,9 @@
+<template>
+    <DocumentationPage/>
+</template>
+
+<script setup lang="ts">
+useHead({
+    title: 'Documentation',
+})
+</script>

frontend/pages/driver-hours.vue

@@ -43,6 +43,7 @@
                     :is-site-manager="isSiteManager"
                     :day-grid-cols="dayGridCols"
                     :is-holiday="isSelectedDateHoliday"
+                    :holiday-label="selectedHolidayLabel"
                     :contract-label="contractLabel"
                     :is-row-locked="isRowLocked"
                     :has-contract-at-selected-date="hasContractAtSelectedDate"
@@ -174,6 +175,7 @@ const {
   closeAbsenceDrawer,
   formatMinutes,
   isSelectedDateHoliday,
+  selectedHolidayLabel,
   handleSave
 } = useDriverHoursPage()
 

frontend/pages/employees/[id].vue

@@ -13,7 +13,16 @@
         <div v-else class="flex min-h-0 flex-1 flex-col">
             <div class="flex items-center justify-between">
                 <div>
-                    <h1 class="text-[32px] font-bold">{{ employee.firstName }} {{ employee.lastName }}</h1>
+                    <div class="flex items-center gap-4">
+                        <h1 class="text-[32px] font-bold">{{ employee.firstName }} {{ employee.lastName }}</h1>
+                        <button
+                            class="inline-flex items-center justify-center rounded-md p-1 transition-colors duration-150 focus:outline-none focus-visible:ring-2 bg-primary-500 hover:bg-secondary-500 active:bg-primary-500 text-white cursor-pointer"
+                            title="Export heures annuelles"
+                            @click="isYearlyHoursDrawerOpen = true"
+                        >
+                            <Icon name="mdi:printer" size="24" />
+                        </button>
+                    </div>
                     <p>Date d'entrée : {{ employee.entryDate ? employee.entryDate.split('-').reverse().join('/') : '-' }}</p>
                 </div>
                 <div class="text-right">
@@ -65,6 +74,16 @@
                         <Icon name="mdi:account-cash-outline" size="24" class="align-self"/>
                         Frais
                     </button>
+                    <button
+                        class="pb-2 border-b-2 flex items-center gap-3"
+                        :class="activeTab === 'formation'
+                            ? 'border-primary-500 text-primary-500'
+                            : 'border-transparent text-primary-500/50 hover:text-primary-500'"
+                        @click="activeTab = 'formation'"
+                    >
+                        <Icon name="mdi:school-outline" size="24" class="align-self"/>
+                        Formation
+                    </button>
                     <button
                         class="pb-2 border-b-2 flex items-center gap-3"
                         :class="activeTab === 'bonus'
@@ -75,6 +94,16 @@
                         <Icon name="mdi:money-100" size="24" class="align-self"/>
                         Prime
                     </button>
+                    <button
+                        class="pb-2 border-b-2 flex items-center gap-3"
+                        :class="activeTab === 'observation'
+                            ? 'border-primary-500 text-primary-500'
+                            : 'border-transparent text-primary-500/50 hover:text-primary-500'"
+                        @click="activeTab = 'observation'"
+                    >
+                        <Icon name="mdi:note-text-outline" size="24" class="align-self"/>
+                        Observation
+                    </button>
                 </div>
             </div>
             <div class="min-h-0 flex-1">
@@ -106,6 +135,8 @@
                     :requires-create-contract-end-date="requiresCreateContractEndDate"
                     :create-contract-end-date-field-class="createContractEndDateFieldClass"
                     :is-create-contract-form-valid="isCreateContractFormValid"
+                    :requires-create-work-days-hours="requiresCreateWorkDaysHours"
+                    :selected-create-contract="selectedCreateContract"
                     :on-open-close-contract-drawer="openCloseContractDrawer"
                     :on-open-create-contract-drawer="openCreateContractDrawer"
                     :on-update-contract-drawer-open="setContractDrawerOpen"
@@ -129,6 +160,7 @@
                         :summary="leaveSummary"
                         :public-holidays="publicHolidays"
                         @update-fractioned-days="submitFractionedDays"
+                        @update-paid-leave-days="submitPaidLeaveDays"
                     />
                 </div>
                 <div v-else-if="showRttTab && activeTab === 'rtt'" class="h-full">
@@ -151,6 +183,20 @@
                         @delete="submitDeleteMileage"
                     />
                 </div>
+                <div v-else-if="activeTab === 'formation'" class="h-full">
+                    <div v-if="isFormationLoading" class="mt-6 rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600">
+                        Chargement...
+                    </div>
+                    <EmployeesFormationTab
+                        v-else
+                        class="h-full"
+                        :formations="formations"
+                        :api-base="formationApiBase"
+                        @create="submitCreateFormation"
+                        @update="submitUpdateFormation"
+                        @delete="submitDeleteFormation"
+                    />
+                </div>
                 <div v-else-if="activeTab === 'bonus'" class="h-full">
                     <div v-if="isBonusLoading" class="mt-6 rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600">
                         Chargement...
@@ -164,12 +210,39 @@
                         @delete="submitDeleteBonus"
                     />
                 </div>
+                <div v-else-if="activeTab === 'observation'" class="h-full">
+                    <div v-if="isObservationLoading" class="mt-6 rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600">
+                        Chargement...
+                    </div>
+                    <EmployeesObservationTab
+                        v-else
+                        class="h-full"
+                        :observations="observations"
+                        @create="submitCreateObservation"
+                        @update="submitUpdateObservation"
+                        @delete="submitDeleteObservation"
+                    />
+                </div>
             </div>
         </div>
+
+        <EmployeeYearlyHoursDrawer
+            v-if="employee"
+            v-model="isYearlyHoursDrawerOpen"
+            :employee-id="employee.id"
+            @submit="handleYearlyHoursPrint"
+        />
     </div>
 </template>
 
 <script setup lang="ts">
+import { ref } from 'vue'
+import EmployeeYearlyHoursDrawer from '~/components/EmployeeYearlyHoursDrawer.vue'
+import { usePdfPrinter } from '~/composables/usePdfPrinter'
+
+const { printPdf } = usePdfPrinter()
+const isYearlyHoursDrawerOpen = ref(false)
+
 const {
     employee,
     isLoading,
@@ -203,6 +276,8 @@ const {
     requiresCreateContractEndDate,
     createContractEndDateFieldClass,
     isCreateContractFormValid,
+    requiresCreateWorkDaysHours,
+    selectedCreateContract,
     contractNatureLabel,
     contractHistoryLabel,
     formatDate,
@@ -213,6 +288,7 @@ const {
     submitContractUpdate,
     submitCreateContract,
     submitFractionedDays,
+    submitPaidLeaveDays,
     submitRttPayment,
     suspensionForms,
     isSuspensionSubmitting,
@@ -227,13 +303,30 @@ const {
     submitCreateMileage,
     submitUpdateMileage,
     submitDeleteMileage,
+    formations,
+    isFormationLoading,
+    formationApiBase,
+    submitCreateFormation,
+    submitUpdateFormation,
+    submitDeleteFormation,
     bonuses,
     isBonusLoading,
     submitCreateBonus,
     submitUpdateBonus,
-    submitDeleteBonus
+    submitDeleteBonus,
+    observations,
+    isObservationLoading,
+    submitCreateObservation,
+    submitUpdateObservation,
+    submitDeleteObservation
 } = useEmployeeDetailPage()
 
+const handleYearlyHoursPrint = async (year: number) => {
+    if (!employee.value) return
+    await printPdf(`/yearly-hours/print?employeeId=${employee.value.id}&year=${year}`)
+    isYearlyHoursDrawerOpen.value = false
+}
+
 useHead(() => ({
     title: employee.value
         ? `${employee.value.firstName} ${employee.value.lastName}`

frontend/pages/employees/index.vue

@@ -205,6 +205,11 @@
                             Chauffeur
                         </label>
                     </div>
+                    <WorkDaysHoursInput
+                        v-if="requiresSchedule"
+                        v-model="form.workDaysHours"
+                        :contract-weekly-hours="selectedContract?.weeklyHours ?? null"
+                    />
                 </template>
                 <div class="flex justify-end gap-3 pt-2">
                     <button
@@ -234,6 +239,8 @@
 
 <script setup lang="ts">
 import type {Contract} from '~/services/dto/contract'
+import WorkDaysHoursInput from '~/components/employees/WorkDaysHoursInput.vue'
+import { requiresWorkDaysHours } from '~/utils/contract'
 import type {Employee} from '~/services/dto/employee'
 import type {Site} from '~/services/dto/site'
 import {listContracts} from '~/services/contracts'
@@ -292,7 +299,8 @@ const form = reactive({
     contractNature: 'CDI' as 'CDI' | 'CDD' | 'INTERIM',
     contractStartDate: '',
     contractEndDate: '',
-    isDriver: false
+    isDriver: false,
+    workDaysHours: null as Record<number, number> | null
 })
 
 const validationTouched = reactive({
@@ -310,6 +318,21 @@ const isLastNameValid = computed(() => form.lastName.trim() !== '')
 const isSiteValid = computed(() => form.siteId !== '')
 const isContractValid = computed(() => form.contractId !== '')
 const isContractNatureValid = computed(() => isContractNature(form.contractNature))
+const selectedContract = computed<Contract | null>(() =>
+    contracts.value.find((c) => c.id === Number(form.contractId)) ?? null
+)
+const requiresSchedule = computed(() =>
+    !editingEmployee.value && requiresWorkDaysHours(selectedContract.value, form.contractNature)
+)
+const scheduleTotalMinutes = computed(() => {
+    const raw = form.workDaysHours ?? {}
+    return Object.values(raw).reduce((s, n) => s + (Number(n) || 0), 0)
+})
+const isScheduleValid = computed(() => {
+    if (!requiresSchedule.value) return true
+    const expected = (selectedContract.value?.weeklyHours ?? 0) * 60
+    return expected > 0 && scheduleTotalMinutes.value === expected
+})
 const isContractStartDateValid = computed(() => form.contractStartDate !== '')
 const showsContractEndDateComputed = computed(() => showsContractEndDate(form.contractNature))
 const requiresContractEndDateComputed = computed(() => requiresContractEndDate(form.contractNature))
@@ -327,7 +350,8 @@ const isFormValid = computed(
             : (isContractValid.value &&
                 isContractNatureValid.value &&
                 isContractStartDateValid.value &&
-                isContractEndDateValid.value))
+                isContractEndDateValid.value &&
+                isScheduleValid.value))
 )
 
 const showFirstNameError = computed(
@@ -478,7 +502,8 @@ const handleSubmit = async () => {
                 contractNature: form.contractNature,
                 contractStartDate: form.contractStartDate,
                 contractEndDate: form.contractEndDate || null,
-                isDriverInput: form.isDriver
+                isDriverInput: form.isDriver,
+                workDaysHoursInput: requiresSchedule.value ? form.workDaysHours : null
             })
         }
 
@@ -490,6 +515,7 @@ const handleSubmit = async () => {
         form.contractStartDate = new Date().toISOString().slice(0, 10)
         form.contractEndDate = ''
         form.isDriver = false
+        form.workDaysHours = null
         editingEmployee.value = null
         isDrawerOpen.value = false
         await loadEmployees()
@@ -516,6 +542,12 @@ watch(showsContractEndDateComputed, (shows) => {
     }
 })
 
+watch(requiresSchedule, (required) => {
+    if (!required) {
+        form.workDaysHours = null
+    }
+})
+
 const openEdit = (employee: Employee) => {
     editingEmployee.value = employee
     form.firstName = employee.firstName
@@ -534,6 +566,7 @@ const openCreate = () => {
     form.contractStartDate = new Date().toISOString().slice(0, 10)
     form.contractEndDate = ''
     form.isDriver = false
+    form.workDaysHours = null
     isDrawerOpen.value = true
 }
 

frontend/pages/hours.vue

@@ -43,6 +43,7 @@
                     :is-site-manager="isSiteManager"
                     :day-grid-cols="dayGridCols"
                     :is-holiday="isSelectedDateHoliday"
+                    :holiday-label="selectedHolidayLabel"
                     :contract-label="contractLabel"
                     :is-time-tracking="isTimeTracking"
                 :is-presence-tracking="isPresenceTracking"
@@ -67,6 +68,8 @@
                 :get-row-metrics="getRowMetrics"
                 :get-row-absence-label="getRowAbsenceLabel"
                 :get-row-absence-style="getRowAbsenceStyle"
+                :has-row-formation="hasRowFormation"
+                :get-row-formation-label="getRowFormationLabel"
                 :get-row-updated-at="getRowUpdatedAt"
                 :get-presence-day-value="getPresenceDayValue"
                 :on-absence-click="openAbsenceDrawer"
@@ -139,6 +142,7 @@ const {
   isSubmitting,
   dayGridCols,
   isSelectedDateHoliday,
+  selectedHolidayLabel,
   weekGridCols,
   saveButtonClass,
   formattedSelectedDate,
@@ -177,6 +181,8 @@ const {
   getRowMetrics,
   getRowAbsenceLabel,
   getRowAbsenceStyle,
+  hasRowFormation,
+  getRowFormationLabel,
   getRowUpdatedAt,
   getPresenceDayValue,
   openAbsenceDrawer,

frontend/pages/leave-recap.vue

@@ -0,0 +1,121 @@
+<template>
+  <div class="h-full flex flex-col overflow-hidden">
+    <div class="flex flex-wrap items-center justify-between gap-4 pb-8">
+      <h1 class="text-4xl font-bold text-primary-500">Récap. congés</h1>
+      <span
+        v-if="cutoffLabel"
+        class="inline-flex items-center gap-2 rounded-full bg-tertiary-500 px-4 py-1 text-sm font-semibold text-primary-500"
+      >
+        <Icon name="mdi:calendar-check-outline" size="18"/>
+        {{ cutoffLabel }}
+      </span>
+    </div>
+
+    <div
+      v-if="isLoading"
+      class="rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600"
+    >
+      Chargement...
+    </div>
+
+    <div
+      v-else-if="rows.length === 0"
+      class="rounded-lg border border-neutral-200 bg-white p-6 text-md text-neutral-600"
+    >
+      Aucun employé à afficher.
+    </div>
+
+    <div v-else class="min-h-0 overflow-auto rounded-md bg-white">
+      <div
+        :class="`grid ${gridColsClass} gap-4 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md sticky top-0 z-10`"
+      >
+        <span v-if="showSiteColumn" class="text-left">Site</span>
+        <span class="text-left">Nom</span>
+        <span class="text-left">Prénom</span>
+        <span class="text-left">Contrat</span>
+        <span class="text-right">CP N-1 restant</span>
+        <span class="text-right">Samedis</span>
+        <span class="text-right">CP N</span>
+        <span class="text-right">RTT</span>
+      </div>
+      <div class="border-x border-b border-primary-500 rounded-b-md">
+        <div
+          v-for="row in rows"
+          :key="row.employeeId"
+          :class="`grid ${gridColsClass} items-center gap-4 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0`"
+        >
+          <span v-if="showSiteColumn" class="truncate">
+            <span
+              v-if="row.siteName"
+              class="inline-block rounded-full px-3 py-1 text-sm"
+              :style="{ backgroundColor: row.siteColor || '#ffd7d7', color: '#1a1a1a' }"
+            >
+              {{ row.siteName }}
+            </span>
+            <span v-else class="text-neutral-500">-</span>
+          </span>
+          <span class="truncate">{{ row.lastName }}</span>
+          <span class="truncate">{{ row.firstName }}</span>
+          <span class="truncate">{{ row.contractName ?? '-' }}</span>
+          <span class="text-right tabular-nums">{{ formatNumber(row.cpN1Remaining) }}</span>
+          <span class="text-right tabular-nums">{{ row.acquiredSaturdays }}</span>
+          <span class="text-right tabular-nums">{{ row.cpN }}</span>
+          <span class="text-right tabular-nums">{{ row.rtt }}</span>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import type { LeaveRecapRow } from '~/services/dto/leave-recap'
+import { fetchLeaveRecap } from '~/services/leave-recap'
+import { formatYmdToFr, getIsoWeekNumber, parseYmd } from '~/utils/date'
+
+definePageMeta({ middleware: ['leave-recap-access'] })
+useHead({ title: 'Récap. congés' })
+
+const auth = useAuthStore()
+const rows = ref<LeaveRecapRow[]>([])
+const isLoading = ref(false)
+
+const isAdmin = computed(() => auth.user?.roles?.includes('ROLE_ADMIN') ?? false)
+const isSelfOnly = computed(() => {
+  const roles = auth.user?.roles ?? []
+  return roles.includes('ROLE_SELF') && !roles.includes('ROLE_ADMIN')
+})
+const showSiteColumn = computed(() => !isSelfOnly.value)
+const gridColsClass = computed(() =>
+  showSiteColumn.value
+    ? 'grid-cols-[1.2fr_1fr_1fr_1.2fr_140px_100px_100px_120px]'
+    : 'grid-cols-[1fr_1fr_1.2fr_140px_100px_100px_120px]'
+)
+
+const cutoffLabel = computed(() => {
+  const ymd = rows.value[0]?.cutoffDate
+  if (!ymd) return ''
+  const parsed = parseYmd(ymd)
+  if (!parsed) return ''
+  const week = getIsoWeekNumber(parsed)
+  return `Arrêté au ${formatYmdToFr(ymd)} (fin S${week})`
+})
+
+const formatNumber = (value: number) => {
+  if (!Number.isFinite(value)) return '-'
+  return value.toLocaleString('fr-FR', { minimumFractionDigits: 0, maximumFractionDigits: 2 })
+}
+
+const load = async () => {
+  isLoading.value = true
+  try {
+    rows.value = await fetchLeaveRecap()
+  } finally {
+    isLoading.value = false
+  }
+}
+
+onMounted(load)
+
+// Silence unused linter warning for isAdmin (kept for future site grouping)
+void isAdmin
+</script>

frontend/pages/login.vue

@@ -69,7 +69,8 @@ const handleSubmit = async () => {
         await auth.login(username.value, password.value)
 
         const isAdmin = auth.user?.roles?.includes('ROLE_ADMIN')
-        await router.push(isAdmin ? '/calendar' : '/hours')
+        const isDriver = auth.user?.isDriver
+        await router.push(isAdmin ? '/calendar' : isDriver ? '/driver-hours' : '/hours')
     } finally {
         isSubmitting.value = false
     }

frontend/pages/users.vue

@@ -19,11 +19,12 @@
     </div>
 
     <div v-else class="min-h-0 overflow-auto rounded-md bg-white">
-      <div class="grid grid-cols-4 gap-4 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md sticky top-0 z-10">
+      <div class="grid grid-cols-5 gap-4 border border-black bg-tertiary-500 px-6 py-3 text-[20px] font-semibold text-black rounded-t-md sticky top-0 z-10">
         <span class="text-left">Utilisateur</span>
         <span class="text-left">Employé</span>
         <span class="text-left">Accès</span>
         <span class="text-left">Sites</span>
+        <span class="text-left">Statut</span>
       </div>
       <div v-if="isLoading" class="px-6 py-4 text-md text-neutral-500">
         Chargement...
@@ -32,7 +33,7 @@
         <div
           v-for="user in users"
           :key="user.id"
-          class="grid grid-cols-4 items-center gap-4 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0 cursor-pointer hover:bg-tertiary-500"
+          class="grid grid-cols-5 items-center gap-4 border-b border-primary-500 px-6 py-3 text-md font-bold text-primary-500 last:border-b-0 cursor-pointer hover:bg-tertiary-500"
           @click="openEdit(user)"
         >
           <span>{{ user.username }}</span>
@@ -41,6 +42,16 @@
           </span>
           <span>{{ getAccessLabel(user) }}</span>
           <span>{{ getSiteLabels(user) }}</span>
+          <span>
+            <span
+              v-if="user.isLocked"
+              class="inline-block rounded-full bg-red-100 px-3 py-1 text-sm font-semibold text-red-700"
+            >Verrouillé</span>
+            <span
+              v-else
+              class="inline-block rounded-full bg-green-100 px-3 py-1 text-sm font-semibold text-green-700"
+            >Actif</span>
+          </span>
         </div>
       </div>
     </div>
@@ -164,6 +175,34 @@
           </p>
         </div>
 
+        <div>
+          <label class="flex items-center gap-2 cursor-pointer">
+            <input
+              v-model="form.isLocked"
+              type="checkbox"
+              class="cursor-pointer"
+            />
+            <span class="text-md font-semibold text-neutral-700">Verrouiller le compte</span>
+          </label>
+          <p class="mt-1 text-sm text-neutral-500">
+            Un compte verrouillé ne peut plus se connecter.
+          </p>
+        </div>
+
+        <div>
+          <label class="flex items-center gap-2 cursor-pointer">
+            <input
+              v-model="form.hasLeaveRecapAccess"
+              type="checkbox"
+              class="cursor-pointer"
+            />
+            <span class="text-md font-semibold text-neutral-700">Accès à l'écran Récap. congés</span>
+          </label>
+          <p class="mt-1 text-sm text-neutral-500">
+            Affiche l'onglet dans la sidebar et donne accès au tableau récap.
+          </p>
+        </div>
+
         <div class="flex justify-center pt-2">
           <button
             type="submit"
@@ -207,7 +246,9 @@ const form = reactive({
   password: '',
   accessMode: 'admin' as 'admin' | 'self' | 'sites',
   employeeId: '' as number | '',
-  siteIds: [] as number[]
+  siteIds: [] as number[],
+  isLocked: false,
+  hasLeaveRecapAccess: false
 })
 
 const validationTouched = reactive({
@@ -318,6 +359,8 @@ const resetForm = () => {
   form.employeeId = ''
   form.accessMode = 'admin'
   form.siteIds = []
+  form.isLocked = false
+  form.hasLeaveRecapAccess = false
   editingUser.value = null
   validationTouched.username = false
   validationTouched.password = false
@@ -345,6 +388,8 @@ const openEdit = (user: User) => {
   }
 
   form.employeeId = user.employee?.id ?? ''
+  form.isLocked = user.isLocked
+  form.hasLeaveRecapAccess = user.hasLeaveRecapAccess ?? false
 
   const siteRoles = userAccessById.value.get(user.id) ?? []
   form.siteIds = siteRoles.map((role) => role.site?.id).filter((id): id is number => typeof id === 'number')
@@ -398,7 +443,9 @@ const handleSubmit = async () => {
         username: form.username,
         plainPassword: form.password.trim() ? form.password : undefined,
         roles,
-        employeeId
+        employeeId,
+        isLocked: form.isLocked,
+        hasLeaveRecapAccess: form.hasLeaveRecapAccess
       })
 
       const existingSiteRoles = userAccessById.value.get(editingUser.value.id) ?? []
@@ -422,7 +469,9 @@ const handleSubmit = async () => {
         username: form.username,
         plainPassword: form.password,
         roles,
-        employeeId
+        employeeId,
+        isLocked: form.isLocked,
+        hasLeaveRecapAccess: form.hasLeaveRecapAccess
       })
 
       if (form.accessMode === 'sites' && form.siteIds.length > 0) {

frontend/services/audit-logs.ts

@@ -0,0 +1,33 @@
+import type { AuditLog } from './dto/audit-log'
+
+export type AuditLogFilters = {
+  employeeId?: number
+  from?: string
+  to?: string
+  entityType?: string
+  page?: number
+}
+
+export type AuditLogPage = {
+  items: AuditLog[]
+  total: number
+  page: number
+  perPage: number
+}
+
+export const fetchAuditLogs = async (filters: AuditLogFilters = {}): Promise<AuditLogPage> => {
+  const api = useApi()
+  const params: Record<string, string> = {}
+
+  if (filters.employeeId) params.employeeId = String(filters.employeeId)
+  if (filters.from) params.from = filters.from
+  if (filters.to) params.to = filters.to
+  if (filters.entityType) params.entityType = filters.entityType
+  if (filters.page) params.page = String(filters.page)
+
+  return api.get<AuditLogPage>(
+    '/audit-logs',
+    params,
+    { toast: false }
+  )
+}

frontend/services/dto/audit-log.ts

@@ -0,0 +1,12 @@
+export type AuditLog = {
+  id: number
+  employeeName: string | null
+  employeeId: number | null
+  username: string
+  action: string
+  entityType: string
+  description: string
+  changes: { old?: Record<string, unknown>; new?: Record<string, unknown> } | null
+  affectedDate: string | null
+  createdAt: string
+}

frontend/services/dto/employee-leave-summary.ts

@@ -13,6 +13,7 @@ export type EmployeeLeaveSummary = {
   previousYearAcquiredDays: number
   previousYearTakenDays: number
   previousYearRemainingDays: number
+  previousYearPaidDays: number
   presenceDaysByMonth: Record<string, number>
 }
 

frontend/services/dto/employee.ts

@@ -19,6 +19,7 @@ export type ContractHistoryItem = {
   periodId?: number | null
   suspensions?: ContractSuspension[]
   isDriver?: boolean
+  workDaysHours?: Record<number, number> | null
 }
 
 export type Employee = {

frontend/services/dto/formation.ts

@@ -0,0 +1,12 @@
+import type { Employee } from './employee'
+
+export type Formation = {
+  id: number
+  startDate: string
+  endDate: string
+  comment: string | null
+  justificatifPath: string | null
+  justificatifName: string | null
+  createdAt: string
+  employee?: Employee
+}

frontend/services/dto/leave-recap.ts

@@ -0,0 +1,14 @@
+export type LeaveRecapRow = {
+  employeeId: number
+  lastName: string
+  firstName: string
+  siteId: number | null
+  siteName: string | null
+  siteColor: string | null
+  contractName: string | null
+  cpN1Remaining: number
+  cpN: string
+  acquiredSaturdays: string
+  rtt: string
+  cutoffDate: string
+}

frontend/services/dto/observation.ts

@@ -0,0 +1,6 @@
+export type Observation = {
+  id: number
+  month: string
+  content: string
+  createdAt: string
+}

frontend/services/dto/user-data.ts

@@ -2,4 +2,6 @@ export type UserData = {
   id: number
   username: string
   roles: string[]
+  isDriver: boolean
+  hasLeaveRecapAccess: boolean
 }

frontend/services/dto/user.ts

@@ -4,5 +4,7 @@ export type User = {
   id: number
   username: string
   roles: string[]
+  isLocked: boolean
+  hasLeaveRecapAccess: boolean
   employee?: Employee | null
 }

frontend/services/dto/work-hour.ts

@@ -59,6 +59,7 @@ export type WeeklyWorkHourDailySummary = {
   hasLunch?: boolean
   hasDinner?: boolean
   hasOvernight?: boolean
+  virtualHolidayMinutes?: number
 }
 
 export type WeeklyWorkHourRowSummary = {
@@ -106,6 +107,9 @@ export type WorkHourDayContextRow = {
   creditedMinutes: number
   creditedPresenceUnits: number
   isDriverContract?: boolean
+  hasFormation?: boolean
+  formationLabel?: string | null
+  virtualHolidayMinutes?: number
 }
 
 export type WorkHourDayContext = {

frontend/services/employee-leave-summary.ts

@@ -16,3 +16,11 @@ export const updateFractionedDays = async (employeeId: number, fractionedDays: n
   return api.patch(`/employees/${employeeId}/fractioned-days`, body)
 }
 
+export const updatePaidLeaveDays = async (employeeId: number, paidLeaveDays: number, year?: number) => {
+  const api = useApi()
+  const body: Record<string, unknown> = { paidLeaveDays }
+  if (year) body.year = year
+
+  return api.patch(`/employees/${employeeId}/paid-leave-days`, body)
+}
+

frontend/services/employees.ts

@@ -35,6 +35,7 @@ export const createEmployee = async (payload: {
   contractStartDate?: string
   contractEndDate?: string | null
   isDriverInput?: boolean
+  workDaysHoursInput?: Record<number, number> | null
 }) => {
   const api = useApi()
   return api.post<Employee>('/employees', {
@@ -45,7 +46,8 @@ export const createEmployee = async (payload: {
     contractNature: payload.contractNature,
     contractStartDate: payload.contractStartDate,
     contractEndDate: payload.contractEndDate ?? null,
-    isDriverInput: payload.isDriverInput ?? false
+    isDriverInput: payload.isDriverInput ?? false,
+    workDaysHoursInput: payload.workDaysHoursInput ?? null
   }, {
     toastSuccessKey: 'success.employee.create',
     toastErrorKey: 'errors.employee.create'
@@ -66,6 +68,7 @@ export const updateEmployee = async (
     contractComment?: string | null
     displayOrder?: number
     isDriverInput?: boolean
+    workDaysHoursInput?: Record<number, number> | null
   }
 ) => {
   const api = useApi()
@@ -97,6 +100,9 @@ export const updateEmployee = async (
   if (payload.isDriverInput !== undefined) {
     body.isDriverInput = payload.isDriverInput
   }
+  if (payload.workDaysHoursInput !== undefined) {
+    body.workDaysHoursInput = payload.workDaysHoursInput
+  }
 
   return api.patch<Employee>(`/employees/${id}`, body, {
     toastSuccessKey: 'success.employee.update',

frontend/services/formations.ts

@@ -0,0 +1,82 @@
+import { $fetch } from 'ofetch'
+import type { Formation } from './dto/formation'
+import { extractItems } from '~/utils/api'
+
+export const listFormations = async (employeeId: number) => {
+  const api = useApi()
+  const data = await api.get<Formation[] | { 'hydra:member'?: Formation[] }>(
+    '/formations',
+    { employee: `/api/employees/${employeeId}` },
+    { toast: false }
+  )
+  return extractItems<Formation>(data)
+}
+
+export const listFormationsByDateRange = async (from: string, to: string) => {
+  const api = useApi()
+  const data = await api.get<Formation[] | { 'hydra:member'?: Formation[] }>(
+    '/formations',
+    {
+      'startDate[before]': to,
+      'endDate[after]': from
+    },
+    { toast: false }
+  )
+  return extractItems<Formation>(data)
+}
+
+export const createFormation = async (data: {
+  employeeId: number
+  startDate: string
+  endDate: string
+  comment?: string
+}) => {
+  const api = useApi()
+  return api.post<Formation>('/formations', {
+    employee: `/api/employees/${data.employeeId}`,
+    startDate: data.startDate,
+    endDate: data.endDate,
+    comment: data.comment
+  }, {
+    toastSuccessKey: 'success.formation.create',
+    toastErrorKey: 'errors.formation.create'
+  })
+}
+
+export const updateFormation = async (id: number, data: {
+  startDate: string
+  endDate: string
+  comment?: string
+}) => {
+  const api = useApi()
+  return api.patch<Formation>(`/formations/${id}`, {
+    startDate: data.startDate,
+    endDate: data.endDate,
+    comment: data.comment
+  }, {
+    toastSuccessKey: 'success.formation.update',
+    toastErrorKey: 'errors.formation.update'
+  })
+}
+
+export const deleteFormation = async (id: number) => {
+  const api = useApi()
+  return api.delete(`/formations/${id}`, {}, {
+    toastSuccessKey: 'success.formation.delete',
+    toastErrorKey: 'errors.formation.delete'
+  })
+}
+
+export const uploadFormationJustificatif = async (baseURL: string, id: number, file: File) => {
+  const formData = new FormData()
+  formData.append('file', file)
+  return $fetch(`${baseURL}/formations/${id}/justificatif`, {
+    method: 'POST',
+    body: formData,
+    credentials: 'include'
+  })
+}
+
+export const getFormationJustificatifUrl = (baseURL: string, id: number): string => {
+  return `${baseURL}/formations/${id}/justificatif`
+}

frontend/services/leave-recap.ts

@@ -0,0 +1,12 @@
+import type { LeaveRecapRow } from './dto/leave-recap'
+import { extractItems } from '~/utils/api'
+
+export const fetchLeaveRecap = async (): Promise<LeaveRecapRow[]> => {
+  const api = useApi()
+  const data = await api.get<LeaveRecapRow[] | { 'hydra:member'?: LeaveRecapRow[] }>(
+    '/leave-recap',
+    {},
+    { toastErrorKey: 'errors.leaveRecap.load' }
+  )
+  return extractItems<LeaveRecapRow>(data)
+}

frontend/services/observations.ts

@@ -0,0 +1,50 @@
+import type { Observation } from './dto/observation'
+import { extractItems } from '~/utils/api'
+
+export const listObservations = async (employeeId: number) => {
+  const api = useApi()
+  const data = await api.get<Observation[] | { 'hydra:member'?: Observation[] }>(
+    '/observations',
+    { employee: `/api/employees/${employeeId}` },
+    { toast: false }
+  )
+  return extractItems<Observation>(data)
+}
+
+export const createObservation = async (data: {
+  employeeId: number
+  month: string
+  content: string
+}) => {
+  const api = useApi()
+  return api.post<Observation>('/observations', {
+    employee: `/api/employees/${data.employeeId}`,
+    month: data.month,
+    content: data.content
+  }, {
+    toastSuccessKey: 'success.observation.create',
+    toastErrorKey: 'errors.observation.create'
+  })
+}
+
+export const updateObservation = async (id: number, data: {
+  month: string
+  content: string
+}) => {
+  const api = useApi()
+  return api.patch<Observation>(`/observations/${id}`, {
+    month: data.month,
+    content: data.content
+  }, {
+    toastSuccessKey: 'success.observation.update',
+    toastErrorKey: 'errors.observation.update'
+  })
+}
+
+export const deleteObservation = async (id: number) => {
+  const api = useApi()
+  return api.delete(`/observations/${id}`, {}, {
+    toastSuccessKey: 'success.observation.delete',
+    toastErrorKey: 'errors.observation.delete'
+  })
+}

frontend/services/users.ts

@@ -16,6 +16,8 @@ export const createUser = async (payload: {
   plainPassword: string
   roles: string[]
   employeeId?: number | null
+  isLocked?: boolean
+  hasLeaveRecapAccess?: boolean
 }) => {
   const api = useApi()
   return api.post<User>(
@@ -24,7 +26,9 @@ export const createUser = async (payload: {
       username: payload.username,
       plainPassword: payload.plainPassword,
       roles: payload.roles,
-      employee: payload.employeeId ? `/api/employees/${payload.employeeId}` : null
+      employee: payload.employeeId ? `/api/employees/${payload.employeeId}` : null,
+      isLocked: payload.isLocked ?? false,
+      hasLeaveRecapAccess: payload.hasLeaveRecapAccess ?? false
     },
     {
       toastSuccessKey: 'success.user.create',
@@ -38,12 +42,16 @@ export const updateUser = async (id: number, payload: {
   plainPassword?: string
   roles: string[]
   employeeId?: number | null
+  isLocked?: boolean
+  hasLeaveRecapAccess?: boolean
 }) => {
   const api = useApi()
   const body: Record<string, unknown> = {
     username: payload.username,
     roles: payload.roles,
-    employee: payload.employeeId ? `/api/employees/${payload.employeeId}` : null
+    employee: payload.employeeId ? `/api/employees/${payload.employeeId}` : null,
+    isLocked: payload.isLocked ?? false,
+    hasLeaveRecapAccess: payload.hasLeaveRecapAccess ?? false
   }
 
   if (payload.plainPassword) {

frontend/types/documentation.ts

@@ -0,0 +1,21 @@
+export type DocAccessLevel = 'employee' | 'site_manager' | 'admin'
+
+export interface DocBlock {
+  type: 'paragraph' | 'list' | 'note'
+  content: string
+}
+
+export interface DocArticle {
+  id: string
+  title: string
+  requiredLevel: DocAccessLevel
+  blocks: DocBlock[]
+}
+
+export interface DocSection {
+  id: string
+  title: string
+  requiredLevel: DocAccessLevel
+  icon: string
+  articles: DocArticle[]
+}

frontend/utils/contract.ts

@@ -19,3 +19,43 @@ export const requiresContractEndDate = (nature: ContractNature) => {
 export const isContractNature = (value: string): value is ContractNature => {
   return (CONTRACT_NATURES as readonly string[]).includes(value)
 }
+
+/**
+ * Whether a contract + nature pair requires the per-day schedule (workDaysHours).
+ * Mirrors EmployeeContractPeriodValidator::assertWorkDaysHours on the backend.
+ */
+export const requiresWorkDaysHours = (
+  contract: { trackingMode?: string | null; weeklyHours?: number | null } | null | undefined,
+  nature: ContractNature
+): boolean => {
+  if (!contract) return false
+  if (nature === 'INTERIM') return false
+  if (contract.trackingMode === 'PRESENCE') return false
+  if (contract.weeklyHours === 35 || contract.weeklyHours === 39) return false
+  return true
+}
+
+const DAY_SHORT_LABELS: Record<number, string> = { 1: 'Lun', 2: 'Mar', 3: 'Mer', 4: 'Jeu', 5: 'Ven' }
+
+/**
+ * Compact human-readable summary of a per-day schedule, e.g. "Lun 2h, Jeu 2h".
+ * Returns null when the schedule is empty/unset.
+ */
+export const formatWorkDaysHoursSummary = (
+  workDaysHours: Record<number, number> | null | undefined
+): string | null => {
+  if (!workDaysHours) return null
+  const entries = Object.entries(workDaysHours)
+    .map(([iso, minutes]) => [Number(iso), Number(minutes)] as const)
+    .filter(([iso, minutes]) => iso >= 1 && iso <= 5 && minutes > 0)
+    .sort(([a], [b]) => a - b)
+  if (entries.length === 0) return null
+  return entries
+    .map(([iso, minutes]) => {
+      const h = Math.floor(minutes / 60)
+      const m = minutes % 60
+      const suffix = m === 0 ? `${h}h` : `${h}h${String(m).padStart(2, '0')}`
+      return `${DAY_SHORT_LABELS[iso]} ${suffix}`
+    })
+    .join(', ')
+}

migrations/Version20260325081258.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260325081258 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Create observations table with unique constraint on (employee_id, month)';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('CREATE TABLE observations (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, employee_id INT NOT NULL, month DATE NOT NULL, content TEXT NOT NULL, created_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL, PRIMARY KEY (id))');
+        $this->addSql('CREATE INDEX IDX_BBC15BA88C03F15C ON observations (employee_id)');
+        $this->addSql('CREATE UNIQUE INDEX uniq_observation_employee_month ON observations (employee_id, month)');
+        $this->addSql('ALTER TABLE observations ADD CONSTRAINT FK_BBC15BA88C03F15C FOREIGN KEY (employee_id) REFERENCES employees (id) NOT DEFERRABLE');
+        $this->addSql("COMMENT ON COLUMN observations.month IS '(DC2Type:date_immutable)'");
+        $this->addSql("COMMENT ON COLUMN observations.created_at IS '(DC2Type:datetime_immutable)'");
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE observations DROP CONSTRAINT FK_BBC15BA88C03F15C');
+        $this->addSql('DROP TABLE observations');
+    }
+}

migrations/Version20260325084215.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260325084215 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add is_locked column to users table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE users ADD is_locked BOOLEAN DEFAULT false NOT NULL');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE users DROP is_locked');
+    }
+}

migrations/Version20260330120000.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260330120000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Create audit_logs table for tracking user actions.';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('CREATE TABLE audit_logs (
+            id SERIAL PRIMARY KEY,
+            employee_id INTEGER DEFAULT NULL,
+            username VARCHAR(180) NOT NULL,
+            action VARCHAR(30) NOT NULL,
+            entity_type VARCHAR(50) NOT NULL,
+            entity_id INTEGER DEFAULT NULL,
+            description TEXT NOT NULL,
+            changes JSON DEFAULT NULL,
+            affected_date DATE DEFAULT NULL,
+            created_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL,
+            CONSTRAINT fk_audit_employee FOREIGN KEY (employee_id) REFERENCES employees (id) ON DELETE SET NULL
+        )');
+
+        $this->addSql('CREATE INDEX idx_audit_employee_created ON audit_logs (employee_id, created_at)');
+        $this->addSql('CREATE INDEX idx_audit_entity ON audit_logs (entity_type, entity_id)');
+        $this->addSql('CREATE INDEX idx_audit_created ON audit_logs (created_at)');
+        $this->addSql('CREATE INDEX idx_audit_affected_date ON audit_logs (affected_date)');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('DROP TABLE audit_logs');
+    }
+}

migrations/Version20260402064647.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260402064647 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add paid_leave_days column to employee_leave_balances for forfait N-1 leave payment';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE employee_leave_balances ADD paid_leave_days DOUBLE PRECISION DEFAULT 0 NOT NULL');
+        $this->addSql("COMMENT ON COLUMN employee_leave_balances.paid_leave_days IS 'Jours de conges N-1 payes par la RH (forfait uniquement).'");
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE employee_leave_balances DROP paid_leave_days');
+    }
+}

migrations/Version20260413120000.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260413120000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Create formations table';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('CREATE TABLE formations (id INT GENERATED BY DEFAULT AS IDENTITY NOT NULL, employee_id INT NOT NULL, start_date DATE NOT NULL, end_date DATE NOT NULL, comment TEXT DEFAULT NULL, justificatif_path VARCHAR(255) DEFAULT NULL, justificatif_name VARCHAR(255) DEFAULT NULL, created_at TIMESTAMP(0) WITHOUT TIME ZONE NOT NULL, PRIMARY KEY (id))');
+        $this->addSql('CREATE INDEX IDX_FORMATION_EMPLOYEE ON formations (employee_id)');
+        $this->addSql('ALTER TABLE formations ADD CONSTRAINT FK_FORMATION_EMPLOYEE FOREIGN KEY (employee_id) REFERENCES employees (id) NOT DEFERRABLE');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE formations DROP CONSTRAINT FK_FORMATION_EMPLOYEE');
+        $this->addSql('DROP TABLE formations');
+    }
+}

migrations/Version20260414100000.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260414100000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add has_leave_recap_access flag on users';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE users ADD has_leave_recap_access BOOLEAN DEFAULT FALSE NOT NULL');
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE users DROP has_leave_recap_access');
+    }
+}

migrations/Version20260416100000.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260416100000 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return 'Add work_days_hours JSON on employee_contract_periods (schedule for non-standard contracts) + seed Ewa and Nadia';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE employee_contract_periods ADD work_days_hours JSON DEFAULT NULL');
+
+        // Seed the two known 4h employees currently in production.
+        // Ewa DALEMBA: Lundi 2h + Jeudi 2h
+        // Nadia GARRAUD: Mardi 2h + Vendredi 2h
+        // Filter on last_name + first_name (not ids) to stay safe across environments,
+        // and only on periods without an already-set schedule to remain idempotent.
+        $this->addSql(
+            "UPDATE employee_contract_periods ecp SET work_days_hours = '{\"1\":120,\"4\":120}' "
+            .'FROM employees e '
+            .'WHERE ecp.employee_id = e.id '
+            ."AND e.last_name = 'DALEMBA' AND e.first_name = 'Ewa' "
+            .'AND ecp.end_date IS NULL AND ecp.work_days_hours IS NULL'
+        );
+        $this->addSql(
+            "UPDATE employee_contract_periods ecp SET work_days_hours = '{\"2\":120,\"5\":120}' "
+            .'FROM employees e '
+            .'WHERE ecp.employee_id = e.id '
+            ."AND e.last_name = 'GARRAUD' AND e.first_name = 'Nadia' "
+            .'AND ecp.end_date IS NULL AND ecp.work_days_hours IS NULL'
+        );
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql('ALTER TABLE employee_contract_periods DROP work_days_hours');
+    }
+}

src/ApiResource/AuditLogResource.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\QueryParameter;
+use App\State\AuditLogProvider;
+
+#[ApiResource(
+    operations: [
+        new GetCollection(
+            uriTemplate: '/audit-logs',
+            provider: AuditLogProvider::class,
+            parameters: [
+                new QueryParameter(key: 'employeeId'),
+                new QueryParameter(key: 'from'),
+                new QueryParameter(key: 'to'),
+                new QueryParameter(key: 'entityType'),
+            ],
+            security: "is_granted('ROLE_SUPER_ADMIN')"
+        ),
+    ]
+)]
+final class AuditLogResource {}

src/ApiResource/EmployeeLeaveRecap.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\GetCollection;
+use App\State\EmployeeLeaveRecapProvider;
+
+#[ApiResource(
+    operations: [
+        new GetCollection(
+            uriTemplate: '/leave-recap',
+            paginationEnabled: false,
+            security: "is_granted('ROLE_USER')",
+            provider: EmployeeLeaveRecapProvider::class,
+        ),
+    ],
+)]
+final class EmployeeLeaveRecap
+{
+    public int $employeeId           = 0;
+    public string $lastName          = '';
+    public string $firstName         = '';
+    public ?int $siteId              = null;
+    public ?string $siteName         = null;
+    public ?string $siteColor        = null;
+    public ?string $contractName     = null;
+    public int $contractSortKey      = 99;
+    public float $cpN1Remaining      = 0.0;
+    public string $cpN               = '-';
+    public string $acquiredSaturdays = '-';
+    public string $rtt               = '-';
+    public string $cutoffDate        = '';
+}

src/ApiResource/EmployeeLeaveSummary.php

@@ -34,6 +34,7 @@ final class EmployeeLeaveSummary
     public float $previousYearAcquiredDays  = 0.0;
     public float $previousYearTakenDays     = 0.0;
     public float $previousYearRemainingDays = 0.0;
+    public float $previousYearPaidDays      = 0.0;
 
     /** @var array<string, float> YYYY-MM => count (0.5 for half-days) */
     public array $presenceDaysByMonth = [];

src/ApiResource/EmployeePaidLeaveDaysInput.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\ApiResource;
+
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Patch;
+use App\State\EmployeePaidLeaveDaysProcessor;
+use App\State\EmployeePaidLeaveDaysProvider;
+
+#[ApiResource(
+    operations: [
+        new Patch(
+            uriTemplate: '/employees/{id}/paid-leave-days',
+            security: "is_granted('ROLE_ADMIN')",
+            provider: EmployeePaidLeaveDaysProvider::class,
+            processor: EmployeePaidLeaveDaysProcessor::class
+        ),
+    ],
+    paginationEnabled: false
+)]
+final class EmployeePaidLeaveDaysInput
+{
+    public float $paidLeaveDays = 0.0;
+    public ?int $year           = null;
+}

src/ApiResource/EmployeeYearlyHoursPrint.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\EmployeeYearlyHoursPrintProvider;
+
+#[ApiResource(
+    operations: [
+        new Get(
+            uriTemplate: '/yearly-hours/print',
+            provider: EmployeeYearlyHoursPrintProvider::class,
+            parameters: [
+                new QueryParameter(key: 'employeeId', required: true),
+                new QueryParameter(key: 'year', required: true),
+            ],
+            security: "is_granted('ROLE_USER')"
+        ),
+    ]
+)]
+final class EmployeeYearlyHoursPrint {}

src/Command/DumpVerificationSnapshotCommand.php

@@ -0,0 +1,805 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Command;
+
+use App\Dto\Rtt\EmployeeRttWeekSummary;
+use App\Dto\Rtt\WeekRecoveryDetail;
+use App\Entity\Employee;
+use App\Enum\ContractType;
+use App\Enum\TrackingMode;
+use App\Repository\AbsenceRepository;
+use App\Repository\EmployeeContractPeriodRepository;
+use App\Repository\EmployeeRepository;
+use App\Repository\EmployeeRttBalanceRepository;
+use App\Repository\EmployeeRttPaymentRepository;
+use App\Repository\WorkHourRepository;
+use App\Service\Leave\LeaveRecapRowBuilder;
+use App\Service\Rtt\RttRecoveryComputationService;
+use App\State\EmployeeLeaveSummaryProvider;
+use DateTimeImmutable;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputArgument;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+#[AsCommand(
+    name: 'app:verification:snapshot',
+    description: 'Dump per-employee Markdown snapshot of RTT (monthly tab view) and leave balances, to serve as a regression baseline before business-rule refactors.'
+)]
+final class DumpVerificationSnapshotCommand extends Command
+{
+    private const array MONTH_LABELS = [
+        1 => 'Janvier', 2 => 'Février', 3 => 'Mars', 4 => 'Avril',
+        5 => 'Mai', 6 => 'Juin', 7 => 'Juillet', 8 => 'Août',
+        9 => 'Septembre', 10 => 'Octobre', 11 => 'Novembre', 12 => 'Décembre',
+    ];
+
+    public function __construct(
+        private readonly EmployeeRepository $employeeRepository,
+        private readonly EmployeeContractPeriodRepository $contractPeriodRepository,
+        private readonly EmployeeLeaveSummaryProvider $leaveSummaryProvider,
+        private readonly LeaveRecapRowBuilder $leaveRecapRowBuilder,
+        private readonly RttRecoveryComputationService $rttRecoveryService,
+        private readonly EmployeeRttBalanceRepository $rttBalanceRepository,
+        private readonly EmployeeRttPaymentRepository $rttPaymentRepository,
+        private readonly WorkHourRepository $workHourRepository,
+        private readonly AbsenceRepository $absenceRepository,
+        #[Autowire('%kernel.project_dir%')]
+        private readonly string $projectDir,
+    ) {
+        parent::__construct();
+    }
+
+    protected function configure(): void
+    {
+        $this
+            ->addArgument(
+                'employee_ids',
+                InputArgument::IS_ARRAY | InputArgument::REQUIRED,
+                'Employee IDs to snapshot (space-separated).'
+            )
+            ->addOption(
+                'output-dir',
+                null,
+                InputOption::VALUE_OPTIONAL,
+                'Output directory (relative to project root, or absolute).',
+                'docs/verifications'
+            )
+            ->addOption(
+                'rtt-year',
+                null,
+                InputOption::VALUE_OPTIONAL,
+                'RTT exercise year (ending year, e.g. 2026 = June 2025 → May 2026). Defaults to current exercise.'
+            )
+        ;
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        $io  = new SymfonyStyle($input, $output);
+        $ids = array_map('intval', $input->getArgument('employee_ids'));
+
+        $outputDirOpt = (string) $input->getOption('output-dir');
+        $outputDir    = str_starts_with($outputDirOpt, '/')
+            ? $outputDirOpt
+            : $this->projectDir.'/'.$outputDirOpt;
+
+        if (!is_dir($outputDir) && !mkdir($outputDir, 0o755, true) && !is_dir($outputDir)) {
+            $io->error('Could not create output directory: '.$outputDir);
+
+            return Command::FAILURE;
+        }
+
+        $today      = new DateTimeImmutable('today');
+        $rttYearOpt = $input->getOption('rtt-year');
+        $rttYear    = null !== $rttYearOpt && '' !== (string) $rttYearOpt
+            ? (int) $rttYearOpt
+            : $this->resolveCurrentRttExerciseYear($today);
+
+        foreach ($ids as $id) {
+            $employee = $this->employeeRepository->find($id);
+            if (!$employee instanceof Employee) {
+                $io->warning(sprintf('Employee id=%d not found — skipped.', $id));
+
+                continue;
+            }
+
+            $markdown = $this->buildEmployeeDoc($employee, $rttYear, $today);
+            $slug     = $this->slugify($employee->getFirstName().'-'.$employee->getLastName());
+            $filename = sprintf('%s/verification-rtt-conges-%s.md', $outputDir, $slug);
+            file_put_contents($filename, $markdown);
+            $io->success(sprintf('Wrote %s', $filename));
+        }
+
+        return Command::SUCCESS;
+    }
+
+    private function buildEmployeeDoc(Employee $employee, int $rttYear, DateTimeImmutable $today): string
+    {
+        $parts   = [];
+        $parts[] = $this->buildHeader($employee, $rttYear, $today);
+        $parts[] = $this->buildProfileSection($employee);
+        $parts[] = $this->buildLeaveSection($employee, $today);
+        $parts[] = $this->buildRecapRowSection($employee, $today);
+        $parts[] = $this->buildRttSection($employee, $rttYear, $today);
+
+        return implode("\n\n", $parts)."\n";
+    }
+
+    private function buildHeader(Employee $employee, int $rttYear, DateTimeImmutable $today): string
+    {
+        $rttFrom = sprintf('01/06/%d', $rttYear - 1);
+        $rttTo   = sprintf('31/05/%d', $rttYear);
+
+        return sprintf(
+            "# Vérification RTT & Congés — %s %s (id=%d)\n\n"
+            ."Généré le %s.  \n"
+            ."Exercice RTT de référence : **%d** (%s → %s).  \n"
+            ."Pour les contrats Forfait, l'exercice de congés est l'année civile.",
+            $employee->getFirstName(),
+            $employee->getLastName(),
+            (int) $employee->getId(),
+            $today->format('Y-m-d'),
+            $rttYear,
+            $rttFrom,
+            $rttTo
+        );
+    }
+
+    private function buildProfileSection(Employee $employee): string
+    {
+        $contract     = $employee->getContract();
+        $contractName = $contract?->getName() ?? '—';
+        $tracking     = $contract?->getTrackingMode() ?? '—';
+        $weekly       = $contract?->getWeeklyHours();
+        $weeklyLabel  = null === $weekly ? '—' : ($weekly.'h');
+        $nature       = $employee->getCurrentContractNature();
+
+        $lines   = [];
+        $lines[] = '## 1. Profil';
+        $lines[] = '';
+        $lines[] = sprintf('- **ID** : %d', (int) $employee->getId());
+        $lines[] = sprintf('- **Nom / Prénom** : %s %s', $employee->getLastName(), $employee->getFirstName());
+        $lines[] = sprintf('- **Contrat actif** : %s — tracking `%s` — %s', $contractName, $tracking, $weeklyLabel);
+        $lines[] = sprintf('- **Nature** : %s', $nature);
+
+        $lines[] = '';
+        $lines[] = '### Périodes de contrat';
+        $lines[] = '';
+        $lines[] = '| Début | Fin | Contrat | Nature | Conducteur | Solde CP soldé | Commentaire |';
+        $lines[] = '|-------|-----|---------|--------|------------|----------------|-------------|';
+
+        $periods = $this->contractPeriodRepository->findBy(['employee' => $employee], ['startDate' => 'ASC']);
+        foreach ($periods as $period) {
+            $lines[] = sprintf(
+                '| %s | %s | %s | %s | %s | %s | %s |',
+                $period->getStartDate()->format('Y-m-d'),
+                null !== $period->getEndDate() ? $period->getEndDate()->format('Y-m-d') : '—',
+                $period->getContract()?->getName() ?? '—',
+                $period->getContractNature(),
+                $period->getIsDriver() ? 'oui' : 'non',
+                $period->isPaidLeaveSettled() ? 'oui' : 'non',
+                str_replace("\n", ' ', (string) ($period->getComment() ?? ''))
+            );
+        }
+
+        return implode("\n", $lines);
+    }
+
+    private function buildLeaveSection(Employee $employee, DateTimeImmutable $today): string
+    {
+        $lines   = [];
+        $lines[] = '## 2. Congés';
+        $lines[] = '';
+
+        $leaveYear   = $this->leaveSummaryProvider->resolveLeaveYearForToday($employee);
+        $isForfait   = ContractType::FORFAIT === $employee->getContract()?->getType();
+        $yearSummary = $this->leaveSummaryProvider->computeYearSummary($employee, $leaveYear);
+
+        if (null === $yearSummary) {
+            $lines[] = '_Aucun résumé congés disponible (contrat non supporté : INTERIM ou autre)._';
+
+            return implode("\n", $lines);
+        }
+
+        // Forfait: recompute with paid leave days if any.
+        $paidLeaveDays = $this->leaveSummaryProvider->resolvePaidLeaveDays($employee, $yearSummary['ruleCode'], $leaveYear);
+        if ($paidLeaveDays > 0.0) {
+            $recomputed = $this->leaveSummaryProvider->computeYearSummary($employee, $leaveYear, $paidLeaveDays);
+            if (null !== $recomputed) {
+                $yearSummary = $recomputed;
+            }
+        }
+
+        [$from, $to] = $isForfait
+            ? [
+                new DateTimeImmutable(sprintf('%d-01-01', $leaveYear)),
+                new DateTimeImmutable(sprintf('%d-12-31', $leaveYear)),
+            ]
+            : [
+                new DateTimeImmutable(sprintf('%d-06-01', $leaveYear - 1)),
+                new DateTimeImmutable(sprintf('%d-05-31', $leaveYear)),
+            ];
+
+        $lines[] = sprintf('**Règle applicable** : `%s`', $yearSummary['ruleCode']);
+        $lines[] = sprintf('**Période** : %s → %s', $from->format('Y-m-d'), $to->format('Y-m-d'));
+        $lines[] = '';
+        $lines[] = '### 2.1 Soldes (tels que calculés aujourd\'hui)';
+        $lines[] = '';
+        $lines[] = '| Indicateur | Valeur |';
+        $lines[] = '|------------|--------|';
+        $lines[] = sprintf('| Acquis (report N-1) | %s j |', $this->fmtDays($yearSummary['acquiredDays']));
+        $lines[] = sprintf('| Acquis samedis | %s j |', $this->fmtDays($yearSummary['acquiredSaturdays']));
+        $lines[] = sprintf('| En cours d\'acquisition | %s j |', $this->fmtDays($yearSummary['accruingDays']));
+        $lines[] = sprintf('| Pris | %s j |', $this->fmtDays($yearSummary['takenDays']));
+        $lines[] = sprintf('| Pris samedis | %s j |', $this->fmtDays($yearSummary['takenSaturdays']));
+        $lines[] = sprintf('| Restant (report N-1) | %s j |', $this->fmtDays($yearSummary['remainingDays']));
+        $lines[] = sprintf('| Restant samedis | %s j |', $this->fmtDays($yearSummary['remainingSaturdays']));
+        if ($isForfait) {
+            $lines[] = sprintf('| N-1 acquis | %s j |', $this->fmtDays($yearSummary['previousYearAcquiredDays']));
+            $lines[] = sprintf('| N-1 pris | %s j |', $this->fmtDays($yearSummary['previousYearTakenDays']));
+            $lines[] = sprintf('| N-1 restant | %s j |', $this->fmtDays($yearSummary['previousYearRemainingDays']));
+            $lines[] = sprintf('| N-1 payés | %s j |', $this->fmtDays($paidLeaveDays));
+        }
+
+        $lines[]  = '';
+        $lines[]  = '### 2.2 Absences de la période';
+        $lines[]  = '';
+        $absences = $this->absenceRepository->findByEmployeeAndOverlappingDateRange($employee, $from, $to);
+        if ([] === $absences) {
+            $lines[] = '_Aucune absence sur la période._';
+        } else {
+            $lines[] = '| Début | Fin | Demi-début | Demi-fin | Type | Commentaire |';
+            $lines[] = '|-------|-----|------------|----------|------|-------------|';
+            foreach ($absences as $absence) {
+                $lines[] = sprintf(
+                    '| %s | %s | %s | %s | %s (%s) | %s |',
+                    $absence->getStartDate()->format('Y-m-d'),
+                    $absence->getEndDate()->format('Y-m-d'),
+                    $absence->getStartHalf()->value,
+                    $absence->getEndHalf()->value,
+                    $absence->getType()?->getCode() ?? '—',
+                    $absence->getType()?->getLabel() ?? '—',
+                    str_replace("\n", ' ', (string) ($absence->getComment() ?? ''))
+                );
+            }
+        }
+
+        $lines[]             = '';
+        $lines[]             = '### 2.3 Jours de présence par mois (calcul provider)';
+        $lines[]             = '';
+        $presenceDaysByMonth = $this->computePresenceDaysByMonth($employee, $leaveYear);
+        if ([] === $presenceDaysByMonth) {
+            $lines[] = '_Aucun jour de présence sur la période._';
+        } else {
+            $lines[] = '| Mois | Jours de présence |';
+            $lines[] = '|------|-------------------|';
+            ksort($presenceDaysByMonth);
+            foreach ($presenceDaysByMonth as $monthKey => $days) {
+                $lines[] = sprintf('| %s | %s |', $monthKey, $this->fmtDays($days));
+            }
+        }
+
+        return implode("\n", $lines);
+    }
+
+    /**
+     * @return array<string, float>
+     */
+    private function computePresenceDaysByMonth(Employee $employee, int $leaveYear): array
+    {
+        // The provider method is private; we re-invoke `provide()` via its public path by
+        // calling computeYearSummary then reading $summary->presenceDaysByMonth.
+        // But computeYearSummary doesn't populate that. So we call the provider publicly
+        // through LeaveRecapRowBuilder? No — we just call the summary API resource directly
+        // via a small helper below.
+        //
+        // Workaround: reuse the provider's provide() would require security; instead we
+        // rebuild the map from WorkHour/absences here, mirroring the provider logic.
+        $isForfait   = ContractType::FORFAIT === $employee->getContract()?->getType();
+        [$from, $to] = $isForfait
+            ? [
+                new DateTimeImmutable(sprintf('%d-01-01', $leaveYear)),
+                new DateTimeImmutable(sprintf('%d-12-31', $leaveYear)),
+            ]
+            : [
+                new DateTimeImmutable(sprintf('%d-06-01', $leaveYear - 1)),
+                new DateTimeImmutable(sprintf('%d-05-31', $leaveYear)),
+            ];
+
+        // Leave this aggregated figure available only for forfait (this is where the UI
+        // shows it). For non-forfait we skip — the UI doesn't show presence per month.
+        if (!$isForfait) {
+            return [];
+        }
+
+        $weekendWorkedDays = $this->workHourRepository->countWeekendWorkedDaysByMonth($employee, $from, $to);
+        $absences          = $this->absenceRepository->findByEmployeeAndOverlappingDateRange($employee, $from, $to);
+
+        $absenceDaysByMonth = [];
+        foreach ($absences as $absence) {
+            $start = DateTimeImmutable::createFromInterface($absence->getStartDate())->setTime(0, 0);
+            $end   = DateTimeImmutable::createFromInterface($absence->getEndDate())->setTime(0, 0);
+            for ($day = $start; $day <= $end; $day = $day->modify('+1 day')) {
+                if ((int) $day->format('N') >= 6) {
+                    continue;
+                }
+                $startDate = $absence->getStartDate()->format('Y-m-d');
+                $endDate   = $absence->getEndDate()->format('Y-m-d');
+                $startHalf = $absence->getStartHalf()->value;
+                $endHalf   = $absence->getEndHalf()->value;
+                $dateStr   = $day->format('Y-m-d');
+                $isStart   = $dateStr === $startDate;
+                $isEnd     = $dateStr === $endDate;
+                if ($startDate === $endDate) {
+                    $am = 'AM' === $startHalf;
+                    $pm = 'PM' === $endHalf;
+                } elseif ($isStart) {
+                    $am = 'AM' === $startHalf;
+                    $pm = true;
+                } elseif ($isEnd) {
+                    $am = true;
+                    $pm = 'PM' === $endHalf;
+                } else {
+                    $am = true;
+                    $pm = true;
+                }
+                $dayAmount = ($am ? 0.5 : 0.0) + ($pm ? 0.5 : 0.0);
+                if ($dayAmount <= 0.0) {
+                    continue;
+                }
+                $mk                      = $day->format('Y-m');
+                $absenceDaysByMonth[$mk] = ($absenceDaysByMonth[$mk] ?? 0.0) + $dayAmount;
+            }
+        }
+
+        $result = [];
+        $cursor = $from->modify('first day of this month')->setTime(0, 0);
+        while ($cursor <= $to) {
+            $monthKey   = $cursor->format('Y-m');
+            $monthStart = $cursor < $from ? $from : $cursor;
+            $monthEnd   = $cursor->modify('last day of this month')->setTime(0, 0);
+            if ($monthEnd > $to) {
+                $monthEnd = $to;
+            }
+            $businessDays = 0;
+            for ($day = $monthStart; $day <= $monthEnd; $day = $day->modify('+1 day')) {
+                if ((int) $day->format('N') <= 5) {
+                    ++$businessDays;
+                }
+            }
+            $weekend  = $weekendWorkedDays[$monthKey] ?? 0.0;
+            $absenced = $absenceDaysByMonth[$monthKey] ?? 0.0;
+            $presence = max(0.0, (float) $businessDays + $weekend - $absenced);
+            if ($presence > 0.0) {
+                $result[$monthKey] = $presence;
+            }
+            $cursor = $cursor->modify('first day of next month');
+        }
+
+        return $result;
+    }
+
+    private function buildRecapRowSection(Employee $employee, DateTimeImmutable $today): string
+    {
+        $row   = $this->leaveRecapRowBuilder->build($employee);
+        $lines = [];
+
+        $lines[] = '## 3. Ligne écran « Récap. congés » (live, as of today)';
+        $lines[] = '';
+        $lines[] = '| CP N-1 restant | CP N | Samedis | RTT |';
+        $lines[] = '|----------------|------|---------|-----|';
+        $lines[] = sprintf(
+            '| %s | %s | %s | %s |',
+            (string) $row['cpN1Remaining'],
+            $row['cpN'],
+            $row['acquiredSaturdays'],
+            $row['rtt']
+        );
+
+        return implode("\n", $lines);
+    }
+
+    private function buildRttSection(Employee $employee, int $rttYear, DateTimeImmutable $today): string
+    {
+        $lines   = [];
+        $lines[] = '## 4. RTT — Onglet par mois';
+        $lines[] = '';
+
+        $contract     = $employee->getContract();
+        $trackingMode = $contract?->getTrackingMode();
+        if (TrackingMode::PRESENCE->value === $trackingMode) {
+            $lines[] = '_Contrat en mode `PRESENCE` (Forfait) : aucun calcul RTT (heures supplémentaires)._';
+            $lines[] = '_Sur l\'UI, l\'onglet RTT ne contient aucune donnée exploitable._';
+            $lines[] = '';
+            $lines[] = '> Voir toutefois la section Congés pour les bonus week-end / jours fériés travaillés intégrés au stock Forfait (acquisDays).';
+
+            return implode("\n", $lines);
+        }
+
+        [$periodFrom, $periodTo] = $this->rttRecoveryService->resolveExerciseBounds($rttYear);
+        $weeks                   = $this->rttRecoveryService->buildWeeksForExercise($periodFrom, $periodTo);
+        $weekRanges              = array_map(
+            static fn (array $w): array => ['weekNumber' => (int) $w['weekNumber'], 'start' => $w['start'], 'end' => $w['end']],
+            $weeks
+        );
+
+        $currentExerciseYear = $this->resolveCurrentRttExerciseYear($today);
+        if ($rttYear > $currentExerciseYear) {
+            $limitDate = $periodFrom->modify('-1 day');
+        } else {
+            $isoDay    = (int) $today->format('N');
+            $limitDate = 7 === $isoDay ? $today : $today->modify('last sunday');
+            if (7 !== $isoDay) {
+                $currentWeekStart = $today->modify('monday this week');
+                $currentWeekEnd   = $currentWeekStart->modify('+6 days');
+                $checkEnd         = $this->resolveWeekEndForEmployee($employee, $currentWeekStart, $currentWeekEnd, $today);
+                if ($this->workHourRepository->isWeekFullyValidated($employee, $currentWeekStart, $checkEnd)) {
+                    $limitDate = $currentWeekEnd;
+                }
+            }
+        }
+
+        $recoveryByWeek       = $this->rttRecoveryService->computeRecoveryByWeek($employee, $weekRanges, $periodFrom, $periodTo, $limitDate);
+        [$carry, $carryMonth] = $this->resolveCarry($employee, $rttYear);
+        $weekSummaries        = $this->buildWeekSummaries($weekRanges, $recoveryByWeek, $periodFrom, $periodTo);
+        $weekSummaries        = $this->distributeDeficits($weekSummaries, $carry);
+
+        // Aggregate payments per month.
+        $paymentsByMonth = [];
+        foreach ($this->rttPaymentRepository->findByEmployeeAndYear($employee, $rttYear) as $payment) {
+            $m = $payment->getMonth();
+            if (!isset($paymentsByMonth[$m])) {
+                $paymentsByMonth[$m] = ['base25' => 0, 'bonus25' => 0, 'base50' => 0, 'bonus50' => 0];
+            }
+            $paymentsByMonth[$m]['base25'] += $payment->getBase25Minutes();
+            $paymentsByMonth[$m]['bonus25'] += $payment->getBonus25Minutes();
+            $paymentsByMonth[$m]['base50'] += $payment->getBase50Minutes();
+            $paymentsByMonth[$m]['bonus50'] += $payment->getBonus50Minutes();
+        }
+
+        $lines[] = sprintf('**Limite des semaines prises en compte** : %s (exclut la semaine en cours incomplète)', $limitDate->format('Y-m-d'));
+        $lines[] = sprintf('**Report N-1 (carry)** : `Base 25%%=%s` / `+25%%=%s` / `Base 50%%=%s` / `+50%%=%s` — **Total %s**', $this->fmtMin($carry->base25Minutes), $this->fmtMin($carry->bonus25Minutes), $this->fmtMin($carry->base50Minutes), $this->fmtMin($carry->bonus50Minutes), $this->fmtMin($carry->totalMinutes));
+        $lines[] = '';
+
+        // Iterate the 12 exercise months (June → May).
+        $cumulativeCarry = [
+            'base25'  => $carry->base25Minutes,
+            'bonus25' => $carry->bonus25Minutes,
+            'base50'  => $carry->base50Minutes,
+            'bonus50' => $carry->bonus50Minutes,
+        ];
+
+        $monthsInExercise = [6, 7, 8, 9, 10, 11, 12, 1, 2, 3, 4, 5];
+        foreach ($monthsInExercise as $i => $month) {
+            $calYear = $month >= 6 ? $rttYear - 1 : $rttYear;
+            $label   = self::MONTH_LABELS[$month].' '.$calYear;
+
+            $lines[] = '### '.$label;
+            $lines[] = '';
+            $lines[] = '| Ligne | Heure | Base 25% | +25% | Total 25% | Base 50% | +50% | Total 50% | Total |';
+            $lines[] = '|-------|-------|----------|------|-----------|----------|------|-----------|-------|';
+
+            // Report line only on the first month (June).
+            if (6 === $month) {
+                $lines[] = sprintf(
+                    '| Report N-1 | | %s | %s | %s | %s | %s | %s | %s |',
+                    $this->fmtMin($carry->base25Minutes),
+                    $this->fmtMin($carry->bonus25Minutes),
+                    $this->fmtMin($carry->base25Minutes + $carry->bonus25Minutes),
+                    $this->fmtMin($carry->base50Minutes),
+                    $this->fmtMin($carry->bonus50Minutes),
+                    $this->fmtMin($carry->base50Minutes + $carry->bonus50Minutes),
+                    $this->fmtMin($carry->totalMinutes),
+                );
+            }
+
+            $monthWeeks = array_values(array_filter($weekSummaries, static fn (EmployeeRttWeekSummary $w): bool => $w->month === $month));
+            $totals     = ['over' => 0, 'b25' => 0, 's25' => 0, 'b50' => 0, 's50' => 0, 'total' => 0];
+
+            foreach ($monthWeeks as $w) {
+                $lines[] = sprintf(
+                    '| Semaine %d (%s → %s) | %s | %s | %s | %s | %s | %s | %s | %s |',
+                    $w->weekNumber,
+                    $w->weekStart,
+                    $w->weekEnd,
+                    $this->fmtMin($w->overtimeMinutes),
+                    $this->fmtMin($w->base25Minutes),
+                    $this->fmtMin($w->bonus25Minutes),
+                    $this->fmtMin($w->base25Minutes + $w->bonus25Minutes),
+                    $this->fmtMin($w->base50Minutes),
+                    $this->fmtMin($w->bonus50Minutes),
+                    $this->fmtMin($w->base50Minutes + $w->bonus50Minutes),
+                    $this->fmtMin($w->totalMinutes),
+                );
+                $totals['over'] += $w->overtimeMinutes;
+                $totals['b25'] += $w->base25Minutes;
+                $totals['s25'] += $w->bonus25Minutes;
+                $totals['b50'] += $w->base50Minutes;
+                $totals['s50'] += $w->bonus50Minutes;
+                $totals['total'] += $w->totalMinutes;
+            }
+
+            if ([] === $monthWeeks && 6 !== $month) {
+                $lines[] = '| _aucune semaine_ | | | | | | | | |';
+            }
+
+            $lines[] = sprintf(
+                '| **Total** | %s | %s | %s | %s | %s | %s | %s | **%s** |',
+                $this->fmtMin($totals['over']),
+                $this->fmtMin($totals['b25']),
+                $this->fmtMin($totals['s25']),
+                $this->fmtMin($totals['b25'] + $totals['s25']),
+                $this->fmtMin($totals['b50']),
+                $this->fmtMin($totals['s50']),
+                $this->fmtMin($totals['b50'] + $totals['s50']),
+                $this->fmtMin($totals['total']),
+            );
+
+            $p          = $paymentsByMonth[$month] ?? null;
+            $hasPayment = null !== $p;
+            if ($hasPayment) {
+                $lines[] = sprintf(
+                    '| Payé | | -%s | -%s | -%s | -%s | -%s | -%s | -%s |',
+                    $this->fmtMin($p['base25']),
+                    $this->fmtMin($p['bonus25']),
+                    $this->fmtMin($p['base25'] + $p['bonus25']),
+                    $this->fmtMin($p['base50']),
+                    $this->fmtMin($p['bonus50']),
+                    $this->fmtMin($p['base50'] + $p['bonus50']),
+                    $this->fmtMin($p['base25'] + $p['bonus25'] + $p['base50'] + $p['bonus50']),
+                );
+            } else {
+                $lines[] = '| Payé | | 0h | 0h | 0h | 0h | 0h | 0h | 0h |';
+            }
+
+            // Cumulative carry update — add month totals, subtract payments.
+            $cumulativeCarry['base25'] += $totals['b25'] - ($p['base25'] ?? 0);
+            $cumulativeCarry['bonus25'] += $totals['s25'] - ($p['bonus25'] ?? 0);
+            $cumulativeCarry['base50'] += $totals['b50'] - ($p['base50'] ?? 0);
+            $cumulativeCarry['bonus50'] += $totals['s50'] - ($p['bonus50'] ?? 0);
+
+            $cb25    = $cumulativeCarry['base25'];
+            $cs25    = $cumulativeCarry['bonus25'];
+            $cb50    = $cumulativeCarry['base50'];
+            $cs50    = $cumulativeCarry['bonus50'];
+            $cTotal  = $cb25 + $cs25 + $cb50 + $cs50;
+            $lines[] = sprintf(
+                '| **Reste (cumul)** | | %s | %s | %s | %s | %s | %s | **%s** |',
+                $this->fmtMin($cb25),
+                $this->fmtMin($cs25),
+                $this->fmtMin($cb25 + $cs25),
+                $this->fmtMin($cb50),
+                $this->fmtMin($cs50),
+                $this->fmtMin($cb50 + $cs50),
+                $this->fmtMin($cTotal),
+            );
+
+            $lines[] = '';
+        }
+
+        // Final summary.
+        $currentYearRecovery = array_sum(array_map(static fn (EmployeeRttWeekSummary $w): int => $w->totalMinutes, $weekSummaries));
+        $totalPaid           = 0;
+        foreach ($paymentsByMonth as $p) {
+            $totalPaid += $p['base25'] + $p['bonus25'] + $p['base50'] + $p['bonus50'];
+        }
+        $available = $carry->totalMinutes + $currentYearRecovery - $totalPaid;
+
+        $lines[] = '### Solde RTT total (fin de période calculée)';
+        $lines[] = '';
+        $lines[] = sprintf('- Report N-1 (opening) : **%s**', $this->fmtMin($carry->totalMinutes));
+        $lines[] = sprintf('- Cumul récupération exercice : **%s**', $this->fmtMin($currentYearRecovery));
+        $lines[] = sprintf('- Total payé : **%s**', $this->fmtMin($totalPaid));
+        $lines[] = sprintf('- **Disponible** : **%s**', $this->fmtMin($available));
+
+        return implode("\n", $lines);
+    }
+
+    /**
+     * Mirrors EmployeeRttSummaryProvider::buildWeekSummaries().
+     *
+     * @param list<array{weekNumber:int,start:DateTimeImmutable,end:DateTimeImmutable}> $weekRanges
+     * @param array<string, WeekRecoveryDetail>                                         $recoveryByWeek
+     *
+     * @return list<EmployeeRttWeekSummary>
+     */
+    private function buildWeekSummaries(array $weekRanges, array $recoveryByWeek, DateTimeImmutable $periodFrom, DateTimeImmutable $periodTo): array
+    {
+        $result = [];
+        foreach ($weekRanges as $week) {
+            $weekStart = $week['start'];
+            $weekEnd   = $week['end'];
+            $weekKey   = $weekStart->format('Y-m-d');
+            $detail    = $recoveryByWeek[$weekKey] ?? new WeekRecoveryDetail();
+
+            $effectiveStart = $weekStart < $periodFrom ? $periodFrom : $weekStart;
+            $effectiveEnd   = $weekEnd > $periodTo ? $periodTo : $weekEnd;
+            $startMonth     = (int) $effectiveStart->format('n');
+            $endMonth       = (int) $effectiveEnd->format('n');
+
+            if ($startMonth === $endMonth) {
+                $result[] = new EmployeeRttWeekSummary(
+                    month: $startMonth,
+                    weekNumber: (int) $week['weekNumber'],
+                    weekStart: $weekStart->format('Y-m-d'),
+                    weekEnd: $weekEnd->format('Y-m-d'),
+                    overtimeMinutes: $detail->overtimeMinutes,
+                    base25Minutes: $detail->base25Minutes,
+                    bonus25Minutes: $detail->bonus25Minutes,
+                    base50Minutes: $detail->base50Minutes,
+                    bonus50Minutes: $detail->bonus50Minutes,
+                    totalMinutes: $detail->totalMinutes,
+                );
+
+                continue;
+            }
+
+            $monthMinutes  = [];
+            $monthWeekdays = [];
+            foreach ($detail->dailyMinutes as $date => $mins) {
+                $m                = (int) new DateTimeImmutable($date)->format('n');
+                $monthMinutes[$m] = ($monthMinutes[$m] ?? 0) + $mins;
+                if ((int) new DateTimeImmutable($date)->format('N') < 6) {
+                    $monthWeekdays[$m] = ($monthWeekdays[$m] ?? 0) + 1;
+                }
+            }
+            $totalWorked   = array_sum($monthMinutes);
+            $totalWeekdays = array_sum($monthWeekdays);
+
+            foreach ([$startMonth, $endMonth] as $m) {
+                if ($totalWorked > 0) {
+                    $ratio = ($monthMinutes[$m] ?? 0) / $totalWorked;
+                } elseif ($totalWeekdays > 0) {
+                    $ratio = ($monthWeekdays[$m] ?? 0) / $totalWeekdays;
+                } else {
+                    $ratio = 0.0;
+                }
+                $result[] = new EmployeeRttWeekSummary(
+                    month: $m,
+                    weekNumber: (int) $week['weekNumber'],
+                    weekStart: $weekStart->format('Y-m-d'),
+                    weekEnd: $weekEnd->format('Y-m-d'),
+                    overtimeMinutes: (int) round($detail->overtimeMinutes * $ratio),
+                    base25Minutes: (int) round($detail->base25Minutes * $ratio),
+                    bonus25Minutes: (int) round($detail->bonus25Minutes * $ratio),
+                    base50Minutes: (int) round($detail->base50Minutes * $ratio),
+                    bonus50Minutes: (int) round($detail->bonus50Minutes * $ratio),
+                    totalMinutes: (int) round($detail->totalMinutes * $ratio),
+                );
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * Mirrors the deficit-distribution step in EmployeeRttSummaryProvider::provide().
+     *
+     * @param list<EmployeeRttWeekSummary> $weeks
+     *
+     * @return list<EmployeeRttWeekSummary>
+     */
+    private function distributeDeficits(array $weeks, WeekRecoveryDetail $carry): array
+    {
+        $cumulative50 = $carry->base50Minutes + $carry->bonus50Minutes;
+        $cumulative25 = $carry->base25Minutes + $carry->bonus25Minutes;
+
+        foreach ($weeks as $i => $week) {
+            if ($week->totalMinutes >= 0) {
+                $cumulative50 += $week->base50Minutes + $week->bonus50Minutes;
+                $cumulative25 += $week->base25Minutes + $week->bonus25Minutes;
+
+                continue;
+            }
+            $deficit = -$week->totalMinutes;
+            $from50  = min($deficit, max(0, $cumulative50));
+            $from25  = $deficit - $from50;
+            $cumulative50 -= $from50;
+            $cumulative25 -= $from25;
+            $weeks[$i] = new EmployeeRttWeekSummary(
+                month: $week->month,
+                weekNumber: $week->weekNumber,
+                weekStart: $week->weekStart,
+                weekEnd: $week->weekEnd,
+                overtimeMinutes: $week->overtimeMinutes,
+                base25Minutes: $from25 > 0 ? -$from25 : 0,
+                bonus25Minutes: 0,
+                base50Minutes: $from50 > 0 ? -$from50 : 0,
+                bonus50Minutes: 0,
+                totalMinutes: $week->totalMinutes,
+            );
+        }
+
+        return $weeks;
+    }
+
+    /**
+     * @return array{WeekRecoveryDetail, int}
+     */
+    private function resolveCarry(Employee $employee, int $year): array
+    {
+        $balance = $this->rttBalanceRepository->findOneByEmployeeAndYear($employee, $year);
+        if (null !== $balance) {
+            return [
+                new WeekRecoveryDetail(
+                    base25Minutes: $balance->getOpeningBase25Minutes(),
+                    bonus25Minutes: $balance->getOpeningBonus25Minutes(),
+                    base50Minutes: $balance->getOpeningBase50Minutes(),
+                    bonus50Minutes: $balance->getOpeningBonus50Minutes(),
+                    totalMinutes: $balance->getTotalOpeningMinutes(),
+                ),
+                $balance->getMonth(),
+            ];
+        }
+
+        return [$this->rttRecoveryService->computeTotalRecoveryForExercise($employee, $year - 1), 5];
+    }
+
+    private function resolveWeekEndForEmployee(Employee $employee, DateTimeImmutable $weekStart, DateTimeImmutable $weekEnd, DateTimeImmutable $today): DateTimeImmutable
+    {
+        foreach ($employee->getContractPeriods() as $period) {
+            if ($period->getStartDate() > $today) {
+                continue;
+            }
+            $endDate = $period->getEndDate();
+            if (null === $endDate) {
+                continue;
+            }
+            if ($endDate >= $weekStart && $endDate <= $weekEnd) {
+                return $endDate;
+            }
+        }
+
+        return $weekEnd;
+    }
+
+    private function resolveCurrentRttExerciseYear(DateTimeImmutable $today): int
+    {
+        $y = (int) $today->format('Y');
+        $m = (int) $today->format('n');
+
+        return $m >= 6 ? $y + 1 : $y;
+    }
+
+    private function fmtMin(int $minutes): string
+    {
+        if (0 === $minutes) {
+            return '0h';
+        }
+        $sign = $minutes < 0 ? '-' : '';
+        $abs  = abs($minutes);
+        $h    = intdiv($abs, 60);
+        $m    = $abs % 60;
+
+        return 0 === $m ? sprintf('%s%dh', $sign, $h) : sprintf('%s%dh%02d', $sign, $h, $m);
+    }
+
+    private function fmtDays(float $value): string
+    {
+        if (abs($value - round($value)) < 0.001) {
+            return (string) (int) round($value);
+        }
+
+        return rtrim(rtrim(number_format($value, 2, '.', ''), '0'), '.');
+    }
+
+    private function slugify(string $value): string
+    {
+        $value = trim($value);
+        $ascii = iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $value);
+        if (false === $ascii) {
+            $ascii = $value;
+        }
+        $ascii = strtolower($ascii);
+        $ascii = preg_replace('/[^a-z0-9]+/', '-', $ascii) ?? $ascii;
+
+        return trim($ascii, '-');
+    }
+}

src/Dto/AuditLogOutput.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Dto;
+
+final class AuditLogOutput
+{
+    public function __construct(
+        public int $id,
+        public ?string $employeeName,
+        public ?int $employeeId,
+        public string $username,
+        public string $action,
+        public string $entityType,
+        public string $description,
+        public ?array $changes,
+        public ?string $affectedDate,
+        public string $createdAt,
+    ) {}
+}

src/Dto/Employees/ContractHistoryItem.php

@@ -29,5 +29,10 @@ final class ContractHistoryItem
         public array $suspensions = [],
         #[Groups(['employee:read'])]
         public bool $isDriver = false,
+        /**
+         * @var null|array<int, int> iso-day → minutes
+         */
+        #[Groups(['employee:read'])]
+        public ?array $workDaysHours = null,
     ) {}
 }

src/Dto/Rtt/WeekRecoveryDetail.php

@@ -6,6 +6,9 @@ namespace App\Dto\Rtt;
 
 final class WeekRecoveryDetail
 {
+    /**
+     * @param array<string, int> $dailyMinutes date (Y-m-d) => worked minutes
+     */
     public function __construct(
         public int $overtimeMinutes = 0,
         public int $base25Minutes = 0,
@@ -13,5 +16,6 @@ final class WeekRecoveryDetail
         public int $base50Minutes = 0,
         public int $bonus50Minutes = 0,
         public int $totalMinutes = 0,
+        public array $dailyMinutes = [],
     ) {}
 }

src/Dto/WorkHours/DayContextRow.php

@@ -17,8 +17,17 @@ final class DayContextRow
         public int $creditedMinutes = 0,
         public float $creditedPresenceUnits = 0.0,
         public bool $isDriverContract = false,
+        public bool $hasFormation = false,
+        public ?string $formationLabel = null,
+        public int $virtualHolidayMinutes = 0,
     ) {}
 
+    public function setFormation(string $label): void
+    {
+        $this->hasFormation   = true;
+        $this->formationLabel = $label;
+    }
+
     public function addAbsence(
         ?string $label,
         ?string $color,
@@ -64,7 +73,11 @@ final class DayContextRow
      *     absentMorning:bool,
      *     absentAfternoon:bool,
      *     creditedMinutes:int,
-     *     creditedPresenceUnits:float
+     *     creditedPresenceUnits:float,
+     *     isDriverContract:bool,
+     *     hasFormation:bool,
+     *     formationLabel:?string,
+     *     virtualHolidayMinutes:int
      * }
      */
     public function toArray(): array
@@ -80,6 +93,9 @@ final class DayContextRow
             'creditedMinutes'       => $this->creditedMinutes,
             'creditedPresenceUnits' => $this->creditedPresenceUnits,
             'isDriverContract'      => $this->isDriverContract,
+            'hasFormation'          => $this->hasFormation,
+            'formationLabel'        => $this->formationLabel,
+            'virtualHolidayMinutes' => $this->virtualHolidayMinutes,
         ];
     }
 

src/Dto/WorkHours/WeeklyDaySummary.php

@@ -21,5 +21,6 @@ final class WeeklyDaySummary
         public bool $hasLunch = false,
         public bool $hasDinner = false,
         public bool $hasOvernight = false,
+        public int $virtualHolidayMinutes = 0,
     ) {}
 }