WP-06 : absences, registre de compteurs, calendrier

Le dernier module de démonstration disparaît : `src/lib/demo/` ne contient plus
que l'aperçu.

Le décompte, là où l'on se trompe
- **`endDate` est le dernier jour d'absence, pas la date de reprise.** C'est la
  confusion la plus fréquente du domaine : elle décompte un jour de trop ou de
  trop peu à chaque demande, et le salarié s'en aperçoit au solde, des mois plus
  tard. Le champ du formulaire s'appelle « Dernier jour d'absence », et un test
  couvre explicitement la confusion.
- **Un jour férié dans un congé ne se décompte pas**, sans que l'utilisateur ait
  à scinder sa demande. Exiger la scission, c'est lui déplacer la charge d'un
  calcul que l'outil sait faire.
- Le rythme du contrat est respecté : un temps partiel qui ne travaille jamais
  le mercredi ne consomme pas de congé ce jour-là.
- Ouvrables ou ouvrés est un **paramètre**, pas une constante : se tromper
  fausse tous les soldes de la même façon.

Jours fériés calculés, pas listés
Une table écrite à la main est juste l'année où on l'écrit et fausse dès la
suivante — et un férié manquant se décompte comme un jour de congé, sans que
personne ne le voie. Les onze jours légaux sont donc calculés, Pâques comprise
(algorithme grégorien anonyme, vérifié sur quatre années de référence). Quand
aucun férié n'est enregistré pour l'année demandée, la demande passe mais
l'écran le dit : mieux vaut l'annoncer que laisser croire à un décompte complet.

Le registre est la source de vérité
- Aucun solde n'est stocké : le solde est la **somme** des écritures. Un solde
  stocké se désynchronise, et la désynchronisation ne se voit qu'au moment où un
  salarié conteste.
- `UPDATE` et `DELETE` sont refusés par un trigger PostgreSQL, pas seulement par
  l'application : une règle applicative finit par être contournée par un script
  de reprise. Les tests d'intégration écrivent directement en base pour le
  prouver.
- Annuler une absence acceptée **contre-passe** la prise au lieu de l'effacer,
  à la date de la correction — antidater masquerait la correction dans les
  soldes déjà communiqués. `reversesId` est unique : contre-passer deux fois
  ferait repartir le solde dans l'autre sens.
- Un ajustement manuel sans justification est refusé.

Confidentialité du motif médical
Un manager voit qu'un salarié est absent, pas de quoi il souffre (matrice n° 9).
Le motif d'un arrêt n'est **pas chargé** pour qui n'a pas la capacité de le
lire — un champ absent de la réponse ne peut fuiter ni par le HTML ni par un
journal. Sur la grille de planning, l'absence s'affiche « Absence » : c'est
suffisant pour ne pas planifier quelqu'un.

Acquisition
2,5 jours ouvrables par mois travaillé ; 2 jours par mois d'arrêt maladie non
professionnelle, plafonnés à 24 par an — droit issu de la réforme de 2024, dont
l'oubli prive le salarié d'un droit acquis.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cr9dkEHwbDgkWPnyGj1Rjv
This commit is contained in:
Claude committed 2026-08-08 08:31:01 +00:00
1 parent 747f0ef86f
commit 0213375a8f
18 files changed
+3160 -228

No files matched your search

