WP-09 : tableau de bord RH, et disparition des données de démonstration

`src/lib/demo` n'existe plus. Aucun écran de PlanFlow ne lit désormais autre
chose que la base.

Un indicateur doit être explicable
Chaque tuile est un lien vers ses lignes sources : profils incomplets, fins de
période d'essai, titres de séjour, entrées, sorties, avenants, journal des
absences. Un chiffre qu'on ne peut pas ouvrir ne se corrige pas — il se
conteste. Et chaque ligne mène à la fiche du salarié.

Les manques sont **nommés**, pas comptés : « 6 profils incomplets » n'aide
personne à agir, « il manque l'IBAN de trois salariés » se règle en un message.
Le NIR et l'IBAN sont contrôlés par la présence de leur colonne chiffrée, jamais
déchiffrés — savoir qu'une valeur existe n'exige pas de la lire.

Des chiffres qui refusent de mentir
- La rotation moyenne entrées et sorties : compter seulement les départs
  sous-estime la rotation d'une équipe qui recrute autant qu'elle perd.
- Sur un effectif nul, elle rend `—` et non « 0 % ». Zéro pour cent de rotation
  sur un établissement vide est une affirmation fausse, pas une absence de
  mouvement.
- L'absentéisme se rapporte aux jours **théoriquement travaillés**, pas aux
  jours calendaires : rapporter à 30 jours ferait passer un problème réel pour
  du bruit.
- Un taux horaire absent vaut zéro dans le coût, jamais une estimation :
  afficher un coût inventé serait pire qu'un coût partiel.

Les échéances remontent avant de tomber
Périodes d'essai à 45 jours, titres de séjour à 90. Les échéances **dépassées**
sont conservées et placées en tête : une période d'essai qu'on a laissé filer
est plus urgente qu'une échéance à venir, et la masquer parce qu'elle est passée
est précisément ce qui la rend coûteuse.

Périmètre et confidentialité
Le filtrage par établissement s'applique **avant** l'agrégation : les mouvements
d'un autre établissement ne transparaissent pas, même fondus dans un total. Le
journal des absences ne porte jamais le motif médical — un tableau de bord n'en
a aucun besoin.

Un salarié, qui n'a pas accès à l'annuaire, reçoit un accueil adapté plutôt
qu'une erreur d'autorisation ou un tableau de bord vide.

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 12:40:19 +00:00
1 parent 19f082b7ef
commit 10a9c923e2
12 files changed
+1360 -227

No files matched your search

