@open3cl/engine 1.8.63 → 1.8.64

package/11_stockage_ecs_volume_chauffe.js

@@ -0,0 +1,31 @@
+/**
+ * Le stockage ECS d'un générateur est-il en volume chauffé ?
+ *
+ * Tribu porte l'information au niveau de l'installation (`installation_ECS.Is_volume_chauffee`,
+ * Calcul_batiment.cs l.375-377). Dans l'export ADEME, elle se lit, par ordre de priorité :
+ * 1. `position_volume_chauffe_stockage` du générateur, s'il est renseigné ;
+ * 2. `tv_rendement_distribution_ecs_id` de l'installation : 1 ou 2 (production en volume
+ *    habitable) → oui, 3 (production hors volume habitable) → non ;
+ * 3. `position_volume_chauffe` du générateur.
+ *
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1 et §11.3 (rendement de distribution)
+ * @param deGenerateur {object} donnee_entree du générateur ECS
+ * @param deInstallation {object} donnee_entree de l'installation ECS
+ * @returns {boolean}
+ */
+export function isStockageEcsVolumeChauffe(deGenerateur, deInstallation) {
+  const positionStockage = Number.parseInt(deGenerateur.position_volume_chauffe_stockage);
+  if (positionStockage === 0 || positionStockage === 1) {
+    return positionStockage === 1;
+  }
+
+  const rdId = Number.parseInt(deInstallation?.tv_rendement_distribution_ecs_id);
+  if (rdId === 1 || rdId === 2) {
+    return true;
+  }
+  if (rdId === 3) {
+    return false;
+  }
+
+  return Number.parseInt(deGenerateur.position_volume_chauffe) !== 0;
+}

package/11_stockage_ecs_volume_chauffe.spec.js

@@ -0,0 +1,35 @@
+import { describe, expect, test } from 'vitest';
+import { isStockageEcsVolumeChauffe } from './11_stockage_ecs_volume_chauffe.js';
+
+describe('isStockageEcsVolumeChauffe - stockage ECS en volume chauffé (#293)', () => {
+  /**
+   * Tribu : installation_ECS.Is_volume_chauffee (Calcul_batiment.cs l.375-377), lue dans l'export
+   * par position_volume_chauffe_stockage, puis tv_rendement_distribution_ecs_id, puis
+   * position_volume_chauffe.
+   */
+  test.each([
+    // [position stockage, rendement distribution, position générateur, attendu]
+    [1, '3', 0, true], // stockage renseigné prioritaire (oui)
+    [0, '1', 1, false], // stockage renseigné prioritaire (non)
+    ['1', undefined, 0, true], // valeur texte acceptée
+    [undefined, '1', 0, true], // production en volume habitable
+    [undefined, 2, 0, true], // production en volume habitable, pièces non contiguës
+    [undefined, '3', 1, false], // production hors volume habitable
+    [undefined, '4', 0, false], // ligne collective : repli sur la position du générateur
+    [undefined, undefined, 1, true], // repli : générateur en volume chauffé
+    [undefined, undefined, 0, false], // repli : générateur hors volume chauffé
+    [undefined, undefined, undefined, true], // aucune information : récupération conservée
+    [null, null, 0, false] // champs nuls traités comme absents
+  ])('stockage %s, rd %s, générateur %s => %s', (pvcs, rd, pvc, attendu) => {
+    expect(
+      isStockageEcsVolumeChauffe(
+        { position_volume_chauffe_stockage: pvcs, position_volume_chauffe: pvc },
+        { tv_rendement_distribution_ecs_id: rd }
+      )
+    ).toBe(attendu);
+  });
+
+  test('installation absente : repli sur la position du générateur', () => {
+    expect(isStockageEcsVolumeChauffe({ position_volume_chauffe: 0 }, undefined)).toBe(false);
+  });
+});

package/9_besoin_ch.js

