@open3cl/engine 1.8.58 → 1.8.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,62 @@
1
+ /**
2
+ * DPE immeuble avec une installation ECS individuelle unique décrite pour un logement type.
3
+ *
4
+ * Certains logiciels (3.0.x, 2.0.x, 1.1.x) exportent l'installation ECS individuelle unique d'un
5
+ * immeuble avec `surface_habitable` = SH / N et `nombre_logement` = N, sans `rdim`. Le calcul de
6
+ * référence (Tribu) a été fait avec Rdim = N : le besoin est ramené à un logement
7
+ * (Becs = Becs_immeuble × Sh × Rdim / SH / Rdim = Becs_immeuble / N), les pertes de stockage sont
8
+ * celles d'un seul ballon (Vs non multiplié), puis la consommation est multipliée par Rdim.
9
+ *
10
+ * Sans rdim, Open3CL impute le besoin de tout l'immeuble à un seul ballon : conso_ecs −25 à −30 %.
11
+ * On reconstitue donc rdim = N, ce qui réutilise la chaîne existante (11_ecs.js : besoin / rdim,
12
+ * conso.js : conso × rdim).
13
+ *
14
+ * LICIEL (nombre_logement = 1, Rdim non exporté) n'est pas concerné.
15
+ *
16
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - § 11.6, § 11.6.2 (p. 74-75) et § 17.2.2.3
17
+ * @see Tribu : Calcul_batiment.cs l. 583-588 (Ratio = Sh·Rdim/SH), l. 602-604 (Vs non multiplié),
18
+ * l. 1654-1664 et l. 1052 (Cecs / Rdim puis × Rdim)
19
+ * @see https://github.com/Open3CL/engine/issues/288
20
+ */
21
+
22
+ /** Tolérance relative sur Sh_ecs × N ≈ SH */
23
+ export const TOLERANCE_SURFACE_LOGEMENT_TYPE = 0.05;
24
+
25
+ /**
26
+ * Rdim implicite de l'installation ECS individuelle unique d'un immeuble, ou null si non concernée.
27
+ *
28
+ * @param th {string} type de bâtiment (maison, appartement, immeuble)
29
+ * @param instal_ecs {Array} installation_ecs
30
+ * @param surfaceHabitableImmeuble {number|string} surface habitable de l'immeuble (SH)
31
+ * @return {number|null}
32
+ */
33
+ export function rdimImpliciteEcsIndividuelleUnique(th, instal_ecs, surfaceHabitableImmeuble) {
34
+ if (th !== 'immeuble' || !Array.isArray(instal_ecs) || instal_ecs.length !== 1) return null;
35
+
36
+ const de = instal_ecs[0].donnee_entree;
37
+ if (!de || String(de.enum_type_installation_id) !== '1' || de.rdim) return null;
38
+
39
+ const N = Number(de.nombre_logement);
40
+ const SH = Number(surfaceHabitableImmeuble);
41
+ const sh = Number(de.surface_habitable);
42
+ if (!(N > 1) || !(SH > 0) || !(sh > 0)) return null;
43
+
44
+ return Math.abs(sh * N - SH) <= TOLERANCE_SURFACE_LOGEMENT_TYPE * SH ? N : null;
45
+ }
46
+
47
+ /**
48
+ * Reconstitue le rdim de l'installation ECS individuelle unique d'un immeuble décrite pour un
49
+ * logement type. L'installation reçoit `rdim` = nombre_logement et le flag `rdim_reconstitue`.
50
+ *
51
+ * @param th {string} type de bâtiment
52
+ * @param instal_ecs {Array} installation_ecs
53
+ * @param surfaceHabitableImmeuble {number|string} surface habitable de l'immeuble (SH)
54
+ * @return {boolean} true si le rdim a été reconstitué
55
+ */
56
+ export function reconstituerRdimEcsIndividuelleUnique(th, instal_ecs, surfaceHabitableImmeuble) {
57
+ const rdim = rdimImpliciteEcsIndividuelleUnique(th, instal_ecs, surfaceHabitableImmeuble);
58
+ if (rdim === null) return false;
59
+ instal_ecs[0].donnee_entree.rdim = rdim;
60
+ instal_ecs[0].donnee_entree.rdim_reconstitue = true;
61
+ return true;
62
+ }
@@ -0,0 +1,113 @@
1
+ import { describe, expect, test } from 'vitest';
2
+ import {
3
+ rdimImpliciteEcsIndividuelleUnique,
4
+ reconstituerRdimEcsIndividuelleUnique,
5
+ TOLERANCE_SURFACE_LOGEMENT_TYPE
6
+ } from './11_rdim_ecs_individuelle_unique.js';
7
+
8
+ /**
9
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - § 11.6, § 11.6.2 et § 17.2.2.3
10
+ * @see Tribu : Calcul_batiment.cs l. 583-588, l. 602-604, l. 1654-1664
11
+ * @see https://github.com/Open3CL/engine/issues/288
12
+ */
13
+ describe("Rdim de l'installation ECS individuelle unique d'un immeuble", () => {
14
+ /** Installation ECS décrite pour un logement type : Sh = SH / N, nombre_logement = N */
15
+ const ecs = (de) => [
16
+ {
17
+ donnee_entree: {
18
+ enum_type_installation_id: '1',
19
+ surface_habitable: 64,
20
+ nombre_logement: 10,
21
+ ...de
22
+ }
23
+ }
24
+ ];
25
+
26
+ describe('rdimImpliciteEcsIndividuelleUnique', () => {
27
+ test('installation individuelle unique, Sh × N = SH, sans rdim : rdim = nombre_logement', () => {
28
+ // Cas type 2244E3131012H : N = 10
29
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 640)).toBe(10);
30
+ expect(
31
+ rdimImpliciteEcsIndividuelleUnique(
32
+ 'immeuble',
33
+ ecs({ enum_type_installation_id: 1, surface_habitable: '64', nombre_logement: '10' }),
34
+ '640'
35
+ )
36
+ ).toBe(10);
37
+ });
38
+
39
+ test('tolérance de 5 % sur Sh × N ≈ SH', () => {
40
+ expect(TOLERANCE_SURFACE_LOGEMENT_TYPE).toBe(0.05);
41
+ // |640 − SH| ≤ 0,05 × SH ⇔ 609,52 ≤ SH ≤ 673,68
42
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 673)).toBe(10);
43
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 610)).toBe(10);
44
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 674)).toBeNull();
45
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 609)).toBeNull();
46
+ });
47
+
48
+ test('installation décrite sur la surface de l’immeuble (Sh = SH) : non concernée', () => {
49
+ expect(
50
+ rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ surface_habitable: 640 }), 640)
51
+ ).toBeNull();
52
+ });
53
+
54
+ test('LICIEL : nombre_logement = 1 → non concerné', () => {
55
+ expect(
56
+ rdimImpliciteEcsIndividuelleUnique(
57
+ 'immeuble',
58
+ ecs({ nombre_logement: 1, surface_habitable: 640 }),
59
+ 640
60
+ )
61
+ ).toBeNull();
62
+ });
63
+
64
+ test('rdim exporté : on conserve la saisie', () => {
65
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ rdim: 4 }), 640)).toBeNull();
66
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ rdim: 1 }), 640)).toBeNull();
67
+ });
68
+
69
+ test('installation collective : non concernée', () => {
70
+ expect(
71
+ rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ enum_type_installation_id: '2' }), 640)
72
+ ).toBeNull();
73
+ });
74
+
75
+ test('maison ou appartement : non concerné', () => {
76
+ expect(rdimImpliciteEcsIndividuelleUnique('maison', ecs(), 640)).toBeNull();
77
+ expect(rdimImpliciteEcsIndividuelleUnique('appartement', ecs(), 640)).toBeNull();
78
+ });
79
+
80
+ test('plusieurs installations ECS : non concerné (#232)', () => {
81
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', [...ecs(), ...ecs()], 640)).toBeNull();
82
+ });
83
+
84
+ test('données manquantes : non concerné', () => {
85
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', undefined, 640)).toBeNull();
86
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', [], 640)).toBeNull();
87
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', [{}], 640)).toBeNull();
88
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), undefined)).toBeNull();
89
+ expect(rdimImpliciteEcsIndividuelleUnique('immeuble', ecs(), 0)).toBeNull();
90
+ expect(
91
+ rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ surface_habitable: undefined }), 640)
92
+ ).toBeNull();
93
+ expect(
94
+ rdimImpliciteEcsIndividuelleUnique('immeuble', ecs({ nombre_logement: undefined }), 640)
95
+ ).toBeNull();
96
+ });
97
+ });
98
+
99
+ describe('reconstituerRdimEcsIndividuelleUnique', () => {
100
+ test('installation concernée : rdim et flag positionnés', () => {
101
+ const inst = ecs();
102
+ expect(reconstituerRdimEcsIndividuelleUnique('immeuble', inst, 640)).toBe(true);
103
+ expect(inst[0].donnee_entree).toMatchObject({ rdim: 10, rdim_reconstitue: true });
104
+ });
105
+
106
+ test('installation non concernée : inchangée', () => {
107
+ const inst = ecs({ nombre_logement: 1 });
108
+ expect(reconstituerRdimEcsIndividuelleUnique('immeuble', inst, 640)).toBe(false);
109
+ expect(inst[0].donnee_entree.rdim).toBeUndefined();
110
+ expect(inst[0].donnee_entree.rdim_reconstitue).toBeUndefined();
111
+ });
112
+ });
113
+ });
package/README.md CHANGED
@@ -375,21 +375,21 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
375
375
 
