@open3cl/engine 1.8.48 → 1.8.49

package/13.2_generateur_combustion.js

@@ -122,6 +122,28 @@ export function caracteristiquesGenerateurCombustion(row, pn, ratio, E, F, type,
   return caracteristiques;
 }
 
+/**
+ * Estimation de la puissance nominale (W) d'un générateur à combustion dont la puissance n'est pas connue :
+ * Pch = Sh1 / Shtot × 1,2 × GV × (19 − Tbase) / 0,95³
+ *
+ * Si le générateur n'alimente qu'une partie du logement, la puissance est proratisée à la surface desservie.
+ * Le ratio est borné à ]0 ; 1] : une surface absente, nulle ou supérieure à Sh ne modifie pas Pch.
+ *
+ * Remarque : la méthode ne prévoit cette estimation que pour les générateurs individuels. Pour un générateur
+ * collectif sans pn, la même formule (GV du logement, convention pn = Pe) est une extrapolation.
+ *
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 Calcul des puissances nominales (p.90-91)
+ *
+ * @param GV {number} déperditions enveloppe + renouvellement d'air (W/K)
+ * @param tbase {number} température extérieure de base (°C)
+ * @param ratioSurface {number} Sh_installation / Sh
+ * @returns {number}
+ */
+export function pnEstimee(GV, tbase, ratioSurface = 1) {
+  const prorata = ratioSurface > 0 && ratioSurface < 1 ? ratioSurface : 1;
+  return (prorata * 1.2 * GV * (19 - tbase)) / 0.95 ** 3;
+}
+
 /**
  * Si la méthode de saisie n'est pas "Valeur forfaitaire" mais "caractéristiques saisies"
  * Documentation 3CL : "Pour les installations récentes ou recommandées, les caractéristiques réelles des chaudières présentées sur les bases
@@ -139,8 +161,19 @@ export function caracteristiquesGenerateurCombustion(row, pn, ratio, E, F, type,
  * @param GV {number} déperdition de l'enveloppe
  * @param tbase {number} température de fonctionnement du générateur
  * @param methodeSaisie {number} méthode de saisie des caractéristiques du générateur
+ * @param ratioSurface {number} part de la surface du logement desservie par le générateur
+ * (Sh_installation / Sh), utilisée pour proratiser la puissance nominale estimée (§13.2.2.4)
  */
