@open3cl/engine 1.0.12 → 1.0.13

package/features/dpe/domain/models/dpe.model.ts

@@ -159,6 +159,15 @@ export interface Logement {
   installation_ecs_collection: { installation_ecs: InstallationEcs[] };
   installation_chauffage_collection: { installation_chauffage: InstallationChauffage[] };
   sortie: Sortie;
+  donnees_de_calcul: LogementDonneesCalcul;
+}
+
+export interface LogementDonneesCalcul {
+  apportsInterneCh: { [key: string]: number };
+  apportsInterneDepensier: { [key: string]: number };
+  apportsSolaire: { [key: string]: number };
+  besoinChauffageHP: { [key: string]: number };
+  besoinChauffageDepensierHP: { [key: string]: number };
 }
 
 export interface Tertiaire extends Logement {}

package/features/dpe/domain/models/installation-chauffage.model.ts

@@ -71,7 +71,7 @@ export interface GenerateurChauffageDE extends DE {
   enum_type_generateur_ch_id: number;
   enum_usage_generateur_id: number;
   enum_type_energie_id: number;
-  position_volume_chauffe: boolean;
+  position_volume_chauffe: number;
   tv_rendement_generation_id?: number;
   tv_scop_id?: number;
   tv_temp_fonc_100_id?: number;
@@ -81,7 +81,7 @@ export interface GenerateurChauffageDE extends DE {
   identifiant_reseau_chaleur?: string;
   date_arrete_reseau_chaleur?: string;
   priorite_generateur_cascade?: number;
-  presence_ventouse?: boolean;
+  presence_ventouse?: number;
   presence_regulation_combustion?: boolean;
   enum_methode_saisie_carac_sys_id: number;
   enum_lien_generateur_emetteur_id: number;

package/features/dpe/infrastructure/froid/frTv.store.js

@@ -15,8 +15,10 @@ export class FrTvStore extends TvStore {
    * — e_fr_28 : ensoleillement reçu en période de refroidissement pour un mois donné et une consigne de refroidissement à 28°C (comportement conventionnel).
    * — textmoy_clim_26 : Température extérieure moyenne pour un mois donné et une consigne de refroidissement à 26°C (comportement conventionnel).
    * — textmoy_clim_28 : nombre d’heures de chauffage pour un mois donné et une consigne de refroidissement à 28°C (comportement conventionnel).
+   * — dh19 : degrés heures de chauffage pour un mois donné à 19°C (comportement conventionnel).
+   * — dh21 : degrés heures de chauffage pour un mois donné à 21°C (comportement dépensier).
    *
-   * @param type {'e', nref26' | 'nref28' | 'e_fr_26' | 'e_fr_28' | 'textmoy_clim_26' | 'textmoy_clim_28'}
+   * @param type {'e', nref26' | 'nref28' | 'e_fr_26' | 'e_fr_28' | 'textmoy_clim_26' | 'textmoy_clim_28'| 'dh19'| 'dh21'}
    * @param classeAltitude {string}
    * @param zoneClimatique {string}
    * @param mois {string}
@@ -31,6 +33,6 @@ export class FrTvStore extends TvStore {
       values = values[ilpa];
     }
 
-    return values[classeAltitude][mois][zoneClimatique];
+    return parseFloat(values[classeAltitude][mois][zoneClimatique]);
   }
 }

package/features/engine/domain/apport_et_besoin/apport-et-besoin.service.js

@@ -5,6 +5,8 @@ import { BesoinFroidService } from './froid/besoin-froid.service.js';
 import { ApportGratuitService } from './apport_gratuit/apport-gratuit.service.js';
 import { InstallationEcsService } from '../ecs/installation-ecs.service.js';
 import { PerteEcsRecupService } from './ecs/perte-ecs-recup.service.js';
+import { BesoinChService } from './ch/besoin-ch.service.js';
+import { PerteChRecupService } from './ch/perte-ch-recup.service.js';
 
 /**
  * Calcul des déperditions de l’enveloppe GV
@@ -21,6 +23,11 @@ export class ApportEtBesoinService {
    */
   #besoinEcsService;
 
+  /**
+   * @type {BesoinChService}
+   */
+  #besoinChService;
+
   /**
    * @type {InstallationEcsService}
    */
@@ -36,6 +43,11 @@ export class ApportEtBesoinService {
    */
   #besoinFroidService;
 
+  /**
+   * @type {PerteChRecupService}
+   */
+  #perteChRecupService;
+
   /**
    * @type {ApportGratuitService}
    */
@@ -43,25 +55,31 @@ export class ApportEtBesoinService {
 
   /**
    * @param besoinEcsService {BesoinEcsService}
+   * @param besoinChService {BesoinChService}
    * @param installationEcsService {InstallationEcsService}
    * @param perteEcsRecupService {PerteEcsRecupService}
    * @param besoinFroidService {BesoinFroidService}
    * @param surfaceSudEquivalenteService {SurfaceSudEquivalenteService}
+   * @param perteChRecupService {PerteChRecupService}
    * @param apportGratuitService {ApportGratuitService}
    */
   constructor(
     besoinEcsService = inject(BesoinEcsService),
+    besoinChService = inject(BesoinChService),
     installationEcsService = inject(InstallationEcsService),
     perteEcsRecupService = inject(PerteEcsRecupService),
     besoinFroidService = inject(BesoinFroidService),
     surfaceSudEquivalenteService = inject(SurfaceSudEquivalenteService),
+    perteChRecupService = inject(PerteChRecupService),
     apportGratuitService = inject(ApportGratuitService)
   ) {
     this.#besoinEcsService = besoinEcsService;
+    this.#besoinChService = besoinChService;
     this.#installationEcsService = installationEcsService;
     this.#perteEcsRecupService = perteEcsRecupService;
     this.#besoinFroidService = besoinFroidService;
     this.#surfaceSudEquivalenteService = surfaceSudEquivalenteService;
+    this.#perteChRecupService = perteChRecupService;
     this.#apportGratuitService = apportGratuitService;
   }
 
@@ -80,6 +98,26 @@ export class ApportEtBesoinService {
      */
     this.#installationEcsService.execute(ctx, logement, besoinEcs);
 
+    const apportsInternes = this.#apportGratuitService.apportInterne(ctx, logement);
+    const apportsSolaires = this.#apportGratuitService.apportSolaire(ctx, logement);
+
+    const pertesEcsRecup = this.#perteEcsRecupService.execute(ctx, logement);
+    // Besoin de chauffage hors pertes récupérées
+    const besoinChHP = this.#besoinChService.execute(ctx, logement);
+    const pertesChauffageRecup = this.#perteChRecupService.execute(ctx, logement);
+
+    const besoinCh = {
+      besoin_ch: besoinChHP.besoin_ch_hp,
+      besoin_ch_depensier: besoinChHP.besoin_ch_depensier_hp
+    };
+    besoinCh.besoin_ch -= pertesEcsRecup.pertes_distribution_ecs_recup;
+    besoinCh.besoin_ch -= pertesEcsRecup.pertes_stockage_ecs_recup;
+    besoinCh.besoin_ch -= pertesChauffageRecup.pertes_generateur_ch_recup;
+
+    besoinCh.besoin_ch_depensier -= pertesEcsRecup.pertes_distribution_ecs_recup_depensier;
+    besoinCh.besoin_ch_depensier -= pertesEcsRecup.pertes_stockage_ecs_recup_depensier;
+    besoinCh.besoin_ch_depensier -= pertesChauffageRecup.pertes_generateur_ch_recup_depensier;
+
     return {
       ...besoinEcs,
       ...{
@@ -92,9 +130,11 @@ export class ApportEtBesoinService {
         v40_ecs_journalier_depensier: ctx.nadeq * 79
       },
       ...this.#besoinFroidService.execute(ctx, logement),
-      ...this.#apportGratuitService.apportInterne(ctx, logement),
-      ...this.#apportGratuitService.apportSolaire(ctx, logement),
-      ...this.#perteEcsRecupService.execute(ctx, logement)
+      ...apportsInternes,
+      ...apportsSolaires,
+      ...pertesEcsRecup,
+      ...pertesChauffageRecup,
+      ...besoinCh
     };
   }
 }

package/features/engine/domain/apport_et_besoin/apport-et-besoin.service.spec.js

@@ -7,6 +7,13 @@ import { BesoinFroidService } from './froid/besoin-froid.service.js';
 import { ApportGratuitService } from './apport_gratuit/apport-gratuit.service.js';
 import { PerteEcsRecupService } from './ecs/perte-ecs-recup.service.js';
 import { InstallationEcsService } from '../ecs/installation-ecs.service.js';
+import { PerteChRecupService } from './ch/perte-ch-recup.service.js';
+import { BesoinChService } from './ch/besoin-ch.service.js';
+import corpus from '../../../../../test/corpus-sano.json';
+import { getAdemeFileJson } from '../../../../../test/test-helpers.js';
+import { PRECISION_PERCENT } from '../../../../../test/constant.js';
+import { DpeNormalizerService } from '../../../normalizer/domain/dpe-normalizer.service.js';
+import { ContexteBuilder } from '../contexte.builder.js';
 
 /** @type {SurfaceSudEquivalenteService} **/
 let surfaceSudEquivalenteService;
@@ -26,6 +33,18 @@ let perteEcsRecupService;
 /** @type {ApportGratuitService} **/
 let apportGratuitService;
 
+/** @type {PerteChRecupService} **/
+let perteChRecupService;
+
+/** @type {BesoinChService} **/
+let besoinChService;
+
+/** @type {DpeNormalizerService} **/
+let normalizerService;
+
+/** @type {ContexteBuilder} **/
+let contexteBuilder;
+
 /** @type {ApportEtBesoinService} **/
 let service;
 
@@ -37,18 +56,24 @@ describe('Calcul des apports et besoin du logement', () => {
     tvStore = new BaieVitreeTvStore();
     surfaceSudEquivalenteService = new SurfaceSudEquivalenteService(tvStore);
     besoinEcsService = new BesoinEcsService();
+    besoinChService = new BesoinChService();
     besoinFroidService = new BesoinFroidService();
     installationEcsService = new InstallationEcsService();
     perteEcsRecupService = new PerteEcsRecupService();
     apportGratuitService = new ApportGratuitService();
+    perteChRecupService = new PerteChRecupService();
     service = new ApportEtBesoinService(
       besoinEcsService,
+      besoinChService,
       installationEcsService,
       perteEcsRecupService,
       besoinFroidService,
       surfaceSudEquivalenteService,
+      perteChRecupService,
       apportGratuitService
     );
+    normalizerService = new DpeNormalizerService();
+    contexteBuilder = new ContexteBuilder();
   });
 
   test('Determination des apports et besoin du logement', () => {
@@ -57,6 +82,10 @@ describe('Calcul des apports et besoin du logement', () => {
       besoin_ecs: 1526,
       besoin_ecs_depensier: 2685.3
     });
+    vi.spyOn(besoinChService, 'execute').mockReturnValue({
+      besoin_ch_hp: 2563,
+      besoin_ch_depensier_hp: 3258.6
+    });
     vi.spyOn(besoinFroidService, 'execute').mockReturnValue({
       besoin_fr: 896,
       besoin_fr_depensier: 1025.3
@@ -73,7 +102,12 @@ describe('Calcul des apports et besoin du logement', () => {
     vi.spyOn(perteEcsRecupService, 'execute').mockReturnValue({
       pertes_distribution_ecs_recup: 354.2,
       pertes_distribution_ecs_recup_depensier: 532.6,
-      pertes_stockage_ecs_recup: 25.9
+      pertes_stockage_ecs_recup: 25.9,
+      pertes_stockage_ecs_recup_depensier: 12.9
+    });
+    vi.spyOn(perteChRecupService, 'execute').mockReturnValue({
+      pertes_generateur_ch_recup: 102.2,
+      pertes_generateur_ch_recup_depensier: 153.4
     });
 
     /** @type {Contexte} */
@@ -84,6 +118,8 @@ describe('Calcul des apports et besoin du logement', () => {
       surface_sud_equivalente: 18.5,
       besoin_ecs: 1526,
       besoin_ecs_depensier: 2685.3,
+      besoin_ch: 2080.7000000000003,
+      besoin_ch_depensier: 2559.7,
       besoin_fr: 896,
       besoin_fr_depensier: 1025.3,
       apport_solaire_ch: 5236.9,
@@ -95,7 +131,10 @@ describe('Calcul des apports et besoin du logement', () => {
       v40_ecs_journalier_depensier: 197.5,
       pertes_distribution_ecs_recup: 354.2,
       pertes_distribution_ecs_recup_depensier: 532.6,
-      pertes_stockage_ecs_recup: 25.9
+      pertes_generateur_ch_recup: 102.2,
+      pertes_generateur_ch_recup_depensier: 153.4,
+      pertes_stockage_ecs_recup: 25.9,
+      pertes_stockage_ecs_recup_depensier: 12.9
     });
     expect(surfaceSudEquivalenteService.execute).toHaveBeenCalledWith(ctx, logement.enveloppe);
     expect(besoinEcsService.execute).toHaveBeenCalledWith(ctx);
@@ -103,4 +142,66 @@ describe('Calcul des apports et besoin du logement', () => {
     expect(apportGratuitService.apportSolaire).toHaveBeenCalledWith(ctx, logement);
     expect(apportGratuitService.apportInterne).toHaveBeenCalledWith(ctx, logement);
   });
+
+  describe("Test d'intégration pour les besoins en chauffage", () => {
+    test.each(corpus)(
+      'Vérification de la DI besoin_ch des besoins en chauffage pour dpe %s',
+      (ademeId) => {
+        /**
+         * @type {Dpe}
+         */
+        let dpeRequest = getAdemeFileJson(ademeId);
+        dpeRequest = normalizerService.normalize(dpeRequest);
+
+        dpeRequest.logement.donnees_de_calcul = {
+          apportsInterneDepensier: [],
+          apportsInterneCh: [],
+          apportsSolaire: [],
+          besoinChauffageHP: [],
+          besoinChauffageDepensierHP: []
+        };
+
+        /** @type {Contexte} */
+        const ctx = contexteBuilder.fromDpe(dpeRequest);
+        const apportEtBesoin = service.execute(ctx, dpeRequest.logement);
+
+        expect(
+          Math.abs(
+            apportEtBesoin.besoin_ch - dpeRequest.logement.sortie.apport_et_besoin.besoin_ch
+          ) / (dpeRequest.logement.sortie.apport_et_besoin.besoin_ch || 1)
+        ).toBeLessThan(PRECISION_PERCENT);
+      }
+    );
+
+    test.each(corpus)(
+      'Vérification de la DI besoin_ch_depensier des besoins en chauffage pour dpe %s',
+      (ademeId) => {
+        /**
+         * @type {Dpe}
+         */
+        let dpeRequest = getAdemeFileJson(ademeId);
+        dpeRequest = normalizerService.normalize(dpeRequest);
+
+        dpeRequest.logement.donnees_de_calcul = {
+          apportsInterneDepensier: [],
+          apportsInterneCh: [],
+          apportsSolaire: [],
+          besoinChauffageHP: [],
+          besoinChauffageDepensierHP: []
+        };
+
+        /** @type {Contexte} */
+        const ctx = contexteBuilder.fromDpe(dpeRequest);
+
+        const apportEtBesoin = service.execute(ctx, dpeRequest.logement);
+
+        expect(
+          Math.abs(
+            apportEtBesoin.besoin_ch_depensier -
+              dpeRequest.logement.sortie.apport_et_besoin.besoin_ch_depensier
+          ) / (dpeRequest.logement.sortie.apport_et_besoin.besoin_ch_depensier || 1)
+        ).toBeLessThan(PRECISION_PERCENT);
+      }
+    );
+  });
 });

package/features/engine/domain/apport_et_besoin/apport_gratuit/apport-gratuit.service.js

@@ -46,7 +46,7 @@ export class ApportGratuitService {
 
     return mois_liste.reduce(
       (acc, mois) => {
-        acc.apport_solaire_ch += this.apportSolaireMois(
+        const apportSolaire = this.apportSolaireMois(
           ctx,
           logement.enveloppe,
           mois,
@@ -58,6 +58,9 @@ export class ApportGratuitService {
             ctx.inertie.ilpa
           )
         );
+        acc.apport_solaire_ch += apportSolaire;
+        logement.donnees_de_calcul.apportsSolaire[mois] = apportSolaire;
+
         if (clim.length > 0) {
           acc.apport_solaire_fr += this.apportSolaireMois(
             ctx,
@@ -84,7 +87,7 @@ export class ApportGratuitService {
 
     return mois_liste.reduce(
       (acc, mois) => {
-        acc.apport_interne_ch += this.apportInterneMois(
+        const apportInterne = this.apportInterneMois(
           ctx,
           this.#frTvStore.getData(
             'nref19',
@@ -94,6 +97,19 @@ export class ApportGratuitService {
             ctx.inertie.ilpa
           )
         );
+        acc.apport_interne_ch += apportInterne;
+        logement.donnees_de_calcul.apportsInterneCh[mois] = apportInterne;
+        logement.donnees_de_calcul.apportsInterneDepensier[mois] = this.apportInterneMois(
+          ctx,
+          this.#frTvStore.getData(
+            'nref21',
+            ctx.altitude.value,
+            ctx.zoneClimatique.value,
+            mois,
+            ctx.inertie.ilpa
+          )
+        );
+
         if (clim.length > 0) {
           acc.apport_interne_fr += this.apportInterneMois(
             ctx,

package/features/engine/domain/apport_et_besoin/apport_gratuit/apport-gratuit.service.spec.js

@@ -41,7 +41,10 @@ describe('Calcul des apports gratuits au logement', () => {
     };
 
     /** @type { Logement } **/
-    const logement = { enveloppe: { porte_collection: {} } };
+    const logement = {
+      enveloppe: { porte_collection: {} },
+      donnees_de_calcul: { apportsSolaire: {} }
+    };
 
     if (withClimatisation) {
       logement.climatisation_collection = { climatisation: [{}] };
@@ -81,6 +84,8 @@ describe('Calcul des apports gratuits au logement', () => {
           mois
         );
       }
+
+      expect(logement.donnees_de_calcul.apportsSolaire[mois]).toBe(185000);
     }
   });
 
@@ -106,7 +111,10 @@ describe('Calcul des apports gratuits au logement', () => {
     };
 
     /** @type { Logement } **/
-    const logement = { enveloppe: { porte_collection: {} } };
+    const logement = {
+      enveloppe: { porte_collection: {} },
+      donnees_de_calcul: { apportsInterneCh: {}, apportsInterneDepensier: {} }
+    };
 
     if (withClimatisation) {
       logement.climatisation_collection = { climatisation: [{}] };
@@ -141,6 +149,9 @@ describe('Calcul des apports gratuits au logement', () => {
           mois
         );
       }
+
+      expect(logement.donnees_de_calcul.apportsInterneCh[mois]).toBeCloseTo(1306.33, 2);
+      expect(logement.donnees_de_calcul.apportsInterneDepensier[mois]).toBeCloseTo(1306.33, 2);
     }
   });
 

package/features/engine/domain/apport_et_besoin/ch/besoin-ch.service.js

@@ -0,0 +1,150 @@
+import { mois_liste } from '../../../../../utils.js';
+import { inject } from 'dioma';
+import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
+
+/**
+ * Calcul du besoin en chauffage
+ * Chapitre 2 - Expression du besoin de chauffage
+ *
+ * Methode_de_calcul_3CL_DPE_2021 - Page 7
+ * Octobre 2021
+ * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ */
+export class BesoinChService {
+  /**
+   * @type {FrTvStore}
+   */
+  #tvStore;
+
+  /**
+   * @param tvStore {FrTvStore}
+   */
+  constructor(tvStore = inject(FrTvStore)) {
+    this.#tvStore = tvStore;
+  }
+
+  /**
+   * Besoin de chauffage hors pertes récupérées
+   * 9.1.1 - Consommation de chauffage
+   *
+   * @param ctx {Contexte}
+   * @param logement {Logement}
+   * @return {{besoin_ch_hp: number, besoin_ch_depensier_hp: number, fraction_apport_gratuit_ch: number, fraction_apport_gratuit_depensier_ch: number}}
+   */
+  execute(ctx, logement) {
+    const besoinCh = mois_liste.reduce(
+      (acc, mois) => {
+        const dh19 = this.#tvStore.getData(
+          'dh19',
+          ctx.altitude.value,
+          ctx.zoneClimatique.value,
+          mois,
+          ctx.inertie.ilpa
+        );
+        const dh21 = this.#tvStore.getData(
+          'dh21',
+          ctx.altitude.value,
+          ctx.zoneClimatique.value,
+          mois,
+          ctx.inertie.ilpa
+        );
+
+        const besoinCh = this.besoinChHorsPertesRecuperees(ctx, logement, mois, dh19);
+        acc.besoin_ch_hp += besoinCh.besoinChMoisHP;
+        acc.fraction_apport_gratuit_ch += besoinCh.fractionApportGratuitMois;
+        logement.donnees_de_calcul.besoinChauffageHP[mois] = besoinCh.besoinChMoisHP;
+
+        const besoinChDepensier = this.besoinChHorsPertesRecuperees(ctx, logement, mois, dh21);
+        acc.besoin_ch_depensier_hp += besoinChDepensier.besoinChMoisHP;
+        acc.fraction_apport_gratuit_depensier_ch += besoinChDepensier.fractionApportGratuitMois;
+        logement.donnees_de_calcul.besoinChauffageDepensierHP[mois] =
+          besoinChDepensier.besoinChMoisHP;
+
+        acc.dh19 += dh19;
+        acc.dh21 += dh21;
+        return acc;
+      },
+      {
+        besoin_ch_hp: 0,
+        besoin_ch_depensier_hp: 0,
+        fraction_apport_gratuit_ch: 0,
+        fraction_apport_gratuit_depensier_ch: 0,
+        dh19: 0,
+        dh21: 0
+      }
+    );
+
+    besoinCh.fraction_apport_gratuit_ch /= besoinCh.dh19;
+    besoinCh.fraction_apport_gratuit_depensier_ch /= besoinCh.dh21;
+
+    delete besoinCh.dh19;
+    delete besoinCh.dh19;
+
+    return besoinCh;
+  }
+
+  /**
+   * Fraction des besoins de chauffage couverts par les apports gratuits pour un mois donné
+   * 6.1 Calcul de F
+   *
+   * @param ctx {Contexte}
+   * @param logement {Logement}
+   * @param mois {string}
+   * @param dh {number} - degrés-heures de chauffage sur le mois j (°Ch)
+   * @returns {number}
+   */
+  fractionBesoinCh(ctx, logement, mois, dh) {
+    // Apports internes dans le logement sur le mois
+    const Ai = logement.donnees_de_calcul.apportsInterneCh[mois];
+    // Apports solaires dans le logement sur le mois durant la période de chauffe
+    const As = logement.donnees_de_calcul.apportsSolaire[mois];
+
+    if (dh === 0) return 0;
+
+    let pow;
+    switch (ctx.inertie.id) {
+      // Inertie très lourde ou lourde
+      case 1:
+      case 2:
+        pow = 3.6;
+        break;
+      // Inertie moyenne
+      case 3:
+        pow = 2.9;
+        break;
+      // Inertie légère
+      case 4:
+        pow = 2.5;
+        break;
+    }
+
+    const Xj = (As + Ai) / (logement.sortie.deperdition.deperdition_enveloppe * dh);
+    return (Xj - Xj ** pow) / (1 - Xj ** pow);
+  }
+
+  /**
+   * Besoin de chauffage hors pertes récupérées sur le mois (kWh) :
+   * 9.1.1 - Consommation de chauffage
+   *
+   * Fraction des besoins de chauffage couverts par les apports gratuits sur le mois
+   * 6.1 - Calcul de F
+   *
+   * @param ctx {Contexte}
+   * @param logement {Logement}
+   * @param mois {string}
+   * @param dh {number} - degrés-heures de chauffage sur le mois j (°Ch)
+   * @returns {{besoinChMoisHP: number, fractionApportGratuitMois: number}}
+   */
+  besoinChHorsPertesRecuperees(ctx, logement, mois, dh) {
+    // Fraction des besoins de chauffage couverts par les apports gratuits pour un mois donné
+    const F = this.fractionBesoinCh(ctx, logement, mois, dh);
+
+    // Besoin de chauffage d’un logement par kelvin sur le mois j (W/K)
+    const BV = logement.sortie.deperdition.deperdition_enveloppe * (1 - F);
+
+    return {
+      besoinChMoisHP: (BV * dh) / 1000,
+      fractionApportGratuitMois: F * dh
+    };
+  }
+}