376
376
  <!-- CORPUS:START -->
377
377
 
378
- > **Version `1.8.57`** · branche `main` · généré le 2026-10-14
378
+ > **Version `1.8.58`** · branche `main` · généré le 2026-10-14
379
379
  > Seuil de tolérance **5%**
380
380
 
381
381
  <table>
382
382
  <tr>
383
383
  <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
384
384
  <td align="center"><strong>89 418</strong><br/><sub>DPE analysés</sub></td>
385
- <td align="center"><strong>66 706</strong><br/><sub>DPE conformes</sub></td>
386
- <td align="center"><strong>74,60 %</strong><br/><sub>réussite globale</sub></td>
385
+ <td align="center"><strong>69 329</strong><br/><sub>DPE conformes</sub></td>
386
+ <td align="center"><strong>77,53 %</strong><br/><sub>réussite globale</sub></td>
387
387
  </tr>
388
388
  </table>
389
389
 
390
390
  | | Corpus | Réussite | | DPE conformes |
391
391
  | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
392
- | 🔴 | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub> | **47,08 %** | `█████████░░░░░░░░░░░` | 4 708 / 9 999 |
392
+ | 🔴 | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub> | **47,67 %** | `██████████░░░░░░░░░░` | 4 767 / 9 999 |
393
393
  | 🟢 | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,90 %** | `███████████████████░` | 9 290 / 10 000 |