-export function tv_generateur_combustion(dpe, di, de, type, GV, tbase, methodeSaisie) {
+export function tv_generateur_combustion(
+  dpe,
+  di,
+  de,
+  type,
+  GV,
+  tbase,
+  methodeSaisie,
+  ratioSurface = 1
+) {
   const typeGenerateurKey = `enum_type_generateur_${type}_id`;
   let enumTypeGenerateurId = de[typeGenerateurKey];
   let row;
@@ -207,7 +240,7 @@ export function tv_generateur_combustion(dpe, di, de, type, GV, tbase, methodeSa
   } else {
     // Calcul de la puissance nominale si non définie
     if (!di.pn) {
-      di.pn = (1.2 * GV * (19 - tbase)) / 0.95 ** 3;
+      di.pn = pnEstimee(GV, tbase, ratioSurface);
     }
 
     selectionLigne = (pn, ratio) => {

package/13.2_generateur_combustion.spec.js

@@ -68,7 +68,8 @@ const {
   valeurVeilleuse,
   caracteristiquesGenerateurCombustion,
   puissanceFormuleQp0,
-  PN_MAX_QP0_CHAUDIERE_GAZ
+  PN_MAX_QP0_CHAUDIERE_GAZ,
+  pnEstimee
 } = await import('./13.2_generateur_combustion.js');
 const { tv, tvColumnLines } = await import('./utils.js');
 const { conventionPuissanceNominale } = await import('./13.2_generateur_combustion_pn.js');
@@ -127,6 +128,22 @@ describe('tv_generateur_combustion - caractéristiques du générateur', () => {
     expect(di.pn).toBe(12345);
   });
 
+  test('puissance nominale absente, générateur desservant 40 % du logement : Pn proratisée (issue #264)', () => {
+    tv.mockReturnValue({ ...ROW_DEFAUT });
+    const di = {};
+    const de = { enum_type_generateur_ch_id: '89', ratio_virtualisation: 1, presence_ventouse: 0 };
+    tv_generateur_combustion({}, di, de, 'ch', 200, -9, 1, 0.4);
+    expect(di.pn).toBeCloseTo(0.4 * 7837.877241580406, 9);
+  });
+
+  test('puissance nominale renseignée : le prorata de surface ne s’applique pas', () => {
+    tv.mockReturnValue({ ...ROW_DEFAUT });
+    const di = { pn: 12345 };
+    const de = { enum_type_generateur_ch_id: '89', ratio_virtualisation: 1, presence_ventouse: 0 };
+    tv_generateur_combustion({}, di, de, 'ch', 200, -9, 1, 0.4);
+    expect(di.pn).toBe(12345);
+  });
+
   test('méthode forfaitaire (1) en chauffage : rpn, rpint, qp0 et pveil renseignés', () => {
     tv.mockReturnValue({ ...ROW_DEFAUT });
     const di = { pn: 20000 };
@@ -1430,3 +1447,35 @@ describe('puissanceFormuleQp0 - plafond de Pn à 400 kW pour les chaudières gaz
     expect(qp0).toBeCloseTo(127.5468019078, 6);
   });
 });
+
+/**
+ * Estimation de la puissance nominale d'un générateur à combustion (pn absente).
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ */
+describe('pnEstimee - puissance nominale estimée (issue #264)', () => {
+  // 1,2 × 200 × (19 − (−9)) / 0,95³ -- valeur de référence de régression
+  const PCH_LOGEMENT = 7837.877241580406;
+
+  test('générateur desservant tout le logement : Pch = 1,2 × GV × (19 − Tbase) / 0,95³', () => {
+    expect(pnEstimee(200, -9)).toBeCloseTo(PCH_LOGEMENT, 9);
+    expect(pnEstimee(200, -9, 1)).toBeCloseTo(PCH_LOGEMENT, 9);
+  });
+
+  test('générateur desservant une partie du logement : Pch1 = Sh1 / Shtot × Pch', () => {
+    expect(pnEstimee(200, -9, 0.25)).toBeCloseTo(0.25 * PCH_LOGEMENT, 9);
+  });
+
+  test('deux générateurs se partageant le logement : Pch1 + Pch2 = Pch', () => {
+    expect(pnEstimee(200, -9, 0.3) + pnEstimee(200, -9, 0.7)).toBeCloseTo(PCH_LOGEMENT, 9);
+  });
+
+  test.each([
+    ['nul', 0],
+    ['négatif', -0.5],
+    ['supérieur à 1', 1.4],
+    ['non numérique', NaN],
+    ['absent', undefined]
+  ])('ratio %s : pas de prorata (Pch du logement)', (_libelle, ratio) => {
+    expect(pnEstimee(200, -9, ratio)).toBeCloseTo(PCH_LOGEMENT, 9);
+  });
+});

package/9_chauffage.js

@@ -80,7 +80,11 @@ export default function calc_chauffage(
 
     if (genChDu.isCombustionGenerator) {
       const methodeSaisie = parseInt(genChDe.enum_methode_saisie_carac_sys_id);
-      tv_generateur_combustion(dpe, genChDi, genChDe, 'ch', GV, tbase, methodeSaisie);
+      // §13.2.2.4 : Pn estimée proratisée à la surface chauffée par l'installation (individuelle uniquement :
+      // un générateur collectif dessert tout le bâtiment, la surface chauffée du logement n'est pas la sienne)
+      const ratioSurface =
+        String(genChDe.enum_type_installation_id) === '1' ? genChDe.surface_chauffee / Sh : 1;
+      tv_generateur_combustion(dpe, genChDi, genChDe, 'ch', GV, tbase, methodeSaisie, ratioSurface);
 
       const type_gen_ch_list = tvColumnIDs('temp_fonc_30', 'type_generateur_ch');
       if (type_gen_ch_list.includes(genChDe.enum_type_generateur_ch_id)) {

package/9_chauffage.spec.js

@@ -336,6 +336,42 @@ describe('calc_chauffage - générateurs à combustion', () => {
     expect(tv_temp_fonc_30_100).toHaveBeenCalled();
   });
 
+  /**
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 (prorata de Pch à la surface desservie)
+   */
+  test('ratio surface chauffée de l’installation / Sh transmis pour la Pn estimée (issue #264)', () => {
+    const ch = installation(
+      [generateur({ enum_type_generateur_ch_id: '5', enum_methode_saisie_carac_sys_id: '1' })],
+      [emetteur('1')],
+      { surface_chauffee: 40, enum_type_installation_id: '1' }
+    );
+    appel(ch, { Sh: 100, GV: 150 });
+    const args = vi.mocked(tv_generateur_combustion).mock.calls[0];
+    expect(args[3]).toBe('ch');
+    expect(args[4]).toBe(150);
+    expect(args[7]).toBeCloseTo(0.4, 9);
+  });
+
+  test('surface chauffée absente : repli sur Sh, ratio de 1', () => {
+    const ch = installation(
+      [generateur({ enum_type_generateur_ch_id: '5', enum_methode_saisie_carac_sys_id: '1' })],
+      [emetteur('1')],
+      { surface_chauffee: undefined, enum_type_installation_id: '1' }
+    );
+    appel(ch, { Sh: 100 });
+    expect(vi.mocked(tv_generateur_combustion).mock.calls[0][7]).toBe(1);
+  });
+
+  test('installation collective : pas de prorata, le générateur dessert tout le bâtiment', () => {
+    const ch = installation(
+      [generateur({ enum_type_generateur_ch_id: '5', enum_methode_saisie_carac_sys_id: '1' })],
+      [emetteur('1')],
+      { surface_chauffee: 40, enum_type_installation_id: '2' }
+    );
+    appel(ch, { Sh: 100 });
+    expect(vi.mocked(tv_generateur_combustion).mock.calls[0][7]).toBe(1);
+  });
+
   test('méthode 5 avec températures déjà connues : pas de recalcul', () => {
     const ch = installation(
       [

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.47`** · branche `main` · généré le 2026-10-11
+> **Version `1.8.48`** · branche `main` · généré le 2026-10-12
 > 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,29 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,62 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>5,92 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>5,25 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>817,3 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>590,9 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 5,04 ms | 4,61 ms | 0,23 ms |  39,5 ms | 9,03 ms | 12,6 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,02 ms | 3,69 ms | 1,36 ms |  32,4 ms | 6,82 ms | 8,63 ms |
-| **Logement individuel (2025)**                 | 5,35 ms | 4,77 ms | 1,73 ms |  44,9 ms | 9,93 ms | 13,3 ms |
-| **Maison individuelle (2025)**                 | 5,82 ms | 5,20 ms | 1,91 ms |  74,9 ms | 10,4 ms | 13,9 ms |
-| **Immeuble · chauffage individuel**            | 6,33 ms | 5,37 ms | 0,11 ms | 115,2 ms | 12,8 ms | 20,1 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,28 ms | 3,80 ms | 1,50 ms |  38,6 ms | 7,24 ms | 9,61 ms |
-| **Immeuble · chauffage collectif**             | 5,52 ms | 4,68 ms | 0,13 ms | 106,4 ms | 10,2 ms | 17,1 ms |
-| **Immeuble · chauffage mixte**                 | 5,32 ms | 4,33 ms | 0,21 ms | 817,3 ms | 10,8 ms | 18,5 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,91 ms | 5,10 ms | 1,83 ms |  65,4 ms | 11,3 ms | 17,1 ms |
+| **Généraliste**                                | 4,99 ms | 4,39 ms | 0,21 ms |  95,5 ms | 9,05 ms | 14,6 ms |
+| **Appartement · chauffage individuel (2025)**  | 4,42 ms | 4,12 ms | 1,64 ms |  30,2 ms | 7,40 ms | 9,25 ms |
+| **Logement individuel (2025)**                 | 5,71 ms | 5,18 ms | 1,70 ms |  46,8 ms | 10,4 ms | 14,1 ms |
+| **Maison individuelle (2025)**                 | 6,69 ms | 6,10 ms | 1,94 ms |  58,0 ms | 11,7 ms | 15,7 ms |
+| **Immeuble · chauffage individuel**            | 7,25 ms | 6,20 ms | 0,11 ms | 141,9 ms | 14,6 ms | 23,6 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,82 ms | 4,57 ms | 1,68 ms |  37,0 ms | 7,67 ms | 9,89 ms |
+| **Immeuble · chauffage collectif**             | 6,49 ms | 5,77 ms | 0,15 ms | 116,1 ms | 11,7 ms | 20,1 ms |
+| **Immeuble · chauffage mixte**                 | 6,05 ms | 4,97 ms | 0,22 ms | 590,9 ms | 12,7 ms | 20,7 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,87 ms | 5,95 ms | 1,71 ms |  72,7 ms | 13,3 ms | 22,3 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.48';
+const LIB_VERSION = '1.8.49';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/features/engine/domain/ch/generateur-ch.service.js

@@ -73,7 +73,11 @@ export class GenerateurChService {
       if (generateurChauffage.donnee_utilisateur.combustion) {
         // Calcul de la puissance nominale si non définie
         if (!generateurChauffageDI.pn) {
-          generateurChauffage.donnee_intermediaire.pn = this.pn(ctx, logement);
+          generateurChauffage.donnee_intermediaire.pn = this.pn(
+            ctx,
+            logement,
+            installationChauffage
+          );
         }
 
         generateurChauffage.donnee_utilisateur.generateur = this.#chTvStore.getGenerateurCombustion(
@@ -201,11 +205,22 @@ export class GenerateurChService {
    *
    * @param ctx {Contexte}
    * @param logement {Logement}
+   * @param installationChauffage {InstallationChauffage}
    * @return {number}
    */
-  pn(ctx, logement) {
+  pn(ctx, logement, installationChauffage) {
     const Tbase = this.#tvStore.getTempBase(ctx.altitude.id, ctx.zoneClimatique.id);
-    return (1.2 * logement.sortie.deperdition.deperdition_enveloppe * (19 - Tbase)) / 0.95 ** 3;
+    // §13.2.2.4 : générateur individuel n'alimentant qu'une partie du logement => prorata Sh_installation / Sh.
+    // Un générateur collectif dessert tout le bâtiment : pas de prorata.
+    const installationDE = installationChauffage?.donnee_entree;
+    const ratio =
+      String(installationDE?.enum_type_installation_id) === '1'
+        ? installationDE.surface_chauffee / ctx.surfaceHabitable
+        : 1;
+    const prorata = ratio > 0 && ratio < 1 ? ratio : 1;
+    return (
+      (prorata * 1.2 * logement.sortie.deperdition.deperdition_enveloppe * (19 - Tbase)) / 0.95 ** 3
+    );
   }
 
   /**

package/features/engine/domain/ch/generateur-ch.service.spec.js

@@ -79,3 +79,52 @@ describe('Températures de fonctionnement des générateurs de chauffage', () =>
     );
   });
 });
+
+/**
+ * Puissance nominale estimée d'un générateur à combustion sans pn.
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ */
+describe('Puissance nominale estimée des générateurs de chauffage (issue #264)', () => {
+  /** @type {TvStore} */
+  let tvStore;
+  const ctx = { altitude: { id: 1 }, zoneClimatique: { id: 1 }, surfaceHabitable: 100 };
+  const logement = { sortie: { deperdition: { deperdition_enveloppe: 200 } } };
+  // 1,2 × 200 × (19 − (−9)) / 0,95³ -- valeur de référence de régression
+  const PCH_LOGEMENT = 7837.877241580406;
+
+  beforeEach(() => {
+    tvStore = new TvStore();
+    service = new GenerateurChService(new ChTvStore(), tvStore, new EmetteurChService());
+    vi.spyOn(tvStore, 'getTempBase').mockReturnValue(-9);
+  });
+
+  test('installation desservant tout le logement : Pch sans prorata', () => {
+    const installation = { donnee_entree: { surface_chauffee: 100, enum_type_installation_id: 1 } };
+    expect(service.pn(ctx, logement, installation)).toBeCloseTo(PCH_LOGEMENT, 9);
+    expect(tvStore.getTempBase).toHaveBeenCalledWith(1, 1);
+  });
+
+  test('installation desservant 40 % du logement : Pch proratisée à la surface chauffée', () => {
+    const installation = { donnee_entree: { surface_chauffee: 40, enum_type_installation_id: 1 } };
+    expect(service.pn(ctx, logement, installation)).toBeCloseTo(0.4 * PCH_LOGEMENT, 9);
+  });
+
+  test.each([
+    ['surface chauffée absente', { donnee_entree: { enum_type_installation_id: 1 } }],
+    [
+      'installation collective',
+      { donnee_entree: { surface_chauffee: 40, enum_type_installation_id: 2 } }
+    ],
+    ['installation absente', undefined],
+    [
+      'surface chauffée supérieure à Sh',
+      { donnee_entree: { surface_chauffee: 130, enum_type_installation_id: 1 } }
+    ],
+    [
+      'surface chauffée nulle',
+      { donnee_entree: { surface_chauffee: 0, enum_type_installation_id: 1 } }
+    ]
+  ])('%s : pas de prorata', (_libelle, installation) => {
+    expect(service.pn(ctx, logement, installation)).toBeCloseTo(PCH_LOGEMENT, 9);
+  });
+});

package/package.json

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