MALIO-DEV/SIRH
4
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases 67 Wiki Activity

docs(leave) : clarify carried CP docblock (net weekdays + gross saturdays)

Browse Source 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Autin
2026-05-20 16:27:44 +02:00
parent ac40cb9813
commit d2a9bd5191
1 changed files with 13 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
src/State/EmployeeLeaveSummaryProvider.php
View File

@@ -565,16 +565,21 @@ final readonly class EmployeeLeaveSummaryProvider implements ProviderInterface
} }
/** /**
* CP nets encore disponibles (jours + samedis) hérités de la phase non-forfait * CP à reporter d'une phase non-forfait vers une entrée en FORFAIT : jours ouvrés
* précédant immédiatement une entrée en FORFAIT. 0 si aucune phase précédente * NETS (acquis + en cours d'acquisition − jours ouvrés posés) + samedis BRUTS (acquis,
* ou si la précédente est elle-même un FORFAIT (nouvel embauché → cas 2). * sans déduction des samedis posés). 0 si aucune phase précédente ou si la précédente
* est elle-même un FORFAIT (nouvel embauché → cas 2).
*
* Composition du retour :
* remainingDays : acquis (report N-1) restant après jours ouvrés posés
* accruingDays : généré de l'exercice restant (jours + samedis générés)
* remainingSaturdays : samedis acquis (report N-1) restants
* + takenSaturdays : ré-ajout des samedis posés (règle métier ci-dessous)
* *
* Règle (validée comptable) : seuls les congés en JOURS OUVRÉS déjà posés réduisent * Règle (validée comptable) : seuls les congés en JOURS OUVRÉS déjà posés réduisent
* le report ; les SAMEDIS déjà posés ne le réduisent pas. Le NET disponible calculé * le report ; les SAMEDIS déjà posés ne le réduisent pas. computeYearSummary déduit
* par computeYearSummary (remainingDays + accruingDays + remainingSaturdays) déduit * tous les congés posés (samedis inclus), d'où le ré-ajout de takenSaturdays.
* tous les congés posés, samedis inclus ; on ré-ajoute donc takenSaturdays pour ne * Ex. Grégory : 12 acquis − 5 jours ouvrés posés = 7 (le samedi posé reste crédité).
* garder déduits que les jours ouvrés (ex. Grégory : 12 acquis − 5 jours ouvrés pris
* = 7, dont le samedi posé reste crédité).
* *
* Les jours fractionnés (fractionedDays, ajustement manuel ajouté par provide() à * Les jours fractionnés (fractionedDays, ajustement manuel ajouté par provide() à
* l'affichage) sont volontairement EXCLUS : on ne reporte que le solde CP acquis/généré * l'affichage) sont volontairement EXCLUS : on ne reporte que le solde CP acquis/généré