394
394
  | 🟢 | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub> | **91,72 %** | `██████████████████░░` | 9 172 / 10 000 |
395
395
  | 🟢 | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub> | **90,47 %** | `██████████████████░░` | 9 040 / 9 992 |
@@ -397,7 +397,7 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
397
397
  | 🟢 | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub> | **85,04 %** | `█████████████████░░░` | 8 346 / 9 814 |
398
398
  | 🟡 | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub> | **84,58 %** | `█████████████████░░░` | 8 456 / 9 998 |
399
399
  | 🔴 | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub> | **59,86 %** | `████████████░░░░░░░░` | 5 756 / 9 616 |
400
- | 🔴 | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub> | **30,49 %** | `██████░░░░░░░░░░░░░░` | 3 049 / 10 000 |
400
+ | 🔴 | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub> | **56,13 %** | `███████████░░░░░░░░░` | 5 613 / 10 000 |
401
401
 
402
402
  <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
403
403
 
@@ -408,24 +408,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
408
408
 
409
409
  <table>
410
410
  <tr>
411
- <td align="center"><strong>5,53 ms</strong><br/><sub>moyenne</sub></td>
412
- <td align="center"><strong>4,81 ms</strong><br/><sub>médiane</sub></td>
413
- <td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
414
- <td align="center"><strong>742,8 ms</strong><br/><sub>max</sub></td>
411
+ <td align="center"><strong>5,46 ms</strong><br/><sub>moyenne</sub></td>
412
+ <td align="center"><strong>4,80 ms</strong><br/><sub>médiane</sub></td>
413
+ <td align="center"><strong>0,11 ms</strong><br/><sub>min</sub></td>
414
+ <td align="center"><strong>655,4 ms</strong><br/><sub>max</sub></td>
415
415
  </tr>
