@open3cl/engine 1.8.47 → 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) => {
@@ -354,14 +387,89 @@ export function updateGenerateurCombustion(dpe, de, type) {
   addInfosFromFichesTechniques(dpe, de, type);
 }
 
+/**
+ * Valeur de la sous-fiche « Présence d'une veilleuse » → 1 (oui), 0 (non) ou undefined (NC, autre).
+ * Valeurs observées : « oui », « non », « Non », « NC », « Générateur sans veilleuse ».
+ * @param valeur {string|number|undefined}
+ * @returns {1 | 0 | undefined}
+ */
+export function valeurVeilleuse(valeur) {
+  const v = (valeur ?? '').toString().trim().toLowerCase();
+  if (v.startsWith('oui')) return 1;
+  if (v.startsWith('non') || v.includes('sans veilleuse') || v.startsWith('absence')) return 0;
+  return undefined;
+}
+
+/**
+ * Présence d'une veilleuse sur un générateur à combustion, lue dans la sous-fiche technique
+ * « Présence d'une veilleuse » (catégorie 7 pour le chauffage, 8 pour l'ECS) du générateur.
+ *
+ * Le modèle ADEME n'a pas de donnée d'entrée « veilleuse » : la fiche technique est la seule trace
+ * de la saisie. Le moteur de référence (Tribu) prend cette information en entrée (`Is_veilleuse`,
+ * DPE.DataClasses/generateur.cs) et annule Pveil en son absence
+ * (DPE.Core/Calcul_generateur.cs, `Pveil1 = 0` si `Is_veilleuse != oui`).
+ *
+ * Une même fiche peut décrire plusieurs générateurs à la suite (ex. LICIEL : deux chaudières dans
+ * la même fiche de catégorie 7). getFicheTechnique() renverrait alors la veilleuse du premier
+ * générateur pour tous : la sous-fiche retenue est la première « veilleuse » qui suit la sous-fiche
+ * dont la valeur contient la description du générateur, avant le générateur suivant. En cas de
+ * réponses contradictoires (descriptions identiques) ou d'absence, la présence est non renseignée.
+ *
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4 / §14.1 (« Pveil : si veilleuse »)
+ *
+ * @param dpe {FullDpe}
+ * @param de {Donnee_entree}
+ * @param type {'ch' | 'ecs'}
+ * @returns {1 | 0 | undefined} 1 si veilleuse, 0 si pas de veilleuse, undefined si non renseigné
+ */
+export function presenceVeilleuse(dpe, de, type) {
+  const description = (de.description ?? '').toString().toLowerCase();
+  if (!description) return undefined;
+
+  const categorie = type === 'ecs' ? '8' : '7';
+  const liste = (x) => (x === undefined || x === null ? [] : Array.isArray(x) ? x : [x]);
+  const valeurs = new Set();
+
+  for (const fiche of liste(dpe.fiche_technique_collection?.fiche_technique)) {
+    if (fiche?.enum_categorie_fiche_technique_id !== categorie) continue;
+    const sousFiches = liste(fiche.sous_fiche_technique_collection?.sous_fiche_technique);
+    const valeurMinuscule = (i) => (sousFiches[i]?.valeur ?? '').toString().toLowerCase();
+
+    for (let i = 0; i < sousFiches.length; i++) {
+      if (!valeurMinuscule(i).includes(description)) continue;
+      for (let j = i + 1; j < sousFiches.length; j++) {
+        const libelle = (sousFiches[j]?.description ?? '').toString().toLowerCase();
+        // début du générateur suivant
+        if (
+          valeurMinuscule(j).includes(description) ||
+          /^type (de )?g[ée]n[ée]rateur/.test(libelle)
+        ) {
+          break;
+        }
+        if (libelle.includes('veilleuse')) {
+          valeurs.add(valeurVeilleuse(sousFiches[j].valeur));
+          break;
+        }
+      }
+    }
+  }
+
+  return valeurs.size === 1 ? [...valeurs][0] : undefined;
+}
+
 /**
  * Récupération d'informations complémentaires issues des fiches techniques pour les générateurs
  *
  * @param dpe {FullDpe}
  * @param de {Donnee_entree}
- * @param type {'ch'|'ecs'}
+ * @param type {'ch' | 'ecs'}
  */
 function addInfosFromFichesTechniques(dpe, de, type) {
+  const veilleuse = presenceVeilleuse(dpe, de, type);
+  if (veilleuse !== undefined) {
+    de.presence_veilleuse = veilleuse;
+  }
+
   // 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(

package/13.2_generateur_combustion.spec.js

@@ -64,9 +64,12 @@ const {
   tv_generateur_combustion,
   findGenerateurChMixteJumeau,
   updateGenerateurCombustion,
+  presenceVeilleuse,
+  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');
@@ -125,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 };
@@ -805,6 +824,20 @@ describe('tv_generateur_combustion - génération mixte avec plusieurs générat
   });
 });
 
