@open3cl/engine 1.11.2 → 1.11.4

package/10_besoin_fr.spec.js

@@ -38,7 +38,7 @@ const { calc_sse_j } = await import('./6.2_surface_sud_equivalente.js');
 
 /**
  * 10. Calcul des besoins de froid (Bfr)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
  */
 describe('calc_besoin_fr_j - besoin de froid journalier', () => {
   test('retourne 0 lorsque le nombre de jours de référence est nul', () => {

package/10_clim.js

@@ -5,7 +5,7 @@ function tv_seer(di, de, du, zc_id) {
     enum_zone_climatique_id: zc_id,
     enum_periode_installation_fr_id: requestInputID(de, du, 'periode_installation_fr')
   };
-  const row = tv('seer', matcher, de);
+  const row = tv('seer', matcher);
   if (row) {
     de.tv_seer_id = Number(row.tv_seer_id);
     di.eer = row.eer;

package/10_clim.spec.js

@@ -31,7 +31,7 @@ beforeEach(() => {
 
 /**
  * 10. Calcul de la consommation de climatisation (froid)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
  */
 describe('calc_clim - consommation de climatisation', () => {
   test('prorate le besoin de froid au ratio surface_clim / Sh', () => {
@@ -69,14 +69,10 @@ describe('calc_clim - consommation de climatisation', () => {
 
     calc_clim(c, 1000, 1500, '2', 100);
 
-    expect(tv).toHaveBeenCalledWith(
-      'seer',
-      {
-        enum_zone_climatique_id: '2',
-        enum_periode_installation_fr_id: '4'
-      },
-      c.donnee_entree
-    );
+    expect(tv).toHaveBeenCalledWith('seer', {
+      enum_zone_climatique_id: '2',
+      enum_periode_installation_fr_id: '4'
+    });
   });
 
   test.each([['6'], ['7'], ['8']])(

package/11_besoin_ecs.spec.js

@@ -23,7 +23,7 @@ const { default: calc_besoin_ecs, calc_besoin_ecs_j } = await import('./11_besoi
 
 /**
  * 11. Calcul du besoin d'eau chaude sanitaire (Becs)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11
  */
 describe('calc_besoin_ecs_j - besoin ECS journalier', () => {
   test('valeur de référence en mode conventionnel (56 L/j/personne)', () => {

package/11_ecs.js

@@ -1,3 +1,4 @@
+/** @import { InstallationEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import calc_gen_ecs from './14_generateur_ecs.js';
 import { tv, requestInput, mois_liste, Njj } from './utils.js';
@@ -196,7 +197,7 @@ const TYPES_INSTALLATION_ECS_COLLECTIVE = ['2', '3'];
  * @see Moteur_DPE.dll Calcul_batiment.cs l.583-592 (Becs / Rdim seulement pour une installation
  * individuelle en immeuble ; Becs × Sh_ecs / SH sans Rdim pour une installation collective)
  * @param th {string} type de bâtiment (maison, appartement, immeuble)
- * @param de {Donnee_entree} donnée d'entrée de l'installation ECS
+ * @param de {InstallationEcsDE} donnée d'entrée de l'installation ECS
  * @returns {boolean}
  */
 export function isRdimEcsNeutralise(th, de) {

package/11_ecs.spec.js

@@ -61,7 +61,7 @@ beforeEach(() => {
 
 /**
  * 11. Prise en compte de l'ECS (ratio de besoin + rendement de distribution)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11 / §17.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11 / §17.2.1
  */
 describe('calc_ecs - ratio de besoin ECS', () => {
   test('virtualisation : le ratio est la clé de répartition ECS', () => {
@@ -87,7 +87,7 @@ describe('calc_ecs - ratio de besoin ECS', () => {
    * Immeuble à ECS individuelles de surfaces différentes (cas CSTB IC1-0-3 / IC1-0-5 : 4
    * appartements de 20, 30, 45 et 80 m² sur 175 m², rdim 1) : besoin au prorata de la surface
    * desservie, comme Tribu (Becs appartement 1 = Becs immeuble × 20 / 175).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
    */
   test('immeuble à ECS individuelles : ratio = surface desservie / surface de l’immeuble', () => {
     const des = [20, 30, 45, 80].map((surface) => ({

package/11_nadeq.js

@@ -1,3 +1,4 @@
+/** @import { Logement } from './features/dpe/domain/models/dpe.model.js' */
 export class Nadeq {
   /**
    * Return nadeq for maison or individual logement

package/11_nadeq.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 
 describe('Nadeq unit tests', () => {
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 70
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 70
    */
   const nadeq = new Nadeq();
 

package/11_rdim_ecs_individuelle_unique.js

@@ -60,3 +60,81 @@ export function reconstituerRdimEcsIndividuelleUnique(th, instal_ecs, surfaceHab
   instal_ecs[0].donnee_entree.rdim_reconstitue = true;
   return true;
 }
+
+/**
+ * DPE immeuble avec plusieurs installations ECS individuelles, chacune décrite pour un logement type.
+ *
+ * Même convention d'export que l'installation unique (3.0.x, 2.0.x, 1.1.x) : pour chaque
+ * installation i, `surface_habitable` = Sh_i d'un logement type et `nombre_logement` = N_i, sans
+ * `rdim`, avec Σ Sh_i × N_i = SH. Tribu traite chaque installation indépendamment avec Rdim_i = N_i :
+ * Becs_i = Becs_immeuble × Sh_i × Rdim_i / SH / Rdim_i, puis Cecs = Σ Cecs_i × Rdim_i. L'export ADEME
+ * le confirme : besoin_ecs_i = Becs_immeuble × Sh_i / SH et conso_ecs = Σ conso_ecs_i × N_i.
+ *
+ * Sans rdim, Σ Sh_i ≠ SH : Open3CL se replie sur Becs_immeuble / nombre_appartement par
+ * installation et ne remultiplie pas la conso par N_i.
+ *
+ * Gardes :
+ * - Σ Sh_i × N_i ≈ SH (TOLERANCE_SURFACE_LOGEMENT_TYPE) : exclut les exports où Sh_i est déjà
+ *   la surface totale desservie (Σ Sh_i = SH, ex. N_i fractionnaires) ;
+ * - au moins un N_i > 1 : sinon rdim = 1 partout, sans effet (LICIEL, nombre_logement = 1).
+ *
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - § 11.4 et § 17.1.3.2
+ * @see Tribu : Calcul_batiment.cs l. 581-588 (boucle par installation, Ratio = Sh·Rdim/SH,
+ * Becs / Rdim), l. 1660-1662 (Cecs_i / Rdim puis × Rdim) ; Calcul_installation_ECS.cs l. 75
+ * @see Guide Tribu TE-211208 « Particularités d'une répétition de systèmes d'ECS individuel dans un
+ * immeuble collectif » (Sh_ecs = surface d'un logement, Rdim = nombre d'installations identiques)
+ */
+
+/**
+ * Rdim implicites des installations ECS individuelles multiples d'un immeuble (dans l'ordre des
+ * installations), ou null si non concernées.
+ *
+ * @param th {string} type de bâtiment (maison, appartement, immeuble)
+ * @param instal_ecs {Array} installation_ecs
+ * @param surfaceHabitableImmeuble {number|string} surface habitable de l'immeuble (SH)
+ * @return {number[]|null}
+ */
+export function rdimsImplicitesEcsIndividuellesMultiples(th, instal_ecs, surfaceHabitableImmeuble) {
+  if (th !== 'immeuble' || !Array.isArray(instal_ecs) || instal_ecs.length < 2) return null;
+
+  const des = instal_ecs.map((inst) => inst?.donnee_entree);
+  const concernees = des.every(
+    (de) => de && String(de.enum_type_installation_id) === '1' && !de.rdim
+  );
+  if (!concernees) return null;
+
+  const SH = Number(surfaceHabitableImmeuble);
+  if (!(SH > 0)) return null;
+
+  const surfaces = des.map((de) => Number(de.surface_habitable));
+  const rdims = des.map((de) => Number(de.nombre_logement) || 1);
+  if (!surfaces.every((sh) => sh > 0) || !rdims.every((n) => n > 0)) return null;
+  if (!rdims.some((n) => n > 1)) return null;
+
+  const sommeShN = surfaces.reduce((acc, sh, i) => acc + sh * rdims[i], 0);
+  return Math.abs(sommeShN - SH) <= TOLERANCE_SURFACE_LOGEMENT_TYPE * SH ? rdims : null;
+}
+
+/**
+ * Reconstitue le rdim des installations ECS individuelles multiples d'un immeuble décrites pour un
+ * logement type. Chaque installation reçoit `rdim` = nombre_logement (1 si absent) et le flag
+ * `rdim_reconstitue`.
+ *
+ * @param th {string} type de bâtiment
+ * @param instal_ecs {Array} installation_ecs
+ * @param surfaceHabitableImmeuble {number|string} surface habitable de l'immeuble (SH)
+ * @return {boolean} true si les rdim ont été reconstitués
+ */
+export function reconstituerRdimEcsIndividuellesMultiples(
+  th,
+  instal_ecs,
+  surfaceHabitableImmeuble
+) {
+  const rdims = rdimsImplicitesEcsIndividuellesMultiples(th, instal_ecs, surfaceHabitableImmeuble);
+  if (rdims === null) return false;
+  instal_ecs.forEach((inst, i) => {
+    inst.donnee_entree.rdim = rdims[i];
+    inst.donnee_entree.rdim_reconstitue = true;
+  });
+  return true;
+}

package/11_rdim_ecs_individuelle_unique.spec.js

@@ -1,7 +1,9 @@
 import { describe, expect, test } from 'vitest';
 import {
   rdimImpliciteEcsIndividuelleUnique,
+  rdimsImplicitesEcsIndividuellesMultiples,
   reconstituerRdimEcsIndividuelleUnique,
+  reconstituerRdimEcsIndividuellesMultiples,
   TOLERANCE_SURFACE_LOGEMENT_TYPE
 } from './11_rdim_ecs_individuelle_unique.js';
 
@@ -111,3 +113,137 @@ describe("Rdim de l'installation ECS individuelle unique d'un immeuble", () => {
     });
   });
 });
+
+/**
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - § 11.4 et § 17.1.3.2
+ * @see Tribu : Calcul_batiment.cs l. 581-588 et l. 1660-1662 ; Calcul_installation_ECS.cs l. 75
+ */
+describe("Rdim des installations ECS individuelles multiples d'un immeuble", () => {
+  /** Installation ECS individuelle décrite pour un logement type */
+  const inst = (surface_habitable, nombre_logement, de = {}) => ({
+    donnee_entree: { enum_type_installation_id: '1', surface_habitable, nombre_logement, ...de }
+  });
+  /** Cas type 2244E3039157K : 48,82 × 2 + 78,09 × 6 = 566,18 ≈ SH = 566,16 */
+  const ecs = () => [inst(48.82, 2), inst(78.09, 6)];
+
+  describe('rdimsImplicitesEcsIndividuellesMultiples', () => {
+    test('installations individuelles, Σ Sh × N = SH, sans rdim : rdim_i = nombre_logement_i', () => {
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', ecs(), 566.16)).toEqual([2, 6]);
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples(
+          'immeuble',
+          [
+            inst('48.82', '2', { enum_type_installation_id: 1 }),
+            inst('78.09', '6', { enum_type_installation_id: 1 })
+          ],
+          '566.16'
+        )
+      ).toEqual([2, 6]);
+    });
+
+    test('nombre_logement absent sur une installation : rdim = 1 pour celle-ci', () => {
+      // 100 × 4 + 50 × 1 = 450
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples(
+          'immeuble',
+          [inst(100, 4), inst(50, undefined)],
+          450
+        )
+      ).toEqual([4, 1]);
+    });
+
+    test('tolérance de 5 % sur Σ Sh × N ≈ SH', () => {
+      // Σ = 100 × 4 + 50 × 2 = 500 ; |500 − SH| ≤ 0,05 × SH ⇔ 476,19 ≤ SH ≤ 526,31
+      const deux = () => [inst(100, 4), inst(50, 2)];
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', deux(), 526)).toEqual([4, 2]);
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', deux(), 477)).toEqual([4, 2]);
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', deux(), 527)).toBeNull();
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', deux(), 476)).toBeNull();
+    });
+
+    test('surfaces exportées comme surface totale desservie (Σ Sh = SH) : non concerné', () => {
+      // Cas type 2224E1374434V : 74,4 × 3 + 31 × 1 = 254,2 ≠ SH = 105,4 = Σ Sh
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(74.4, 3), inst(31, 1)], 105.4)
+      ).toBeNull();
+    });
+
+    test('tous les nombre_logement à 1 (LICIEL) : non concerné', () => {
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(60, 1), inst(40, 1)], 100)
+      ).toBeNull();
+    });
+
+    test('un rdim exporté sur une installation : on conserve la saisie', () => {
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples(
+          'immeuble',
+          [inst(48.82, 2, { rdim: 2 }), inst(78.09, 6)],
+          566.16
+        )
+      ).toBeNull();
+    });
+
+    test('une installation collective : non concerné', () => {
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples(
+          'immeuble',
+          [inst(48.82, 2), inst(78.09, 6, { enum_type_installation_id: '2' })],
+          566.16
+        )
+      ).toBeNull();
+    });
+
+    test('maison ou appartement : non concerné', () => {
+      expect(rdimsImplicitesEcsIndividuellesMultiples('maison', ecs(), 566.16)).toBeNull();
+      expect(rdimsImplicitesEcsIndividuellesMultiples('appartement', ecs(), 566.16)).toBeNull();
+    });
+
+    test('installation unique : non concerné (cf. rdimImpliciteEcsIndividuelleUnique)', () => {
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(64, 10)], 640)).toBeNull();
+    });
+
+    test('données manquantes ou invalides : non concerné', () => {
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', undefined, 566.16)).toBeNull();
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', [], 566.16)).toBeNull();
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(48.82, 2), {}], 566.16)
+      ).toBeNull();
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(48.82, 2), null], 566.16)
+      ).toBeNull();
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', ecs(), undefined)).toBeNull();
+      expect(rdimsImplicitesEcsIndividuellesMultiples('immeuble', ecs(), 0)).toBeNull();
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples(
+          'immeuble',
+          [inst(48.82, 2), inst(undefined, 6)],
+          566.16
+        )
+      ).toBeNull();
+      expect(
+        rdimsImplicitesEcsIndividuellesMultiples('immeuble', [inst(100, 4), inst(50, -2)], 300)
+      ).toBeNull();
+    });
+  });
+
+  describe('reconstituerRdimEcsIndividuellesMultiples', () => {
+    test('installations concernées : rdim et flag positionnés sur chacune', () => {
+      const installations = ecs();
+      expect(reconstituerRdimEcsIndividuellesMultiples('immeuble', installations, 566.16)).toBe(
+        true
+      );
+      expect(installations[0].donnee_entree).toMatchObject({ rdim: 2, rdim_reconstitue: true });
+      expect(installations[1].donnee_entree).toMatchObject({ rdim: 6, rdim_reconstitue: true });
+    });
+
+    test('installations non concernées : inchangées', () => {
+      const installations = [inst(60, 1), inst(40, 1)];
+      expect(reconstituerRdimEcsIndividuellesMultiples('immeuble', installations, 100)).toBe(false);
+      installations.forEach((i) => {
+        expect(i.donnee_entree.rdim).toBeUndefined();
+        expect(i.donnee_entree.rdim_reconstitue).toBeUndefined();
+      });
+    });
+  });
+});

package/12.4_pac.js

@@ -1,9 +1,11 @@
+/** @import { GenerateurChauffageDE, GenerateurChauffageDI } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE, GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import { requestInputID, tv } from './utils.js';
 
 /**
  * Calcul ou récupération des paramètres scop ou cop
- * @param di {Donnee_intermediaire}
- * @param de {Donnee_entree}
+ * @param di {GenerateurChauffageDI|GenerateurEcsDI}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param du {Object}
  * @param zc_id {string}
  * @param ed_id {string|null}
@@ -31,7 +33,7 @@ function tv_scop(di, de, du, zc_id, ed_id, type) {
   };
   matcher[`enum_type_generateur_${type}_id`] = requestInputID(de, du, `type_generateur_${type}`);
   if (ed_id) matcher.enum_type_emission_distribution_id = ed_id;
-  const row = tv('scop', matcher, de);
+  const row = tv('scop', matcher);
   if (row) {
     const scop = row.scop_ou_cop;
     di[scop] = Number(row.scop);

package/12.4_pac.spec.js

@@ -26,7 +26,7 @@ beforeEach(() => {
 
 /**
  * 12.4 - Détermination du SCOP / COP des pompes à chaleur.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §12.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §12.4
  */
 describe('scopOrCop - méthode de saisie "caractéristiques saisies" (id 6)', () => {
   test('SCOP renseigné : rg et rg_dep prennent la valeur du SCOP sans accès à la table', () => {
@@ -55,14 +55,10 @@ describe('scopOrCop - valeur forfaitaire (table scop)', () => {
 
     scopOrCop(di, de, {}, 'h1a', null, 'ch');
 
-    expect(tv).toHaveBeenCalledWith(
-      'scop',
-      {
-        enum_zone_climatique_id: 'h1a',
-        enum_type_generateur_ch_id: '160'
-      },
-      de
-    );
+    expect(tv).toHaveBeenCalledWith('scop', {
+      enum_zone_climatique_id: 'h1a',
+      enum_type_generateur_ch_id: '160'
+    });
     expect(di.scop).toBe(4.2);
     expect(di.rg).toBe(4.2);
     expect(di.rg_dep).toBe(4.2);
@@ -76,15 +72,11 @@ describe('scopOrCop - valeur forfaitaire (table scop)', () => {
 
     scopOrCop(di, de, {}, 'h2b', '5', 'ecs');
 
-    expect(tv).toHaveBeenCalledWith(
-      'scop',
-      {
-        enum_zone_climatique_id: 'h2b',
-        enum_type_generateur_ecs_id: '10',
-        enum_type_emission_distribution_id: '5'
-      },
-      de
-    );
+    expect(tv).toHaveBeenCalledWith('scop', {
+      enum_zone_climatique_id: 'h2b',
+      enum_type_generateur_ecs_id: '10',
+      enum_type_emission_distribution_id: '5'
+    });
     // scop_ou_cop vaut 'cop' : la valeur est stockée sous di.cop
     expect(di.cop).toBe(3.1);
     expect(di.rg).toBe(3.1);

package/13.2_generateur_combustion.js

@@ -1,3 +1,6 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffage, GenerateurChauffageDE, GenerateurChauffageDI, InstallationChauffage } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE, GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import { bug_for_bug_compat, convertExpression, tv, tvColumnLines } from './utils.js';
 import enums from './enums.js';
 import { updateGenerateurBouilleurs } from './13.2_generateur_combustion_bouilleur.js';
@@ -63,7 +66,7 @@ export const PN_MAX_QP0_CHAUDIERE_GAZ = 400000;
  * (Tribu, `Calcul_generateur.cs` Rpn_chaudieregaz, `Math.Min(400.0, Pn)`) plafonne Pn à 400 kW :
  * au-delà, la formule n'est plus représentative (elle décroît et devient négative vers 1 500 kW).
  * Le plafond ne s'applique pas aux chaudières fioul (Rpn_chaudierefioul : Pn non plafonné).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
  *
  * @param row {object} ligne de la table generateur_combustion
  * @param pnCollectif {number} puissance nominale du générateur (W)
@@ -154,7 +157,7 @@ export function pnEstimee(GV, tbase, ratioSurface = 1) {
  * pour le chauffage, 8 pour l'ECS) du générateur.
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  * @returns {boolean|undefined} undefined si non renseigné
  */
@@ -170,7 +173,7 @@ export function chaudiereMurale(dpe, de, type) {
  * générateur ECS mixte de même `reference_generateur_mixte`, sinon générateur ECS mixte unique.
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree} données du générateur de chauffage
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur de chauffage
  * @returns {number|undefined}
  */
 export function volumeStockageEcsMixte(dpe, de) {
@@ -200,7 +203,7 @@ export function volumeStockageEcsMixte(dpe, de) {
  * pour une installation collective, Pch est conservée (comportement historique).
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree} données du générateur
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur
  * @param type {'ch' | 'ecs'}
  * @param pch {number} Pch (W) proratisée à la surface desservie
  * @param optionsPn {{installationIndividuelle?: boolean, volumeStockage?: number}}
@@ -249,8 +252,8 @@ export function pnEstimeeGenerateur(dpe, de, type, pch, optionsPn = {}) {
  * 5 - caractéristiques saisies à partir de la plaque signalétique ou d'une documentation technique du système à combustion : pn, rpn,rpint,qp0,temp_fonc_30,temp_fonc_100
  *
  * @param dpe {FullDpe}
- * @param di {Donnee_intermediaire} données du générateur
- * @param de {Donnee_entree} données du générateur
+ * @param di {GenerateurChauffageDI|GenerateurEcsDI} données du générateur
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur
  * @param type {'ecs'|'ch'}
  * @param GV {number} déperdition de l'enveloppe
  * @param tbase {number} température de fonctionnement du générateur
@@ -392,8 +395,8 @@ export function tv_generateur_combustion(
    * 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)
+   * @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];
@@ -474,7 +477,7 @@ export function tv_generateur_combustion(
 /**
  * Mise à jour du type de générateur si besoin
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurCombustion(dpe, de, type) {
@@ -515,7 +518,7 @@ export function valeurVeilleuse(valeur) {
  * @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 de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  * @returns {1 | 0 | undefined} 1 si veilleuse, 0 si pas de veilleuse, undefined si non renseigné
  */
@@ -558,7 +561,7 @@ export function presenceVeilleuse(dpe, de, type) {
  * Récupération d'informations complémentaires issues des fiches techniques pour les générateurs
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 function addInfosFromFichesTechniques(dpe, de, type) {
@@ -590,7 +593,7 @@ function addInfosFromFichesTechniques(dpe, de, type) {
  * Vérifier que les informations du générateur ECS sont bien les mêmes que celles du générateur de chauffage
  * Dans le cas d'une génération mixte, le type du générateur doit être le même
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param typeGenerateurKey {string}
  * @returns {string}
  */
@@ -612,7 +615,7 @@ function checkEcsVsChauffageForMixteGeneration(dpe, de, typeGenerateurKey) {
   }
 
   /**
-   * @type {InstallationChauffageItem[]}
+   * @type {InstallationChauffage[]}
    */
   const installationsCh = dpe.logement.installation_chauffage_collection.installation_chauffage;
 
@@ -668,9 +671,9 @@ function checkEcsVsChauffageForMixteGeneration(dpe, de, typeGenerateurKey) {
  * 3. même énergie (`enum_type_energie_id`), si un seul générateur de chauffage mixte correspond ;
  * 4. générateur de chauffage mixte unique du DPE, si son énergie n'est pas incompatible.
  *
- * @param generateursChMixtes {GenerateurChauffageItem[]} générateurs de chauffage d'usage 'chauffage + ecs'
- * @param de {Donnee_entree} données du générateur ECS
- * @returns {GenerateurChauffageItem|null} null si aucun jumeau ne peut être identifié sans ambiguïté
+ * @param generateursChMixtes {GenerateurChauffage[]} générateurs de chauffage d'usage 'chauffage + ecs'
+ * @param de {GenerateurEcsDE} données du générateur ECS
+ * @returns {GenerateurChauffage|null} null si aucun jumeau ne peut être identifié sans ambiguïté
  */
 export function findGenerateurChMixteJumeau(generateursChMixtes, de) {
   const sameValue = (a, b) =>

package/13.2_generateur_combustion.spec.js

@@ -121,7 +121,7 @@ const ROW_DEFAUT = {
 
 /**
  * 13.2 - Récupération des caractéristiques forfaitaires d'un générateur à combustion.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('tv_generateur_combustion - caractéristiques du générateur', () => {
   test('puissance nominale calculée à partir de GV et Tbase lorsqu’elle est absente', () => {
@@ -358,7 +358,7 @@ describe('tv_generateur_combustion - compatibilité bug_for_bug_compat', () => {
 
   /**
    * Système collectif par défaut : chaudière fioul standard datant de la construction du bâtiment.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
    */
   describe('système collectif par défaut : chaudière selon l’année de construction', () => {
     test('CH 119 + ligne compatible : type et ligne de la période de construction retenus', () => {
@@ -668,7 +668,7 @@ describe('tv_generateur_combustion - génération mixte (checkEcsVsChauffageForM
 /**
  * Issue #210 : l'ECS mixte doit être appariée avec SON générateur de chauffage mixte (même appareil),
  * et non avec le premier générateur de chauffage mixte du DPE.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §14
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §14
  */
 describe('findGenerateurChMixteJumeau - appariement ECS / chauffage mixte (issue #210)', () => {
   const ch = (donnees) => ({ donnee_entree: { enum_usage_generateur_id: '3', ...donnees } });
@@ -876,7 +876,7 @@ const dpeFiches = (...fiches) => ({
 
 /**
  * 13.2 - Orchestration des substitutions de générateurs et enrichissement fiches techniques.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('updateGenerateurCombustion - orchestration des substitutions', () => {
   test('délègue aux trois routines de substitution avec les mêmes arguments', () => {
@@ -983,7 +983,7 @@ describe('updateGenerateurCombustion - orchestration des substitutions', () => {
 /**
  * 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
+ * @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' };
@@ -1032,7 +1032,7 @@ 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
+ * @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) => [
@@ -1151,7 +1151,7 @@ describe('presenceVeilleuse - fiche technique « Présence d’une veilleuse »'
 /**
  * Issue #124 : générateur collectif virtualisé, puissance saisie collective (Pn) ou individualisée
  * (Pe = a × Pn) selon les logiciels.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1
  */
 describe('tv_generateur_combustion - convention de puissance d’un générateur virtualisé (#124)', () => {
   const ROW_PN = {
@@ -1418,7 +1418,7 @@ describe('caracteristiquesGenerateurCombustion - selon la méthode de saisie', (
 /**
  * Plafond de Pn à 400 kW dans Qp0 = Pn × (E + F × log Pn) / 100 des chaudières gaz après 2015
  * (moteur de référence Tribu : Calcul_generateur.cs, Rpn_chaudieregaz, Math.Min(400.0, Pn)).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
  */
 describe('puissanceFormuleQp0 - plafond de Pn à 400 kW pour les chaudières gaz', () => {
   const ROW_GAZ = {
@@ -1486,7 +1486,7 @@ describe('puissanceFormuleQp0 - plafond de Pn à 400 kW pour les chaudières gaz
 
 /**
  * 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
+ * @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
@@ -1518,7 +1518,7 @@ describe('pnEstimee - puissance nominale estimée (issue #264)', () => {
 
 /**
  * Pn estimée par la puissance de dimensionnement (issue #271).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
  */
 describe('pnEstimeeGenerateur - Pdim = max(Pch ; Pecs) et table Pdim → Pn (issue #271)', () => {
   const dpeAvecEcsMixte = (generateursEcs) => ({

package/13.2_generateur_combustion_bouilleur.js

@@ -1,9 +1,12 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffageDE } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 import getFicheTechnique from './ficheTechnique.js';
 
 /**
  * Pour les générateurs "poêles à bois bouilleur", les calculs sont faits comme pour les chaudières bois
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurBouilleurs(dpe, de, type) {
@@ -121,7 +124,7 @@ export function updateGenerateurBouilleurs(dpe, de, type) {
  *  - Pour un poêle à bois bouilleur bûche installé avant 1948, on prendra la chaudière bois bûche avant 1978
  * @param dpe {FullDpe}
  * @param ids
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 function updateGenerateurBouilleur(dpe, ids, de, type) {

package/13.2_generateur_combustion_bouilleur.spec.js

@@ -18,7 +18,7 @@ beforeEach(() => {
 /**
  * 13.1 - Les poêles à bois bouilleur sont assimilés à des chaudières bois de la
  * période correspondante.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.1
  */
 describe('updateGenerateurBouilleurs - substitution par une chaudière bois équivalente', () => {
   test('type non concerné : aucune substitution', () => {