416
416
  </table>
417
417
 
418
418
  | Corpus | Moyenne | Médiane | Min | Max | p95 | p99 |
419
419
  | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
420
- | **Généraliste** | 4,78 ms | 4,29 ms | 0,23 ms | 40,0 ms | 8,73 ms | 12,9 ms |
421
- | **Appartement · chauffage individuel (2025)** | 3,72 ms | 3,39 ms | 1,41 ms | 33,6 ms | 6,34 ms | 8,20 ms |
422
- | **Appartement · chauffage collectif (2025)** | 4,22 ms | 3,81 ms | 1,66 ms | 30,8 ms | 6,96 ms | 8,81 ms |
423
- | **Logement individuel (2025)** | 5,29 ms | 4,69 ms | 1,77 ms | 43,8 ms | 9,75 ms | 13,8 ms |
424
- | **Maison individuelle (2025)** | 6,53 ms | 5,76 ms | 1,90 ms | 55,5 ms | 11,9 ms | 17,5 ms |
425
- | **Immeuble · chauffage collectif** | 5,71 ms | 4,92 ms | 0,13 ms | 134,1 ms | 10,5 ms | 17,7 ms |
426
- | **Immeuble · chauffage individuel** | 7,32 ms | 6,25 ms | 0,12 ms | 97,9 ms | 14,8 ms | 23,2 ms |
427
- | **Immeuble · chauffage mixte** | 5,87 ms | 4,75 ms | 0,21 ms | 742,8 ms | 12,5 ms | 20,4 ms |
428
- | **Individuel généré depuis l'immeuble (2026)** | 6,34 ms | 5,40 ms | 1,62 ms | 55,7 ms | 12,2 ms | 20,3 ms |
420
+ | **Généraliste** | 4,56 ms | 4,11 ms | 0,22 ms | 28,4 ms | 8,39 ms | 11,5 ms |
421
+ | **Appartement · chauffage individuel (2025)** | 4,13 ms | 3,83 ms | 1,53 ms | 33,1 ms | 6,90 ms | 8,83 ms |
422
+ | **Appartement · chauffage collectif (2025)** | 4,69 ms | 4,36 ms | 1,65 ms | 38,2 ms | 7,69 ms | 10,3 ms |
423
+ | **Logement individuel (2025)** | 5,25 ms | 4,70 ms | 1,64 ms | 43,6 ms | 9,63 ms | 12,9 ms |
424
+ | **Maison individuelle (2025)** | 6,17 ms | 5,56 ms | 1,99 ms | 53,3 ms | 11,0 ms | 14,5 ms |
425
+ | **Immeuble · chauffage collectif** | 5,61 ms | 4,85 ms | 0,21 ms | 104,4 ms | 10,3 ms | 16,3 ms |
426
+ | **Immeuble · chauffage individuel** | 6,70 ms | 5,71 ms | 0,11 ms | 164,2 ms | 13,6 ms | 21,3 ms |
427
+ | **Immeuble · chauffage mixte** | 5,70 ms | 4,65 ms | 0,20 ms | 655,4 ms | 12,0 ms | 19,4 ms |
428
+ | **Individuel généré depuis l'immeuble (2026)** | 6,33 ms | 5,45 ms | 1,65 ms | 53,8 ms | 11,9 ms | 19,5 ms |
429
429
 
430
430
  <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
431
431
  dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas
package/engine.js CHANGED
@@ -33,8 +33,9 @@ import getFicheTechnique from './ficheTechnique.js';
33
33
  import { ProductionENR, ratioProrataPvLogement } from './16.2_production_enr.js';
34
34
  import DpeSanitizerService from './dpe-sanitizer.service.js';
35
35
  import { reconstituerRdimDpeGenereImmeuble } from './17.2_rdim_dpe_genere_immeuble.js';
36
+ import { reconstituerRdimEcsIndividuelleUnique } from './11_rdim_ecs_individuelle_unique.js';
36
37
 
37
- const LIB_VERSION = '1.8.58';
38
+ const LIB_VERSION = '1.8.59';
38
39
 
