Ajout des notification + page employé (#6)

| Numéro du ticket | Titre du ticket | |------------------|-----------------| | | | ## Description de la PR ## Modification du .env ## Check list - [ ] Pas de régression - [ ] TU/TI/TF rédigée - [ ] TU/TI/TF OK - [ ] CHANGELOG modifié Reviewed-on: #6 Co-authored-by: tristan <tristan@yuno.malio.fr> Co-committed-by: tristan <tristan@yuno.malio.fr>
2026-03-10 12:35:17 +00:00
parent ae42c70d50
commit f493ea237b
126 changed files with 9215 additions and 935 deletions
--- a/doc/functional-rules.md
+++ b/doc/functional-rules.md
@@ -0,0 +1,255 @@
+# Règles Fonctionnelles SIRH
+
+Ce document centralise les règles métier actuellement implémentées dans l'application.
+
+Documents complementaires:
+- `doc/leave-rollover.md` (rollover conges et checklist de lancement)
+- `doc/rtt-rollover.md` (rollover RTT et checklist de lancement)
+
+## 1) Utilisateurs et accès
+
+- `ROLE_ADMIN`
+  - accès complet aux écrans d'administration
+  - vue semaine des heures
+  - validation RH des lignes d'heures
+- `ROLE_SELF`
+  - accès limité à son périmètre personnel
+- Accès "Sites" (via `user_site_roles` avec rôle `SITE_ACCESS`)
+  - accès au périmètre des sites autorisés
+  - validation site des lignes d'heures
+
+## 2) Contrats
+
+- Le profil de temps de travail est porté par `Contract`:
+  - `trackingMode`: `TIME` ou `PRESENCE`
+  - `weeklyHours` (ex: 35, 39, 4, etc.)
+- La nature RH est portée par période employé:
+  - `CDI`, `CDD`, `INTERIM`
+- Historique des contrats employé:
+  - table `employee_contract_periods`
+  - un employé peut avoir plusieurs périodes
+
+### Règles de période
+
+- `CDI`:
+  - à la création d'une période: `endDate` doit être vide
+  - en clôture d'un contrat en cours: `endDate` peut être renseignée
+- `CDD` / `INTERIM`:
+  - `endDate` obligatoire
+- `endDate` ne peut pas être antérieure à `startDate`
+
+## 3) Heures (vue jour)
+
+- Saisie par salarié et par date:
+  - matin / après-midi / soir
+  - pour `PRESENCE`: demi-journées matin/après-midi
+- Sélecteur de temps:
+  - créneaux de 15 minutes uniquement (00:00, 00:15, ..., 23:45)
+  - saisie libre possible mais valeur vidée au blur si hors options
+- Calculs affichés:
+  - `Jour`, `Nuit`, `Total`
+- Heures de nuit:
+  - fenêtres `00:00-06:00` et `21:00-24:00`
+- Date de modification (`updatedAt`):
+  - mise à jour uniquement quand un employé (`ROLE_SELF`) modifie ses propres heures
+  - non mise à jour lors de modifications admin ou chef de site
+  - affichée sous le nom de l'employé (visible admin uniquement)
+
+## 4) Absences
+
+- Les absences sont stockées par jour (découpage lors de l'écriture)
+- Une absence peut être:
+  - journée complète
+  - demi-journée `AM` ou `PM`
+- Colonne absence (vue jour):
+  - affiche le libellé
+  - fond coloré selon le type d'absence
+- Calendrier congés: fond coloré selon la couleur du type d'absence (`AbsenceType.color`)
+  - demi-journée: dégradé diagonal
+  - journée complète: fond plein
+
+### Effet absence sur les heures
+
+- Absence `AM`:
+  - efface les heures du matin
+- Absence `PM`:
+  - efface les heures d'après-midi et du soir
+- Absence journée:
+  - efface toutes les plages horaires
+
+### Absences "comptées comme travaillées"
+
+- Si `countAsWorkedHours = true`:
+  - `TIME`: crédit de minutes selon contrat actif du jour
+  - `PRESENCE` (forfait): aucun crédit de présence (seules les checkboxes cochées comptent)
+
+## 5) Validations des lignes d'heures
+
+- Validation RH (`isValid`)
+  - action admin
+- Validation site (`isSiteValid`)
+  - action chef de site
+
+### Verrouillage
+
+- Ligne validée RH:
+  - verrouillée pour modifications heures/absences
+- Ligne validée site:
+  - verrouillée pour non-admin
+  - admin peut corriger
+- Toute vraie modification d'une ligne:
+  - remet `isSiteValid = false`
+  - remet `isValid = false`
+- Si aucun changement réel à l'enregistrement:
+  - les validations existantes ne sont pas altérées
+
+## 6) Heures supplémentaires (vue semaine)
+
+- Base de calcul:
+  - dépend du contrat actif par jour
+- Tranche 25%:
+  - contrats <= 35h: de 35h à 43h
+  - contrats >= 39h: de 39h à 43h
+- Tranche 50%:
+  - au-delà de 43h
+- Nature `INTERIM`:
+  - pas de bonus 25%
+  - pas de bonus 50%
+  - pas de total récup
+
+## 7) Fériés
+
+- Les jours fériés sont identifiés et affichés
+- Onglet congés: jours fériés affichés sur le calendrier avec fond `rgb(179, 229, 252)` et nom au survol
+- Règle courante:
+  - absences bloquées sur jour férié
+  - saisie d'heures autorisée
+
+## 8) Impression absences (PDF)
+
+Filtres disponibles:
+- période `from` / `to`
+- sites
+- nature de contrat (`CDI`, `CDD`, `INTERIM`)
+- temps de travail (contrats de type Forfait, 35h, 39h, etc.)
+
+Tous les filtres checkbox sont cochés par défaut à l'ouverture du drawer.
+
+## 9) Employés
+
+- Création employé:
+  - prénom, nom, site
+  - type de contrat (nature RH)
+  - temps de travail
+  - dates début/fin (selon règles nature)
+- Modification employé:
+  - uniquement prénom, nom, site
+  - pas de modification de contrat depuis ce 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
+    - ouvre un drawer en lecture seule (type/temps de travail/date de début)
+    - 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é: saisie manuelle par la RH via `PATCH /employees/{id}/fractioned-days`, stocké dans `employee_leave_balances.fractioned_days`. Les jours fractionnés sont ajoutés aux acquis et au reste à prendre.
+      - 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é)
+  - onglet `RTT`:
+    - endpoint de synthèse: `GET /api/employees/{id}/rtt-summary?year=YYYY`
+    - exercice RTT: du `1er juin (YYYY-1)` au `31 mai (YYYY)` (paramètre `year` = année de fin d'exercice)
+    - affichage:
+      - détail hebdomadaire (semaine ISO) regroupé par mois
+      - 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
+    - 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%`
+      - contrats `INTERIM` et suivi `PRESENCE`: récupération à `0`
+    - compteur global:
+      - affiché en **jours** (1 jour = 7h = 420 minutes)
+    - report:
+      - le report N-1 correspond à la somme des minutes de récupération calculées sur l'exercice précédent
+      - si une ligne existe dans `employee_rtt_balances` pour `(employee, year)`, le champ `opening_minutes` est utilisé en priorité
+      - sinon, le calcul dynamique sur l'exercice N-1 est effectué
+    - rollover automatique:
+      - commande: `php bin/console app:rtt:rollover`
+      - s'exécute le `1er juin` (même cron que le rollover congés)
+      - calcule le total récup N-1 et le persiste en `opening_minutes` du nouvel exercice
+      - idempotent (ne recrée pas si la ligne existe)
+    - paiement RTT:
+      - saisie RH via `PATCH /employees/{id}/rtt-payments` (body: `month`, `minutes`, `rate`)
+      - stocké dans `employee_rtt_payments` (employee, year, month, minutes, rate)
+      - `rate`: taux de majoration, valeurs `25` ou `50`
+      - les heures payées sont soustraites du disponible RTT (`availableMinutes -= totalPaidMinutes`)
+      - affichage: 2 lignes par mois dans le tableau (25% et 50%)
+    - affichage:
+      - le compteur global RTT est affiché en **heures** (format `Xh00`)
+
+## 10) Notifications
+
+- Icône cloche en topbar:
+  - badge = nombre de notifications non lues
+  - ouverture panneau = liste des non lues
+  - fermeture panneau = marquage "lu" en masse
+
+### Règle métier de déclenchement
+
+- Les notifications de validation site ne sont pas envoyées ligne par ligne.
+- 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`
--- a/doc/leave-rollover.md
+++ b/doc/leave-rollover.md
@@ -0,0 +1,226 @@
+# Rollover Conges - Regles et Mise en Production
+
+Document de reference pour expliquer le fonctionnement metier du report N-1 et preparer le lancement en production.
+
+## 1) Objectif
+
+Eviter les recalculs "depuis le debut du contrat" et fiabiliser les soldes.
+
+Principe:
+- le solde est stocké par exercice
+- au changement d'exercice, on ouvre la nouvelle période avec un "solde d'ouverture" (report N-1)
+- un indicateur de cloture (`contractPaidLeaveSettled`) permet de couper la continuité entre 2 contrats
+
+## 2) Exercices metier
+
+- `CDI` / `CDD` non forfait:
+  - exercice: `1er juin` au `31 mai`
+  - `year` = annee de fin d'exercice (ex: `2026` = 01/06/2025 -> 31/05/2026)
+- `FORFAIT`:
+  - exercice: `1er janvier` au `31 decembre`
+  - `year` = annee civile
+- `INTERIM`:
+  - hors perimetre conges
+
+## 3) Logique de compteurs
+
+- `acquis`:
+  - correspond au report N-1 (solde d'ouverture)
+- `en cours d'acquisition`:
+  - correspond aux droits generes sur l'exercice en cours
+- `pris`:
+  - non forfait: absences type `C` (conge)
+  - forfait: toutes absences
+- `restant`:
+  - `acquis + en_cours - pris` (borne a 0 dans l'affichage)
+
+## 4) Effet du "solde de tout compte"
+
+Le champ de cloture `contractPaidLeaveSettled` est saisi lors de la fermeture d'une periode contrat.
+
+- `false`:
+  - continuite des droits entre contrats
+- `true`:
+  - pas de reprise des droits precedents
+  - reset de continuite au lendemain de la date de cloture
+
+## 5) Table cible
+
+Table `employee_leave_balances` (une ligne par employe et exercice):
+- `employee_id`
+- `rule_code` (`CDI_CDD_NON_FORFAIT` ou `FORFAIT_218`)
+- `year`
+- `opening_days`
+- `opening_saturdays`
+- `accrued_days`
+- `accrued_saturdays` (optionnel selon implementation)
+- `taken_days`
+- `taken_saturdays`
+- `closing_days`
+- `closing_saturdays`
+- `is_locked`
+- `created_at`, `updated_at`
+
+Contrainte unique recommandee:
+- `(employee_id, rule_code, year)`
+
+Etat implementation:
+- la table est creee
+- le calcul de synthese conges lit en priorite `opening_days/opening_saturdays` de cette table quand une ligne existe pour `(employee, rule_code, year)`
+- si aucune ligne n'existe, le calcul reste base sur le report dynamique N-1
+- la commande `app:leave:rollover` calcule aussi le report dynamique N-1 si la ligne N-1 n'est pas encore persistée (pas de reset a 0 par defaut)
+
+### Definition des colonnes
+
+- `employee_id`:
+  - identifiant employe (FK vers `employees`)
+  - une ligne de solde par employe / regle / exercice
+- `rule_code`:
+  - code de regle appliquee (`CDI_CDD_NON_FORFAIT`, `FORFAIT_218`)
+  - permet de savoir quelles regles de calcul sont utilisees
+- `year`:
+  - annee d'exercice
+  - non forfait: annee de fin d'exercice (`2026` = 01/06/2025 -> 31/05/2026)
+  - forfait: annee civile (`2026` = 01/01/2026 -> 31/12/2026)
+- `opening_days`:
+  - report N-1 en jours (solde d'ouverture)
+- `opening_saturdays`:
+  - report N-1 "samedis" (0 pour forfait)
+- `accrued_days`:
+  - droits generes sur l'exercice courant (N)
+- `accrued_saturdays`:
+  - droits samedis generes sur N (0 pour forfait)
+- `taken_days`:
+  - jours poses sur l'exercice
+- `taken_saturdays`:
+  - samedis poses sur l'exercice (0 pour forfait)
+- `closing_days`:
+  - solde de cloture jours (`opening_days + accrued_days - taken_days`)
+- `closing_saturdays`:
+  - solde de cloture samedis (`opening_saturdays + accrued_saturdays - taken_saturdays`)
+- `is_locked`:
+  - `false` sur exercice ouvert (recalcul possible)
+  - `true` apres validation RH (exercice fige)
+- `created_at`, `updated_at`:
+  - trace technique creation / mise a jour
+
+## 6) Rollover automatique
+
+Commande quotidienne (cron) idempotente.
+
+- commande Symfony: `php bin/console app:leave:rollover`
+- comportement date metier:
+  - le `01/01`: traite uniquement `FORFAIT_218`
+  - le `01/06`: traite uniquement `CDI_CDD_NON_FORFAIT`
+  - les autres jours: sortie sans action
+- option manuelle: `--force` pour executer hors date metier (reprise/correction)
+
+Date d'effet:
+- forfait: au `1er janvier`
+- non forfait: au `1er juin`
+
+Traitement par employe:
+1. lire l'exercice precedent
+2. determiner le report:
+   - si cloture `paidLeaveSettled=true` sur la periode precedente => report `0`
+   - sinon report = `closing` exercice precedent
+3. creer la ligne du nouvel exercice avec ce report en `opening_*`
+4. initialiser `accrued/taken/closing` pour le nouvel exercice
+
+## 7) Donnees a fournir au go-live
+
+La RH doit fournir un import d'ouverture:
+
+Colonnes minimales:
+- `employee_identifier` (id interne ou matricule)
+- `rule_code`
+- `year`
+- `opening_days`
+- `opening_saturdays` (0 pour forfait)
+- `source_date` (date de reference du relevé RH)
+- `comment` (optionnel)
+
+Format recommande:
+- CSV UTF-8
+- separateur `;`
+- decimales en point (`7.5`)
+
+Exemple:
+```csv
+employee_id;rule_code;year;opening_days;opening_saturdays;source_date;comment
+42;CDI_CDD_NON_FORFAIT;2026;12.5;2;2026-05-31;Reprise fichier RH
+17;FORFAIT_218;2026;8;0;2025-12-31;Reprise fichier RH
+```
+
+## 8) Checklist mise en prod
+
+1. Valider le mapping employe RH -> employe applicatif
+2. Importer les soldes d'ouverture N-1
+3. Verifier 5 cas metier:
+   - CDI simple sans changement de contrat
+   - CDD -> CDI avec `paidLeaveSettled=false`
+   - CDD -> CDI avec `paidLeaveSettled=true`
+   - Forfait sur annee complete
+   - Forfait avec debut en cours d'annee
+4. Activer le cron de rollover
+5. Geler (`is_locked`) les exercices historicises valides
+
+Exemple cron (tous les jours a 02:10):
+Dev
+```cron
+10 2 * * * cd /var/www/html && php bin/console app:leave:rollover --no-interaction 2>&1
+```
+Prod
+```cron
+10 2 * * * cd /var/www/sirh && php bin/console app:leave:rollover --no-interaction 2>&1
+```
+Explication de la ligne cron:
+- `10 2 * * *`: planification
+  - `10` = minute
+  - `2` = heure
+  - `*` = tous les jours du mois
+  - `*` = tous les mois
+  - `*` = tous les jours de la semaine
+- `cd /var/www/html`: se place dans le dossier de l application Symfony
+- `php bin/console app:leave:rollover --no-interaction`: execute le rollover sans demander de confirmation
+  - hors `01/01` et `01/06`, la commande sort en no-op (normal)
+- `>> var/log/leave-rollover.log`: ajoute la sortie standard dans le fichier de log (sans ecraser l historique)
+- `2>&1`: redirige aussi les erreurs dans le meme fichier de log
+
+Execution manuelle forcee:
+```bash
+php bin/console app:leave:rollover --force --no-interaction
+```
+
+Exemple de verification rapide:
+```bash
+tail -n 50 /var/www/html/var/log/leave-rollover.log
+```
+
+## 9) Points de vigilance
+
+- Ne jamais recalculer les soldes historiques apres validation RH sans procedure explicite
+- Garder une trace de toute correction manuelle (auteur, date, motif)
+- Aligner strictement les regles UI et API sur les memes compteurs (pas de formule differente front/back)
+
+## 10) Regle de consommation des droits
+
+Regle metier:
+- un employe peut poser des conges en cours d'acquisition
+- la consommation se fait par ordre:
+  1. `acquis` (report N-1)
+  2. `en cours d'acquisition` (droits N)
+
+Effet attendu:
+- si `acquis = 0` et `en cours = 7.5`, puis prise de `7`, alors:
+  - `acquis` reste `0`
+  - `en cours` devient `0.5`
+- si `acquis = 0` et `en cours = 2.5`, puis prise de `3`, alors:
+  - `acquis` reste `0`
+  - `en cours` devient `-0.5` (dette)
+  - le mois suivant, une acquisition de `2.5` ramené `en cours` a `2.0`
+
+Formule de lecture recommandée:
+- `restant_acquis = max(0, acquis - pris)`
+- `reste_a_imputer_sur_en_cours = max(0, pris - acquis)`
+- `restant_en_cours = en_cours - reste_a_imputer_sur_en_cours` (valeur negative autorisee)
--- a/doc/rtt-rollover.md
+++ b/doc/rtt-rollover.md
@@ -0,0 +1,163 @@
+# Rollover RTT - Regles et Mise en Production
+
+Document de reference pour expliquer le fonctionnement metier du report RTT N-1 et preparer le lancement en production.
+
+## 1) Objectif
+
+Permettre le report des heures supplementaires (RTT) d'un exercice a l'autre et fiabiliser les soldes.
+
+Principe:
+- le solde d'ouverture est stocke par exercice
+- au changement d'exercice, on ouvre la nouvelle periode avec un "solde d'ouverture" (report N-1)
+- au go-live, les soldes d'ouverture sont importes manuellement (CSV ou insertion SQL)
+
+## 2) Exercice metier
+
+- exercice RTT: du `1er juin` au `31 mai`
+- `year` = annee de fin d'exercice (ex: `2026` = 01/06/2025 -> 31/05/2026)
+- employes eligibles: tous sauf `INTERIM` et suivi `PRESENCE`
+
+## 3) Logique de compteurs
+
+- `report N-1`:
+  - correspond au solde d'ouverture (`opening_minutes`)
+  - source prioritaire: table `employee_rtt_balances`
+  - fallback: calcul dynamique de la somme des minutes de recuperation de l'exercice precedent
+- `acquis N`:
+  - somme des minutes de recuperation hebdomadaires de l'exercice en cours
+  - calcul: `HS totales + bonus 25% + bonus 50%` par semaine
+- `disponible`:
+  - `report N-1 + acquis N`
+- affichage du compteur global: en **jours** (1 jour = 7h = 420 minutes)
+
+## 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
+
+## 5) Table cible
+
+Table `employee_rtt_balances` (une ligne par employe et exercice):
+- `employee_id`
+- `year`
+- `opening_minutes`
+- `is_locked`
+- `created_at`, `updated_at`
+
+Contrainte unique:
+- `(employee_id, year)`
+
+Etat implementation:
+- la table est creee
+- le calcul de synthese RTT lit en priorite `opening_minutes` de cette table quand une ligne existe pour `(employee, year)`
+- si aucune ligne n'existe, le calcul dynamique sur l'exercice N-1 est effectue
+
+### Definition des colonnes
+
+- `employee_id`:
+  - identifiant employe (FK vers `employees`)
+  - une ligne de solde par employe / exercice
+- `year`:
+  - annee d'exercice (annee de fin)
+  - `2026` = 01/06/2025 -> 31/05/2026
+- `opening_minutes`:
+  - report N-1 en minutes (solde d'ouverture)
+  - correspond a la somme des minutes de recuperation de l'exercice precedent
+- `is_locked`:
+  - `false` sur exercice ouvert (recalcul possible)
+  - `true` apres validation RH (exercice fige)
+- `created_at`, `updated_at`:
+  - trace technique creation / mise a jour
+
+## 6) Rollover automatique
+
+Commande quotidienne (cron) idempotente.
+
+- commande Symfony: `php bin/console app:rtt:rollover`
+- comportement date metier:
+  - le `01/06`: calcule et persiste le report pour chaque employe eligible
+  - les autres jours: sortie sans action
+- option manuelle: `--force` pour executer hors date metier (reprise/correction)
+
+Date d'effet:
+- au `1er juin` (meme date que le rollover conges non forfait)
+
+Traitement par employe:
+1. verifier l'eligibilite (ni INTERIM, ni suivi PRESENCE)
+2. verifier qu'aucune ligne n'existe deja pour `(employee, targetYear)` (idempotence)
+3. calculer la somme des minutes de recuperation de l'exercice N-1
+4. creer la ligne du nouvel exercice avec ce total en `opening_minutes`
+
+## 7) Donnees a fournir au go-live
+
+La RH doit fournir les soldes RTT a reporter.
+
+Colonnes minimales:
+- `employee_id` (id interne)
+- `year`
+- `opening_minutes` (total en minutes)
+
+Format recommande:
+- CSV UTF-8
+- separateur `;`
+
+Exemple:
+```csv
+employee_id;year;opening_minutes
+42;2026;1260
+17;2026;840
+```
+
+Equivalent en insertion SQL directe:
+```sql
+INSERT INTO employee_rtt_balances (employee_id, year, opening_minutes, is_locked, created_at, updated_at)
+VALUES
+  (42, 2026, 1260, false, NOW(), NOW()),
+  (17, 2026, 840, false, NOW(), NOW());
+```
+
+Conversion rapide: `1260 minutes = 21h00 = 3.00 jours` (1 jour = 420 min = 7h)
+
+## 8) Checklist mise en prod
+
+1. Executer la migration (`employee_rtt_balances`)
+2. Importer les soldes d'ouverture N-1 (CSV ou SQL)
+3. Verifier 3 cas metier:
+   - CDI 39h avec heures supp sur l'exercice precedent
+   - CDI 35h sans heures supp (report = 0)
+   - INTERIM (doit etre ignore, pas de ligne creee)
+4. Activer le cron de rollover
+5. Geler (`is_locked`) les exercices historicises valides
+
+Exemple cron (tous les jours a 02:15, juste apres le rollover conges):
+Dev
+```cron
+15 2 * * * cd /var/www/html && php bin/console app:rtt:rollover --no-interaction 2>&1
+```
+Prod
+```cron
+10 2 * * * cd /var/www/sirh && php bin/console app:rtt:rollover --no-interaction 2>&1
+```
+Explication de la ligne cron:
+- `15 2 * * *`: tous les jours a 02:15
+- `php bin/console app:rtt:rollover --no-interaction`: execute le rollover sans confirmation
+  - hors `01/06`, la commande sort en no-op (normal)
+- `>> var/log/rtt-rollover.log 2>&1`: log sortie standard et erreurs
+
+Execution manuelle forcee:
+```bash
+php bin/console app:rtt:rollover --force --no-interaction
+```
+
+Exemple de verification rapide:
+```bash
+tail -n 50 /var/www/html/var/log/rtt-rollover.log
+```
+
+## 9) Points de vigilance
+
+- Ne jamais modifier `opening_minutes` apres validation RH sans procedure explicite
+- Garder une trace de toute correction manuelle (auteur, date, motif)
+- Le calcul dynamique N-1 (fallback) parcourt toutes les heures de l'exercice precedent: preferer l'import explicite pour les exercices historiques
+- La commande de rollover est idempotente: si une ligne existe deja, l'employe est ignore (pas d'ecrasement)