+/**
+ * Construit un DPE avec des fiches techniques (catégorie, liste [description, valeur]).
+ */
+const dpeFiches = (...fiches) => ({
+  fiche_technique_collection: {
+    fiche_technique: fiches.map(([categorie, sousFiches]) => ({
+      enum_categorie_fiche_technique_id: categorie,
+      sous_fiche_technique_collection: {
+        sous_fiche_technique: sousFiches.map(([description, valeur]) => ({ description, valeur }))
+      }
+    }))
+  }
+});
+
 /**
  * 13.2 - Orchestration des substitutions de générateurs et enrichissement fiches techniques.
  * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
@@ -887,6 +920,28 @@ describe('updateGenerateurCombustion - orchestration des substitutions', () => {
     updateGenerateurCombustion({}, deInconnu, 'ch');
     expect(deInconnu.ventilateurCombustion).toBeUndefined();
   });
+
+  test('présence de veilleuse lue dans la fiche technique : presence_veilleuse renseigné', () => {
+    getFicheTechnique.mockReturnValue(null);
+    const dpe = dpeFiches([
+      '8',
+      [
+        ['Type générateur', 'Chauffe-eau gaz'],
+        ["Présence d'une veilleuse", 'oui']
+      ]
+    ]);
+    const de = { description: 'Chauffe-eau gaz' };
+    updateGenerateurCombustion(dpe, de, 'ecs');
+    expect(de.presence_veilleuse).toBe(1);
+    expect(de.presenceVentilateur).toBeUndefined();
+  });
+
+  test('fiche veilleuse absente : presence_veilleuse non renseigné', () => {
+    getFicheTechnique.mockReturnValue(null);
+    const de = { description: 'gen' };
+    updateGenerateurCombustion({}, de, 'ch');
+    expect(de).not.toHaveProperty('presence_veilleuse');
+  });
 });
 
 /**
@@ -937,6 +992,126 @@ describe('tv_generateur_combustion - coefficients (E, F) selon le ventilateur de
   });
 });
 
+/**
+ * Issue #39 : présence d'une veilleuse lue dans la sous-fiche technique du générateur.
+ * Tribu : entrée `Is_veilleuse` (DPE.DataClasses/generateur.cs), Pveil1 = 0 si absente
+ * (DPE.Core/Calcul_generateur.cs).
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4 / §14.1
+ */
+describe('presenceVeilleuse - fiche technique « Présence d’une veilleuse »', () => {
+  const ficheGen = (desc, veilleuse) => [
+    ['Type générateur', desc],
+    ["Année d'installation", '1995'],
+    ...(veilleuse === undefined ? [] : [['Présence d’une veilleuse', veilleuse]])
+  ];
+
+  test.each([
+    ['oui', 1],
+    [' Oui ', 1],
+    ['non', 0],
+    ['Non', 0],
+    ['Générateur sans veilleuse', 0],
+    ['Absence de veilleuse', 0],
+    ['NC', undefined],
+    ['', undefined],
+    [undefined, undefined]
+  ])('valeur « %s » -> %s', (valeur, attendu) => {
+    expect(valeurVeilleuse(valeur)).toBe(attendu);
+    const dpe = dpeFiches([
+      '7',
+      [
+        ['Type générateur', 'Chaudière'],
+        ['Présence d’une veilleuse', valeur]
+      ]
+    ]);
+    expect(presenceVeilleuse(dpe, { description: 'Chaudière' }, 'ch')).toBe(attendu);
+  });
+
+  test('catégorie 7 pour le chauffage, 8 pour l’ECS', () => {
+    const dpe = dpeFiches(
+      ['7', ficheGen('Chaudière gaz', 'oui')],
+      ['8', ficheGen('Chaudière gaz', 'non')]
+    );
+    expect(presenceVeilleuse(dpe, { description: 'Chaudière gaz' }, 'ch')).toBe(1);
+    expect(presenceVeilleuse(dpe, { description: 'Chaudière gaz' }, 'ecs')).toBe(0);
+  });
+
+  test('plusieurs générateurs dans la même fiche : veilleuse du générateur décrit', () => {
+    // cas réel 2551E0134306T (LICIEL) : condensation « non » puis standard « oui »
+    const dpe = dpeFiches([
+      '7',
+      [
+        ...ficheGen('Gaz Naturel - Chaudière gaz à condensation', 'non'),
+        ...ficheGen('Gaz Naturel - Chaudière gaz standard', 'oui')
+      ]
+    ]);
+    expect(
+      presenceVeilleuse(dpe, { description: 'Gaz Naturel - Chaudière gaz standard' }, 'ch')
+    ).toBe(1);
+    expect(
+      presenceVeilleuse(dpe, { description: 'Gaz Naturel - Chaudière gaz à condensation' }, 'ch')
+    ).toBe(0);
+  });
+
+  test('générateur sans ligne veilleuse : pas de reprise de celle du générateur suivant', () => {
+    const dpe = dpeFiches([
+      '7',
+      [...ficheGen('Poêle bûche'), ...ficheGen('Chaudière standard', 'oui')]
+    ]);
+    expect(presenceVeilleuse(dpe, { description: 'Poêle bûche' }, 'ch')).toBeUndefined();
+  });
+
+  test('même description répétée avec des réponses contradictoires : non renseigné', () => {
+    // cas réel 2567E1314804D : deux « Chaudière standard », l'une avec, l'autre sans veilleuse
+    const dpe = dpeFiches([
+      '7',
+      [...ficheGen('Chaudière standard', 'Oui'), ...ficheGen('Chaudière standard', 'Non')]
+    ]);
+    expect(presenceVeilleuse(dpe, { description: 'Chaudière standard' }, 'ch')).toBeUndefined();
+    const dpe2 = dpeFiches(
+      ['7', ficheGen('Chaudière standard', 'Oui')],
+      ['7', ficheGen('Chaudière standard', 'Oui')]
+    );
+    expect(presenceVeilleuse(dpe2, { description: 'Chaudière standard' }, 'ch')).toBe(1);
+  });
+
+  test('description absente, fiche absente ou générateur non décrit : non renseigné', () => {
+    const dpe = dpeFiches(['7', ficheGen('Chaudière', 'oui')], ['2', [['x', 'Chaudière']]]);
+    expect(presenceVeilleuse(dpe, {}, 'ch')).toBeUndefined();
+    expect(presenceVeilleuse({}, { description: 'Chaudière' }, 'ch')).toBeUndefined();
+    expect(presenceVeilleuse(dpe, { description: 'Poêle' }, 'ch')).toBeUndefined();
+    const fichesUniques = {
+      fiche_technique_collection: {
+        fiche_technique: {
+          enum_categorie_fiche_technique_id: '7',
+          sous_fiche_technique_collection: {
+            sous_fiche_technique: { description: 'Type', valeur: 'Chaudière' }
+          }
+        }
+      }
+    };
+    expect(presenceVeilleuse(fichesUniques, { description: 'Chaudière' }, 'ch')).toBeUndefined();
+    const sansSousFiche = {
+      fiche_technique_collection: {
+        fiche_technique: [null, { enum_categorie_fiche_technique_id: '7' }]
+      }
+    };
+    expect(presenceVeilleuse(sansSousFiche, { description: 'Chaudière' }, 'ch')).toBeUndefined();
+    const sousFichesVides = dpeFiches([
+      '7',
+      [
+        ['Type', 'Chaudière'],
+        [undefined, undefined],
+        [undefined, 'x']
+      ]
+    ]);
+    sousFichesVides.fiche_technique_collection.fiche_technique[0].sous_fiche_technique_collection.sous_fiche_technique.push(
+      null
+    );
+    expect(presenceVeilleuse(sousFichesVides, { description: 'Chaudière' }, 'ch')).toBeUndefined();
+  });
+});
+
 /**
  * Issue #124 : générateur collectif virtualisé, puissance saisie collective (Pn) ou individualisée
  * (Pe = a × Pn) selon les logiciels.
@@ -1272,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/13.2_generateur_combustion_ch.js

@@ -377,8 +377,14 @@ export function calc_generateur_combustion_ch(dpe, di, de, du) {
     }
   }
 
-  // La puissance de la veilleuse est à prendre en compte seulement si elle est présente dans l'installation
-  if (!di.pveilleuse) {
+  /**
+   * La puissance de la veilleuse n'est à prendre en compte que si une veilleuse est présente.
+   * Présence lue dans la fiche technique du générateur (de.presence_veilleuse, cf.
+   * presenceVeilleuse()) ; à défaut, déduite de la valeur intermédiaire pveilleuse du DPE.
+   * Tribu : DPE.Core/Calcul_generateur.cs, Pveil1 = 0 si Is_veilleuse != oui.
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4
+   */
+  if (de.presence_veilleuse === 0 || (de.presence_veilleuse !== 1 && !di.pveilleuse)) {
     di.pveil = 0;
   }
 