39
40
  const dpeSanitizerService = new DpeSanitizerService();
40
41
 
@@ -291,6 +292,12 @@ export function calcul_3cl(inputDpe, options) {
291
292
  const ilpa = logement.meteo.batiment_materiaux_anciens === 1 ? '1' : '0';
292
293
 
293
294
  const ecs = logement.installation_ecs_collection.installation_ecs || [];
295
+ /**
296
+ * Immeuble avec une installation ECS individuelle unique décrite pour un logement type
297
+ * (Sh_ecs × nombre_logement ≈ SH, sans rdim) : rdim = nombre_logement.
298
+ * @see https://github.com/Open3CL/engine/issues/288
299
+ */
300
+ reconstituerRdimEcsIndividuelleUnique(th, ecs, cg.surface_habitable_immeuble);
294
301
  const Nb_lgt = cg.nombre_appartement || 1;
295
302
 
296
303
  /**
package/engine.spec.js CHANGED
@@ -73,6 +73,9 @@ vi.mock('./ficheTechnique.js', () => ({ default: vi.fn() }));
73
73
  vi.mock('./17.2_rdim_dpe_genere_immeuble.js', () => ({
74
74
  reconstituerRdimDpeGenereImmeuble: vi.fn()
75
75
  }));
76
+ vi.mock('./11_rdim_ecs_individuelle_unique.js', () => ({
77
+ reconstituerRdimEcsIndividuelleUnique: vi.fn()
78
+ }));
76
79
 
77
80
  // Les instances Inertie / ProductionENR sont créées au chargement du module.
78
81
  // On expose des méthodes mockées récupérables dans les tests.
@@ -116,6 +119,8 @@ const calc_confort_ete = (await import('./2021_04_13_confort_ete.js')).default;
116
119
  const calc_qualite_isolation = (await import('./2021_04_13_qualite_isolation.js')).default;
117
120
  const getFicheTechnique = (await import('./ficheTechnique.js')).default;
118
121
  const { reconstituerRdimDpeGenereImmeuble } = await import('./17.2_rdim_dpe_genere_immeuble.js');
122
+ const { reconstituerRdimEcsIndividuelleUnique } =
123
+ await import('./11_rdim_ecs_individuelle_unique.js');
119
124
 
120
125
  /** Objet conso renvoyé par le mock de `calc_conso` (mêmes réf pour les 3 appels). */
121
126
  let consoResult;
@@ -1198,6 +1203,27 @@ describe('calcul_3cl - rdim reconstitué des DPE générés depuis un DPE immeub
1198
1203
  });
1199
1204
  });
1200
1205
 
1206
+ describe('calcul_3cl - rdim de l’installation ECS individuelle unique d’un immeuble (#288)', () => {
1207
+ test('reconstitution appelée avec le type de bâtiment, les installations ECS et SH, avant le calcul ECS', () => {
1208
+ const dpe = makeDpe();
1209
+ dpe.logement.caracteristique_generale.surface_habitable_immeuble = 640;
1210
+ // la reconstitution doit précéder le calcul de l'ECS (besoin / rdim)
1211
+ vi.mocked(reconstituerRdimEcsIndividuelleUnique).mockImplementationOnce(() => {
1212
+ expect(calc_ecs).not.toHaveBeenCalled();
1213
+ return false;
1214
+ });
1215
+
1216
+ calcul_3cl(dpe, { sanitize: false });
1217
+
1218
+ expect(reconstituerRdimEcsIndividuelleUnique).toHaveBeenCalledWith(
1219
+ 'maison',
1220
+ dpe.logement.installation_ecs_collection.installation_ecs,
1221
+ 640
1222
+ );
1223
+ expect(calc_ecs).toHaveBeenCalled();
1224
+ });
1225
+ });
1226
+
1201
1227
  describe('get_conso_coeff_1_7_2027', () => {
1202
1228
  test('projette la conso EP 2027 pour une maison', () => {
1203
1229
  vi.mocked(classe_bilan_dpe).mockReturnValue('C');
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open3cl/engine",
3
- "version": "1.8.58",
3
+ "version": "1.8.59",
4
4
  "description": "Open Source 3CL-DPE engine",
5
5
  "main": "index.js",
6
6
  "directories": {