@open3cl/engine 1.8.23 → 1.8.24

package/9_chauffage.js

@@ -110,15 +110,18 @@ export default function calc_chauffage(
    * Cas particulier des PAC hybrides avec répartition forfaitaire du besoin
    * @type {number|number}
    */
-  const Pnominal = gen_ch.reduce((acc, gen) => acc + (gen.donnee_intermediaire.pn || 0), 0);
-  du.Pnominal = Pnominal;
-
   const nbCascadeAndCombustion = gen_ch.filter(
     (value) =>
       value.donnee_utilisateur.isCombustionGenerator &&
       Number.parseInt(de.enum_cfg_installation_ch_id) === 1
   ).length;
 
+  // Cascade avec priorité : seuls les générateurs principaux assurent le besoin (et dimensionnent
+  // le taux de charge) ; les générateurs secondaires (relève) ont un besoin nul.
+  const principaux = nbCascadeAndCombustion > 1 ? generateursPrincipauxCascade(gen_ch) : gen_ch;
+  const Pnominal = principaux.reduce((acc, gen) => acc + (gen.donnee_intermediaire.pn || 0), 0);
+  du.Pnominal = Pnominal;
+
   // Nombre de générateurs avec une consommation des auxiliaires de distribution
   const nbGenWithAuxConsoDistribution = gen_ch.reduce((acc, gen) => {
     if (hasConsoForAuxDistribution(gen.donnee_entree.enum_type_generateur_ch_id)) {
@@ -148,7 +151,8 @@ export default function calc_chauffage(
       nbCascadeAndCombustion,
       nbCascadeForSameEmetteur,
       Pnominal,
-      zc
+      zc,
+      principaux.includes(gen)
     );
     /* c8 ignore next 2 -- repli défensif inatteignable : donnee_utilisateur est toujours renseignée
        par la première boucle sur gen_ch ci-dessus */
@@ -194,6 +198,29 @@ export default function calc_chauffage(
   ch.donnee_utilisateur = du;
 }
 
+/**
+ * 13.2.1.3 Cascade de deux générateurs à combustion avec priorité
+ *
+ * `priorite_generateur_cascade` (modèle DPE ADEME) : 1 = générateur principal, 2 = secondaire…
+ * « Dans le cas de deux générateurs en cascade sans priorité, les deux générateurs sont déclarés
+ * comme principal. » Les générateurs principaux sont ceux de plus petite priorité ; si aucune
+ * priorité n'est renseignée, ou si toutes sont identiques, tous les générateurs sont principaux
+ * (cascade sans priorité : prorata des puissances nominales).
+ *
+ * Comme le moteur de référence CSTB (Tribu, autotests État APP5-0-4/41/43), le générateur
+ * prioritaire assure la totalité du besoin et son taux de charge est calculé avec sa seule Pn.
+ *
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
+ * @param gen_ch {GenerateurChauffageItem[]}
+ * @return {GenerateurChauffageItem[]} générateurs principaux
+ */
+export function generateursPrincipauxCascade(gen_ch) {
+  const priorites = gen_ch.map((gen) => Number(gen.donnee_entree.priorite_generateur_cascade));
+  if (priorites.some((p) => !(p > 0))) return gen_ch;
+  const prioriteMin = Math.min(...priorites);
+  return gen_ch.filter((_gen, i) => priorites[i] === prioriteMin);
+}
+
 /**
  * 13.2.1.3 Cascade de deux générateurs à combustion
  * Une puissance relative pour chaque générateur est calculée et appliquée à la conso globale de chauffage
@@ -203,7 +230,14 @@ export default function calc_chauffage(
  * Cas particulier des PAC hybrides avec répartition forfaitaire du besoin
  * @type {number|number}
  */
-function getProrataGenerateur(genCh, nbCascadeAndCombustion, nbGenerateurCascade, Pnominal, zc) {
+function getProrataGenerateur(
+  genCh,
+  nbCascadeAndCombustion,
+  nbGenerateurCascade,
+  Pnominal,
+  zc,
+  estPrincipal
+) {
   // IDs des pompes à chaleur hybrides
   if (
     genCh.donnee_entree.enum_type_generateur_ch_id >= 145 &&
@@ -233,9 +267,11 @@ function getProrataGenerateur(genCh, nbCascadeAndCombustion, nbGenerateurCascade
     }
   }
 
-  return nbCascadeAndCombustion > 1
-    ? genCh.donnee_intermediaire.pn / Pnominal
-    : 1 / (nbGenerateurCascade || 1);
+  if (nbCascadeAndCombustion > 1) {
+    // générateur secondaire d'une cascade avec priorité : aucun besoin assuré
+    return estPrincipal ? genCh.donnee_intermediaire.pn / Pnominal : 0;
+  }
+  return 1 / (nbGenerateurCascade || 1);
 }
 
 /**

package/9_chauffage.spec.js

@@ -58,7 +58,8 @@ vi.mock('./enums.js', () => ({
 const {
   default: calc_chauffage,
   tauxChargeForGenerator,
-  isImmeuble
+  isImmeuble,
+  generateursPrincipauxCascade
 } = await import('./9_chauffage.js');
 const { requestInput, tv, tvColumnIDs } = await import('./utils.js');
 const { calc_emetteur_ch } = await import('./9_emetteur_ch.js');
@@ -457,6 +458,100 @@ describe('calc_chauffage - prorata entre générateurs', () => {
   });
 });
 
+/**
+ * 13.2.1.3 Cascade de deux générateurs à combustion avec priorité
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
+ */
+describe('calc_chauffage - cascade de générateurs à combustion avec priorité', () => {
+  /** Deux chaudières (combustion) en cascade sur un seul émetteur. */
+  function cascade(prio1, prio2) {
+    vi.mocked(checkForGeneratorType).mockImplementation((_dpe, _de, _di, du) => {
+      du.isCombustionGenerator = true;
+    });
+    vi.mocked(tvColumnIDs).mockReturnValue([]);
+    return installation(
+      [
+        generateur({ priorite_generateur_cascade: prio1 }, { pn: 17000 }),
+        generateur({ priorite_generateur_cascade: prio2 }, { pn: 13000 })
+      ],
+      [emetteur('1')]
+    );
+  }
+
+  test('sans priorité : prorata des puissances nominales (Pnominal = somme des Pn)', () => {
+    const ch = cascade(undefined, undefined);
+    appel(ch, { bch: 3000 });
+    expect(vi.mocked(calc_generateur_ch).mock.calls[0][5]).toBeCloseTo(1700, 9);
+    expect(vi.mocked(calc_generateur_ch).mock.calls[1][5]).toBeCloseTo(1300, 9);
+    expect(ch.donnee_utilisateur.Pnominal).toBe(30000);
+  });
+
+  test('deux générateurs déclarés principaux (même priorité) : prorata des puissances', () => {
+    const ch = cascade(1, 1);
+    appel(ch, { bch: 3000 });
+    expect(vi.mocked(calc_generateur_ch).mock.calls[0][5]).toBeCloseTo(1700, 9);
+    expect(vi.mocked(calc_generateur_ch).mock.calls[1][5]).toBeCloseTo(1300, 9);
+  });
+
+  test('priorité 1 / 2 : le principal assure tout le besoin, le secondaire aucun', () => {
+    const ch = cascade(1, 2);
+    appel(ch, { bch: 3000, bch_dep: 3600 });
+    const [appelPrincipal, appelSecondaire] = vi.mocked(calc_generateur_ch).mock.calls;
+    expect(appelPrincipal[5]).toBe(3000);
+    expect(appelPrincipal[6]).toBe(3600);
+    expect(appelSecondaire[5]).toBe(0);
+    expect(appelSecondaire[6]).toBe(0);
+    // le taux de charge (cdimref) est dimensionné sur la seule Pn du principal
+    expect(ch.donnee_utilisateur.Pnominal).toBe(17000);
+  });
+
+  test('priorité inversée (2 / 1) : le second générateur est le principal', () => {
+    const ch = cascade(2, 1);
+    appel(ch, { bch: 3000 });
+    expect(vi.mocked(calc_generateur_ch).mock.calls[0][5]).toBe(0);
+    expect(vi.mocked(calc_generateur_ch).mock.calls[1][5]).toBe(3000);
+    expect(ch.donnee_utilisateur.Pnominal).toBe(13000);
+  });
+
+  test('générateur unique avec priorité : besoin entier (pas de cascade)', () => {
+    vi.mocked(checkForGeneratorType).mockImplementation((_dpe, _de, _di, du) => {
+      du.isCombustionGenerator = true;
+    });
+    vi.mocked(tvColumnIDs).mockReturnValue([]);
+    const ch = installation(
+      [generateur({ priorite_generateur_cascade: 2 }, { pn: 17000 })],
+      [emetteur('1')]
+    );
+    appel(ch, { bch: 3000 });
+    expect(vi.mocked(calc_generateur_ch).mock.calls[0][5]).toBe(3000);
+    expect(ch.donnee_utilisateur.Pnominal).toBe(17000);
+  });
+});
+
+describe('generateursPrincipauxCascade', () => {
+  const gen = (priorite) => ({ donnee_entree: { priorite_generateur_cascade: priorite } });
+
+  test('priorité absente sur un générateur : tous principaux', () => {
+    const gens = [gen(1), gen(undefined)];
+    expect(generateursPrincipauxCascade(gens)).toEqual(gens);
+  });
+
+  test('priorité nulle ou invalide : tous principaux', () => {
+    const gens = [gen('0'), gen('2')];
+    expect(generateursPrincipauxCascade(gens)).toEqual(gens);
+  });
+
+  test('priorités saisies en chaîne : plus petite priorité retenue', () => {
+    const gens = [gen('2'), gen('1'), gen('3')];
+    expect(generateursPrincipauxCascade(gens)).toEqual([gens[1]]);
+  });
+
+  test('plusieurs générateurs de même priorité minimale : tous retenus', () => {
+    const gens = [gen(1), gen(1), gen(2)];
+    expect(generateursPrincipauxCascade(gens)).toEqual([gens[0], gens[1]]);
+  });
+});
+
 describe('calc_chauffage - auxiliaires de distribution répartis', () => {
   test('répartition de la consommation d’auxiliaires sur les générateurs éligibles', () => {
     vi.mocked(hasConsoForAuxDistribution).mockReturnValue(true);

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.22`** · branche `main` · généré le 2026-10-04
+> **Version `1.8.23`** · branche `main` · généré le 2026-10-04
 > 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,36 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,64 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,10 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>823,0 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,32 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,66 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>933,6 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 5,23 ms | 4,71 ms | 0,23 ms |  52,3 ms | 9,47 ms | 13,8 ms |
-| **Appartement · chauffage individuel (2025)**  | 4,08 ms | 3,70 ms | 1,52 ms |  32,7 ms | 7,06 ms | 9,53 ms |
-| **Logement individuel (2025)**                 | 4,71 ms | 4,17 ms | 1,61 ms |  28,7 ms | 8,70 ms | 12,0 ms |
-| **Maison individuelle (2025)**                 | 6,26 ms | 5,66 ms | 1,96 ms |  47,2 ms | 11,3 ms | 15,1 ms |
-| **Immeuble · chauffage individuel**            | 6,21 ms | 5,23 ms | 0,10 ms |  81,6 ms | 12,6 ms | 19,8 ms |
-| **Appartement · chauffage collectif (2025)**   | 5,76 ms | 4,99 ms | 1,45 ms |  35,9 ms | 12,5 ms | 19,0 ms |
-| **Immeuble · chauffage collectif**             | 5,22 ms | 4,34 ms | 0,12 ms | 119,3 ms | 9,61 ms | 17,5 ms |
-| **Immeuble · chauffage mixte**                 | 5,11 ms | 4,13 ms | 0,18 ms | 823,0 ms | 10,5 ms | 16,6 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,63 ms | 4,86 ms | 1,65 ms |  44,3 ms | 10,6 ms | 15,8 ms |
+| **Généraliste**                                | 4,90 ms | 4,46 ms | 0,22 ms |  38,9 ms | 8,82 ms | 12,0 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,82 ms | 3,51 ms | 1,34 ms |  30,2 ms | 6,52 ms | 8,52 ms |
+| **Logement individuel (2025)**                 | 5,25 ms | 4,67 ms | 1,66 ms |  38,9 ms | 9,78 ms | 13,2 ms |
+| **Maison individuelle (2025)**                 | 6,36 ms | 5,77 ms | 2,05 ms |  50,5 ms | 11,3 ms | 14,5 ms |
+| **Immeuble · chauffage individuel**            | 6,23 ms | 5,25 ms | 0,12 ms | 122,1 ms | 12,5 ms | 20,5 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,33 ms | 3,99 ms | 1,46 ms |  35,9 ms | 7,01 ms | 9,22 ms |
+| **Immeuble · chauffage collectif**             | 5,18 ms | 4,35 ms | 0,12 ms | 129,8 ms | 9,51 ms | 17,0 ms |
+| **Immeuble · chauffage mixte**                 | 5,66 ms | 4,59 ms | 0,22 ms | 933,6 ms | 11,8 ms | 18,9 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 6,18 ms | 5,35 ms | 1,62 ms |  44,3 ms | 11,6 ms | 17,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 } from './16.2_production_enr.js';
 import DpeSanitizerService from './dpe-sanitizer.service.js';
 
-const LIB_VERSION = '1.8.23';
+const LIB_VERSION = '1.8.24';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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