@open3cl/engine 1.8.36 → 1.8.38

package/README.md

@@ -370,7 +370,7 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.35`** · branche `main` · généré le 2026-10-09
+> **Version `1.8.36`** · branche `main` · généré le 2026-10-09
 > Seuil de tolérance **5%**
 
 <table>
@@ -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,06 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,41 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>5,13 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,48 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>768,9 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>468,0 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,20 ms | 3,76 ms | 0,22 ms |  34,2 ms | 7,69 ms | 10,6 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,75 ms | 3,39 ms | 1,47 ms |  29,4 ms | 6,55 ms | 8,36 ms |
-| **Logement individuel (2025)**                 | 4,83 ms | 4,30 ms | 1,55 ms |  29,3 ms | 9,03 ms | 12,1 ms |
-| **Maison individuelle (2025)**                 | 5,88 ms | 5,27 ms | 1,84 ms |  50,5 ms | 10,7 ms | 13,9 ms |
-| **Immeuble · chauffage individuel**            | 6,26 ms | 5,33 ms | 0,11 ms |  74,5 ms | 12,9 ms | 19,8 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,16 ms | 3,75 ms | 1,41 ms |  35,8 ms | 6,88 ms | 8,69 ms |
-| **Immeuble · chauffage collectif**             | 5,42 ms | 4,62 ms | 0,12 ms | 106,1 ms | 10,1 ms | 17,7 ms |
-| **Immeuble · chauffage mixte**                 | 5,23 ms | 4,26 ms | 0,17 ms | 768,9 ms | 10,7 ms | 17,1 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,81 ms | 5,00 ms | 1,65 ms |  42,2 ms | 11,0 ms | 16,4 ms |
+| **Généraliste**                                | 4,50 ms | 4,02 ms | 0,22 ms |  33,8 ms | 8,30 ms | 12,2 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,59 ms | 3,26 ms | 1,42 ms |  25,6 ms | 6,19 ms | 7,93 ms |
+| **Logement individuel (2025)**                 | 5,29 ms | 4,77 ms | 1,61 ms |  35,7 ms | 9,74 ms | 13,2 ms |
+| **Maison individuelle (2025)**                 | 6,09 ms | 5,50 ms | 1,84 ms |  37,9 ms | 10,9 ms | 14,2 ms |
+| **Immeuble · chauffage individuel**            | 6,28 ms | 5,40 ms | 0,12 ms |  85,1 ms | 12,7 ms | 19,8 ms |
+| **Appartement · chauffage collectif (2025)**   | 3,96 ms | 3,55 ms | 1,40 ms |  33,4 ms | 6,53 ms | 8,28 ms |
+| **Immeuble · chauffage collectif**             | 5,22 ms | 4,41 ms | 0,11 ms |  93,8 ms | 9,69 ms | 16,8 ms |
+| **Immeuble · chauffage mixte**                 | 5,18 ms | 4,23 ms | 0,22 ms | 468,0 ms | 10,7 ms | 17,7 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,07 ms | 5,20 ms | 1,63 ms |  47,3 ms | 11,7 ms | 18,6 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

@@ -212,16 +212,29 @@ export function masqueEnergie(groupe) {
  * postes au prorata de leur consommation.
  * Immeuble : consommation des usages individuels rapportée au logement (N × f(C / N)) ;
  * chauffage / ECS des installations collectives tarifés sur leur total (f(C)).
+ * Appartement desservi par une installation collective : la tranche est déterminée sur la
+ * consommation de l'immeuble extrapolée (C × SH_immeuble / SH_logement) et le coût ramené au
+ * logement : f(C × k) / k avec k = SH_immeuble / SH_logement (moteur de référence CSTB :
+ * DPE.Core Calcul_cout.cs l.133-136 et l.152-154, appelé avec SH_batiment / SH par
+ * Calcul_batiment.cs l.1318). Vérifié sur 927 / 1000 DPE ADEME appartement gaz collectif 2026.
  *
  * @param base {object} barème (prix unitaires et fonctions par tranches)
  * @param consoGroupe {function(masque): {total: number, collectif: number}} consommations EF
  * @param nbLogements {number} nombre de logements (1 hors immeuble)
  * @param genCollectifs {Set} générateurs de chauffage / ECS d'installations collectives
+ * @param ratioSurfaceCollectif {number} SH_immeuble / SH_logement pour un appartement (1 sinon)
  * @returns {object}
  */
-export function coefCoutProrata(base, consoGroupe, nbLogements, genCollectifs) {
+export function coefCoutProrata(
+  base,
+  consoGroupe,
+  nbLogements,
+  genCollectifs,
+  ratioSurfaceCollectif = 1
+) {
   const coef = { ...base };
   const coefCollectif = { ...base };
+  const k = ratioSurfaceCollectif > 1 ? ratioSurfaceCollectif : 1;
   new Set(Object.values(ENERGIES_A_TRANCHES)).forEach((groupe) => {
     const { total, collectif } = consoGroupe(masqueEnergie(groupe));
     const individuel = total - collectif;
@@ -230,7 +243,7 @@ export function coefCoutProrata(base, consoGroupe, nbLogements, genCollectifs) {
       .forEach((cle) => {
         const f = base[cle];
         const prix = individuel > 0 ? (nbLogements * f(individuel / nbLogements)) / individuel : 0;
-        const prixCollectif = collectif > 0 ? f(collectif) / collectif : 0;
+        const prixCollectif = collectif > 0 ? f(collectif * k) / (collectif * k) : 0;
         coef[cle] = (c) => prix * c;
         coefCollectif[cle] = (c) => prixCollectif * c;
       });
@@ -321,7 +334,8 @@ export default function calc_conso(
   prorataChauffage,
   dateDpe,
   coeffEp,
-  nbLogements = 1
+  nbLogements = 1,
+  ratioSurfaceCollectif = 1
 ) {
   const gen_ch = ch.reduce((acc, ch) => {
     const generateur_chauffage = ch.generateur_chauffage_collection.generateur_chauffage;
@@ -369,7 +383,7 @@ export default function calc_conso(
     const base = getCoefCout(dateDpe);
     if (base === coef_cout) return coef_cout;
     const genCollectifs = new Set();
-    if (nbLogements > 1) {
+    if (nbLogements > 1 || ratioSurfaceCollectif > 1) {
       gen_ch
         .filter((g) => g.donnee_entree.enum_type_installation_id !== '1')
         .forEach((g) => genCollectifs.add(g));
@@ -408,7 +422,7 @@ export default function calc_conso(
       );
       return { total: tot.c_5_usages, collectif: coll.c_ch + coll.c_ecs };
     };
-    return coefCoutProrata(base, consoGroupe, nbLogements, genCollectifs);
+    return coefCoutProrata(base, consoGroupe, nbLogements, genCollectifs, ratioSurfaceCollectif);
   };
 
   const ret = {
@@ -612,6 +626,28 @@ function getEcsConso(gen_ecs, field, coef, prorataECS, prefix) {
   }, 0);
 }
 
+/**
+ * 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
+ * consommation ECS (cle_repartition_ecs × rdim), les auxiliaires de génération sont multipliés
+ * par le rdim de l'installation lorsque la conso est calculée à l'échelle du DPE (prorataECS = 1).
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.660 (Qcirc_ecs1 += Qcirc × Rdim)
+ * @param ecs {InstallationEcs[]}
+ * @param field {string} conso_auxiliaire_generation_ecs[_depensier]
+ * @param coef {object}
+ * @param prorataECS {number}
+ * @returns {number}
+ */
+export function getAuxGenerationEcs(ecs, field, coef, prorataECS) {
+  return ecs.reduce((acc, inst) => {
+    const rdim = prorataECS === 1 ? Number(inst.donnee_entree.rdim) || 1 : 1;
+    return inst.generateur_ecs_collection.generateur_ecs.reduce((acc2, gen) => {
+      const conso = (gen.donnee_intermediaire[field] || 0) * rdim;
+      return acc2 + getConso(coef, 'électricité auxiliaire', conso);
+    }, acc);
+  }, 0);
+}
+
 /**
  * Calcul de la consommation globale de chauffage
  * @param gen_ch {Generateur_chauffage_collection}
@@ -707,15 +743,19 @@ function calc_conso_pond(
     prefix
   );
 
-  ret.auxiliaire_generation_ecs = gen_ecs.reduce((acc, gen_ecs) => {
-    const conso = gen_ecs.donnee_intermediaire.conso_auxiliaire_generation_ecs || 0;
-    return acc + getConso(coef, 'électricité auxiliaire', conso);
-  }, 0);
+  ret.auxiliaire_generation_ecs = getAuxGenerationEcs(
+    ecs_installations,
+    'conso_auxiliaire_generation_ecs',
+    coef,
+    prorataECS
+  );
 
-  ret.auxiliaire_generation_ecs_depensier = gen_ecs.reduce((acc, gen_ecs) => {
-    const conso = gen_ecs.donnee_intermediaire.conso_auxiliaire_generation_ecs_depensier || 0;
-    return acc + getConso(coef, 'électricité auxiliaire', conso);
-  }, 0);
+  ret.auxiliaire_generation_ecs_depensier = getAuxGenerationEcs(
+    ecs_installations,
+    'conso_auxiliaire_generation_ecs_depensier',
+    coef,
+    prorataECS
+  );
 
   ret.auxiliaire_distribution_ecs = ecs_installations.reduce((acc, inst) => {
     const conso = inst.donnee_intermediaire.conso_auxiliaire_distribution_ecs || 0;

package/conso.spec.js

@@ -55,6 +55,7 @@ const {
   getCoefCout,
   coefCoutProrata,
   masqueEnergie,
+  getAuxGenerationEcs,
   DATE_BAREME_COUT_2024
 } = await import('./conso.js');
 
@@ -684,4 +685,115 @@ describe('calc_conso - coût avec le barème mis à jour (DPE 2026)', () => {
     // Élec totale 4100 kWh / 4 logements => 4 × (158 + 0,18954 × 1025)
     expect(res.cout.cout_5_usages).toBeCloseTo(4 * (158 + 0.18954 * 1025), 9);
   });
+
+  /**
+   * Appartement desservi par une installation collective : tranche déterminée sur la conso de
+   * l'immeuble extrapolée (C × k, k = SH_immeuble / SH_logement), coût ramené au logement (÷ k).
+   * @see Moteur_DPE.dll (CSTB) Calcul_cout.cs l.133-136 / l.152-154 ; autotests APP5-0-5x, APP3-0-2.
+   */
+  test('appartement, chauffage gaz collectif : tranche sur la conso extrapolée à l’immeuble', () => {
+    const ch = [
+      installCh({ enum_type_installation_id: '2' }, [
+        genCh('2', { conso_ch: 4000, conso_ch_depensier: 4000 })
+      ])
+    ];
+    const res = calc_conso(100, 1, 1, [], ch, [], [], 1, 1, DATE_DPE_2026, coef_ep, 1, 20);
+    // 4000 × 20 = 80000 kWh (> 50000) => (288 + 0,09274 × 80000) / 20 = 0,0965 €/kWh × 4000
+    expect(res.cout.cout_ch).toBeCloseTo((288 + 0.09274 * 80000) / 20, 9);
+    // Sans extrapolation, le logement serait tarifé en 1ʳᵉ tranche (0,1312 × 4000 = 524,8 €).
+    expect(res.cout.cout_ch).not.toBeCloseTo(0.1312 * 4000, 0);
+    // Éclairage (usage individuel) : tarifé sur la seule conso du logement (100 kWh).
+    expect(res.cout.cout_eclairage).toBeCloseTo(0.34721 * 100, 9);
+  });
+
+  test('appartement, ECS électrique collective : tranche élec sur la conso extrapolée', () => {
+    const ecs = [
+      installEcs({ enum_type_installation_id: '2' }, [
+        genEcs('1', { conso_ecs: 1400, conso_ecs_depensier: 1400 })
+      ])
+    ];
+    const res = calc_conso(100, 1, 1, [], [], ecs, [], 1, 1, DATE_DPE_2026, coef_ep, 1, 10);
+    // 1400 × 10 = 14000 kWh => (119 + 0,19726 × 14000) / 10
+    expect(res.cout.cout_ecs).toBeCloseTo((119 + 0.19726 * 14000) / 10, 9);
+  });
+
+  test('appartement, installations individuelles : ratio de surface sans effet', () => {
+    const ch = [installCh({}, [genCh('2', { conso_ch: 4000, conso_ch_depensier: 4000 })])];
+    const res = calc_conso(100, 1, 1, [], ch, [], [], 1, 1, DATE_DPE_2026, coef_ep, 1, 20);
+    expect(res.cout.cout_ch).toBeCloseTo(0.1312 * 4000, 9);
+  });
+});
+
+describe('coefCoutProrata - ratio de surface des installations collectives', () => {
+  test('ratio ≤ 1 : neutre (tarif sur la conso collective seule)', () => {
+    const base = getCoefCout('2026-01-15');
+    const consoGroupe = () => ({ total: 4000, collectif: 4000 });
+    [undefined, 1, 0.5].forEach((ratio) => {
+      const coef = coefCoutProrata(base, consoGroupe, 1, new Set(['g']), ratio);
+      const coll = Object.getOwnPropertySymbols(coef).map((s) => coef[s])[0].coef;
+      expect(coll['gaz naturel'](4000)).toBeCloseTo(0.1312 * 4000, 9);
+    });
+  });
+});
+
+/**
+ * Auxiliaires de génération ECS : multipliés par le rdim de l'installation (comme la conso ECS).
+ * @see Moteur_DPE.dll Calcul_batiment.cs l.660 (Qcirc_ecs1 += Qcirc × Rdim) ; autotests IC-echantillon-gaz.
+ */
+describe('getAuxGenerationEcs - auxiliaires de génération ECS et rdim', () => {
+  const coefUnitaire = { 'électricité auxiliaire': 1 };
+  const inst = (rdim, ...consos) =>
+    installEcs(
+      rdim === undefined ? {} : { rdim },
+      consos.map((c) =>
+        genEcs('1', {
+          conso_auxiliaire_generation_ecs: c,
+          conso_auxiliaire_generation_ecs_depensier: 2 * c
+        })
+      )
+    );
+
+  test('installation dimensionnée (rdim 3,25) : auxiliaires × rdim à l’échelle du DPE', () => {
+    const ecs = [inst(3.25, 2.74, 2.97), inst(undefined, 10)];
+    // (2,74 + 2,97) × 3,25 + 10 × 1
+    expect(
+      getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs', coefUnitaire, 1)
+    ).toBeCloseTo((2.74 + 2.97) * 3.25 + 10, 9);
+    expect(
+      getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs_depensier', coefUnitaire, 1)
+    ).toBeCloseTo(2 * ((2.74 + 2.97) * 3.25 + 10), 9);
+  });
+
+  test('appartement proratisé (prorataECS ≠ 1) : rdim non appliqué', () => {
+    const ecs = [inst(3.25, 4)];
+    expect(getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs', coefUnitaire, 0.4)).toBe(4);
+  });
+
+  test('rdim non numérique ou générateur sans conso : neutre', () => {
+    const ecs = [inst('abc', 4), installEcs({ rdim: 2 }, [genEcs('1', {})])];
+    expect(getAuxGenerationEcs(ecs, 'conso_auxiliaire_generation_ecs', coefUnitaire, 1)).toBe(4);
+  });
+
+  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);
+    const sansRdim = calc_conso(
+      100,
+      1,
+      1,
+      [],
+      [],
+      [inst(undefined, 5)],
+      [],
+      1,
+      1,
+      DATE_DPE,
+      coef_ep
+    );
+    expect(res.ef_conso.conso_auxiliaire_generation_ecs).toBeCloseTo(
+      2 * sansRdim.ef_conso.conso_auxiliaire_generation_ecs,
+      9
+    );
+    expect(res.ef_conso.conso_auxiliaire_generation_ecs).toBeGreaterThan(0);
+  });
 });

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.36';
+const LIB_VERSION = '1.8.38';
 
 const dpeSanitizerService = new DpeSanitizerService();
 
@@ -583,6 +583,15 @@ export function calcul_3cl(inputDpe, options) {
     prorataChauffage = Sh / ShChauffageAndEcs;
   }
 
+  /**
+   * Appartement : rapport SH_immeuble / SH_logement utilisé pour déterminer la tranche du barème
+   * des installations collectives sur la consommation de l'immeuble (voir coefCoutProrata).
+   */
+  const ratioSurfaceCoutCollectif =
+    th === 'appartement' && Number(cg.surface_habitable_immeuble) > Number(Sh) && Number(Sh) > 0
+      ? Number(cg.surface_habitable_immeuble) / Number(Sh)
+      : 1;
+
   const conso = calc_conso(
     Sh,
     zc_id,
@@ -595,7 +604,8 @@ export function calcul_3cl(inputDpe, options) {
     prorataChauffage,
     dateDpe,
     coef_ep,
-    th === 'immeuble' ? Nb_lgt : 1
+    th === 'immeuble' ? Nb_lgt : 1,
+    ratioSurfaceCoutCollectif
   );
 
   // Proratisation au logement d'une installation PV d'immeuble (appartement)
@@ -628,7 +638,8 @@ export function calcul_3cl(inputDpe, options) {
     prorataChauffage,
     dateDpe,
     coef_ep_1_7,
-    th === 'immeuble' ? Nb_lgt : 1
+    th === 'immeuble' ? Nb_lgt : 1,
+    ratioSurfaceCoutCollectif
   );
 
   productionENR.calculateEnr(
@@ -653,7 +664,8 @@ export function calcul_3cl(inputDpe, options) {
     prorataChauffage,
     dateDpe,
     coef_ep_2_3,
-    th === 'immeuble' ? Nb_lgt : 1
+    th === 'immeuble' ? Nb_lgt : 1,
+    ratioSurfaceCoutCollectif
   );
 
   productionENR.calculateEnr(

package/engine.spec.js

@@ -710,6 +710,47 @@ describe('calcul_3cl - surfaces immeuble / appartement et prorata', () => {
     expect(conso_aux_distribution_ecs.mock.calls[0][3]).toBe(80);
     expect(conso_aux_distribution_ecs.mock.calls[0][4]).toBe(200);
   });
+
+  test('appartement : rapport SH immeuble / SH logement transmis au calcul du coût', () => {
+    enums.methode_application_dpe_log = { 2: 'dpe appartement individuel' };
+    const dpe = makeDpe();
+    dpe.logement.caracteristique_generale.enum_methode_application_dpe_log_id = '2';
+
+    calcul_3cl(dpe, { sanitize: false });
+
+    // 3 appels (coef_ep, 1,7, 2,3) : nbLogements = 1 (hors immeuble), ratio = 200 / 80 = 2,5.
+    expect(calc_conso).toHaveBeenCalledTimes(3);
+    calc_conso.mock.calls.forEach((call) => {
+      expect(call[11]).toBe(1);
+      expect(call[12]).toBeCloseTo(2.5, 9);
+    });
+  });
+
+  test('appartement sans surface immeuble exploitable : ratio neutre (1)', () => {
+    enums.methode_application_dpe_log = { 2: 'dpe appartement individuel' };
+    const dpe = makeDpe();
+    dpe.logement.caracteristique_generale.enum_methode_application_dpe_log_id = '2';
+    // Surface immeuble inférieure à celle du logement (saisie incohérente) => pas d'extrapolation.
+    dpe.logement.caracteristique_generale.surface_habitable_immeuble = 50;
+
+    calcul_3cl(dpe, { sanitize: false });
+
+    expect(calc_conso.mock.calls[0][12]).toBe(1);
+  });
+
+  test('maison et immeuble : ratio de surface du coût neutre (1)', () => {
+    const maison = makeDpe();
+    calcul_3cl(maison, { sanitize: false });
+    expect(calc_conso.mock.calls[0][12]).toBe(1);
+
+    vi.mocked(calc_conso).mockClear();
+    enums.methode_application_dpe_log = { 6: 'dpe immeuble collectif' };
+    const immeuble = makeDpe();
+    immeuble.logement.caracteristique_generale.enum_methode_application_dpe_log_id = '6';
+    calcul_3cl(immeuble, { sanitize: false });
+    expect(calc_conso.mock.calls[0][11]).toBe(4);
+    expect(calc_conso.mock.calls[0][12]).toBe(1);
+  });
 });
 
 describe("calcul_3cl - auxiliaires de distribution d'ECS", () => {

package/package.json

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