@open3cl/engine 1.8.33 → 1.8.34

package/11_ecs.js

@@ -136,6 +136,49 @@ function calc_auxiliaire_distribution_ecs_immeuble(de, surfaceImmeuble, becsParM
   return 0;
 }
 
+/** Écart relatif toléré entre la somme des surfaces ECS exportées et SH. */
+const TOLERANCE_SURFACE_ECS = 0.05;
+
+/**
+ * Ratio de besoin ECS d'une installation individuelle d'un immeuble (par unité dimensionnée).
+ *
+ * Tribu (Moteur_DPE.dll, Calcul_batiment.Calcul_Cecs) : Ratio = Sh_ecs × Rdim / SH puis
+ * Becs = Becs_immeuble × Ratio / Rdim, la consommation étant remultipliée par rdim à l'agrégation
+ * (conso.js, cle_repartition_ecs). Les logiciels n'exportent pas tous Sh_ecs de la même façon :
+ * - surface d'un logement (Σ Sh × rdim ≈ SH) → ratio = Sh / SH ;
+ * - surface totale desservie par l'installation (Σ Sh ≈ SH) → ratio = Sh / SH / rdim.
+ * La convention est détectée sur l'ensemble des installations ECS du DPE. Repli sur
+ * 1 / nombre d'appartements si la surface est absente, si aucune des deux sommes ne retrouve SH
+ * (à TOLERANCE_SURFACE_ECS près) ou si le ratio est ≥ 1.
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
+ */
+export function ratio_besoin_ecs_individuel(dpe, de, surfaceImmeuble, nombreAppartements) {
+  const sh = Number(de.surface_habitable);
+  const SH = Number(surfaceImmeuble);
+  if (!(sh > 0 && SH > 0)) return 1 / nombreAppartements;
+
+  const installations = dpe?.logement?.installation_ecs_collection?.installation_ecs || [
+    { donnee_entree: de }
+  ];
+  const des = installations.map((inst) => inst.donnee_entree);
+  const sommeSh = des.reduce((acc, d) => acc + (Number(d.surface_habitable) || 0), 0);
+  const sommeShRdim = des.reduce(
+    (acc, d) => acc + (Number(d.surface_habitable) || 0) * (Number(d.rdim) || 1),
+    0
+  );
+  const ecartParLogement = Math.abs(sommeShRdim - SH);
+  const ecartParInstallation = Math.abs(sommeSh - SH);
+  const surfaceParLogement = ecartParLogement < ecartParInstallation;
+
+  // Surfaces exportées incohérentes avec SH (installations partielles, surface moyenne…) : repli
+  if (Math.min(ecartParLogement, ecartParInstallation) > TOLERANCE_SURFACE_ECS * SH) {
+    return 1 / nombreAppartements;
+  }
+
+  const ratio = surfaceParLogement ? sh / SH : sh / SH / (Number(de.rdim) || 1);
+  return ratio < 1 ? ratio : 1 / nombreAppartements;
+}
+
 export default function calc_ecs(
   dpe,
   ecs,
@@ -173,7 +216,12 @@ export default function calc_ecs(
     di.ratio_besoin_ecs = de.cle_repartition_ecs || 1;
   } else if (isImmeubleSystemEcsIndividuels) {
     if (nombreAppartements) {
-      di.ratio_besoin_ecs = 1 / nombreAppartements;
+      di.ratio_besoin_ecs = ratio_besoin_ecs_individuel(
+        dpe,
+        de,
+        surfaceImmeuble,
+        nombreAppartements
+      );
     } else {
       di.ratio_besoin_ecs =
         ((de.surface_habitable / (surfaceImmeuble || 1)) * (de.rdim || 1)) /

package/11_ecs.spec.js

@@ -82,6 +82,139 @@ describe('calc_ecs - ratio de besoin ECS', () => {
     expect(ecs.donnee_intermediaire.besoin_ecs).toBeCloseTo(25, 9);
   });
 
+  /**
+   * Immeuble à ECS individuelles de surfaces différentes (cas CSTB IC1-0-3 / IC1-0-5 : 4
+   * appartements de 20, 30, 45 et 80 m² sur 175 m², rdim 1) : besoin au prorata de la surface
+   * desservie, comme Tribu (Becs appartement 1 = Becs immeuble × 20 / 175).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
+   */
+  test('immeuble à ECS individuelles : ratio = surface desservie / surface de l’immeuble', () => {
+    const des = [20, 30, 45, 80].map((surface) => ({
+      tv_rendement_distribution_ecs_id: '5',
+      surface_habitable: surface,
+      rdim: 1
+    }));
+    const dpe = {
+      logement: { installation_ecs_collection: { installation_ecs: des.map((de) => makeEcs(de)) } }
+    };
+    const ratios = dpe.logement.installation_ecs_collection.installation_ecs.map((ecs) => {
+      calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 175, 4, true);
+      return ecs.donnee_intermediaire;
+    });
+
+    expect(ratios[0].ratio_besoin_ecs).toBeCloseTo(20 / 175, 9);
+    expect(ratios[0].besoin_ecs).toBeCloseTo((100 * 20) / 175, 9);
+    expect(ratios[0].besoin_ecs_depensier).toBeCloseTo((200 * 20) / 175, 9);
+    expect(ratios[3].ratio_besoin_ecs).toBeCloseTo(80 / 175, 9);
+    expect(ratios.reduce((acc, di) => acc + di.ratio_besoin_ecs, 0)).toBeCloseTo(1, 9);
+  });
+
+  test('immeuble à ECS individuelles, surface d’un logement exportée (Σ Sh × rdim = SH) : ratio = Sh / SH', () => {
+    // 3 installations de 100 m² par logement, rdim 2, 2 et 1 → 500 m²
+    const dpe = {
+      logement: {
+        installation_ecs_collection: {
+          installation_ecs: [2, 2, 1].map((rdim) =>
+            makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 100, rdim })
+          )
+        }
+      }
+    };
+    const [ecs] = dpe.logement.installation_ecs_collection.installation_ecs;
+    calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 500, 5, true);
+
+    // besoin par logement ; la conso est remultipliée par rdim à l'agrégation
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBeCloseTo(100 / 500, 9);
+  });
+
+  test('immeuble à ECS individuelles, surface desservie totale exportée (Σ Sh = SH) : ratio = Sh / SH / rdim', () => {
+    // 2 installations desservant 300 m² (rdim 3) et 200 m² (rdim 2) → 500 m²
+    const dpe = {
+      logement: {
+        installation_ecs_collection: {
+          installation_ecs: [
+            makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 300, rdim: 3 }),
+            makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 200, rdim: 2 })
+          ]
+        }
+      }
+    };
+    const [ecs] = dpe.logement.installation_ecs_collection.installation_ecs;
+    calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 500, 5, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBeCloseTo(300 / 500 / 3, 9);
+  });
+
+  test('immeuble à ECS individuelles, rdim absent : rdim pris à 1', () => {
+    // 4 installations de 50 m² sans rdim : Σ Sh = 200 m² = SH
+    const dpe = {
+      logement: {
+        installation_ecs_collection: {
+          installation_ecs: [1, 2, 3, 4].map(() =>
+            makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 50 })
+          )
+        }
+      }
+    };
+    const [ecs] = dpe.logement.installation_ecs_collection.installation_ecs;
+    calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 200, 5, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBeCloseTo(50 / 200, 9);
+  });
+
+  test('immeuble à ECS individuelles, installation voisine sans surface ni rdim : ignorée dans la détection', () => {
+    const dpe = {
+      logement: {
+        installation_ecs_collection: {
+          installation_ecs: [
+            makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 100, rdim: 2 }),
+            makeEcs({ tv_rendement_distribution_ecs_id: '5' })
+          ]
+        }
+      }
+    };
+    const [ecs] = dpe.logement.installation_ecs_collection.installation_ecs;
+    calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 200, 2, true);
+
+    // Σ Sh × rdim = 200 = SH → surface par logement
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBeCloseTo(100 / 200, 9);
+  });
+
+  test('immeuble à ECS individuelles, surfaces exportées incohérentes avec SH → repli 1 / nombre d’appartements', () => {
+    // 2 installations de 88,67 m², rdim 1,33 (LICIEL) : Σ Sh = 177, Σ Sh × rdim = 236 ≠ 266 m²
+    const dpe = {
+      logement: {
+        installation_ecs_collection: {
+          installation_ecs: [1, 2].map(() =>
+            makeEcs({
+              tv_rendement_distribution_ecs_id: '5',
+              surface_habitable: 88.67,
+              rdim: 1.333
+            })
+          )
+        }
+      }
+    };
+    const [ecs] = dpe.logement.installation_ecs_collection.installation_ecs;
+    calc_ecs(dpe, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 266, 4, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(0.25);
+  });
+
+  test('immeuble à ECS individuelles, surface couvrant tout l’immeuble → repli 1 / nombre d’appartements', () => {
+    const ecs = makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 175 });
+    calc_ecs({}, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, 175, 4, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(0.25);
+  });
+
+  test('immeuble à ECS individuelles, surface de l’immeuble absente → repli 1 / nombre d’appartements', () => {
+    const ecs = makeEcs({ tv_rendement_distribution_ecs_id: '5', surface_habitable: 20 });
+    calc_ecs({}, ecs, 100, 200, 1, 'ca1', 'h1a', 'immeuble', false, null, 4, true);
+
+    expect(ecs.donnee_intermediaire.ratio_besoin_ecs).toBe(0.25);
+  });
+
   test('présence de rdim : ratio = 1 / rdim', () => {
     const de = { tv_rendement_distribution_ecs_id: '5', rdim: 2 };
     const ecs = makeEcs(de);

package/README.md

@@ -370,21 +370,21 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.32`** · branche `main` · généré le 2026-10-09
+> **Version `1.8.33`** · branche `main` · généré le 2026-10-09
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
-<td align="center"><strong>89 987</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>60 962</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>67,75 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>89 986</strong><br/><sub>DPE analysés</sub></td>
+<td align="center"><strong>60 961</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>67,74 %</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,14 %** | `█████████░░░░░░░░░░░` | 4 614 / 10 000 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,13 %** | `█████████░░░░░░░░░░░` |  4 613 / 9 999 |
 | 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,53 %** | `███████████████████░` | 9 253 / 10 000 |
 | 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,54 %** | `██████████████████░░` |  8 947 / 9 992 |
 | 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,60 %** | `██████████████████░░` |  8 859 / 9 999 |
@@ -398,29 +398,29 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 #### Temps d’exécution
 
-> Durée de l’appel à `calcul_3cl` par DPE, sur 89 953 calculs.
+> Durée de l’appel à `calcul_3cl` par DPE, sur 89 952 calculs.
 > La copie défensive de l’entrée et la lecture du fichier sont exclues de la mesure.
 
 <table>
 <tr>
-<td align="center"><strong>5,04 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,40 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>540,9 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,69 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>5,00 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,11 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>479,4 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,72 ms | 4,29 ms | 0,22 ms |  39,9 ms | 8,47 ms | 12,0 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,77 ms | 3,41 ms | 1,43 ms |  30,2 ms | 6,59 ms | 8,63 ms |
-| **Logement individuel (2025)**                 | 4,70 ms | 4,16 ms | 1,67 ms |  35,0 ms | 8,73 ms | 11,8 ms |
-| **Maison individuelle (2025)**                 | 5,69 ms | 5,09 ms | 1,67 ms |  53,0 ms | 10,4 ms | 13,8 ms |
-| **Immeuble · chauffage individuel**            | 6,13 ms | 5,22 ms | 0,12 ms |  77,1 ms | 12,3 ms | 19,5 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,20 ms | 3,77 ms | 1,44 ms |  24,5 ms | 6,96 ms | 9,09 ms |
-| **Immeuble · chauffage collectif**             | 5,33 ms | 4,49 ms | 0,12 ms |  99,2 ms | 9,91 ms | 18,2 ms |
-| **Immeuble · chauffage mixte**                 | 5,06 ms | 4,14 ms | 0,20 ms | 540,9 ms | 10,6 ms | 16,8 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,77 ms | 5,02 ms | 1,64 ms |  45,3 ms | 10,9 ms | 16,5 ms |
+| **Généraliste**                                | 5,39 ms | 4,95 ms | 0,25 ms |  38,8 ms | 9,87 ms | 13,9 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,01 ms | 3,64 ms | 1,41 ms |  28,6 ms | 6,92 ms | 9,06 ms |
+| **Logement individuel (2025)**                 | 5,43 ms | 4,82 ms | 1,69 ms |  37,7 ms | 10,1 ms | 14,1 ms |
+| **Maison individuelle (2025)**                 | 7,12 ms | 6,44 ms | 2,19 ms |  48,5 ms | 12,6 ms | 16,7 ms |
+| **Immeuble · chauffage individuel**            | 7,03 ms | 5,96 ms | 0,11 ms |  81,7 ms | 14,9 ms | 22,9 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,34 ms | 3,91 ms | 1,41 ms |  49,2 ms | 7,18 ms | 9,95 ms |
+| **Immeuble · chauffage collectif**             | 6,26 ms | 5,48 ms | 0,16 ms | 139,4 ms | 11,5 ms | 20,2 ms |
+| **Immeuble · chauffage mixte**                 | 5,33 ms | 4,36 ms | 0,18 ms | 479,4 ms | 11,0 ms | 17,8 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,30 ms | 5,41 ms | 1,57 ms |  43,6 ms | 12,2 ms | 18,1 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/engine.js

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

package/package.json

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