@open3cl/engine 1.8.40 → 1.8.41

package/9_conso_ch.js

@@ -140,6 +140,14 @@ export function conso_ch(
       di.conso_ch = consoInd.conso_ch + consoColl.conso_ch;
       di.conso_ch_depensier = consoInd.conso_ch_dep + consoColl.conso_ch_dep;
 
+      /**
+       * Part d'appoint individuel (40 %) conservée pour le coût : la base (60 %) est facturée en
+       * électricité collective, l'appoint en électricité individuelle (voir conso.js,
+       * coutBijonction).
+       */
+      du.conso_ch_appoint_bijonction = consoInd.conso_ch;
+      du.conso_ch_appoint_bijonction_depensier = consoInd.conso_ch_dep;
+
       return bch;
     }
     default: {

package/9_conso_ch.spec.js

@@ -291,6 +291,35 @@ describe('conso_ch - convecteurs bi-jonction (individuel + collectif)', () => {
     // l'intermittence collective est calculée avec I0 = 1.03
     expect(calc_intermittence).toHaveBeenCalledWith(150, 100, 2.5, 1.03);
   });
+
+  test("part d'appoint individuel mémorisée pour le coût (base collective / appoint individuel)", () => {
+    const di = { rg: 1, rg_dep: 1 };
+    const du = {};
+    const de = { enum_type_generateur_ch_id: '10', surface_chauffee: 100, fch: 0.5 };
+
+    conso_ch(
+      di,
+      de,
+      du,
+      0,
+      'convecteurs bi-jonction',
+      [emetteur(0.5)],
+      150,
+      100,
+      2.5,
+      1000,
+      2000,
+      -9.5,
+      0,
+      1,
+      1
+    );
+
+    // appoint individuel seul : 0.4 * (0.5 / 0.8) * 1000 = 250 (dépensier : × 2)
+    expect(du.conso_ch_appoint_bijonction).toBeCloseTo(250, 9);
+    expect(du.conso_ch_appoint_bijonction_depensier).toBeCloseTo(500, 9);
+    expect(di.conso_ch - du.conso_ch_appoint_bijonction).toBeCloseTo(772.5, 9);
+  });
 });
 
 describe('conso_ch - installation collective base + appoint', () => {

package/README.md

@@ -370,14 +370,14 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.39`** · branche `main` · généré le 2026-10-10
+> **Version `1.8.40`** · branche `main` · généré le 2026-10-10
 > 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>61 951</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>61 956</strong><br/><sub>DPE conformes</sub></td>
 <td align="center"><strong>68,85 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
@@ -385,13 +385,13 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
 | 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,18 %** | `█████████░░░░░░░░░░░` |  4 618 / 9 999 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,53 %** | `███████████████████░` | 9 253 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,54 %** | `██████████████████░░` |  8 947 / 9 992 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **92,54 %** | `███████████████████░` | 9 254 / 10 000 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **89,55 %** | `██████████████████░░` |  8 948 / 9 992 |
 | 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,61 %** | `██████████████████░░` |  8 860 / 9 999 |
 | 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **84,22 %** | `█████████████████░░░` |  8 420 / 9 998 |
 | 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **71,60 %** | `██████████████░░░░░░` | 7 160 / 10 000 |
 | 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **66,19 %** | `█████████████░░░░░░░` |  6 618 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **53,71 %** | `███████████░░░░░░░░░` |  5 369 / 9 997 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **53,74 %** | `███████████░░░░░░░░░` |  5 372 / 9 997 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,06 %** | `█████░░░░░░░░░░░░░░░` | 2 706 / 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>4,88 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,26 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>537,6 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>4,76 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,15 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>705,6 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 4,60 ms | 4,17 ms | 0,21 ms |  26,6 ms | 8,53 ms | 11,6 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,63 ms | 3,29 ms | 1,44 ms |  35,4 ms | 6,29 ms | 8,33 ms |
-| **Logement individuel (2025)**                 | 4,67 ms | 4,15 ms | 1,54 ms |  26,8 ms | 8,72 ms | 11,8 ms |
-| **Maison individuelle (2025)**                 | 5,51 ms | 4,95 ms | 1,80 ms |  43,2 ms | 10,0 ms | 13,0 ms |
-| **Immeuble · chauffage individuel**            | 5,99 ms | 5,11 ms | 0,11 ms |  79,0 ms | 11,9 ms | 19,5 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,09 ms | 3,69 ms | 1,45 ms |  35,2 ms | 6,70 ms | 8,49 ms |
-| **Immeuble · chauffage collectif**             | 5,22 ms | 4,42 ms | 0,11 ms | 112,3 ms | 9,63 ms | 17,2 ms |
-| **Immeuble · chauffage mixte**                 | 4,99 ms | 4,03 ms | 0,18 ms | 537,6 ms | 10,3 ms | 17,6 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 5,17 ms | 4,53 ms | 1,55 ms |  51,1 ms | 9,47 ms | 14,4 ms |
+| **Généraliste**                                | 4,07 ms | 3,65 ms | 0,22 ms |  28,8 ms | 7,49 ms | 10,1 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,71 ms | 3,38 ms | 1,40 ms |  27,1 ms | 6,41 ms | 8,18 ms |
+| **Logement individuel (2025)**                 | 4,46 ms | 3,95 ms | 1,65 ms |  39,9 ms | 8,31 ms | 11,3 ms |
+| **Maison individuelle (2025)**                 | 5,46 ms | 4,87 ms | 1,84 ms |  39,8 ms | 9,77 ms | 12,9 ms |
+| **Immeuble · chauffage individuel**            | 5,80 ms | 4,92 ms | 0,12 ms |  83,3 ms | 11,6 ms | 19,0 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,27 ms | 3,90 ms | 1,50 ms |  35,0 ms | 7,03 ms | 9,07 ms |
+| **Immeuble · chauffage collectif**             | 5,12 ms | 4,32 ms | 0,12 ms |  92,3 ms | 9,55 ms | 16,6 ms |
+| **Immeuble · chauffage mixte**                 | 4,62 ms | 3,78 ms | 0,17 ms | 705,6 ms | 9,38 ms | 15,3 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,29 ms | 4,53 ms | 1,68 ms |  45,3 ms | 9,97 ms | 15,4 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/conso.js

@@ -258,6 +258,47 @@ function coefPourGenerateur(coef, gen) {
   return collectif?.generateurs.has(gen) ? collectif.coef : coef;
 }
 
+/**
+ * Part d'appoint individuel (40 % du besoin, §9.1.6) de la consommation d'un convecteur
+ * bi-jonction, mémorisée par conso_ch (9_conso_ch.js) ; 0 pour les autres générateurs.
+ * @param gen {GenerateurChauffageItem}
+ * @param field {'conso_ch'|'conso_ch_depensier'}
+ * @returns {number}
+ */
+export function appointBijonction(gen, field) {
+  const du = gen.donnee_utilisateur || {};
+  const appoint =
+    field === 'conso_ch_depensier'
+      ? du.conso_ch_appoint_bijonction_depensier
+      : du.conso_ch_appoint_bijonction;
+  return appoint || 0;
+}
+
+/**
+ * Coût du chauffage d'un convecteur bi-jonction d'une installation collective : la base est
+ * facturée en électricité collective (tranche de l'installation collective), l'appoint
+ * individuel en électricité individuelle (tranche du logement).
+ * Moteur de référence CSTB : DPE.Core Calcul_batiment.cs l.861-872 (base Cch1 → conso_elec_coll_ch
+ * si l'installation n'est pas individuelle) et l.912-915 (Cch_appoint_elec → conso_elec_indiv_ch),
+ * Calcul_cout.cs l.149-172 (tarification séparée collectif / individuel).
+ * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.6 (convecteurs bi-jonction)
+ *
+ * @param coef {object} barème issu de coefCoutProrata
+ * @param gen {GenerateurChauffageItem}
+ * @param typeEnergie {string}
+ * @param conso {number} consommation du générateur (base + appoint)
+ * @param field {'conso_ch'|'conso_ch_depensier'}
+ * @returns {number|null} coût, ou null si la règle ne s'applique pas
+ */
+export function coutBijonction(coef, gen, typeEnergie, conso, field) {
+  const collectif = coef?.[COUT_COLLECTIF];
+  const appoint = appointBijonction(gen, field);
+  if (!collectif?.generateurs.has(gen) || appoint <= 0) return null;
+  return (
+    getConso(collectif.coef, typeEnergie, conso - appoint) + getConso(coef, typeEnergie, appoint)
+  );
+}
+
 function getConso(coef, type_energie, conso) {
   // is coef is a function, execute it
   if (!coef) return conso;
@@ -393,6 +434,16 @@ export default function calc_conso(
           inst.generateur_ecs_collection.generateur_ecs.forEach((g) => genCollectifs.add(g))
         );
     }
+    /**
+     * Convecteurs bi-jonction d'une installation non individuelle : base toujours facturée en
+     * électricité collective, même sans extrapolation à l'immeuble (Tribu : SH_total = SH).
+     */
+    gen_ch
+      .filter(
+        (g) =>
+          g.donnee_entree.enum_type_installation_id !== '1' && appointBijonction(g, 'conso_ch') > 0
+      )
+      .forEach((g) => genCollectifs.add(g));
     const consoGroupe = (masque) => {
       const tot = calc_conso_pond(
         Sh,
@@ -420,7 +471,21 @@ export default function calc_conso(
         prorataChauffage,
         []
       );
-      return { total: tot.c_5_usages, collectif: coll.c_ch + coll.c_ecs };
+      // Appoint individuel des convecteurs bi-jonction : tarifé en individuel (voir coutBijonction)
+      const appointIndividuel = gen_ch
+        .filter((g) => genCollectifs.has(g))
+        .reduce(
+          (acc, g) =>
+            acc +
+            getConso(
+              masque,
+              getTypeEnergie(g.donnee_entree, 'ch'),
+              appointBijonction(g, 'conso_ch')
+            ) *
+              g.donnee_entree.cle_repartition_ch,
+          0
+        );
+      return { total: tot.c_5_usages, collectif: coll.c_ch + coll.c_ecs - appointIndividuel };
     };
     return coefCoutProrata(base, consoGroupe, nbLogements, genCollectifs, ratioSurfaceCollectif);
   };
@@ -668,6 +733,9 @@ function getChauffageConso(gen_ch, field, coef, prorataChauffage, prefix) {
         ? gen_ch.donnee_entree.cle_repartition_ch || prorataChauffage
         : prorataChauffage;
 
+    const coutBij = coutBijonction(coef, gen_ch, typeEnergie, conso, field);
+    if (coutBij !== null) return acc + coutBij * repartition;
+
     let coeffConsoChauffage = { ...coefPourGenerateur(coef, gen_ch) };
 
     if (prefix === 'emission_ges') {

package/conso.spec.js

@@ -56,7 +56,9 @@ const {
   coefCoutProrata,
   masqueEnergie,
   getAuxGenerationEcs,
-  DATE_BAREME_COUT_2024
+  DATE_BAREME_COUT_2024,
+  appointBijonction,
+  coutBijonction
 } = await import('./conso.js');
 
 /**
@@ -797,3 +799,173 @@ describe('getAuxGenerationEcs - auxiliaires de génération ECS et rdim', () =>
     expect(res.ef_conso.conso_auxiliaire_generation_ecs).toBeGreaterThan(0);
   });
 });
+
+/**
+ * Convecteurs bi-jonction (§9.1.6) : base (60 %) facturée en électricité collective, appoint
+ * individuel (40 %) en électricité individuelle.
+ * @see Moteur_DPE.dll (CSTB) Calcul_batiment.cs l.861-872 / l.912-915, Calcul_cout.cs l.149-172 ;
+ * autotests APP3-0-1 (base 1541 kWh → 311 €, appoint 858 kWh → 197 €) et IC1-0-5.
+ */
+describe('calc_conso - coût des convecteurs bi-jonction (base collective + appoint individuel)', () => {
+  const DATE_DPE_2026 = '2026-01-15';
+  let errorSpy;
+
+  beforeEach(() => {
+    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+  });
+
+  afterEach(() => {
+    errorSpy.mockRestore();
+  });
+
+  /** Installation bi-jonction (type 4) : conso totale 2400 kWh dont 900 kWh d'appoint. */
+  const bijonction = (typeInstallation = '4') => [
+    installCh({ enum_type_installation_id: typeInstallation }, [
+      {
+        ...genCh('1', { conso_ch: 2400, conso_ch_depensier: 4800 }),
+        donnee_utilisateur: {
+          conso_ch_appoint_bijonction: 900,
+          conso_ch_appoint_bijonction_depensier: 1800
+        }
+      }
+    ])
+  ];
+
+  test('appartement : base tarifée sur la tranche de l’immeuble, appoint avec les usages individuels', () => {
+    const res = calc_conso(
+      100,
+      1,
+      1,
+      [],
+      bijonction(),
+      [],
+      [],
+      1,
+      1,
+      DATE_DPE_2026,
+      coef_ep,
+      1,
+      20
+    );
+    // Base 1500 kWh × 20 = 30000 kWh (≥ 15000) => (78 + 0,20001 × 30000) / 20
+    const base = (78 + 0.20001 * 30000) / 20;
+    // Individuel : appoint 900 + éclairage 100 = 1000 kWh (tranche 1000-2500) au prorata
+    const indiv = 158 + 0.18954 * 1000;
+    expect(res.cout.cout_ch).toBeCloseTo(base + (indiv * 900) / 1000, 9);
+    expect(res.cout.cout_eclairage).toBeCloseTo((indiv * 100) / 1000, 9);
+    expect(res.cout.cout_5_usages).toBeCloseTo(base + indiv, 9);
+  });
+
+  test('immeuble : base sur le total collectif, appoint rapporté au logement (N × f(C / N))', () => {
+    const res = calc_conso(100, 1, 1, [], bijonction(), [], [], 1, 1, DATE_DPE_2026, coef_ep, 4);
+    // Base 1500 kWh (tranche 1000-2500) ; individuel (900 + 100) / 4 logements = 250 kWh
+    const base = 158 + 0.18954 * 1500;
+    const indiv = 4 * 0.34721 * 250;
+    expect(res.cout.cout_ch).toBeCloseTo(base + (indiv * 900) / 1000, 9);
+    expect(res.cout.cout_5_usages).toBeCloseTo(base + indiv, 9);
+  });
+
+  test('scénario dépensier : part d’appoint dépensière utilisée', () => {
+    const res = calc_conso(
+      100,
+      1,
+      1,
+      [],
+      bijonction(),
+      [],
+      [],
+      1,
+      1,
+      DATE_DPE_2026,
+      coef_ep,
+      1,
+      20
+    );
+    const coef = (c) => ((78 + 0.20001 * 30000) / 30000) * c;
+    const prixIndiv = (158 + 0.18954 * 1000) / 1000;
+    expect(res.cout.cout_ch_depensier).toBeCloseTo(coef(3000) + prixIndiv * 1800, 9);
+  });
+
+  test('installation individuelle : un seul barème (individuel) pour tout le générateur', () => {
+    const res = calc_conso(
+      100,
+      1,
+      1,
+      [],
+      bijonction('1'),
+      [],
+      [],
+      1,
+      1,
+      DATE_DPE_2026,
+      coef_ep,
+      1,
+      20
+    );
+    // Élec totale 2400 + 100 = 2500 kWh (tranche 2500-5000) au prorata
+    expect(res.cout.cout_ch).toBeCloseTo(((158 + 0.18949 * 2500) * 2400) / 2500, 9);
+  });
+
+  test('sans surface d’immeuble (ratio 1, 1 logement) : base et appoint tarifés séparément', () => {
+    const res = calc_conso(100, 1, 1, [], bijonction(), [], [], 1, 1, DATE_DPE_2026, coef_ep);
+    // Base 1500 kWh seule (tranche 1000-2500) ; individuel 900 + 100 = 1000 kWh
+    const base = 158 + 0.18954 * 1500;
+    const indiv = 158 + 0.18954 * 1000;
+    expect(res.cout.cout_ch).toBeCloseTo(base + (indiv * 900) / 1000, 9);
+    expect(res.cout.cout_5_usages).toBeCloseTo(base + indiv, 9);
+  });
+
+  test('DPE antérieur au 01/07/2024 : barème 2021 par poste, sans scission', () => {
+    const res = calc_conso(100, 1, 1, [], bijonction(), [], [], 1, 1, '2024-06-30', coef_ep, 1, 20);
+    expect(res.cout.cout_ch).toBeCloseTo(149 + 0.14066 * 2400, 9);
+  });
+
+  test('consommations EF / EP inchangées par la scission', () => {
+    const res = calc_conso(
+      100,
+      1,
+      1,
+      [],
+      bijonction(),
+      [],
+      [],
+      1,
+      1,
+      DATE_DPE_2026,
+      coef_ep,
+      1,
+      20
+    );
+    expect(res.ef_conso.conso_ch).toBeCloseTo(2400, 9);
+    expect(res.ep_conso.ep_conso_ch).toBeCloseTo(2400 * 1.9, 9);
+  });
+});
+
+describe('appointBijonction / coutBijonction', () => {
+  test('appointBijonction : part mémorisée selon le scénario, 0 sinon', () => {
+    const gen = {
+      donnee_utilisateur: {
+        conso_ch_appoint_bijonction: 9,
+        conso_ch_appoint_bijonction_depensier: 18
+      }
+    };
+    expect(appointBijonction(gen, 'conso_ch')).toBe(9);
+    expect(appointBijonction(gen, 'conso_ch_depensier')).toBe(18);
+    expect(appointBijonction({}, 'conso_ch')).toBe(0);
+    expect(appointBijonction({ donnee_utilisateur: {} }, 'conso_ch_depensier')).toBe(0);
+  });
+
+  test('coutBijonction : null hors barème collectif ou sans appoint', () => {
+    const gen = { donnee_utilisateur: { conso_ch_appoint_bijonction: 10 } };
+    const base = getCoefCout('2026-01-15');
+    expect(coutBijonction(base, gen, 'électricité ch', 30, 'conso_ch')).toBeNull();
+    expect(coutBijonction(null, gen, 'électricité ch', 30, 'conso_ch')).toBeNull();
+    const coef = coefCoutProrata(base, () => ({ total: 100, collectif: 50 }), 1, new Set([gen]));
+    expect(coutBijonction(coef, {}, 'électricité ch', 30, 'conso_ch')).toBeNull();
+    // base 20 kWh au prix collectif f(50)/50, appoint 10 kWh au prix individuel f(50)/50
+    expect(coutBijonction(coef, gen, 'électricité ch', 30, 'conso_ch')).toBeCloseTo(
+      0.34721 * 30,
+      9
+    );
+  });
+});

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.40';
+const LIB_VERSION = '1.8.41';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

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