WP-08 : export Silae, format relevé sur un export réel du dossier

Le format n'est plus déduit d'une documentation. Il est vérifié octet par octet sur un export du dossier (juillet 2026, 55 lignes) : un contrôle d'aller-retour a reproduit ce fichier **sans aucune ligne divergente**. Ce que le fichier réel a corrigé dans la spécification - L'export est en **ASCII pur**, pas en UTF-8 : aucun accent, y compris dans les libellés (« Heures travaillees », « Date debut »). Le sérialiseur translittère, pour qu'un salarié nommé « Rémi » n'introduise pas le premier octet non-ASCII du fichier. - Fins de ligne **CRLF**, la dernière comprise ; ni guillemet ni point-virgule final ; décimale point. - Heures avec au moins une décimale et au plus deux — `96.0`, `52.5`, `69.67` ; jours en entier nu — `14`, `22`. L'arrondi se fait **par ligne**, au centième : recomposer un total depuis les lignes peut donc s'écarter de quelques centièmes. C'est le comportement de l'export existant, et le reproduire est délibéré. - Un salarié sous contrat sans aucun créneau planifié figure quand même, avec sa durée contractuelle entière en heures manquantes. Ce que le fichier n'a pas dit Les codes sont maintenant connus — `AB-100`, `AB-200`, `AB-300`, `AB-630`, `EV-HDimanche`, `EV-HFerie`, `HS-HS25` — mais **savoir qu'un code existe ne dit pas ce qu'il désigne**. `EV-HDimanche` se lit ; `AB-300` non. Les premiers sont proposés, les seconds restent vides, et rien n'est confirmé d'office : l'export refuse de tourner tant que le gestionnaire de paie n'a pas validé chaque correspondance. C'est le signal d'arrêt de PLAN.md §8.2, maintenu. Refus plutôt que fichier partiel Un CSV incomplet se charge sans erreur dans Silae et rend la paie fausse pour les salariés qui en sont absents — l'échec est silencieux jusqu'au bulletin. L'export liste donc les manques et ne produit rien. Données personnelles L'export de référence porte les heures et les absences de salariés identifiables. Il **n'est pas versionné**, ni comme fixture ni comme donnée de démonstration. Ce sont les règles de forme qui sont figées dans les tests, avec les valeurs observées mais sans les matricules ni les volumes réels. Le fichier produit revient dans la réponse de l'action plutôt que par une URL : un fichier de paie ne doit pas rester adressable, mis en cache ou présent dans un historique de navigation. En base, seule l'empreinte est conservée — elle suffit à prouver qu'un réexport est identique. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Cr9dkEHwbDgkWPnyGj1Rjv
2026-08-08 07:58:34 +00:00
1 parent 0babdb0936
commit af9429901d
@@ -0,0 +1,218 @@
+import { describe, expect, it } from 'vitest';
+
+import {
+  checkSilaeLines,
+  checksum,
+  formatSilaeCsv,
+  formatSilaeDate,
+  formatSilaeValue,
+  minutesToDecimalHours,
+  SILAE_HEADER,
+  SilaeExportError,
+  toAscii,
+  type SilaeLine,
+} from '@/domain/payroll/silae';
+
+/**
+ * Ces tests reproduisent les conventions relevées sur un export réel du
+ * dossier (juillet 2026). Le fichier lui-même n'est pas versionné : il contient
+ * les heures et les absences de salariés identifiables.
+ *
+ * Ce sont donc les **règles de forme** qui sont figées ici, avec les valeurs
+ * exactes observées — un import de paie refusé pour un accent ou une virgule
+ * coûte une demi-journée, un import accepté avec de mauvais arrondis coûte
+ * bien davantage.
+ */
+
+const h = (hours: number, minutes = 0) => hours * 60 + minutes;
+
+function line(over: Partial<SilaeLine> = {}): SilaeLine {
+  return {
+    matricule: '00061',
+    code: 'Heures travaillees',
+    value: h(96),
+    kind: 'HOURS',
+    startDate: '2026-07-01',
+    endDate: '2026-07-31',
+    ...over,
+  };
+}
+
+describe('mise en forme des valeurs', () => {
+  it('rend les heures avec au moins une décimale', () => {
+    expect(formatSilaeValue(h(96), 'HOURS')).toBe('96.0');
+    expect(formatSilaeValue(h(105), 'HOURS')).toBe('105.0');
+    expect(formatSilaeValue(h(1), 'HOURS')).toBe('1.0');
+  });
+
+  it('retire le zéro superflu sans perdre la décimale utile', () => {
+    expect(formatSilaeValue(h(52, 30), 'HOURS')).toBe('52.5');
+    expect(formatSilaeValue(h(0, 30), 'HOURS')).toBe('0.5');
+    expect(formatSilaeValue(h(6, 30), 'HOURS')).toBe('6.5');
+  });
+
+  it('reproduit les arrondis observés au centième', () => {
+    // Chaque valeur de gauche vient de l'export de référence.
+    expect(formatSilaeValue(h(69, 40), 'HOURS')).toBe('69.67');
+    expect(formatSilaeValue(h(4, 50), 'HOURS')).toBe('4.83');
+    expect(formatSilaeValue(h(3, 5), 'HOURS')).toBe('3.08');
+    expect(formatSilaeValue(h(4, 35), 'HOURS')).toBe('4.58');
+    expect(formatSilaeValue(h(5, 45), 'HOURS')).toBe('5.75');
+    expect(formatSilaeValue(h(116, 40), 'HOURS')).toBe('116.67');
+    expect(formatSilaeValue(h(166, 15), 'HOURS')).toBe('166.25');
+  });
+
+  it('rend les jours en entier nu', () => {
+    // Les jours travaillés sortent « 14 », jamais « 14.0 ».
+    expect(formatSilaeValue(14, 'DAYS')).toBe('14');
+    expect(formatSilaeValue(22, 'DAYS')).toBe('22');
+    expect(formatSilaeValue(3, 'DAYS')).toBe('3');
+  });
+
+  it('convertit les minutes en heures décimales', () => {
+    expect(minutesToDecimalHours(h(4, 50))).toBe(4.83);
+    expect(minutesToDecimalHours(h(69, 40))).toBe(69.67);
+    expect(minutesToDecimalHours(0)).toBe(0);
+  });
+});
+
+describe('dates', () => {
+  it('inverse en JJ/MM/AAAA', () => {
+    expect(formatSilaeDate('2026-07-01')).toBe('01/07/2026');
+    expect(formatSilaeDate('2026-07-31')).toBe('31/07/2026');
+  });
+
+  it('refuse une date qui n’est pas une date', () => {
+    expect(() => formatSilaeDate('juillet')).toThrow(/invalide/);
+  });
+});
+
+describe('ASCII', () => {
+  it('retire les accents', () => {
+    // L'export de référence ne contient aucun caractère composé : un salarié
+    // nommé « Rémi » ne doit pas introduire le premier octet non-ASCII.
+    expect(toAscii('Absence rémunérée')).toBe('Absence remuneree');
+    expect(toAscii('Heures travaillées')).toBe('Heures travaillees');
+  });
+
+  it('écarte ce qui n’est pas imprimable en ASCII', () => {
+    expect(toAscii('AB‑300')).toBe('AB300');
+    expect(toAscii('café ☕')).toBe('cafe ');
+  });
+});
+
+describe('sérialisation', () => {
+  it('produit l’en-tête exact', () => {
+    const { csv } = formatSilaeCsv([line()]);
+    expect(csv.split('\r\n')[0]).toBe(SILAE_HEADER);
+    expect(SILAE_HEADER).toBe('Matricule;Code;Valeur;Date debut;Date fin');
+  });
+
+  it('termine chaque ligne par CRLF, la dernière comprise', () => {
+    const { csv } = formatSilaeCsv([line()]);
+    expect(csv.endsWith('\r\n')).toBe(true);
+    expect(csv).not.toMatch(/[^\r]\n/);
+  });
+
+  it('reproduit une ligne de l’export de référence', () => {
+    const { csv } = formatSilaeCsv([
+      line({ code: 'Heures travaillees', value: h(96) }),
+    ]);
+    expect(csv).toContain('00061;Heures travaillees;96.0;01/07/2026;31/07/2026');
+  });
+
+  it('reproduit une ligne d’absence bornée sur ses propres dates', () => {
+    // Les agrégats couvrent la période de paie ; une absence couvre la période
+    // d'absence. Les confondre décalerait le décompte d'un mois entier.
+    const { csv } = formatSilaeCsv([
+      line({
+        matricule: '00173',
+        code: 'AB-630',
+        value: h(4, 50),
+        startDate: '2026-07-27',
+        endDate: '2026-07-27',
+      }),
+    ]);
+    expect(csv).toContain('00173;AB-630;4.83;27/07/2026;27/07/2026');
+  });
+
+  it('n’ajoute ni guillemet ni point-virgule final', () => {
+    const { csv } = formatSilaeCsv([line()]);
+    const row = csv.split('\r\n')[1] ?? '';
+    expect(row).not.toContain('"');
+    expect(row.endsWith(';')).toBe(false);
+    expect(row.split(';')).toHaveLength(5);
+  });
+
+  it('accepte les deux formes de matricule du dossier', () => {
+    const { csv } = formatSilaeCsv([
+      line({ matricule: '00201' }),
+      line({ matricule: 'COPIGA' }),
+    ]);
+    expect(csv).toContain('00201;');
+    expect(csv).toContain('COPIGA;');
+  });
+});
+
+describe('déterminisme', () => {
+  it('trie de façon stable quel que soit l’ordre d’entrée', () => {
+    const lines = [
+      line({ matricule: '00201', code: 'Heures travaillees' }),
+      line({ matricule: '00061', code: 'Nombre total de jours travailles', value: 14, kind: 'DAYS' }),
+      line({ matricule: '00061', code: 'AB-300', value: h(11) }),
+    ];
+
+    const first = formatSilaeCsv(lines).csv;
+    const second = formatSilaeCsv([...lines].reverse()).csv;
+    expect(first).toBe(second);
+  });
+
+  it('produit la même empreinte pour un réexport identique', async () => {
+    // L'import Silae écrase la période pour les salariés concernés : un export
+    // doit pouvoir être rejoué sans effet de bord, et l'empreinte le prouve.
+    const lines = [line(), line({ code: 'AB-300', value: h(11) })];
+    const a = await checksum(formatSilaeCsv(lines).csv);
+    const b = await checksum(formatSilaeCsv([...lines].reverse()).csv);
+    expect(a).toBe(b);
+    expect(a).toHaveLength(64);
+  });
+});
+
+describe('contrôles préalables', () => {
+  it('refuse un matricule manquant', () => {
+    // Un export partiel se charge sans erreur et la paie est fausse pour les
+    // salariés absents du fichier : il vaut mieux ne rien produire.
+    const issues = checkSilaeLines([line({ matricule: '  ' })]);
+    expect(issues[0]?.message).toMatch(/Matricule Silae manquant/);
+  });
+
+  it('refuse un code non renseigné', () => {
+    const issues = checkSilaeLines([line({ code: '' })]);
+    expect(issues[0]?.message).toMatch(/Code de paie non renseigné/);
+  });
+
+  it('refuse une valeur négative', () => {
+    const issues = checkSilaeLines([line({ value: -60 })]);
+    expect(issues[0]?.message).toMatch(/négative/);
+  });
+
+  it('refuse une période inversée', () => {
+    const issues = checkSilaeLines([
+      line({ startDate: '2026-07-31', endDate: '2026-07-01' }),
+    ]);
+    expect(issues[0]?.message).toMatch(/antérieure/);
+  });
+
+  it('échoue en listant les manques plutôt qu’en produisant un fichier', () => {
+    expect(() => formatSilaeCsv([line({ matricule: '' })])).toThrow(
+      SilaeExportError,
+    );
+
+    try {
+      formatSilaeCsv([line({ matricule: '' }), line({ code: '' })]);
+      expect.unreachable('Un export incomplet ne doit pas aboutir.');
+    } catch (error) {
+      expect((error as SilaeExportError).issues).toHaveLength(2);
+    }
+  });
+});