@@ -9,6 +9,7 @@ import {
 import { calc_ai_j, calc_as_j } from './6.1_apport_gratuit.js';
 import { calc_sse_j } from './6.2_surface_sud_equivalente.js';
 import { bug_for_bug_compat, mois_liste } from './utils.js';
+import { isStockageEcsVolumeChauffe } from './11_stockage_ecs_volume_chauffe.js';
 
 export default function calc_besoin_ch(
   ilpa,
@@ -67,10 +68,7 @@ export default function calc_besoin_ch(
     } else {
       Qgw = gen_ecs.reduce((acc, gen_ecs) => {
         // Pas de récupération de stockage si le ballon est hors volume chauffé
-        if (
-          gen_ecs.donnee_entree.position_volume_chauffe_stockage === 0 ||
-          gen_ecs.donnee_entree.position_volume_chauffe === 0
-        ) {
+        if (!isStockageEcsVolumeChauffe(gen_ecs.donnee_entree, instal_ecs.donnee_entree)) {
           return acc;
         }
 

package/9_besoin_ch.spec.js

@@ -313,7 +313,7 @@ describe('calc_besoin_ch - branches complémentaires', () => {
               donnee_intermediaire: { Qgw: 100 }
             },
             {
-              // générateur hors volume chauffé => ignoré
+              // générateur hors volume chauffé mais stockage en volume chauffé => compté (#293)
               donnee_entree: { position_volume_chauffe_stockage: 1, position_volume_chauffe: 0 },
               donnee_intermediaire: { Qgw: 100 }
             },
@@ -660,3 +660,60 @@ describe('calc_besoin_ch - immeuble à installations ECS individuelles et collec
     expect(ret.pertes_distribution_ecs_recup).toBeCloseTo((0.48 * 100 * total) / 8760, 9);
   });
 });
+
+describe('calc_besoin_ch - stockage ECS en volume chauffé (#293)', () => {
+  /**
+   * Cas des exemples de l'issue (2301E2484046J, 2322E2765016S) : ballon électrique LICIEL
+   * exporté avec position_volume_chauffe = 0 mais production en volume habitable (rd 1).
+   */
+  test('ballon en volume habitable exporté avec position_volume_chauffe = 0 : pertes récupérées', () => {
+    utilState.bug = false;
+    vi.mocked(calc_ai_j).mockReset().mockReturnValue(5000);
+    vi.mocked(calc_as_j).mockReset().mockReturnValue(2000);
+    vi.mocked(calc_sse_j).mockReset().mockReturnValue(10);
+    vi.mocked(calc_besoin_ecs_j).mockReset().mockReturnValue(10);
+    vi.mocked(calc_Qrec_gen_j).mockReset().mockReturnValue(0);
+    const instal = (rd) => [
+      {
+        donnee_entree: { enum_type_installation_id: '1', tv_rendement_distribution_ecs_id: rd },
+        generateur_ecs_collection: {
+          generateur_ecs: [
+            { donnee_entree: { position_volume_chauffe: 0 }, donnee_intermediaire: { Qgw: 8760 } }
+          ]
+        }
+      }
+    ];
+    const enVolume = calc_besoin_ch(
+      0,
+      0,
+      0,
+      0,
+      100,
+      100,
+      3,
+      instal('1'),
+      [],
+      [],
+      null,
+      'maison',
+      1
+    );
+    const horsVolume = calc_besoin_ch(
+      0,
+      0,
+      0,
+      0,
+      100,
+      100,
+      3,
+      instal('3'),
+      [],
+      [],
+      null,
+      'maison',
+      1
+    );
+    expect(enVolume.pertes_stockage_ecs_recup).toBeGreaterThan(0);
+    expect(horsVolume.pertes_stockage_ecs_recup).toBe(0);
+  });
+});

package/README.md

@@ -375,15 +375,15 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.62`** · branche `main` · généré le 2026-10-15
+> **Version `1.8.63`** · branche `main` · généré le 2026-10-15
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>89 418</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>71 082</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>79,49 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>71 098</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>79,51 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
@@ -392,11 +392,11 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 | 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **47,82 %** | `██████████░░░░░░░░░░` |  4 782 / 9 999 |
 | 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **93,94 %** | `███████████████████░` | 9 394 / 10 000 |
 | 🟢  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **93,64 %** | `███████████████████░` | 9 364 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **91,54 %** | `██████████████████░░` |  9 147 / 9 992 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **91,57 %** | `██████████████████░░` |  9 150 / 9 992 |
 | 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **89,44 %** | `██████████████████░░` |  8 943 / 9 999 |
 | 🟢  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **88,20 %** | `██████████████████░░` |  8 656 / 9 814 |
 | 🟢  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **85,14 %** | `█████████████████░░░` |  8 512 / 9 998 |
-| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **69,39 %** | `██████████████░░░░░░` |  6 673 / 9 616 |
+| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **69,53 %** | `██████████████░░░░░░` |  6 686 / 9 616 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **56,11 %** | `███████████░░░░░░░░░` | 5 611 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -408,24 +408,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>5,85 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>5,12 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,10 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>1,05 s</strong><br/><sub>max</sub></td>
+<td align="center"><strong>6,64 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>5,83 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>759,2 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 6,93 ms | 5,75 ms | 0,40 ms |  73,5 ms | 15,6 ms | 24,8 ms |
-| **Appartement · chauffage individuel (2025)**  | 5,03 ms | 4,64 ms | 1,66 ms |  38,8 ms | 8,73 ms | 12,6 ms |
-| **Appartement · chauffage collectif (2025)**   | 6,12 ms | 5,80 ms | 1,86 ms |  62,0 ms | 9,63 ms | 15,0 ms |
-| **Logement individuel (2025)**                 | 4,76 ms | 4,26 ms | 1,72 ms |  33,5 ms | 8,74 ms | 11,8 ms |
-| **Maison individuelle (2025)**                 | 5,58 ms | 5,02 ms | 1,86 ms |  47,1 ms | 9,86 ms | 13,1 ms |
-| **Immeuble · chauffage collectif**             | 5,90 ms | 5,14 ms | 0,17 ms | 139,6 ms | 11,0 ms | 17,6 ms |
-| **Immeuble · chauffage individuel**            | 6,51 ms | 5,59 ms | 0,10 ms |  88,8 ms | 13,0 ms | 20,7 ms |
-| **Immeuble · chauffage mixte**                 | 5,71 ms | 4,62 ms | 0,19 ms |   1,05 s | 11,9 ms | 18,8 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,12 ms | 5,29 ms | 1,69 ms |  64,4 ms | 11,4 ms | 18,8 ms |
+| **Généraliste**                                | 5,27 ms | 4,83 ms | 0,23 ms |  38,0 ms | 9,31 ms | 12,8 ms |
+| **Appartement · chauffage individuel (2025)**  | 5,05 ms | 4,61 ms | 1,84 ms |  39,8 ms | 8,69 ms | 11,1 ms |
+| **Appartement · chauffage collectif (2025)**   | 5,64 ms | 5,11 ms | 1,92 ms |  58,6 ms | 9,35 ms | 14,6 ms |
+| **Logement individuel (2025)**                 | 6,17 ms | 5,54 ms | 2,13 ms |  48,5 ms | 11,3 ms | 15,3 ms |
+| **Maison individuelle (2025)**                 | 7,18 ms | 6,49 ms | 2,29 ms |  52,4 ms | 12,7 ms | 16,4 ms |
+| **Immeuble · chauffage collectif**             | 7,20 ms | 6,19 ms | 0,24 ms | 140,8 ms | 13,4 ms | 22,0 ms |
+| **Immeuble · chauffage individuel**            | 8,44 ms | 7,21 ms | 0,13 ms | 115,0 ms | 17,0 ms | 27,1 ms |
+| **Immeuble · chauffage mixte**                 | 7,18 ms | 5,88 ms | 0,23 ms | 759,2 ms | 15,3 ms | 24,7 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 7,70 ms | 6,63 ms | 2,02 ms |  81,6 ms | 14,5 ms | 24,0 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

@@ -35,7 +35,7 @@ import DpeSanitizerService from './dpe-sanitizer.service.js';
 import { reconstituerRdimDpeGenereImmeuble } from './17.2_rdim_dpe_genere_immeuble.js';
 import { reconstituerRdimEcsIndividuelleUnique } from './11_rdim_ecs_individuelle_unique.js';
 
-const LIB_VERSION = '1.8.63';
+const LIB_VERSION = '1.8.64';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/features/engine/domain/ecs/installation-ecs.service.js

@@ -1,5 +1,6 @@
 import { GenerateurEcsService } from './generateur-ecs.service.js';
 import { inject } from 'dioma';
+import { isStockageEcsVolumeChauffe } from '../../../../11_stockage_ecs_volume_chauffe.js';
 
 /**
  * Calcul des besoins et pertes des installations ECS
@@ -142,11 +143,8 @@ export class InstallationEcsService {
     if (installationIndividuelle) {
       installationEcs.donnee_utilisateur.QgwRecuperable =
         installationEcs.generateur_ecs_collection?.generateur_ecs
-          .filter(
-            (generateurEcs) =>
-              parseInt(generateurEcs.donnee_entree.position_volume_chauffe_stockage) === 1 ||
-              (generateurEcs.donnee_entree.position_volume_chauffe_stockage === undefined &&
-                parseInt(generateurEcs.donnee_entree.position_volume_chauffe) === 1)
+          .filter((generateurEcs) =>
+            isStockageEcsVolumeChauffe(generateurEcs.donnee_entree, installationEcsDE)
           )
           .reduce((acc, generateurEcs) => {
             return acc + generateurEcs.donnee_utilisateur.Qgw;

package/package.json

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