+74 -3
View File
@@ -34,6 +34,15 @@ export interface BoardShift {
note: string | null;
}
export interface BoardAbsence {
label: string;
colorKey: string;
/** Index de colonne du premier jour visible, 0 = lundi. */
startDay: number;
/** Nombre de jours couverts dans la semaine affichée. */
span: number;
}
export interface BoardRow {
/** `null` sur la ligne des besoins non couverts. */
membershipId: string | null;
@@ -44,6 +53,8 @@ export interface BoardRow {
counters: WeekCounters;
/** Sept cases, lundi → dimanche. */
days: BoardShift[][];
/** Absences acceptées recouvrant la semaine affichée. */
absences: BoardAbsence[];
unassigned: boolean;
}
@@ -56,6 +67,15 @@ export interface RowPerson {
contractMinutes: number;
}
export interface AbsenceInput {
membershipId: string;
startDate: string;
/** Dernier jour d'absence, pas la date de reprise. */
endDate: string;
label: string;
colorKey: string;
}
/**
* Range les créneaux d'une semaine en lignes × sept colonnes.
*
@@ -70,6 +90,7 @@ export function buildRows(
weekDates: string[],
timeZone: string,
isPublished: boolean,
absences: AbsenceInput[] = [],
): { rows: BoardRow[]; unassignedRow: BoardRow | null } {
const columnOf = new Map(weekDates.map((date, index) => [date, index]));
@@ -128,9 +149,34 @@ export function buildRows(
}
for (const column of unassignedDays) column.sort(byStartTime);
const first = weekDates[0] ?? '';
const last = weekDates[6] ?? '';
const rows = people.map((person) => {
const days = byMember.get(person.membershipId) ?? emptyDays();
const worked = days.filter((column) => column.length > 0).length;
// L'absence est **rognée** aux bornes de la semaine affichée : une absence
// de trois semaines doit apparaître entière sur chacune, pas déborder.
const rowAbsences = absences
.filter(
(absence) =>
absence.membershipId === person.membershipId &&
absence.startDate <= last &&
absence.endDate >= first,
)
.map((absence) => {
const startDay = Math.max(0, weekDates.indexOf(absence.startDate));
const endIndex = weekDates.indexOf(absence.endDate);
const endDay = endIndex === -1 ? 6 : endIndex;
return {
label: absence.label,
colorKey: absence.colorKey,
startDay: absence.startDate < first ? 0 : startDay,
span: endDay - (absence.startDate < first ? 0 : startDay) + 1,
};
});
return {
membershipId: person.membershipId,
firstName: person.firstName,
@@ -139,12 +185,18 @@ export function buildRows(
forfaitJours: person.forfaitJours,
unassigned: false,
days,
absences: rowAbsences,
counters: {
contractMinutes: person.forfaitJours ? 0 : person.contractMinutes,
plannedMinutes: minutesByMember.get(person.membershipId) ?? 0,
// Les absences arrivent au lot suivant ; le compteur existe déjà pour
// que la formule d'écart ne change pas quand elles se brancheront.
absenceMinutes: 0,
// Les absences comptent dans l'atteinte du contrat : une semaine
// entièrement en congés ne doit pas apparaître en sous-réalisation.
// Leur valorisation en minutes vient du contrat, pas du planning.
absenceMinutes: absenceMinutesOf(
rowAbsences,
person.contractMinutes,
person.forfaitJours,
),
sundaysWorked: sundaysByMember.get(person.membershipId)?.size ?? 0,
restDays: 7 - worked,
},
@@ -160,6 +212,7 @@ export function buildRows(
forfaitJours: false,
unassigned: true,
days: unassignedDays,
absences: [],
counters: {
contractMinutes: 0,
plannedMinutes: unassignedDays
@@ -175,6 +228,24 @@ export function buildRows(
return { rows, unassignedRow };
}
/**
* Durée créditée par une absence, en minutes.
*
* Proportionnelle au contrat sur une base de cinq jours ouvrés : un salarié à
* 35 h absent trois jours est crédité de 21 h. Le calcul reste ici, dans la
* mise en forme, parce qu'il ne sert qu'à l'écart affiché — la paie, elle, part
* du décompte en jours figé à la décision.
*/
function absenceMinutesOf(
absences: BoardAbsence[],
contractMinutes: number,
forfaitJours: boolean,
): number {
if (forfaitJours || contractMinutes <= 0) return 0;
const days = absences.reduce((total, absence) => total + absence.span, 0);
return Math.round((contractMinutes / 5) * Math.min(days, 5));
}
function byStartTime(a: BoardShift, b: BoardShift): number {
return a.time.localeCompare(b.time);
}