+214
View File
@@ -0,0 +1,214 @@
import { describe, expect, it } from 'vitest';
import {
absenteeism,
headcount,
labourCost,
profileGaps,
turnoverRate,
upcomingDeadlines,
type HeadcountInput,
} from '@/domain/hr/indicators';
describe('effectif', () => {
const contracts: HeadcountInput[] = [
{ membershipId: 'a', startDate: '2024-01-01', endDate: null },
{ membershipId: 'b', startDate: '2024-01-01', endDate: '2026-08-15' },
{ membershipId: 'c', startDate: '2026-08-03', endDate: null },
{ membershipId: 'd', startDate: '2027-01-01', endDate: null },
];
it('compte les présents en fin de période', () => {
const result = headcount(contracts, '2026-08-01', '2026-08-31');
// a et c sont là au 31 ; b est parti le 15 ; d n'est pas encore arrivé.
expect(result.closing).toBe(2);
});
it('relève les entrées et les sorties de la période', () => {
const result = headcount(contracts, '2026-08-01', '2026-08-31');
expect(result.entries).toEqual(['c']);
expect(result.exits).toEqual(['b']);
});
it('compte un salarié entré et sorti dans la période', () => {
// Présent, même s'il n'était là ni au premier ni au dernier jour.
const result = headcount(
[{ membershipId: 'e', startDate: '2026-08-03', endDate: '2026-08-28' }],
'2026-08-01',
'2026-08-31',
);
expect(result.entries).toEqual(['e']);
expect(result.exits).toEqual(['e']);
expect(result.closing).toBe(0);
});
it('calcule l’effectif moyen sur les deux bornes', () => {
const result = headcount(contracts, '2026-08-01', '2026-08-31');
// 2 présents au 1er (a, b), 2 au 31 (a, c).
expect(result.average).toBe(2);
});
});
describe('rotation', () => {
it('moyenne entrées et sorties', () => {
// Compter seulement les départs sous-estime la rotation d'une équipe qui
// recrute autant qu'elle perd.
const result = headcount(
[
{ membershipId: 'a', startDate: '2024-01-01', endDate: null },
{ membershipId: 'b', startDate: '2024-01-01', endDate: null },
{ membershipId: 'c', startDate: '2024-01-01', endDate: null },
{ membershipId: 'd', startDate: '2024-01-01', endDate: '2026-08-20' },
{ membershipId: 'e', startDate: '2026-08-10', endDate: null },
],
'2026-08-01',
'2026-08-31',
);
// 1 entrée, 1 sortie, effectif moyen (4 + 4) / 2 = 4 → 25 %.
expect(turnoverRate(result)).toBe(25);
});
it('ne prétend pas 0 % sur un effectif nul', () => {
// « 0 % de rotation » sur un établissement vide est une affirmation
// fausse, pas une absence de mouvement.
const result = headcount([], '2026-08-01', '2026-08-31');
expect(turnoverRate(result)).toBeNull();
});
});
describe('absentéisme', () => {
const absences = [
{ membershipId: 'a', days: 5, isSocialSecurity: false, timeOffId: 't1' },
{ membershipId: 'b', days: 3, isSocialSecurity: true, timeOffId: 't2' },
{ membershipId: 'c', days: 1.5, isSocialSecurity: true, timeOffId: 't3' },
];
it('sépare les arrêts du reste', () => {
const result = absenteeism(absences, 200);
expect(result.totalDays).toBe(9.5);
expect(result.sickDays).toBe(4.5);
});
it('rapporte le taux aux jours théoriquement travaillés', () => {
// Rapporter à 30 jours calendaires donnerait un taux artificiellement bas
// et ferait passer un problème réel pour du bruit.
expect(absenteeism(absences, 200).rate).toBe(4.8);
expect(absenteeism(absences, 100).rate).toBe(9.5);
});
it('rend les identifiants sources', () => {
// Un indicateur qu'on ne peut pas ouvrir ne se corrige pas, il se conteste.
expect(absenteeism(absences, 200).sourceIds).toEqual(['t1', 't2', 't3']);
});
it('ne calcule pas de taux sans base', () => {
expect(absenteeism(absences, 0).rate).toBeNull();
});
});
describe('échéances', () => {
const entries = [
{
id: 'p1',
membershipId: 'a',
name: 'Awa Diallo',
dueDate: '2026-08-20',
label: 'Titre de séjour',
},
{
id: 'p2',
membershipId: 'b',
name: 'Yanis Trabelsi',
dueDate: '2026-07-30',
label: 'Période d’essai',
},
{
id: 'p3',
membershipId: 'c',
name: 'Léa Nguyen',
dueDate: '2026-11-30',
label: 'Titre de séjour',
},
];
it('remonte les échéances de la fenêtre', () => {
const result = upcomingDeadlines(entries, '2026-08-10', 60);
expect(result.map((entry) => entry.id)).toEqual(['p2', 'p1']);
});
it('place les échéances dépassées en tête', () => {
// Une période d'essai qu'on a laissé filer est plus urgente qu'une
// échéance à venir : la masquer est ce qui la rend coûteuse.
const result = upcomingDeadlines(entries, '2026-08-10', 60);
expect(result[0]?.severity).toBe('PASSED');
expect(result[0]?.daysLeft).toBe(-11);
});
it('distingue l’urgent du prochain', () => {
const result = upcomingDeadlines(entries, '2026-08-10', 200);
expect(result.find((entry) => entry.id === 'p1')?.severity).toBe('URGENT');
expect(result.find((entry) => entry.id === 'p3')?.severity).toBe('SOON');
});
it('exclut ce qui dépasse la fenêtre', () => {
const result = upcomingDeadlines(entries, '2026-08-10', 30);
expect(result.map((entry) => entry.id)).not.toContain('p3');
});
it('traite la borne exacte comme incluse', () => {
const result = upcomingDeadlines(entries, '2026-08-10', 10);
// 20 août − 10 août = 10 jours : exactement la fenêtre.
expect(result.map((entry) => entry.id)).toContain('p1');
});
});
describe('complétude des dossiers', () => {
const complete = {
membershipId: 'a',
name: 'Sofia Marchetti',
birthDate: new Date('1990-01-01'),
address: '1 rue de la Paix',
city: 'Nantes',
phone: '00 00 00 00 00',
socialSecurityNumber: Buffer.from('chiffré'),
iban: Buffer.from('chiffré'),
hasContract: true,
};
it('ne signale rien sur un dossier complet', () => {
expect(profileGaps(complete).missing).toEqual([]);
});
it('nomme ce qui manque plutôt que de le compter', () => {
// « 6 profils incomplets » n'aide personne à agir ; « il manque l'IBAN de
// trois salariés » se règle en un message.
const gaps = profileGaps({ ...complete, iban: null, phone: null });
expect(gaps.missing).toEqual(['téléphone', 'IBAN']);
});
it('signale un salarié sans contrat', () => {
expect(profileGaps({ ...complete, hasContract: false }).missing).toEqual([
'contrat',
]);
});
it('contrôle la présence du NIR sans le déchiffrer', () => {
// Savoir qu'une valeur existe n'exige pas de la lire.
const gaps = profileGaps({ ...complete, socialSecurityNumber: null });
expect(gaps.missing).toEqual(['numéro de sécurité sociale']);
});
});
describe('coût de main-d’œuvre', () => {
it('applique le taux de cotisations de l’établissement', () => {
// 10 h à 12 € avec 42 % de charges : 120 × 1,42.
expect(labourCost(600, 12, 42)).toBe(170.4);
});
it('suit un taux différent d’un établissement à l’autre', () => {
// Le taux patronal est un paramètre, jamais une constante.
expect(labourCost(600, 12, 0)).toBe(120);
expect(labourCost(600, 12, 50)).toBe(180);
});
});