docs(leave) : note bonusDays deliberately omitted on forfait entry year

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/State/EmployeeLeaveSummaryProvider.php

@@ -778,6 +778,10 @@ final readonly class EmployeeLeaveSummaryProvider implements ProviderInterface
                 $repoDays  = $this->computeProratedForfaitRepoDays($businessDaysYear, $businessDaysPeriod);
                 $carriedCp = $this->resolveCarriedCpFromPriorPhase($employee, $phase);
 
+                // NB : le bonus week-end/férié travaillé (bonusDays du chemin année pleine)
+                // n'est volontairement PAS ajouté ici. L'acquis de l'année d'entrée = repos
+                // proratisés + CP reportés (règle comptable). À revoir si la RH veut créditer
+                // le travail week-end/férié posé pendant la période forfait partielle.
                 return [
                     'ruleCode'                => LeaveRuleCode::FORFAIT_218->value,
                     'acquiredDays'            => $repoDays + $carriedCp,