@open3cl/engine 1.8.46 → 1.8.47

package/13.2_generateur_combustion.js

@@ -256,8 +256,18 @@ export function tv_generateur_combustion(dpe, di, de, type, GV, tbase, methodeSa
 
   de.tv_generateur_combustion_id = Number(row.tv_generateur_combustion_id);
 
-  const E = E_tab[de.presence_ventouse];
-  const F = F_tab[de.presence_ventouse];
+  /**
+   * Les coefficients (E, F) dépendent de la présence d'un ventilateur ou autre dispositif de
+   * circulation d'air dans le circuit de combustion, et non de la ventouse (qui n'intervient que
+   * dans Cper). Le XML ne transporte pas cette donnée : elle est lue dans la fiche technique du
+   * générateur. Sans fiche technique, la ventouse est conservée comme approximation (choix
+   * Open3CL, la méthode ne prévoyant pas de valeur par défaut).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+   * @see : Tribu Calcul_generateur.cs (ventilateur_combustion)
+   */
+  const indexEF = de.ventilateurCombustion ?? de.presence_ventouse;
+  const E = E_tab[indexEF];
+  const F = F_tab[indexEF];
 
   let ratioVirtualisation = de.ratio_virtualisation || 1;
 
@@ -341,7 +351,7 @@ export function updateGenerateurCombustion(dpe, de, type) {
   updateGenerateurBouilleurs(dpe, de, type);
   updateGenerateurChaudieres(dpe, de, type);
   updateGenerateurPacs(dpe, de, type);
-  addInfosFromFichesTechniques(dpe, de);
+  addInfosFromFichesTechniques(dpe, de, type);
 }
 
 /**
@@ -349,12 +359,14 @@ export function updateGenerateurCombustion(dpe, de, type) {
  *
  * @param dpe {FullDpe}
  * @param de {Donnee_entree}
+ * @param type {'ch'|'ecs'}
  */
-function addInfosFromFichesTechniques(dpe, de) {
+function addInfosFromFichesTechniques(dpe, de, type) {
   // Récupération de la présence ou non d'un système de ventilation
+  // Fiches techniques : catégorie 7 pour le chauffage, catégorie 8 pour l'ECS
   const ficheTechnique = getFicheTechnique(
     dpe,
-    '8',
+    type === 'ch' ? '7' : '8',
     'Présence ventilateur / dispositif circulation air dans circuit combustion',
     [de.description]
   )?.valeur;
@@ -362,6 +374,11 @@ function addInfosFromFichesTechniques(dpe, de) {
   if (ficheTechnique && ficheTechnique === 'oui') {
     de.presenceVentilateur = 1;
   }
+
+  // Présence d'un ventilateur dans le circuit de combustion (choix des coefficients E, F de qp0)
+  if (ficheTechnique === 'oui' || ficheTechnique === 'non') {
+    de.ventilateurCombustion = ficheTechnique === 'oui' ? 1 : 0;
+  }
 }
 
 /**

package/13.2_generateur_combustion.spec.js

@@ -833,6 +833,108 @@ describe('updateGenerateurCombustion - orchestration des substitutions', () => {
     updateGenerateurCombustion({}, de, 'ch');
     expect(de.presenceVentilateur).toBeUndefined();
   });
+
+  /**
+   * Issue #35 : la fiche technique d'un générateur de chauffage est en catégorie 7, celle d'un
+   * générateur ECS en catégorie 8.
+   */
+  test('générateur de chauffage : fiche technique recherchée en catégorie 7 (#35)', () => {
+    getFicheTechnique.mockReturnValue(undefined);
+    const dpe = {};
+    updateGenerateurCombustion(dpe, { description: 'chaudière' }, 'ch');
+    expect(getFicheTechnique).toHaveBeenCalledWith(
+      dpe,
+      '7',
+      'Présence ventilateur / dispositif circulation air dans circuit combustion',
+      ['chaudière']
+    );
+  });
+
+  test('générateur ECS : fiche technique recherchée en catégorie 8 (#35)', () => {
+    getFicheTechnique.mockReturnValue(undefined);
+    const dpe = {};
+    updateGenerateurCombustion(dpe, { description: 'chauffe-eau' }, 'ecs');
+    expect(getFicheTechnique).toHaveBeenCalledWith(
+      dpe,
+      '8',
+      'Présence ventilateur / dispositif circulation air dans circuit combustion',
+      ['chauffe-eau']
+    );
+  });
+
+  test('ventilateur de combustion renseigné à 1 si la fiche indique « oui » (#35)', () => {
+    getFicheTechnique.mockReturnValue({ valeur: 'oui' });
+    const de = { description: 'gen' };
+    updateGenerateurCombustion({}, de, 'ch');
+    expect(de.ventilateurCombustion).toBe(1);
+  });
+
+  test('ventilateur de combustion renseigné à 0 si la fiche indique « non » (#35)', () => {
+    getFicheTechnique.mockReturnValue({ valeur: 'non' });
+    const de = { description: 'gen' };
+    updateGenerateurCombustion({}, de, 'ch');
+    expect(de.ventilateurCombustion).toBe(0);
+  });
+
+  test('ventilateur de combustion non renseigné sans fiche ou valeur inconnue (#35)', () => {
+    getFicheTechnique.mockReturnValue(undefined);
+    const deSansFiche = { description: 'gen' };
+    updateGenerateurCombustion({}, deSansFiche, 'ch');
+    expect(deSansFiche.ventilateurCombustion).toBeUndefined();
+
+    getFicheTechnique.mockReturnValue({ valeur: 'inconnu' });
+    const deInconnu = { description: 'gen' };
+    updateGenerateurCombustion({}, deInconnu, 'ch');
+    expect(deInconnu.ventilateurCombustion).toBeUndefined();
+  });
+});
+
+/**
+ * Issue #35 : les coefficients (E, F) de la formule qp0 dépendent de la présence d'un ventilateur
+ * dans le circuit de combustion (fiche technique), la ventouse n'étant qu'un repli.
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ */
+describe('tv_generateur_combustion - coefficients (E, F) selon le ventilateur de combustion (#35)', () => {
+  const ROW_EF = { ...ROW_DEFAUT, rpn: 'E*40', qp0_perc: 'Pn*(E+F*log10(Pn))/100' };
+
+  test('ventouse mais pas de ventilateur : couple (E, F) sans ventilateur (2,5 ; -0,8)', () => {
+    tv.mockReturnValue({ ...ROW_EF });
+    const di = { pn: 24000 };
+    const de = {
+      enum_type_generateur_ch_id: '93',
+      ratio_virtualisation: 1,
+      presence_ventouse: 1,
+      ventilateurCombustion: 0
+    };
+    tv_generateur_combustion({}, di, de, 'ch', 200, -9, 1);
+    // E = 2.5 => rpn = 2.5*40/100 = 1
+    expect(di.rpn).toBeCloseTo(1, 9);
+    // qp0 = 24000 * (2.5 - 0.8 * log10(24)) / 100 -- valeur du DPE 2459E3195669T
+    expect(di.qp0).toBeCloseTo(334.99944159137164, 9);
+  });
+
+  test('ventilateur sans ventouse : couple (E, F) avec ventilateur (1,75 ; -0,55)', () => {
+    tv.mockReturnValue({ ...ROW_EF });
+    const di = { pn: 24000 };
+    const de = {
+      enum_type_generateur_ch_id: '93',
+      ratio_virtualisation: 1,
+      presence_ventouse: 0,
+      ventilateurCombustion: 1
+    };
+    tv_generateur_combustion({}, di, de, 'ch', 200, -9, 1);
+    expect(di.rpn).toBeCloseTo(0.7, 9);
+    // qp0 = 24000 * (1.75 - 0.55 * log10(24)) / 100 -- valeur de référence de régression
+    expect(di.qp0).toBeCloseTo(237.81211609406802, 9);
+  });
+
+  test('sans information de ventilateur : repli sur la présence de ventouse', () => {
+    tv.mockReturnValue({ ...ROW_EF });
+    const di = { pn: 24000 };
+    const de = { enum_type_generateur_ch_id: '93', ratio_virtualisation: 1, presence_ventouse: 1 };
+    tv_generateur_combustion({}, di, de, 'ch', 200, -9, 1);
+    expect(di.qp0).toBeCloseTo(237.81211609406802, 9);
+  });
 });
 
 /**

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.45`** · branche `main` · généré le 2026-10-10
+> **Version `1.8.46`** · branche `main` · généré le 2026-10-11
 > 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,18 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,51 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>468,0 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,63 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,14 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>601,2 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,87 ms | 4,40 ms | 0,22 ms |  50,4 ms | 8,77 ms | 12,5 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,08 ms | 3,72 ms | 1,48 ms |  33,5 ms | 7,05 ms | 9,43 ms |
-| **Logement individuel (2025)**                 | 4,71 ms | 4,20 ms | 1,54 ms |  35,6 ms | 8,74 ms | 11,8 ms |
-| **Maison individuelle (2025)**                 | 5,56 ms | 4,98 ms | 1,88 ms |  47,7 ms | 10,1 ms | 12,9 ms |
-| **Immeuble · chauffage individuel**            | 6,18 ms | 5,30 ms | 0,11 ms |  78,2 ms | 12,5 ms | 19,5 ms |
-| **Appartement · chauffage collectif (2025)**   | 5,27 ms | 4,59 ms | 1,62 ms |  45,8 ms | 11,3 ms | 18,1 ms |
-| **Immeuble · chauffage collectif**             | 5,45 ms | 4,63 ms | 0,12 ms |  98,6 ms | 10,0 ms | 18,0 ms |
-| **Immeuble · chauffage mixte**                 | 5,05 ms | 4,14 ms | 0,24 ms | 468,0 ms | 10,5 ms | 16,9 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,44 ms | 4,66 ms | 1,71 ms |  43,7 ms | 10,2 ms | 15,6 ms |
+| **Généraliste**                                | 5,37 ms | 4,86 ms | 0,26 ms |  97,3 ms | 9,51 ms | 14,0 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,70 ms | 4,36 ms | 1,56 ms |  36,9 ms | 7,96 ms | 11,1 ms |
+| **Logement individuel (2025)**                 | 4,99 ms | 4,45 ms | 1,68 ms |  43,5 ms | 9,03 ms | 12,5 ms |
+| **Maison individuelle (2025)**                 | 6,20 ms | 5,63 ms | 1,90 ms |  54,9 ms | 10,8 ms | 14,3 ms |
+| **Immeuble · chauffage individuel**            | 6,48 ms | 5,52 ms | 0,14 ms |  89,1 ms | 13,0 ms | 21,1 ms |
+| **Appartement · chauffage collectif (2025)**   | 5,12 ms | 4,90 ms | 1,79 ms |  42,1 ms | 8,10 ms | 12,6 ms |
+| **Immeuble · chauffage collectif**             | 6,73 ms | 5,99 ms | 0,20 ms | 171,0 ms | 12,4 ms | 21,7 ms |
+| **Immeuble · chauffage mixte**                 | 5,17 ms | 4,24 ms | 0,19 ms | 601,2 ms | 10,5 ms | 16,5 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,87 ms | 5,04 ms | 1,69 ms |  48,6 ms | 11,0 ms | 16,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/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.46';
+const LIB_VERSION = '1.8.47';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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