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
* précédant immédiatement une entrée en FORFAIT. 0 si aucune phase précédente
* ou si la précédente est elle-même un FORFAIT (nouvel embauché → cas 2).
* CP à reporter d'une phase non-forfait vers une entrée en FORFAIT : jours ouvrés
* NETS (acquis + en cours d'acquisition − jours ouvrés posés) + samedis BRUTS (acquis,
* 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
* le report ; les SAMEDIS déjà posés ne le réduisent pas. Le NET disponible calculé
* par computeYearSummary (remainingDays + accruingDays + remainingSaturdays) déduit
* tous les congés posés, samedis inclus ; on ré-ajoute donc takenSaturdays pour ne
* 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é).
* le report ; les SAMEDIS déjà posés ne le réduisent pas. computeYearSummary déduit
* tous les congés posés (samedis inclus), d'où le ré-ajout de takenSaturdays.
* Ex. Grégory : 12 acquis − 5 jours ouvrés posés = 7 (le samedi posé reste crédité).
*
* 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é