feat : ajout de la gestion Congé

doc/functional-rules.md

@@ -2,6 +2,9 @@
 
 Ce document centralise les règles métier actuellement implémentées dans l'application.
 
+Document complementaire (rollover conges et checklist de lancement):
+- `doc/leave-rollover.md`
+
 ## 1) Utilisateurs et accès
 
 - `ROLE_ADMIN`
@@ -138,11 +141,61 @@ Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
   - action `Clôturer`:
     - bouton actif uniquement s'il existe un contrat en cours non déjà clôturé à la date du jour
     - ouvre un drawer en lecture seule (type/temps de travail/date de début)
-    - seule la date de fin est saisissable (préremplie à aujourd'hui)
-    - backend: en mode clôture, seule `contractEndDate` est acceptée
+    - champs saisissables:
+      - `contractEndDate` (prérempli à aujourd'hui)
+      - `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
   - 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
+  - onglet `Congé`:
+    - endpoint de synthèse: `GET /api/employees/{id}/leave-summary?year=YYYY`
+    - phase 1 métier (`CDI`/`CDD` non forfait + `FORFAIT`):
+      - exercice CP:
+        - `CDI`/`CDD` non forfait: du `1er juin (YYYY-1)` au `31 mai (YYYY)` (paramètre `year` = année de fin d'exercice)
+        - `FORFAIT`: du `1er janvier (YYYY)` au `31 décembre (YYYY)` (paramètre `year` = année civile)
+      - contrats `39h` / `35h` / `25h` (et plus largement CDI/CDD non forfait hors `4h`):
+        - acquis annuel CP: `25`
+        - acquis annuel samedi: `5`
+        - en cours d'acquisition jours: `25/12 = 2,08` jours/mois
+        - en cours d'acquisition samedis: `5/12 = 0,42` samedi/mois (non detaille en UI)
+        - samedis acquis affiches: uniquement `opening_saturdays` (report N-1)
+      - contrat `4h`:
+        - acquis annuel CP: `10`
+        - acquis annuel samedi: `0`
+        - en cours d'acquisition: `0.83` jour/mois
+      - contrat `FORFAIT`:
+        - base annuelle: `jours ouvrés de l'exercice (lundi-vendredi, hors jours fériés métropole) - 218`
+        - 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`)
+        - pas de jours en cours d'acquisition (`0`)
+      - fractionné: `0` (saisie RH ultérieure, non calculée automatiquement)
+      - pour `CDI`/`CDD` non forfait:
+        - pris CP: basé sur absences de type code `C` (CONGÉ), en tenant compte des demi-journées
+        - samedi pris: absences `C` posées le samedi (demi-journée incluse)
+        - restants = acquis - pris (borné à 0)
+      - pour `FORFAIT`:
+        - pris: basé sur toutes les absences (demi-journées incluses)
+        - restants = acquis - pris (borné à 0)
+      - 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
+        - pour `FORFAIT`: report uniquement sur les jours
+        - si un solde d'ouverture existe en base (`employee_leave_balances`) pour l'exercice courant, ce solde devient la source prioritaire du report
+        - si une clôture de contrat est marquée `contractPaidLeaveSettled=true` sur l'exercice précédent, le report vers l'exercice suivant est remis à `0`
+        - si une clôture `contractPaidLeaveSettled=true` existe dans l'exercice courant, le calcul est réinitialisé à partir du lendemain de cette clôture (pas de continuité intra-exercice)
+      - lecture des compteurs:
+        - `acquis` = droits reportés de l'exercice N-1 (après application des règles de soldé)
+        - `en cours d'acquisition` = total droits générés sur l'exercice N (jours + samedis en cours), sans detail séparé en UI
+      - règle de consommation:
+        - les absences s'imputent d'abord sur `acquis`, puis sur `en cours d'acquisition`
+        - la prise sur `en cours d'acquisition` est autorisée (usage anticipé)
+        - `en cours d'acquisition` peut devenir négatif si la prise dépasse le généré (ex: `2.08 - 3 = -0.92`), puis se reconstitue avec les acquisitions suivantes
+      - date d'arret de calcul:
+        - les compteurs sont calculés jusqu'au dernier jour du mois précédent (le mois en cours est exclu)
+        - exemple: au `04/03/2026`, l'arret de calcul est le `28/02/2026` (ou `29/02` en année bissextile)
+    - hors périmètre phase 1: `INTERIM` (retour non supporté)
 
 ## 10) Notifications