@open3cl/engine 1.8.39 → 1.8.40

package/14_generateur_ecs.js

@@ -17,6 +17,20 @@ import { scopOrCop } from './12.4_pac.js';
 import getFicheTechnique from './ficheTechnique.js';
 import { getChaudiereFioulDefautId } from './13.2_generateur_combustion_chaudiere.js';
 
+/**
+ * Type de générateur utilisé pour lire la table des pertes de stockage.
+ * La chaudière électrique (118) est présente sur toutes les lignes de la table : le matcher
+ * renverrait la première (ballon horizontal). Comme les logiciels et le moteur de référence,
+ * on retient la ligne « ballon vertical autres ou inconnue » (69).
+ * Tribu : Calcul_installation_ECS.cs - calcul_Rs_elec (tab_Cr_ballon_elec, type de ballon inconnu)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - pertes de stockage des ballons électriques (tableau Cr)
+ * @param {string} typeGenerateurId enum_type_generateur_ecs_id
+ * @returns {string}
+ */
+export function typeGenerateurPertesStockage(typeGenerateurId) {
+  return typeGenerateurId === '118' ? '69' : typeGenerateurId;
+}
+
 function tv_pertes_stockage(di, de, VsCollectif) {
   let vb;
   const Vs = VsCollectif ? VsCollectif : de.volume_stockage;
@@ -26,7 +40,7 @@ function tv_pertes_stockage(di, de, VsCollectif) {
   else vb = '> 300';
 
   let matcher = {
-    enum_type_generateur_ecs_id: de.enum_type_generateur_ecs_id,
+    enum_type_generateur_ecs_id: typeGenerateurPertesStockage(de.enum_type_generateur_ecs_id),
     volume_ballon: vb
   };
 
@@ -166,6 +180,9 @@ function type_generateur_ecs(di, de, du, usage_generateur) {
   return type_generateur;
 }
 
+/** Rendement de génération d'une chaudière électrique (tv rendement_generation, id 30). */
+export const RG_CHAUDIERE_ELECTRIQUE = 0.97;
+
 export function rg_chauffe_eau_gaz(di, besoin_ecs) {
   return (
     1 /
@@ -303,6 +320,16 @@ export default function calc_gen_ecs(dpe, gen_ecs, ecs_di, ecs_de, GV, ca_id, zc
     }
     Iecs = 1 / di.rendement_stockage;
     Iecs_dep = 1 / di.rendement_stockage_depensier;
+    /**
+     * Chaudière électrique : rendement de génération forfaitaire Rg = 0,97 (comme en chauffage).
+     * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.2 (rendements de génération ECS)
+     */
+    if (type_generateur === 'chaudière électrique') {
+      di.rendement_generation = RG_CHAUDIERE_ELECTRIQUE;
+      di.rendement_generation_depensier = RG_CHAUDIERE_ELECTRIQUE;
+      Iecs /= RG_CHAUDIERE_ELECTRIQUE;
+      Iecs_dep /= RG_CHAUDIERE_ELECTRIQUE;
+    }
   } else if (isReseauChaleur) {
     if (bug_for_bug_compat) {
       if (di.rendement_generation_stockage === 0.9 && ecs_de.reseau_distribution_isole === 0) {

package/14_generateur_ecs.spec.js

@@ -16,6 +16,8 @@ vi.mock('./enums.js', () => ({
     type_generateur_ecs: {
       60: 'ballon électrique à accumulation vertical',
       61: 'ballon électrique à accumulation vertical catégorie c ou 3 étoiles',
+      117: 'chauffe-eau électrique instantané',
+      118: 'chaudière électrique',
       gaz: 'chauffe-eau gaz',
       chaud: 'chaudière gaz condensation',
       accu: 'accumulateur gaz',
@@ -70,7 +72,9 @@ const {
   rg_chauffe_eau_gaz,
   rgrs_chaudiere,
   rg_accumulateur_gaz,
-  rgrsReseauUrbain
+  rgrsReseauUrbain,
+  RG_CHAUDIERE_ELECTRIQUE,
+  typeGenerateurPertesStockage
 } = await import('./14_generateur_ecs.js');
 const { tvColumnIDs, requestInput, requestInputID, tv, getVolumeStockageFromDescription } =
   await import('./utils.js');
@@ -175,6 +179,26 @@ describe('calc_gen_ecs - consommation par générateur', () => {
     expect(g.donnee_intermediaire.conso_ecs_depensier).toBeCloseTo(166.66666666666666, 9);
   });
 
+  test('chaudière électrique : rendement de génération 0,97 (§11.2)', () => {
+    // @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.2 ; Tribu Calcul_generateur.cs (Rg_defaut = 0,97)
+    const g = gen({ type_energie: 'électricité', enum_type_generateur_ecs_id: '118' });
+    calc_gen_ecs({}, g, ecs_di, ecs_de, 0, '1', '1', 'maison');
+
+    expect(g.donnee_intermediaire.rendement_generation).toBe(RG_CHAUDIERE_ELECTRIQUE);
+    expect(g.donnee_intermediaire.rendement_generation_depensier).toBe(0.97);
+    // valeur de référence de régression : 100 / (0.97 * 0.9)
+    expect(g.donnee_intermediaire.conso_ecs).toBeCloseTo(114.5475372279496, 9);
+    expect(g.donnee_intermediaire.conso_ecs_depensier).toBeCloseTo(171.82130584192439, 9);
+  });
+
+  test('chauffe-eau électrique instantané : pas de rendement de génération (Rg = 1)', () => {
+    const g = gen({ type_energie: 'électricité', enum_type_generateur_ecs_id: '117' });
+    calc_gen_ecs({}, g, ecs_di, ecs_de, 0, '1', '1', 'maison');
+
+    expect(g.donnee_intermediaire.rendement_generation).toBeUndefined();
+    expect(g.donnee_intermediaire.conso_ecs).toBeCloseTo(111.11111111111111, 9);
+  });
+
   test('ballon électrique 3 étoiles : bonus de 8 % sur le rendement de stockage', () => {
     const g = gen({ type_energie: 'électricité', enum_type_generateur_ecs_id: '61' });
     calc_gen_ecs({}, g, ecs_di, ecs_de, 0, '1', '1', 'maison');
@@ -282,6 +306,43 @@ describe('calc_gen_ecs - consommation par générateur', () => {
     expect(g.donnee_intermediaire.conso_ecs_depensier).toBeCloseTo(1374.9166666666667, 9);
   });
 
+  test('chaudière électrique avec stockage : pertes lues sur la ligne ballon vertical autres ou inconnue (69)', () => {
+    // La chaudière électrique (118) figure sur toutes les lignes de pertes_stockage : sans
+    // redirection, le matcher tomberait sur la ligne « ballon horizontal » (cr 0,30 au lieu de 0,22).
+    vi.mocked(tvColumnIDs).mockImplementation((table) =>
+      table === 'pertes_stockage' ? ['118'] : []
+    );
+    vi.mocked(tv).mockReturnValue({ cr: '0.22', tv_pertes_stockage_id: '14' });
+    const g = gen({
+      type_energie: 'électricité',
+      enum_type_generateur_ecs_id: '118',
+      type_stockage_ecs: 'ballon vertical',
+      volume_stockage: 2000
+    });
+    calc_gen_ecs({}, g, ecs_di, ecs_de, 0, '1', '1', 'maison');
+
+    expect(tv).toHaveBeenCalledWith('pertes_stockage', {
+      enum_type_generateur_ecs_id: '69',
+      volume_ballon: '> 300'
+    });
+    expect(g.donnee_entree.tv_pertes_stockage_id).toBe(14);
+    // Qgw = (8592 * 45 / 24) * 2000 * 0.22 -- valeur de référence de régression
+    expect(g.donnee_intermediaire.Qgw).toBeCloseTo(7088400, 6);
+    expect(g.donnee_intermediaire.rendement_generation).toBe(RG_CHAUDIERE_ELECTRIQUE);
+  });
+
+  test.each([
+    ['118', '69'],
+    ['68', '68'],
+    ['69', '69'],
+    ['71', '71']
+  ])(
+    'typeGenerateurPertesStockage : %s -> %s (seule la chaudière électrique est redirigée)',
+    (id, attendu) => {
+      expect(typeGenerateurPertesStockage(id)).toBe(attendu);
+    }
+  );
+
   test.each([
     [50, '≤ 100'],
     [150, '100 <   ≤ 200'],

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.38`** · branche `main` · généré le 2026-10-10
+> **Version `1.8.39`** · branche `main` · généré le 2026-10-10
 > 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>4,77 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,18 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>4,88 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,26 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>803,0 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>537,6 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,10 ms | 3,68 ms | 0,22 ms |  30,3 ms | 7,50 ms | 10,6 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,65 ms | 3,31 ms | 1,44 ms |  25,0 ms | 6,29 ms | 8,11 ms |
-| **Logement individuel (2025)**                 | 4,48 ms | 3,99 ms | 1,56 ms |  42,6 ms | 8,07 ms | 11,5 ms |
-| **Maison individuelle (2025)**                 | 5,21 ms | 4,74 ms | 1,90 ms |  43,1 ms | 8,99 ms | 12,2 ms |
-| **Immeuble · chauffage individuel**            | 6,01 ms | 5,14 ms | 0,11 ms |  82,9 ms | 12,1 ms | 19,4 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,14 ms | 3,77 ms | 1,38 ms |  34,4 ms | 6,76 ms | 8,60 ms |
-| **Immeuble · chauffage collectif**             | 5,32 ms | 4,53 ms | 0,13 ms | 104,0 ms | 9,82 ms | 17,4 ms |
-| **Immeuble · chauffage mixte**                 | 4,73 ms | 3,88 ms | 0,19 ms | 803,0 ms | 9,38 ms | 15,8 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,31 ms | 4,59 ms | 1,72 ms |  40,3 ms | 9,84 ms | 15,7 ms |
+| **Généraliste**                                | 4,60 ms | 4,17 ms | 0,21 ms |  26,6 ms | 8,53 ms | 11,6 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,63 ms | 3,29 ms | 1,44 ms |  35,4 ms | 6,29 ms | 8,33 ms |
+| **Logement individuel (2025)**                 | 4,67 ms | 4,15 ms | 1,54 ms |  26,8 ms | 8,72 ms | 11,8 ms |
+| **Maison individuelle (2025)**                 | 5,51 ms | 4,95 ms | 1,80 ms |  43,2 ms | 10,0 ms | 13,0 ms |
+| **Immeuble · chauffage individuel**            | 5,99 ms | 5,11 ms | 0,11 ms |  79,0 ms | 11,9 ms | 19,5 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,09 ms | 3,69 ms | 1,45 ms |  35,2 ms | 6,70 ms | 8,49 ms |
+| **Immeuble · chauffage collectif**             | 5,22 ms | 4,42 ms | 0,11 ms | 112,3 ms | 9,63 ms | 17,2 ms |
+| **Immeuble · chauffage mixte**                 | 4,99 ms | 4,03 ms | 0,18 ms | 537,6 ms | 10,3 ms | 17,6 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,17 ms | 4,53 ms | 1,55 ms |  51,1 ms | 9,47 ms | 14,4 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, ratioProrataPvLogement } from './16.2_production_enr.js';
 import DpeSanitizerService from './dpe-sanitizer.service.js';
 
-const LIB_VERSION = '1.8.39';
+const LIB_VERSION = '1.8.40';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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