This commit is contained in:
nessar committed 2026-10-07 00:28:29 +02:00
1 parent 03841c6e3d
commit 036a8c0e1e
32 files changed
+1805 -89

No files matched your search

+25
View File
@@ -40,6 +40,9 @@ A working day on which the user declares they will not work, identified by a CP,
**Public holiday**:
A French calendar date that cannot receive a leave placement and contributes to a time-off period.
**Public holiday connected to a weekend**:
A distinct Monday-to-Friday public-holiday date in a planned time-off period containing at least one Saturday or Sunday, including adjacent holiday dates outside the planning horizon; the connection may be direct or through leave placements or declared non-working days. Weekend public holidays and naturally long weekends without a leave placement or declared non-working day are excluded.
**Public-holiday week**:
A Monday-to-Friday window containing a weekday French public holiday where every other working day is a leave placement or declared non-working day.
@@ -54,19 +57,35 @@ A leave placement from a deferred balance that completes a public-holiday week,
**Time-off period**:
A contiguous period containing at least one leave placement or declared non-working day, together with any adjacent non-working dates, including those immediately outside the planning horizon.
_Avoid_: leave sequence
**Time-off duration**:
The number of distinct calendar dates covered by all planned time-off periods.
**Average time-off period length**:
The arithmetic mean duration in calendar days of all planned time-off periods, including adjacent non-working dates outside the planning horizon.
**Longest time-off period length**:
The greatest duration in calendar days among the planned time-off periods, including adjacent non-working dates outside the planning horizon.
**Non-working-day gain**:
The distinct weekend and public-holiday dates contained in planned time-off periods. Leave placement dates themselves do not contribute to this gain.
**Work sequence**:
The working days in an interval delimited by planned time-off periods or by the planning horizon edges. Intervening weekends and public holidays neither count nor split the sequence.
**Average work-sequence length**:
The arithmetic mean number of working days across all non-empty work sequences within the planning horizon, including the sequences before the first time-off period and after the last.
**Longest work-sequence length**:
The greatest number of working days in any work sequence within the planning horizon, including the sequences at both horizon edges.
**Short work sequence**:
A work sequence of fewer than five working days between two planned time-off periods.
**Week with one workday**:
An undesirable Monday-to-Sunday calendar week with exactly one working day remaining after excluding leave placements and declared non-working days. All five Monday-to-Friday dates must fall within the planning horizon.
**Planning rule**:
A user instruction that requests leave placements around a calendar opportunity or inside a date window. Its force is either an obligation or a preference.
@@ -94,6 +113,9 @@ The relationship in which a plan fulfils a planning rule. One compatible leave p
**Placement provenance**:
The consumed leave entitlement and every planning rule satisfied by a leave placement.
**Plan statistics**:
The numerical summary of a calculated valid plan's leave usage, time-off periods, and work patterns, including a valid plan retained by an incomplete calculation. It reflects that calculation's horizon, balances, rules, declared non-working days, and Europe/Paris calendar date.
**Plan explanation**:
A stable account of why an optimization result or incomplete calculation contains its displayed leave placements, expressed through placement provenance, planning objectives, time-off periods, and remaining balances. It reports every contribution of a placement while highlighting the first planning objective that made its position decisive, and describes the displayed plan rather than the calculation history.
_Avoid_: calculation explanation
@@ -144,6 +166,9 @@ A calculation stopped by user cancellation or another interruption before it com
**Planning objective order**:
The lexicographic quality order applied after joint obligation feasibility: minimize unplaced at-risk leave; satisfy each preference in user order; maximize public-holiday week value; maximize non-working-day gain; minimize the longest work sequence; minimize the total deficit of internal work sequences shorter than five days; minimize supporting placements; consume earlier-expiring balances; then prefer earlier placement dates. Complete holiday weeks therefore precede broader calendar-gain and work-sequence optimization. A lower criterion never degrades a higher one.
**Earned leave**:
The total quantity of earned leave entitlements generated by all applicable planning rules for a plan, counted before consumption and attributed to their generating rules. Only entitlements becoming available strictly after the calculation's Europe/Paris calendar date qualify, including those becoming available after the planning horizon.
**Earned leave entitlement**:
A leave entitlement earned for each completed occurrence of an applicable planning rule after its generating time-off period ends, whether that occurrence is fulfilled by leave placements, declared non-working days, or both. It becomes available the following day, expires one year later, and may fund later compatible placements; only entitlements becoming available after the calculation's Europe/Paris calendar date are added to the plan.
_Avoid_: reward, bonus days