@open3cl/engine 1.11.3 → 1.11.4

package/features/dpe/domain/models/baie-ets.model.ts

@@ -3,7 +3,7 @@
 import type {
   XsdLogementEnveloppeEtsBaieEts,
   XsdLogementEnveloppeEtsBaieEtsDonneeEntree
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type BaieEts = XsdLogementEnveloppeEtsBaieEts;
 export type BaieEtsDE = XsdLogementEnveloppeEtsBaieEtsDonneeEntree;

package/features/dpe/domain/models/baie-vitree.model.ts

@@ -8,14 +8,18 @@ import type {
   XsdLogementEnveloppeBaieVitreeDonneeEntree,
   XsdLogementEnveloppeBaieVitreeDonneeEntreeMasqueLointainNonHomogene,
   XsdLogementEnveloppeBaieVitreeDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 /** + `donnee_utilisateur` Open3CL hors XSD. */
 export type BaieVitree = XsdLogementEnveloppeBaieVitree & {
   donnee_utilisateur?: Record<string, any>;
 };
 export type BaieVitreeDE = XsdLogementEnveloppeBaieVitreeDonneeEntree;
-export type BaieVitreeDI = XsdLogementEnveloppeBaieVitreeDonneeIntermediaire;
+/** + facteurs d'ensoleillement `fe1` / `fe2` (masques proches / lointains) calculés par le moteur hors XSD. */
+export type BaieVitreeDI = XsdLogementEnveloppeBaieVitreeDonneeIntermediaire & {
+  fe1?: number;
+  fe2?: number;
+};
 export type BaieVitreeDoubleFenetre = XsdLogementEnveloppeBaieVitreeBaieVitreeDoubleFenetre;
 export type BaieVitreeDoubleFenetreDE =
   XsdLogementEnveloppeBaieVitreeBaieVitreeDoubleFenetreDonneeEntree;

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

@@ -4,7 +4,7 @@ import type {
   XsdLogementClimatisation,
   XsdLogementClimatisationDonneeEntree,
   XsdLogementClimatisationDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export interface Climatisation extends Omit<XsdLogementClimatisation, 'donnee_intermediaire'> {
   donnee_intermediaire?: ClimatisationDI;

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

@@ -11,19 +11,19 @@ import type {
   XsdLogementEnveloppe,
   XsdLogementMeteo,
   XsdTAdresse
-} from './dpe-xsd.generated';
-import type { BaieVitree } from './baie-vitree.model';
-import type { Climatisation } from './climatisation.model';
-import type { Ets } from './ets.model';
-import type { InstallationChauffage } from './installation-chauffage.model';
-import type { InstallationEcs } from './installation-ecs.model';
-import type { Mur } from './mur.model';
-import type { PlancherBas, PlancherHaut } from './plancher.model';
-import type { PontThermique } from './pont-thermique.model';
-import type { Porte } from './porte.model';
-import type { ProductionElecEnr } from './production-elec-enr.model';
-import type { Sortie } from './sortie.model';
-import type { Ventilation } from './ventilation.model';
+} from './dpe-xsd.generated.js';
+import type { BaieVitree } from './baie-vitree.model.js';
+import type { Climatisation } from './climatisation.model.js';
+import type { Ets } from './ets.model.js';
+import type { InstallationChauffage } from './installation-chauffage.model.js';
+import type { InstallationEcs } from './installation-ecs.model.js';
+import type { Mur } from './mur.model.js';
+import type { PlancherBas, PlancherHaut } from './plancher.model.js';
+import type { PontThermique } from './pont-thermique.model.js';
+import type { Porte } from './porte.model.js';
+import type { ProductionElecEnr } from './production-elec-enr.model.js';
+import type { Sortie } from './sortie.model.js';
+import type { Ventilation } from './ventilation.model.js';
 
 // Types issus du XSD (générés) : voir dpe-xsd.generated.ts
 export type Administratif = XsdAdministratif;
@@ -124,15 +124,8 @@ export interface DE {
   reference?: string;
 }
 
-export enum TypeHabitation {
-  MAISON = 'MAISON',
-  APPARTEMENT = 'APPARTEMENT',
-  IMMEUBLE = 'IMMEUBLE'
-}
-export enum TypeDpe {
-  MAISON = 'MAISON',
-  APPARTEMENT = 'APPARTEMENT',
-  IMMEUBLE = 'IMMEUBLE'
-}
+/** Types définis à l'exécution dans type-habitation.model.js. */
+export type TypeHabitation = 'MAISON' | 'APPARTEMENT' | 'IMMEUBLE';
+export type TypeDpe = 'MAISON' | 'APPARTEMENT' | 'APPARTEMENT_A_PARTIR_IMMEUBLE' | 'IMMEUBLE';
 
 export type FullDpe = Dpe;

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

@@ -4,7 +4,7 @@ import type {
   XsdLogementEnveloppeEts,
   XsdLogementEnveloppeEtsDonneeEntree,
   XsdLogementEnveloppeEtsDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type Ets = XsdLogementEnveloppeEts;
 export type EtsDE = XsdLogementEnveloppeEtsDonneeEntree;

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

@@ -8,7 +8,7 @@ import type {
   XsdLogementInstallationChauffageGenerateurChauffage,
   XsdLogementInstallationChauffageGenerateurChauffageDonneeEntree,
   XsdLogementInstallationChauffageGenerateurChauffageDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 /** + champ Open3CL hors XSD : `ficheTechniqueComptage` (fiche technique). */
 export type InstallationChauffageDE = XsdLogementInstallationChauffageDonneeEntree & {
@@ -27,15 +27,56 @@ export type EmetteurChauffageDI =
   XsdLogementInstallationChauffageEmetteurChauffageDonneeIntermediaire & {
     lb?: number;
   };
-export type GenerateurChauffageDE = XsdLogementInstallationChauffageGenerateurChauffageDonneeEntree;
-export type GenerateurChauffageDI =
-  XsdLogementInstallationChauffageGenerateurChauffageDonneeIntermediaire;
+/** Champs communs aux générateurs (chauffage et ECS) ajoutés par le moteur hors XSD, en entrée. */
+export interface GenerateurDEMoteur {
+  /** Année d'installation (issue de la saisie ou de la fiche technique). */
+  annee_installation?: number | string;
+  /** 1 si le générateur a un ventilateur (chaudières bois). */
+  presenceVentilateur?: number;
+  /** 1 si le générateur est à ventilateur de combustion (renseigné par le moteur, §13.2). */
+  ventilateurCombustion?: number;
+  ratio_virtualisation?: number | null;
+  enum_type_installation_id?: string | null;
+  enum_type_generateur_ecs_id?: string | null;
+  enum_periode_installation_ecs_thermo_id?: string | null;
+  volume_stockage?: number | null;
+  /** Clé de répartition de la consommation ECS (copiée de l'installation par le moteur). */
+  cle_repartition_ecs?: number | null;
+  /** Clé de répartition de la consommation de chauffage (copiée de l'installation par le moteur). */
+  cle_repartition_ch?: number | null;
+}
 
-export enum TypeGenerateur {
-  CHAUDIERE = 'CHAUDIERE',
-  OTHER = 'OTHER'
+/** Champs communs aux générateurs (chauffage et ECS) calculés par le moteur hors XSD. */
+export interface GenerateurDIMoteur {
+  /** Rendement de génération (PAC) : scop ou cop. */
+  rg?: number | null;
+  /** Rendement de génération du cas dépensier (PAC). */
+  rg_dep?: number | null;
+  scop?: number | null;
+  cop?: number | null;
+  /** Puissance de la veilleuse (W). */
+  pveil?: number | null;
 }
 
+/** + champs calculés/renseignés par le moteur hors XSD. */
+export type GenerateurChauffageDE =
+  XsdLogementInstallationChauffageGenerateurChauffageDonneeEntree &
+    GenerateurDEMoteur & {
+      /** Nombre d'installations de chauffage de l'immeuble (rdim). */
+      rdim_installation_ch?: number;
+      /** true si `rdim` a été reconstitué pour un DPE à l'immeuble. */
+      rdim_reconstitue?: boolean;
+      /** Nombre de niveaux de l'installation (copié de l'installation par le moteur). */
+      nombre_niveau_installation_ch?: number;
+      /** Surface chauffée par l'installation (copiée de l'installation par le moteur). */
+      surface_chauffee?: number;
+    };
+export type GenerateurChauffageDI =
+  XsdLogementInstallationChauffageGenerateurChauffageDonneeIntermediaire & GenerateurDIMoteur;
+
+/** Type de générateur (défini à l'exécution dans type-generateur.model.js). */
+export type TypeGenerateur = 'CHAUDIERE' | 'OTHER';
+
 /** Donnée utilisateur propre à Open3CL (absente du XSD). */
 export interface GenerateurChauffageDU {
   /** Valeurs intermédiaires ajoutées dynamiquement par le moteur (ex. conso_ch_appoint_bijonction). */
@@ -57,7 +98,12 @@ export interface GenerateurChauffageDU {
   };
 }
 
-export interface GenerateurChauffage extends XsdLogementInstallationChauffageGenerateurChauffage {
+export interface GenerateurChauffage extends Omit<
+  XsdLogementInstallationChauffageGenerateurChauffage,
+  'donnee_entree' | 'donnee_intermediaire'
+> {
+  donnee_entree: GenerateurChauffageDE;
+  donnee_intermediaire?: GenerateurChauffageDI;
   donnee_utilisateur?: GenerateurChauffageDU;
 }
 

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

@@ -5,12 +5,24 @@ import type {
   XsdLogementInstallationEcsGenerateurEcs,
   XsdLogementInstallationEcsGenerateurEcsDonneeEntree,
   XsdLogementInstallationEcsGenerateurEcsDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
+import type { GenerateurDEMoteur, GenerateurDIMoteur } from './installation-chauffage.model.js';
 
 export type InstallationEcsDE = XsdLogementInstallationEcsDonneeEntree;
-export type InstallationEcsDI = XsdLogementInstallationEcsDonneeIntermediaire;
-export type GenerateurEcsDE = XsdLogementInstallationEcsGenerateurEcsDonneeEntree;
-export type GenerateurEcsDI = XsdLogementInstallationEcsGenerateurEcsDonneeIntermediaire;
+/** + champs calculés par le moteur hors XSD. */
+export type InstallationEcsDI = XsdLogementInstallationEcsDonneeIntermediaire & {
+  /** Longueur de boucle de distribution ECS (m). */
+  lb?: number;
+  /** Consommation des auxiliaires de distribution ECS. */
+  conso_auxiliaire_distribution_ecs?: number;
+  /** true si rdim est neutralisé pour l'installation. */
+  rdim_neutralise?: boolean;
+};
+/** + champs calculés/renseignés par le moteur hors XSD. */
+export type GenerateurEcsDE = XsdLogementInstallationEcsGenerateurEcsDonneeEntree &
+  GenerateurDEMoteur;
+export type GenerateurEcsDI = XsdLogementInstallationEcsGenerateurEcsDonneeIntermediaire &
+  GenerateurDIMoteur;
 
 /** Donnée utilisateur propre à Open3CL (absente du XSD) : valeurs intermédiaires du moteur. */
 export interface InstallationEcsDU {
@@ -26,14 +38,20 @@ export interface GenerateurEcsDU {
   Qgw?: number;
 }
 
-export interface GenerateurEcs extends XsdLogementInstallationEcsGenerateurEcs {
+export interface GenerateurEcs extends Omit<
+  XsdLogementInstallationEcsGenerateurEcs,
+  'donnee_entree' | 'donnee_intermediaire'
+> {
+  donnee_entree: GenerateurEcsDE;
+  donnee_intermediaire?: GenerateurEcsDI;
   donnee_utilisateur?: GenerateurEcsDU;
 }
 
 export interface InstallationEcs extends Omit<
   XsdLogementInstallationEcs,
-  'generateur_ecs_collection'
+  'generateur_ecs_collection' | 'donnee_intermediaire'
 > {
+  donnee_intermediaire?: InstallationEcsDI;
   donnee_utilisateur?: InstallationEcsDU;
   generateur_ecs_collection: { generateur_ecs: GenerateurEcs[] };
 }

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

@@ -4,7 +4,7 @@ import type {
   XsdLogementEnveloppeMur,
   XsdLogementEnveloppeMurDonneeEntree,
   XsdLogementEnveloppeMurDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type Mur = XsdLogementEnveloppeMur;
 export type MurDE = XsdLogementEnveloppeMurDonneeEntree;

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

@@ -7,7 +7,7 @@ import type {
   XsdLogementEnveloppePlancherHaut,
   XsdLogementEnveloppePlancherHautDonneeEntree,
   XsdLogementEnveloppePlancherHautDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type PlancherBas = XsdLogementEnveloppePlancherBas;
 export type PlancherBasDE = XsdLogementEnveloppePlancherBasDonneeEntree;

package/features/dpe/domain/models/pont-thermique.model.ts

@@ -4,7 +4,7 @@ import type {
   XsdLogementEnveloppePontThermique,
   XsdLogementEnveloppePontThermiqueDonneeEntree,
   XsdLogementEnveloppePontThermiqueDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type PontThermique = XsdLogementEnveloppePontThermique;
 export type PontThermiqueDE = XsdLogementEnveloppePontThermiqueDonneeEntree;

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

@@ -4,7 +4,7 @@ import type {
   XsdLogementEnveloppePorte,
   XsdLogementEnveloppePorteDonneeEntree,
   XsdLogementEnveloppePorteDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type Porte = XsdLogementEnveloppePorte;
 export type PorteDE = XsdLogementEnveloppePorteDonneeEntree;

package/features/dpe/domain/models/production-elec-enr.model.ts

@@ -5,7 +5,7 @@ import type {
   XsdLogementProductionElecEnrDonneeEntree,
   XsdLogementProductionElecEnrDonneeIntermediaire,
   XsdLogementProductionElecEnrPanneauxPv
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export type ProductionElecEnr = XsdLogementProductionElecEnr;
 export type ProductionElecEnrDE = XsdLogementProductionElecEnrDonneeEntree;

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

@@ -12,7 +12,7 @@ import type {
   XsdLogementSortieProductionElectricite,
   XsdLogementSortieQualiteIsolation,
   XsdLogementSortieSortieParEnergie
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export interface Sortie extends Omit<XsdLogementSortie, 'ep_conso'> {
   ep_conso: EpConso;

package/features/dpe/domain/models/type-generateur.model.js

@@ -1,7 +1,8 @@
 /**
- * @type {{[key: string]: string}}
+ * Valeur de TypeGenerateur.
+ * @typedef {'CHAUDIERE' | 'OTHER'} TypeGenerateur
  */
-export const TypeGenerateur = {
+export const TypeGenerateur = /** @type {const} */ ({
   CHAUDIERE: 'CHAUDIERE',
   OTHER: 'OTHER'
-};
+});

package/features/dpe/domain/models/type-habitation.model.js

@@ -1,17 +1,19 @@
 /**
- * @type {{[key: string]: string}}
+ * Valeur d'un type d'habitation (MAISON | APPARTEMENT | IMMEUBLE).
+ * @typedef {'MAISON' | 'APPARTEMENT' | 'IMMEUBLE'} TypeHabitation
  */
-export const TypeHabitation = {
+export const TypeHabitation = /** @type {const} */ ({
   MAISON: 'MAISON',
   APPARTEMENT: 'APPARTEMENT',
   IMMEUBLE: 'IMMEUBLE'
-};
+});
 /**
- * @type {{[key: string]: string}}
+ * Valeur d'un type de DPE.
+ * @typedef {'MAISON' | 'APPARTEMENT' | 'APPARTEMENT_A_PARTIR_IMMEUBLE' | 'IMMEUBLE'} TypeDpe
  */
-export const TypeDpe = {
+export const TypeDpe = /** @type {const} */ ({
   MAISON: 'MAISON',
   APPARTEMENT: 'APPARTEMENT',
   APPARTEMENT_A_PARTIR_IMMEUBLE: 'APPARTEMENT_A_PARTIR_IMMEUBLE',
   IMMEUBLE: 'IMMEUBLE'
-};
+});

package/features/dpe/domain/models/type-stockage.model.js

@@ -1,8 +1,9 @@
 /**
- * @type {{[key: string]: string}}
+ * Valeur de TypeStockage.
+ * @typedef {'INSTANTANE' | 'INTEGRE' | 'INDEPENDANT'} TypeStockage
  */
-export const TypeStockage = {
+export const TypeStockage = /** @type {const} */ ({
   INSTANTANE: 'INSTANTANE',
   INTEGRE: 'INTEGRE',
   INDEPENDANT: 'INDEPENDANT'
-};
+});

package/features/dpe/domain/models/type-ventilation.model.js

@@ -1,8 +1,9 @@
 /**
- * @type {{[key: string]: string}}
+ * Valeur de TypeVentilation.
+ * @typedef {'SIMPLE_FLUX_AUTO' | 'SIMPLE_FLUX_HYGRO' | 'DOUBLE_FLUX'} TypeVentilation
  */
-export const TypeVentilation = {
+export const TypeVentilation = /** @type {const} */ ({
   SIMPLE_FLUX_AUTO: 'SIMPLE_FLUX_AUTO',
   SIMPLE_FLUX_HYGRO: 'SIMPLE_FLUX_HYGRO',
   DOUBLE_FLUX: 'DOUBLE_FLUX'
-};
+});

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

@@ -4,7 +4,7 @@ import type {
   XsdLogementVentilation,
   XsdLogementVentilationDonneeEntree,
   XsdLogementVentilationDonneeIntermediaire
-} from './dpe-xsd.generated';
+} from './dpe-xsd.generated.js';
 
 export interface Ventilation extends Omit<XsdLogementVentilation, 'donnee_entree'> {
   donnee_entree: VentilationDE;

package/features/dpe/infrastructure/ch/chTv.store.js

@@ -10,14 +10,14 @@ import { logger } from '../../../../core/util/logger/log-service.js';
 export class ChTvStore extends TvStore {
   /**
    * Récupération des ids des générateurs de chauffage à combustion
-   * @return {[number]}
+   * @return {number[]}
    */
   getCombustionGenerateurs() {
     return this.#getTypeGenerateurChId('generateur_combustion');
   }
   /**
    * Récupération des ids des générateurs de chauffage pompes à chaleur
-   * @return {[number]}
+   * @return {number[]}
    */
   getPacGenerateurs() {
     return this.#getTypeGenerateurChId('scop');

package/features/dpe/infrastructure/ecs/ecsTv.store.js

@@ -9,7 +9,7 @@ export class EcsTvStore extends TvStore {
   /**
    * Température moyenne d’eau froide sanitaire sur le mois j (°C).
    * La température d’eau froide est une donnée climatique mensuelle pour chacune des 8 zones climatiques
-   * @see 11.1 Calcul du besoin d’ECS : Tefs
+   * @see Chapitre 11.1 Calcul du besoin d’ECS : Tefs
    *
    * @param classeAltitude {string}
    * @param zoneClimatique {string}
@@ -23,7 +23,7 @@ export class EcsTvStore extends TvStore {
 
   /**
    * Coefficient de perte du ballon de stockage
-   * @see 11.6.2 Pertes des ballons électriques
+   * @see Chapitre 11.6.2 Pertes des ballons électriques
    *
    * @param enumTypeGenerateurEcsId {string}
    * @param volumeStockage {number}
@@ -55,7 +55,7 @@ export class EcsTvStore extends TvStore {
 
   /**
    * Récupération des ids des générateurs électriques ECS
-   * @return {[number]}
+   * @return {number[]}
    */
   getElectriqueEcsGenerateurs() {
     return [

package/features/dpe/infrastructure/enveloppe/baieVitreeTv.store.js

@@ -349,7 +349,7 @@ export class BaieVitreeTvStore extends TvStore {
   }
 
   /**
-   * @see 18.5 - Coefficients d’orientation et d’inclinaison des parois vitrées : C1
+   * @see Chapitre 18.5 - Coefficients d’orientation et d’inclinaison des parois vitrées : C1
    *
    * @param enumOrientationId {number}
    * @param enumInclinaisonVitrageId {number}

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

@@ -8,7 +8,7 @@ import { logger } from '../../../../core/util/logger/log-service.js';
 export class FrTvStore extends TvStore {
   /**
    * Recherche des valeurs nécessaires au calcul du besoin en froid
-   * @see 10.2 Calcul du besoin mensuel de froid
+   * @see Chapitre 10.2 Calcul du besoin mensuel de froid
    * — e : nombre d’heures de chauffage pour un mois donné et une consigne de refroidissement à 26°C (comportement dépensier).
    * — nref26 : nombre d’heures de chauffage pour un mois donné et une consigne de refroidissement à 26°C (comportement dépensier).
    * — nref28 : nombre d’heures de chauffage pour un mois donné et une consigne de refroidissement à 28°C (comportement conventionnel).
@@ -19,7 +19,7 @@ export class FrTvStore extends TvStore {
    * — 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'| 'dh19'| 'dh21'}
+   * @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}
@@ -39,7 +39,7 @@ export class FrTvStore extends TvStore {
 
   /**
    * Coefficient d’efficience énergétique
-   * @see 10.3 - Les consommations de refroidissement
+   * @see Chapitre 10.3 - Les consommations de refroidissement
    *
    * @param zoneClimatiqueId {string}
    * @param periodeInstallationId {number}

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

@@ -54,7 +54,7 @@ describe('Lecture des tables de valeurs', () => {
 
   /**
    * Nombre d’heures de refroidissement Nref entre 400 m et 800 m d’altitude
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - Annexe 18.2.2 (tableaux Nref (26°C) et Nref (28°C))
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - Annexe 18.2.2 (tableaux Nref (26°C) et Nref (28°C))
    */
   describe('lecture des heures de refroidissement Nref entre 400m et 800m', () => {
     const zones = ['h1a', 'h1b', 'h1c', 'h2a', 'h2b', 'h2c', 'h2d', 'h3'];

package/features/dpe/infrastructure/tv.store.js

@@ -322,7 +322,7 @@ export class TvStore {
 
   /**
    * Débits de la ventilation
-   * @param typeVentilation {number}
+   * @param typeVentilation {string}
    * @return {object|undefined}
    */
   getDebitsVentilation(typeVentilation) {

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

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { ApportEtBesoin } from '../../../dpe/domain/models/sortie.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { BesoinEcsService } from './ecs/besoin-ecs.service.js';
 import { SurfaceSudEquivalenteService } from './surface-sud-equivalente.service.js';

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

@@ -1,3 +1,5 @@
+/** @import { Enveloppe, Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { SurfaceSudEquivalenteService } from '../surface-sud-equivalente.service.js';
 import { mois_liste } from '../../../../../utils.js';
@@ -9,7 +11,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 42
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class ApportGratuitService {
   /**

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

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { mois_liste } from '../../../../../utils.js';
 import { inject } from 'dioma';
 import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
@@ -8,7 +10,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * 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
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class BesoinChService {
   /**

package/features/engine/domain/apport_et_besoin/ch/perte-ch-recup.service.js

@@ -1,3 +1,7 @@
+/** @import { Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffage } from '../../../../dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcs, GenerateurEcsDE, GenerateurEcsDI } from '../../../../dpe/domain/models/installation-ecs.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { mois_liste } from '../../../../../utils.js';
 import { inject } from 'dioma';
 import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
@@ -12,7 +16,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 57
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class PerteChRecupService {
   /**
@@ -93,8 +97,10 @@ export class PerteChRecupService {
 
     return installationsEcs.flatMap((installation) =>
       (installation.generateur_ecs_collection?.generateur_ecs || []).filter((generateurEcs) => {
-        const generateurEcsDE = generateurEcs.donnee_entree || {};
-        const generateurEcsDI = generateurEcs.donnee_intermediaire || {};
+        const generateurEcsDE = /** @type {GenerateurEcsDE} */ (generateurEcs.donnee_entree || {});
+        const generateurEcsDI = /** @type {GenerateurEcsDI} */ (
+          generateurEcs.donnee_intermediaire || {}
+        );
         return (
           Number(generateurEcsDI.qp0 || 0) > 0 &&
           Number(generateurEcsDE.position_volume_chauffe ?? 0) === 1 &&

package/features/engine/domain/apport_et_besoin/ch/perte-ch-recup.service.spec.js

@@ -12,7 +12,7 @@ let tvStore;
 /**
  * 9.1.1 Pertes récupérées de génération pour le chauffage
  * Qgen_rec_j = 0,48 * Cper * Qp0 * Dperj
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
  */
 describe('Calcul des pertes récupérées de génération pour le chauffage', () => {
   /** @type {Contexte} */

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

@@ -1,3 +1,4 @@
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { mois_liste, Njj } from '../../../../../utils.js';
 import { EcsTvStore } from '../../../../dpe/infrastructure/ecs/ecsTv.store.js';
 import { inject } from 'dioma';
@@ -8,7 +9,7 @@ import { inject } from 'dioma';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 70
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class BesoinEcsService {
   /**

package/features/engine/domain/apport_et_besoin/ecs/perte-ecs-recup.service.js

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { InstallationEcsDU } from '../../../../dpe/domain/models/installation-ecs.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { mois_liste } from '../../../../../utils.js';
 import { inject } from 'dioma';
 import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
@@ -13,7 +16,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 57
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class PerteEcsRecupService {
   /**

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

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { mois_liste } from '../../../../../utils.js';
 import { inject } from 'dioma';
 import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
@@ -9,7 +11,7 @@ import { ApportGratuitService } from '../apport_gratuit/apport-gratuit.service.j
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 68
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class BesoinFroidService {
   /**