package/13.2_generateur_combustion_ch.spec.js

@@ -857,6 +857,56 @@ describe('calc_generateur_combustion_ch - rendement de génération', () => {
     expect(avecVeilleuse.rg).toBeLessThan((k * pmfou) / (pmcons + 0.15));
   });
 
+  /**
+   * Issue #39 : la présence de veilleuse lue dans la fiche technique (de.presence_veilleuse)
+   * prime sur la valeur intermédiaire pveilleuse du DPE. Sans fiche, comportement inchangé.
+   * Tribu : Pveil1 = 0 si Is_veilleuse != oui (DPE.Core/Calcul_generateur.cs).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4
+   */
+  describe('présence de veilleuse (issue #39)', () => {
+    const di = (extra) => ({
+      pn: 24000,
+      rpn: 0.87,
+      rpint: 0.84,
+      qp0: 0,
+      pveil: 150,
+      temp_fonc_30: 56,
+      temp_fonc_100: 70,
+      ...extra
+    });
+    const de = (extra) => ({
+      enum_type_generateur_ch_id: '86',
+      enum_type_energie_id: '2',
+      type_energie: 'gaz naturel',
+      presence_regulation_combustion: true,
+      description: 't',
+      ...extra
+    });
+
+    test('fiche « oui » sans pveilleuse exportée : Pveil de la table conservé', () => {
+      const d = di();
+      calc_generateur_combustion_ch({}, d, de({ presence_veilleuse: 1 }), { cdimref: 3 });
+      expect(d.pveil).toBe(150);
+    });
+
+    test('fiche « non » avec pveilleuse exportée : Pveil annulé', () => {
+      const d = di({ pveilleuse: 150 });
+      calc_generateur_combustion_ch({}, d, de({ presence_veilleuse: 0 }), { cdimref: 3 });
+      expect(d.pveil).toBe(0);
+    });
+
+    test('pas de fiche : Pveil conservé si pveilleuse exportée, annulé sinon', () => {
+      const avec = di({ pveilleuse: 150 });
+      calc_generateur_combustion_ch({}, avec, de(), { cdimref: 3 });
+      expect(avec.pveil).toBe(150);
+      const sans = di();
+      calc_generateur_combustion_ch({}, sans, de(), { cdimref: 3 });
+      expect(sans.pveil).toBe(0);
+      // la veilleuse dégrade le rendement
+      expect(avec.rg).toBeLessThan(sans.rg);
+    });
+  });
+
   test('les pertes à charge nulle QP0 réduisent le rendement de génération', () => {
     const di = () => ({
       pn: 23000,

package/14_generateur_ecs.js

@@ -391,8 +391,14 @@ export default function calc_gen_ecs(dpe, gen_ecs, ecs_di, ecs_de, GV, ca_id, zc
       }
     }
 
-    // La puissance de la veilleuse est à prendre en compte seulement si elle est présente dans l'installation
-    if (!di.pveilleuse) {
+    /**
+     * La puissance de la veilleuse n'est à prendre en compte que si une veilleuse est présente.
+     * Présence lue dans la fiche technique du générateur (de.presence_veilleuse, cf.
+     * presenceVeilleuse()) ; à défaut, déduite de la valeur intermédiaire pveilleuse du DPE.
+     * Tribu : DPE.Core/Calcul_generateur.cs, Pveil1 = 0 si Is_veilleuse != oui.
+     * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
+     */
+    if (de.presence_veilleuse === 0 || (de.presence_veilleuse !== 1 && !di.pveilleuse)) {
       di.pveil = 0;
     }
 

package/14_generateur_ecs.spec.js

@@ -548,6 +548,39 @@ describe('calc_gen_ecs - consommation par générateur', () => {
     expect(g.donnee_intermediaire.conso_ecs).toBeCloseTo(322.3456790123457, 9);
   });
 
+  /**
+   * Issue #39 : présence de veilleuse lue dans la fiche technique (de.presence_veilleuse).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
+   */
+  test.each([
+    [1, undefined, 0.02],
+    [0, 1, 0],
+    [undefined, 1, 0.02],
+    [undefined, undefined, 0]
+  ])(
+    'présence de veilleuse (fiche %s, pveilleuse %s) : pveil = %s',
+    (presenceVeilleuse, pveilleuse, attendu) => {
+      vi.mocked(tvColumnIDs).mockImplementation((table) =>
+        table === 'generateur_combustion' ? ['chaud'] : []
+      );
+      vi.mocked(tv_generateur_combustion).mockImplementation((dpe, di) => {
+        di.rpn = 0.9;
+        di.qp0 = 100;
+        di.pn = 20000;
+        di.pveil = 0.02;
+        di.pveilleuse = pveilleuse;
+      });
+      const g = gen({
+        type_energie: 'gaz',
+        enum_type_generateur_ecs_id: 'chaud',
+        enum_methode_saisie_carac_sys_id: '1',
+        presence_veilleuse: presenceVeilleuse
+      });
+      calc_gen_ecs({}, g, ecs_di, ecs_de, 0, '1', '1', 'maison');
+      expect(g.donnee_intermediaire.pveil).toBe(attendu);
+    }
+  );
+
   test('chaudière combustion avec stockage (Qgw > 0) : rendement génération + stockage', () => {
     vi.mocked(tvColumnIDs).mockImplementation((table) =>
       table === 'generateur_combustion' ? ['chaud'] : []

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,28 +370,28 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.46`** · 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>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>89 984</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>62 119</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>69,03 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>62 220</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>69,15 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
-| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,42 %** | `█████████░░░░░░░░░░░` |  4 642 / 9 999 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,56 %** | `███████████████████░` | 9 256 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,71 %** | `██████████████████░░` |  8 964 / 9 992 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,66 %** | `██████████████████░░` |  8 865 / 9 999 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,23 %** | `█████████████████░░░` |  8 421 / 9 998 |
-| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **71,70 %** | `██████████████░░░░░░` | 7 170 / 10 000 |
-| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **66,40 %** | `█████████████░░░░░░░` |  6 639 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **54,14 %** | `███████████░░░░░░░░░` |  5 412 / 9 997 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,45 %** | `█████████░░░░░░░░░░░` |  4 645 / 9 999 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,84 %** | `███████████████████░` | 9 284 / 10 000 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,93 %** | `██████████████████░░` |  8 986 / 9 992 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,83 %** | `██████████████████░░` |  8 882 / 9 999 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,51 %** | `█████████████████░░░` |  8 449 / 9 998 |
+| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **71,71 %** | `██████████████░░░░░░` | 7 171 / 10 000 |
+| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **66,41 %** | `█████████████░░░░░░░` |  6 640 / 9 999 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **54,15 %** | `███████████░░░░░░░░░` |  5 413 / 9 997 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,50 %** | `██████░░░░░░░░░░░░░░` | 2 750 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -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,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>
+<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>590,9 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **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 |
+| **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.47';
+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.47",
+  "version": "1.8.49",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {