@open3cl/engine 1.8.51 → 1.8.53

package/11_ecs.js

@@ -179,6 +179,33 @@ export function ratio_besoin_ecs_individuel(dpe, de, surfaceImmeuble, nombreAppa
   return ratio < 1 ? ratio : 1 / nombreAppartements;
 }
 
+/**
+ * enum_type_installation_id des installations ECS collectives :
+ * 2 - installation collective ; 3 - installation collective multi-bâtiment (réseau de chaleur)
+ */
+const TYPES_INSTALLATION_ECS_COLLECTIVE = ['2', '3'];
+
+/**
+ * Rdim (nombre d'installations individuelles identiques) sans objet pour une installation ECS
+ * collective décrite dans un DPE immeuble : elle dessert tout l'immeuble, le besoin ECS n'est donc
+ * pas ramené à un logement type. Sinon, le besoin serait divisé par rdim alors que les pertes de
+ * stockage (Qgw) et à l'arrêt (qp0) du générateur collectif restent celles de l'immeuble,
+ * effondrant les rendements de génération et de stockage.
+ * @see Guide Tribu TE-211208 p. 24 (Rdim = nombre d'installations individuelles identiques)
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.583-592 (Becs / Rdim seulement pour une installation
+ * individuelle en immeuble ; Becs × Sh_ecs / SH sans Rdim pour une installation collective)
+ * @param th {string} type de bâtiment (maison, appartement, immeuble)
+ * @param de {Donnee_entree} donnée d'entrée de l'installation ECS
+ * @returns {boolean}
+ */
+export function isRdimEcsNeutralise(th, de) {
+  return (
+    th === 'immeuble' &&
+    TYPES_INSTALLATION_ECS_COLLECTIVE.includes(String(de.enum_type_installation_id)) &&
+    Number(de.rdim) > 1
+  );
+}
+
 export default function calc_ecs(
   dpe,
   ecs,
@@ -227,6 +254,12 @@ export default function calc_ecs(
         ((de.surface_habitable / (surfaceImmeuble || 1)) * (de.rdim || 1)) /
         (de.nombre_logement * nombreAppartements);
     }
+  } else if (isRdimEcsNeutralise(th, de)) {
+    /**
+     * Installation ECS collective d'un DPE immeuble : le besoin est celui de l'immeuble (pas de
+     * division par rdim), la consommation n'étant pas remultipliée par rdim (conso.js).
+     */
+    di.rdim_neutralise = true;
   } else if (de.rdim) {
     di.ratio_besoin_ecs = 1 / de.rdim || 1;
   }

package/11_ecs.spec.js

@@ -31,7 +31,7 @@ vi.mock('./14_generateur_ecs.js', () => ({
   default: vi.fn()
 }));
 
-const { default: calc_ecs } = await import('./11_ecs.js');
+const { default: calc_ecs, isRdimEcsNeutralise } = await import('./11_ecs.js');
 const { tv, requestInput } = await import('./utils.js');
 const { default: calc_gen_ecs } = await import('./14_generateur_ecs.js');
 
@@ -379,6 +379,91 @@ describe('calc_ecs - immeuble à plusieurs installations ECS (prorata des surfac
   });
 });
 
+/**
+ * Installation ECS collective unique d'un DPE immeuble : le rdim (nombre d'installations
+ * individuelles identiques) est sans objet, le besoin n'est pas divisé par rdim et la consommation
+ * n'est pas remultipliée par rdim à l'agrégation (conso.js getRdimEcs).
+ * @see Guide Tribu TE-211208 p. 24
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.583-592 (Becs / Rdim seulement en installation individuelle)
+ */
+describe('calc_ecs - installation ECS collective en immeuble : rdim neutralisé', () => {
+  test.each([
+    ['collective', '2'],
+    ['collective multi-bâtiment', '3']
+  ])('installation %s, rdim 22 : besoin de l’immeuble (ratio 1)', (_libelle, type) => {
+    const ecs = makeEcs({
+      tv_rendement_distribution_ecs_id: '5',
+      enum_type_installation_id: type,
+      rdim: 22
+    });
+    calc_ecs({}, ecs, 1000, 1500, 1, 'ca1', 'h1a', 'immeuble', false, 681, 22, false, {});
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(1);
+    expect(ecs.donnee_intermediaire.besoin_ecs).toBe(1000);
+    expect(ecs.donnee_intermediaire.besoin_ecs_depensier).toBe(1500);
+    expect(ecs.donnee_intermediaire.rdim_neutralise).toBe(true);
+    // le générateur reçoit le besoin de l'immeuble (cohérent avec ses pertes Qgw / qp0)
+    expect(vi.mocked(calc_gen_ecs).mock.calls[0][2].besoin_ecs).toBe(1000);
+  });
+
+  test.each([
+    ['installation individuelle en immeuble', '1', 'immeuble', 0.25],
+    ['installation hybride collective-individuelle', '4', 'immeuble', 0.25],
+    ['DPE appartement (installation collective)', '2', 'appartement', 0.25],
+    ['DPE maison', '2', 'maison', 0.25]
+  ])('%s : division par rdim conservée', (_libelle, type, th, ratio) => {
+    const ecs = makeEcs({
+      tv_rendement_distribution_ecs_id: '5',
+      enum_type_installation_id: type,
+      rdim: 4
+    });
+    calc_ecs({}, ecs, 1000, 1500, 1, 'ca1', 'h1a', th, false, 200, null, false, {});
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(ratio);
+    expect(ecs.donnee_intermediaire.rdim_neutralise).toBeUndefined();
+  });
+
+  test('installation collective en immeuble, rdim 1 : inchangé (ratio 1, pas d’indicateur)', () => {
+    const ecs = makeEcs({
+      tv_rendement_distribution_ecs_id: '5',
+      enum_type_installation_id: '2',
+      rdim: 1
+    });
+    calc_ecs({}, ecs, 1000, 1500, 1, 'ca1', 'h1a', 'immeuble', false, 200, null, false, {});
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(1);
+    expect(ecs.donnee_intermediaire.rdim_neutralise).toBeUndefined();
+  });
+
+  test('immeuble multi-installations : prorata Sh / SH / rdim conservé (branche prioritaire)', () => {
+    const ecs = makeEcs({
+      tv_rendement_distribution_ecs_id: '5',
+      enum_type_installation_id: '2',
+      surface_habitable: 100,
+      rdim: 4
+    });
+    calc_ecs({}, ecs, 1000, 1500, 1, 'ca1', 'h1a', 'immeuble', false, 200, null, false, {}, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBeCloseTo(100 / 200 / 4, 9);
+    expect(ecs.donnee_intermediaire.rdim_neutralise).toBeUndefined();
+  });
+});
+
+describe('isRdimEcsNeutralise', () => {
+  test.each([
+    ['immeuble', '2', 22, true],
+    ['immeuble', 3, '2', true],
+    ['immeuble', '2', 1, false],
+    ['immeuble', '2', undefined, false],
+    ['immeuble', '1', 22, false],
+    ['immeuble', '4', 22, false],
+    ['appartement', '2', 22, false],
+    ['maison', '2', 22, false]
+  ])('th %s, type %s, rdim %s → %s', (th, type, rdim, attendu) => {
+    expect(isRdimEcsNeutralise(th, { enum_type_installation_id: type, rdim })).toBe(attendu);
+  });
+});
+
 describe('calc_ecs - rendement de distribution', () => {
   test('la ligne forfaitaire alimente rendement_distribution et l’identifiant de table', () => {
     const de = { tv_rendement_distribution_ecs_id: '5' };

package/README.md

@@ -370,29 +370,29 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.50`** · branche `main` · généré le 2026-10-12
+> **Version `1.8.52`** · à publier · branche `main` · généré le 2026-10-12
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>89 984</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>62 220</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>69,15 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>65 424</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>72,71 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
-| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,45 %** | `█████████░░░░░░░░░░░` |  4 645 / 9 999 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,84 %** | `███████████████████░` | 9 284 / 10 000 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,65 %** | `█████████░░░░░░░░░░░` |  4 665 / 9 999 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,90 %** | `███████████████████░` | 9 290 / 10 000 |
+| 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **91,27 %** | `██████████████████░░` | 9 127 / 10 000 |
 | 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,93 %** | `██████████████████░░` |  8 986 / 9 992 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,83 %** | `██████████████████░░` |  8 882 / 9 999 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,51 %** | `█████████████████░░░` |  8 449 / 9 998 |
-| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **71,71 %** | `██████████████░░░░░░` | 7 171 / 10 000 |
-| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **66,41 %** | `█████████████░░░░░░░` |  6 640 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **54,15 %** | `███████████░░░░░░░░░` |  5 413 / 9 997 |
-| 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,50 %** | `██████░░░░░░░░░░░░░░` | 2 750 / 10 000 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,88 %** | `██████████████████░░` |  8 887 / 9 999 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,57 %** | `█████████████████░░░` |  8 455 / 9 998 |
+| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **74,67 %** | `███████████████░░░░░` |  7 466 / 9 999 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **56,65 %** | `███████████░░░░░░░░░` |  5 663 / 9 997 |
+| 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **28,85 %** | `██████░░░░░░░░░░░░░░` | 2 885 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
 
@@ -403,24 +403,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>5,86 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>5,18 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>549,4 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,66 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,98 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,13 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>869,7 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,94 ms | 4,45 ms | 0,23 ms |  35,1 ms | 9,08 ms | 13,0 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,79 ms | 4,42 ms | 1,59 ms |  39,2 ms | 8,31 ms | 11,2 ms |
-| **Logement individuel (2025)**                 | 5,40 ms | 4,84 ms | 1,68 ms |  42,3 ms | 10,0 ms | 13,4 ms |
-| **Maison individuelle (2025)**                 | 6,47 ms | 5,87 ms | 1,94 ms |  55,6 ms | 11,4 ms | 14,6 ms |
-| **Immeuble · chauffage individuel**            | 7,31 ms | 6,23 ms | 0,12 ms | 153,7 ms | 14,9 ms | 23,5 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,94 ms | 4,79 ms | 1,61 ms |  34,7 ms | 7,75 ms | 9,99 ms |
-| **Immeuble · chauffage collectif**             | 6,38 ms | 5,54 ms | 0,13 ms | 119,4 ms | 11,9 ms | 21,2 ms |
-| **Immeuble · chauffage mixte**                 | 5,90 ms | 4,82 ms | 0,22 ms | 549,4 ms | 12,7 ms | 20,4 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,63 ms | 5,69 ms | 1,75 ms |  67,7 ms | 12,3 ms | 20,8 ms |
+| **Généraliste**                                | 4,82 ms | 4,33 ms | 0,21 ms |  40,9 ms | 8,99 ms | 12,6 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,00 ms | 3,65 ms | 1,55 ms |  36,8 ms | 6,83 ms | 8,63 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,88 ms | 4,58 ms | 1,60 ms |  38,2 ms | 8,05 ms | 11,1 ms |
+| **Logement individuel (2025)**                 | 5,39 ms | 4,83 ms | 1,75 ms |  36,5 ms | 9,91 ms | 13,4 ms |
+| **Maison individuelle (2025)**                 | 6,37 ms | 5,75 ms | 1,94 ms |  46,1 ms | 11,4 ms | 15,0 ms |
+| **Immeuble · chauffage individuel**            | 7,22 ms | 6,19 ms | 0,13 ms | 127,3 ms | 14,6 ms | 22,8 ms |
+| **Immeuble · chauffage collectif**             | 6,13 ms | 5,37 ms | 0,21 ms | 135,7 ms | 11,2 ms | 20,3 ms |
+| **Immeuble · chauffage mixte**                 | 5,77 ms | 4,63 ms | 0,19 ms | 869,7 ms | 12,1 ms | 19,7 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,39 ms | 5,45 ms | 1,80 ms |  65,3 ms | 12,2 ms | 20,2 ms |
 
 <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
 dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas

package/conso.js

@@ -484,7 +484,7 @@ export default function calc_conso(
       // S'il existe une clé de repartition ECS, utilisation de celle-ci pour répartir la conso ECS collective à l'appartement
       generateur_ecs.forEach((value) => {
         value.donnee_entree.cle_repartition_ecs =
-          (ecs.donnee_entree.cle_repartition_ecs || 1) * (ecs.donnee_entree.rdim || 1);
+          (ecs.donnee_entree.cle_repartition_ecs || 1) * getRdimEcs(ecs);
         (value.donnee_utilisateur = value.donnee_utilisateur || {}).coeffEmissionGes =
           getGesCoeffForGenerateur(value, 'ecs', dateDpe, versionLogiciel);
       });
@@ -872,6 +872,19 @@ function getEcsConso(gen_ecs, field, coef, prorataECS, prefix, facteurAc = 1) {
   }, 0);
 }
 
+/**
+ * Rdim appliqué à la consommation d'une installation ECS lors de l'agrégation. Il vaut 1 lorsque le
+ * besoin n'a pas été divisé par rdim (installation ECS collective en immeuble, cf. 11_ecs.js
+ * isRdimEcsNeutralise), afin de rester cohérent avec le besoin calculé.
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.1067 (conso × Rdim, Rdim = 1 transmis en collectif)
+ * @param inst {InstallationEcs}
+ * @returns {number}
+ */
+export function getRdimEcs(inst) {
+  if (inst.donnee_intermediaire?.rdim_neutralise) return 1;
+  return Number(inst.donnee_entree.rdim) || 1;
+}
+
 /**
  * Consommation des auxiliaires de génération ECS (circulateurs des générateurs).
  * Le besoin d'une installation dimensionnée (rdim > 1) est exprimé par unité : comme la
@@ -887,7 +900,7 @@ function getEcsConso(gen_ecs, field, coef, prorataECS, prefix, facteurAc = 1) {
  */
 export function getAuxGenerationEcs(ecs, field, coef, prorataECS, facteurAc = 1) {
   return ecs.reduce((acc, inst) => {
-    const rdim = prorataECS === 1 ? Number(inst.donnee_entree.rdim) || 1 : 1;
+    const rdim = prorataECS === 1 ? getRdimEcs(inst) : 1;
     return inst.generateur_ecs_collection.generateur_ecs.reduce((acc2, gen) => {
       const conso = (gen.donnee_intermediaire[field] || 0) * rdim * facteurAc;
       return acc2 + getConso(coef, 'électricité auxiliaire', conso);

package/conso.spec.js

@@ -64,6 +64,7 @@ const {
   coefCoutProrata,
   masqueEnergie,
   getAuxGenerationEcs,
+  getRdimEcs,
   DATE_BAREME_COUT_2024,
   appointBijonction,
   coutBijonction,
@@ -551,6 +552,20 @@ describe('calc_conso - agrégation des consommations', () => {
     expect(res.ef_conso.conso_ecs).toBe(600);
   });
 
+  test('ECS collective en immeuble, rdim neutralisé (11_ecs.js) : conso non remultipliée par rdim', () => {
+    const inst = installEcs({ cle_repartition_ecs: 2, rdim: 22 }, [
+      genEcs('1', { conso_ecs: 100, conso_ecs_depensier: 120 })
+    ]);
+    inst.donnee_intermediaire.rdim_neutralise = true;
+
+    const res = calc_conso(100, 1, 1, [], [], [inst], [], 1, 1, DATE_DPE, coef_ep);
+    // clé = 2 × 1 (rdim neutralisé) => conso_ecs = 100 × 2
+    expect(inst.generateur_ecs_collection.generateur_ecs[0].donnee_entree.cle_repartition_ecs).toBe(
+      2
+    );
+    expect(res.ef_conso.conso_ecs).toBe(200);
+  });
+
   test('ECS avec prorataECS différent de 1 : clé issue du prorata', () => {
     // Quand prorataECS !== 1, la boucle ECS ne renseigne pas donnee_utilisateur :
     // on la fournit en amont (coefficient GES déjà connu) pour refléter les données réelles.
@@ -991,6 +1006,14 @@ describe('getAuxGenerationEcs - auxiliaires de génération ECS et rdim', () =>
     expect(getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs', coefUnitaire, 1)).toBe(4);
   });
 
+  test('installation ECS collective en immeuble (rdim neutralisé) : auxiliaires non multipliés', () => {
+    const collective = inst(22, 4);
+    collective.donnee_intermediaire.rdim_neutralise = true;
+    const ecs = [collective, inst(3, 1)];
+    // 4 × 1 (rdim neutralisé) + 1 × 3
+    expect(getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs', coefUnitaire, 1)).toBe(7);
+  });
+
   test('calc_conso : auxiliaire_generation_ecs intègre le rdim', () => {
     const ecs = [inst(2, 5)];
     const res = calc_conso(100, 1, 1, [], [], ecs, [], 1, 1, DATE_DPE, coef_ep);
@@ -1015,6 +1038,23 @@ describe('getAuxGenerationEcs - auxiliaires de génération ECS et rdim', () =>
   });
 });
 
+/**
+ * Rdim appliqué à la conso ECS lors de l'agrégation : 1 si le besoin n'a pas été divisé par rdim.
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.1067
+ */
+describe('getRdimEcs', () => {
+  test.each([
+    ['rdim renseigné', { rdim: 3 }, {}, 3],
+    ['rdim chaîne', { rdim: '2.5' }, {}, 2.5],
+    ['rdim absent', {}, {}, 1],
+    ['rdim non numérique', { rdim: 'abc' }, {}, 1],
+    ['rdim neutralisé', { rdim: 22 }, { rdim_neutralise: true }, 1],
+    ['sans donnée intermédiaire', { rdim: 4 }, undefined, 4]
+  ])('%s', (_libelle, de, di, attendu) => {
+    expect(getRdimEcs({ donnee_entree: de, donnee_intermediaire: di })).toBe(attendu);
+  });
+});
+
 /**
  * Convecteurs bi-jonction (§9.1.6) : base (60 %) facturée en électricité collective, appoint
  * individuel (40 %) en électricité individuelle.

package/engine.js

@@ -33,7 +33,7 @@ import getFicheTechnique from './ficheTechnique.js';
 import { ProductionENR, ratioProrataPvLogement } from './16.2_production_enr.js';
 import DpeSanitizerService from './dpe-sanitizer.service.js';
 
-const LIB_VERSION = '1.8.51';
+const LIB_VERSION = '1.8.53';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open3cl/engine",
-  "version": "1.8.51",
+  "version": "1.8.53",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {