@open3cl/engine 1.0.6 → 1.0.8

package/features/engine/domain/enveloppe/plancher_bas/deperdition-plancher-bas.service.spec.js

@@ -0,0 +1,200 @@
+import corpus from '../../../../../../test/corpus-sano.json';
+import { getAdemeFileJson } from '../../../../../../test/test-helpers.js';
+import { ContexteBuilder } from '../../contexte.builder.js';
+import { DpeNormalizerService } from '../../../../normalizer/domain/dpe-normalizer.service.js';
+import { DeperditionPlancherBasService } from './deperdition-plancher-bas.service.js';
+import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
+import { beforeEach, describe, expect, test } from 'vitest';
+
+/** @type {DeperditionPlancherBasService} **/
+let service;
+
+/** @type {DpeNormalizerService} **/
+let normalizerService;
+
+/** @type {ContexteBuilder} **/
+let contexteBuilder;
+
+describe('Calcul de déperdition des planchers bas', () => {
+  beforeEach(() => {
+    service = new DeperditionPlancherBasService(new TvStore());
+    normalizerService = new DpeNormalizerService();
+    contexteBuilder = new ContexteBuilder();
+  });
+
+  describe('Determination de upb, upb0 et upb_final', () => {
+    test('Plancher  1 - Dalle béton non isolée donnant sur un terre-plein', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '5',
+        enum_type_plancher_bas_id: '9',
+        enum_methode_saisie_u0_id: '2',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '1',
+        calcul_ue: 1,
+        perimetre_ue: 19.2,
+        ue: 0.49684211
+      };
+
+      const di = service.execute(ctx, de, []);
+      expect(di.upb).toBeCloseTo(2);
+      expect(di.upb0).toBeCloseTo(2);
+      expect(di.upb_final).toBeCloseTo(0.49684211);
+    });
+
+    test('Plancher  1 - Plancher lourd type entrevous terre-cuite, poutrelles béton donnant sur un sous-sol non chauffé avec isolation intrinsèque ou en sous-face (5 cm)', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '6',
+        enum_type_plancher_bas_id: '11',
+        enum_methode_saisie_u0_id: '2',
+        enum_type_isolation_id: '4',
+        epaisseur_isolation: 5,
+        enum_methode_saisie_u_id: '3',
+        calcul_ue: 0,
+        perimetre_ue: 27,
+        surface_ue: 42.08,
+        ue: 0.37117494
+      };
+
+      const di = service.execute(ctx, de, [{ donnee_entree: de }]);
+      expect(di.upb).toBeCloseTo(0.59154929577464788);
+      expect(di.upb0).toBeCloseTo(2);
+      expect(di.upb_final).toBeCloseTo(0.37117494);
+    });
+
+    test('Plancher  2 - Plancher avec ou sans remplissage non isolé donnant sur un garage', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_bas_id: '2',
+        enum_methode_saisie_u0_id: '2',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '1',
+        calcul_ue: 0
+      };
+
+      const di = service.execute(ctx, de, []);
+      expect(di.upb).toBeCloseTo(1.45);
+      expect(di.upb0).toBeCloseTo(1.45);
+      expect(di.upb_final).toBeCloseTo(1.45);
+    });
+
+    test('Test de plancher avec upb0 saisie', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_bas_id: '2',
+        enum_methode_saisie_u0_id: '9',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '1',
+        calcul_ue: 0,
+        upb0_saisi: 3.2
+      };
+
+      const di = service.execute(ctx, de, []);
+      expect(di.upb).toBeCloseTo(2);
+      expect(di.upb0).toBeCloseTo(3.2);
+      expect(di.upb_final).toBeCloseTo(2);
+    });
+
+    test('Test de plancher avec type de paroi inconnue', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_bas_id: '1',
+        enum_methode_saisie_u0_id: '1',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '1',
+        calcul_ue: 0
+      };
+
+      const di = service.execute(ctx, de, []);
+      expect(di.upb).toBeCloseTo(2);
+      expect(di.upb0).toBeCloseTo(2);
+      expect(di.upb_final).toBeCloseTo(2);
+    });
+
+    test('Test de plancher avec upb directement saisie', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherBasDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_bas_id: '1',
+        enum_methode_saisie_u0_id: '5',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '9',
+        calcul_ue: 0,
+        upb_saisi: 1.25
+      };
+
+      const di = service.execute(ctx, de, []);
+      expect(di.upb).toBeCloseTo(1.25);
+      expect(di.upb0).toBeUndefined();
+      expect(di.upb_final).toBeCloseTo(1.25);
+    });
+  });
+
+  describe("Test d'intégration de plancher bas", () => {
+    test.each(corpus)('vérification des DI des pb pour dpe %s', (ademeId) => {
+      /**
+       * @type {Dpe}
+       */
+      let dpeRequest = getAdemeFileJson(ademeId);
+      dpeRequest = normalizerService.normalize(dpeRequest);
+
+      /** @type {Contexte} */
+      const ctx = contexteBuilder.fromDpe(dpeRequest);
+
+      /** @type {PlancherBas[]} */
+      const pbs = dpeRequest.logement.enveloppe.plancher_bas_collection?.plancher_bas || [];
+
+      pbs.forEach((pb) => {
+        const di = service.execute(ctx, pb.donnee_entree, pbs);
+
+        if (pb.donnee_intermediaire) {
+          expect(di.upb0).toBeCloseTo(pb.donnee_intermediaire.upb0, 2);
+        } else {
+          expect(di.upb0).toBeUndefined();
+        }
+        expect(di.upb_final).toBeCloseTo(pb.donnee_intermediaire.upb_final, 2);
+        expect(di.b).toBeCloseTo(pb.donnee_intermediaire.b, 2);
+      });
+    });
+  });
+});

package/features/engine/domain/enveloppe/plancher_haut/deperdition-plancher-haut.service.js

@@ -0,0 +1,136 @@
+import { inject } from 'dioma';
+import { PRECISION } from '../../constants.js';
+import { DeperditionService } from '../deperdition.service.js';
+import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
+
+/**
+ * Calcul des déperditions de l’enveloppe GV
+ * Chapitre 3.2.3 Calcul des planchers haut
+ *
+ * Méthode de calcul 3CL-DPE 2021
+ * Octobre 2021
+ * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ */
+export class DeperditionPlancherHautService extends DeperditionService {
+  /**
+   * @param tvStore {TvStore}
+   */
+  constructor(tvStore = inject(TvStore)) {
+    super(tvStore);
+  }
+
+  /**
+   * @param ctx {Contexte}
+   * @param phDE {PlancherHautDE}
+   * @return {PlancherHautDI}
+   */
+  execute(ctx, phDE) {
+    const uph0 = this.#uph0(phDE);
+    const uph = this.#uph(phDE, uph0, ctx);
+    const b = this.b({
+      enumTypeAdjacenceId: phDE.enum_type_adjacence_id,
+      surfaceAiu: phDE.surface_aiu,
+      surfaceAue: phDE.surface_aue,
+      enumCfgIsolationLncId: phDE.enum_cfg_isolation_lnc_id,
+      zoneClimatiqueId: ctx.zoneClimatiqueId
+    });
+
+    /** @type {PlancherHautDI} */
+    return { uph0, uph, b };
+  }
+
+  /**
+   * @param phDE {PlancherHautDE}
+   * @param uph0 {number}
+   * @param ctx {Contexte}
+   * @return {number|undefined}
+   */
+  #uph(phDE, uph0, ctx) {
+    // On determine uph_nu (soit uph0 soit 2 comme valeur minimale forfaitaire)
+    const uphNu = Math.min(uph0, 2.5);
+
+    const enumPeriodeIsolationId = this.getEnumPeriodeIsolationId(
+      phDE.enum_periode_isolation_id,
+      ctx
+    );
+
+    // Selon l'isolation, on applique un calcul au uph nu pour simuler son isolation
+    let uph;
+    switch (phDE.enum_methode_saisie_u_id) {
+      case '1':
+        // non isolé
+        uph = uphNu;
+        break;
+      case '2': // isolation inconnue (table forfaitaire)
+      case '7': // année d'isolation différente de l'année de construction
+      case '8': // année de construction saisie
+        uph = Math.min(
+          uphNu,
+          this.tvStore.getUph(
+            enumPeriodeIsolationId,
+            this.#getTypeAdjacence(phDE),
+            ctx.zoneClimatiqueId,
+            ctx.effetJoule
+          )
+        );
+        break;
+      case '3': // epaisseur isolation saisie justifiée par mesure ou observation
+      case '4': // epaisseur isolation saisie (en cm)
+        uph = 1 / (1 / uphNu + (phDE.epaisseur_isolation * 0.01) / 0.04);
+        break;
+      case '5':
+      case '6': // resistance isolation saisie
+        uph = 1 / (1 / uphNu + phDE.resistance_isolation);
+        break;
+      default: // saisie direct de la valeur de u
+        uph = phDE.uph_saisi;
+        break;
+    }
+
+    return Math.round(parseFloat(uph) * PRECISION) / PRECISION;
+  }
+
+  /**
+   * @param phDE {PlancherHautDE}
+   * @return {number|undefined}
+   */
+  #uph0(phDE) {
+    let uph0;
+    switch (phDE.enum_methode_saisie_u0_id) {
+      case '1':
+      case '2':
+        // type de paroi inconnu (valeur par défaut)
+        // déterminé selon le matériau et épaisseur à partir de la table de valeur forfaitaire
+        uph0 = this.tvStore.getUph0(phDE.enum_type_plancher_haut_id);
+        break;
+      case '5':
+        // u0 non saisi car le u est saisi connu et justifié
+        return;
+      default:
+        // Valeur saisie
+        return phDE.uph0_saisi;
+    }
+
+    return uph0;
+  }
+
+  /**
+   * Retourne le type d'adjacence à utiliser combles ou terrasse
+   * @see Méthode de calcul 3CL-DPE 2021 (cotobre 2021) chapitre 3.2.3.1
+   * "Lorsque le local au-dessus du logement est un local non chauffé, ou un local autre que d’habitation., Uph_tab est pris dans la catégorie « Terrasse »."
+   * @param phDE {PlancherHautDE}
+   * @return {'combles'|'terasse'}
+   */
+  #getTypeAdjacence(phDE) {
+    switch (phDE.enum_type_adjacence_id) {
+      case '1':
+        // extérieur - type de ph != 'combles aménagés sous rampant'
+        return phDE.enum_type_plancher_haut_id === '12' ? 'combles' : 'terrasse';
+      case '7':
+        // locaux non chauffés non accessible
+        return 'terrasse';
+      default:
+        return 'combles';
+    }
+  }
+}

package/features/engine/domain/enveloppe/plancher_haut/deperdition-plancher-haut.service.spec.js

@@ -0,0 +1,211 @@
+import { getAdemeFileJson } from '../../../../../../test/test-helpers.js';
+import { ContexteBuilder } from '../../contexte.builder.js';
+import { DpeNormalizerService } from '../../../../normalizer/domain/dpe-normalizer.service.js';
+import { DeperditionPlancherHautService } from './deperdition-plancher-haut.service.js';
+import corpus from '../../../../../../test/corpus-sano.json';
+import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
+import { beforeEach, describe, expect, test } from 'vitest';
+
+/** @type {DeperditionPlancherHautService} **/
+let service;
+
+/** @type {DpeNormalizerService} **/
+let normalizerService;
+
+/** @type {ContexteBuilder} **/
+let contexteBuilder;
+
+describe('Calcul de déperdition des planchers haut', () => {
+  beforeEach(() => {
+    service = new DeperditionPlancherHautService(new TvStore());
+    normalizerService = new DpeNormalizerService();
+    contexteBuilder = new ContexteBuilder();
+  });
+
+  describe('Determination de uph, uph0 et uph_final', () => {
+    test('(2187E1039187C) Plafond 2 : plafond bois sous solives bois', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '2',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '1',
+        enum_type_plancher_haut_id: '10',
+        enum_methode_saisie_u0_id: '2',
+        enum_type_isolation_id: '9',
+        enum_periode_isolation_id: '3',
+        enum_methode_saisie_u_id: '8'
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(2.3);
+      expect(di.uph).toBeCloseTo(0.75);
+    });
+
+    test("(2287E0224445X) Plafond  2 - Plafond structure inconnu (sous combles perdus) donnant sur l'extérieur (combles aménagés) avec isolation intérieure (réalisée entre 1989 et 2000)", () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '1',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '1', // extérieur
+        enum_type_plancher_haut_id: '1', // inconnu
+        enum_methode_saisie_u0_id: '2', // déterminé selon le matériau et épaisseur à partir de la table de valeur forfaitaire
+        enum_type_isolation_id: '3', // iti
+        enum_periode_isolation_id: '6', // 1989-2000
+        enum_methode_saisie_u_id: '7' // année d'isolation différente de l'année de construction saisie justifiée (table forfaitaire)
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(2.5);
+      expect(di.uph).toBeCloseTo(0.4); // Dans le DPE d'origine, uph (0.25) est pris dans la partie "comble" et pas "terrasse" alors que le local donne sur l'extérieur
+      expect(di.b).toBeCloseTo(1);
+    });
+
+    test("(2387E0562437Q) Plafond  2 - Plafond structure inconnu (sous combles perdus) donnant sur l'extérieur (combles aménagés) avec isolation intérieure (réalisée entre 1989 et 2000)", () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: true,
+        enumPeriodeConstructionId: '1',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '1', // extérieur
+        enum_type_plancher_haut_id: '1', // inconnu
+        enum_methode_saisie_u0_id: '2', // déterminé selon le matériau et épaisseur à partir de la table de valeur forfaitaire
+        enum_type_isolation_id: '3', // iti
+        enum_periode_isolation_id: '8', // 2006-2012
+        enum_methode_saisie_u_id: '7' // année d'isolation différente de l'année de construction saisie justifiée (table forfaitaire)
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(2.5);
+      expect(di.uph).toBeCloseTo(0.27); // Dans le DPE d'origine, uph (0.2) est pris dans la partie "comble" et pas "terrasse" alors que le local donne sur l'extérieur
+      expect(di.b).toBeCloseTo(1);
+    });
+
+    test("(2287E0272588O) Plafond - Combles aménagés sous rampants donnant sur l'extérieur (combles aménagés) avec isolation intérieure (réalisée entre 1975 et 1977)", () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: true,
+        enumPeriodeConstructionId: '1',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '1', // extérieur
+        enum_type_plancher_haut_id: '12', // combles aménagés sous rampant
+        enum_methode_saisie_u0_id: '2', // déterminé selon le matériau et épaisseur à partir de la table de valeur forfaitaire
+        enum_type_isolation_id: '3', // iti
+        enum_periode_isolation_id: '3', // 1975-1977
+        enum_methode_saisie_u_id: '7' // année d'isolation différente de l'année de construction saisie justifiée (table forfaitaire)
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(2.5);
+      expect(di.uph).toBeCloseTo(0.5);
+      expect(di.b).toBeCloseTo(1);
+    });
+
+    test('Test de plancher avec uph directement saisie', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_haut_id: '1',
+        enum_methode_saisie_u0_id: '5',
+        enum_type_isolation_id: '2',
+        enum_methode_saisie_u_id: '9',
+        uph_saisi: 1.25
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph).toBeCloseTo(1.25);
+      expect(di.uph0).toBeUndefined();
+    });
+
+    test('Test de plancher avec uph0 directement saisie', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '21',
+        enum_type_plancher_haut_id: '1',
+        enum_methode_saisie_u0_id: '3',
+        enum_type_isolation_id: '2',
+        enum_periode_isolation_id: '3',
+        enum_methode_saisie_u_id: '7',
+        uph0_saisi: 1.25
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(1.25);
+      expect(di.uph).toBeCloseTo(0.5);
+    });
+
+    test('Test de plancher avec uph0 type de paroi inconnu (valeur par défaut)', () => {
+      /** @type {Contexte} */
+      const ctx = {
+        effetJoule: false,
+        enumPeriodeConstructionId: '6',
+        zoneClimatiqueId: '3'
+      };
+      /** @type {PlancherHautDE} */
+      const de = {
+        enum_type_adjacence_id: '1',
+        enum_type_plancher_haut_id: '1',
+        enum_methode_saisie_u0_id: '1',
+        enum_type_isolation_id: '1',
+        enum_methode_saisie_u_id: '7'
+      };
+
+      const di = service.execute(ctx, de);
+      expect(di.uph0).toBeCloseTo(2.5);
+      expect(di.uph).toBeCloseTo(0.4);
+    });
+  });
+
+  describe("Test d'intégration de plancher haut", () => {
+    test.each(corpus)('vérification des DI des ph pour dpe %s', (ademeId) => {
+      /**
+       * @type {Dpe}
+       */
+      let dpeRequest = getAdemeFileJson(ademeId);
+      dpeRequest = normalizerService.normalize(dpeRequest);
+
+      /** @type {Contexte} */
+      const ctx = contexteBuilder.fromDpe(dpeRequest);
+
+      /** @type {PlancherHaut[]} */
+      const phs = dpeRequest.logement.enveloppe.plancher_haut_collection?.plancher_haut || [];
+
+      phs.forEach((ph) => {
+        const di = service.execute(ctx, ph.donnee_entree);
+
+        if (ph.donnee_intermediaire) {
+          expect(di.uph0).toBeCloseTo(ph.donnee_intermediaire.uph0, 2);
+        } else {
+          expect(di.uph0).toBeUndefined();
+        }
+        expect(di.uph).toBeCloseTo(ph.donnee_intermediaire.uph, 2);
+        expect(di.b).toBeCloseTo(ph.donnee_intermediaire.b, 2);
+      });
+    });
+  });
+});

package/features/engine/domain/enveloppe/porte/deperdition-porte.service.js

@@ -0,0 +1,56 @@
+import { inject } from 'dioma';
+import { DeperditionService } from '../deperdition.service.js';
+import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
+
+/**
+ * Calcul des déperditions de l’enveloppe GV
+ * Chapitre 3.3.4 Coefficients U des portes
+ *
+ * Méthode de calcul 3CL-DPE 2021
+ * Octobre 2021
+ * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ *
+ * Si le coefficient U des portes est connu et justifié, le saisir directement. Sinon, prendre les valeurs tabulées
+ */
+export class DeperditionPorteService extends DeperditionService {
+  /**
+   * @param tvStore {TvStore}
+   */
+  constructor(tvStore = inject(TvStore)) {
+    super(tvStore);
+  }
+
+  /**
+   * @param ctx {Contexte}
+   * @param porteDE {PorteDE}
+   * @return {PorteDI}
+   */
+  execute(ctx, porteDE) {
+    /** @type {PorteDI} */
+    const di = {
+      uporte: undefined,
+      b: undefined
+    };
+
+    // @todo : Une porte vitrée avec plus de 60% de vitrage est traitée comme une porte-fenêtre avec soubassement.
+
+    if (['2', '3'].includes(porteDE.enum_methode_saisie_uporte_id)) {
+      // valeur justifiée saisie à partir des documents justificatifs autorisés
+      // saisie direct U depuis RSET/RSEE( etude RT2012/RE2020)
+      di.uporte = porteDE.uporte_saisi;
+    } else {
+      // valeur forfaitaire
+      di.uporte = this.tvStore.getUPorte(porteDE.enum_type_porte_id);
+    }
+
+    di.b = this.b({
+      enumTypeAdjacenceId: porteDE.enum_type_adjacence_id,
+      surfaceAiu: porteDE.surface_aiu,
+      surfaceAue: porteDE.surface_aue,
+      enumCfgIsolationLncId: porteDE.enum_cfg_isolation_lnc_id,
+      zoneClimatiqueId: ctx.zoneClimatiqueId
+    });
+
+    return di;
+  }
+}