@open3cl/engine 1.11.2 → 1.11.4

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

@@ -1,30 +1,20 @@
-import { DE } from './dpe.model';
+// Alias des types générés depuis le XSD DPE (voir dpe-xsd.generated.ts). Les extensions propres
+// à Open3CL se déclarent ici (hors fichier généré) pour survivre à la régénération.
+import type {
+  XsdLogementVentilation,
+  XsdLogementVentilationDonneeEntree,
+  XsdLogementVentilationDonneeIntermediaire
+} from './dpe-xsd.generated.js';
 
-export interface Ventilation {
-  donnee_entree?: VentilationDE;
-  donnee_intermediaire?: VentilationDI;
-}
-
-export interface VentilationDE extends DE {
-  enum_type_ventilation_id: number;
-  surface_ventile: number;
-  plusieurs_facade_exposee: boolean;
-  tv_q4pa_conv_id?: number;
-  q4pa_conv_saisi?: number;
-  enum_methode_saisie_q4pa_conv_id: number;
-  tv_debits_ventilation_id: number;
-  ventilation_post_2012: boolean;
-  ref_produit_ventilation?: number;
-  cle_repartition_ventilation?: number;
-}
-
-export interface VentilationDI {
-  pvent_moy?: number;
-  q4pa_conv: number;
-  conso_auxiliaire_ventilation: number;
-  hperm: number;
-  hvent: number;
+export interface Ventilation extends Omit<XsdLogementVentilation, 'donnee_entree'> {
+  donnee_entree: VentilationDE;
 }
+/** + champs Open3CL hors XSD issus des fiches techniques. */
+export type VentilationDE = XsdLogementVentilationDonneeEntree & {
+  ficheTechniqueFacadesExposees?: any;
+  ficheTechniqueVentilationPost2012?: any;
+};
+export type VentilationDI = XsdLogementVentilationDonneeIntermediaire;
 
 enum TypeVentilation {
   SIMPLE_FLUX_AUTO = 'SIMPLE_FLUX_AUTO',

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 {
   /**

package/features/engine/domain/apport_et_besoin/surface-sud-equivalente.service.js

@@ -1,3 +1,8 @@
+/** @import { BaieEts } from '../../../dpe/domain/models/baie-ets.model.js' */
+/** @import { BaieVitree } from '../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Enveloppe } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Ets } from '../../../dpe/domain/models/ets.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { mois_liste } from '../../../../utils.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +13,7 @@ import { BaieVitreeTvStore } from '../../../dpe/infrastructure/enveloppe/baieVit
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 45
  * 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 SurfaceSudEquivalenteService {
   /**
@@ -206,7 +211,7 @@ export class SurfaceSudEquivalenteService {
    * @param baieVitree {BaieVitree|BaieEts}
    * @param zc {string} zone climatique du logement
    * @param mois {string} mois au cours duquel calculer la surface sur équivalente de la baie vitrée
-   * @param coeff {number} coefficient à appliquer à cette surface sud
+   * @param [coeff] {number} coefficient à appliquer à cette surface sud
    * @returns {number}
    */
   ssdBaieMois(baieVitree, zc, mois, coeff) {

package/features/engine/domain/apport_et_besoin/surface-sud-equivalente.service.spec.js

@@ -170,7 +170,7 @@ describe('Calcul de la surface sud équivalente (§6.2 / §6.3)', () => {
    * véranda ; Sse = Sse_ext + Σ(v) Sse_veranda_v. Une baie adjacence 10 n'entre que dans la véranda
    * sur laquelle elle donne (reference_lnc = ets.reference).
    * Cas de test fournis par Olivier (thermicien) : C1 sud = 1, est = 0,40, nord = 0,31 ; Fe = 1.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
    */
   describe('ssdMois - plusieurs espaces tampons solarisés (issue #101)', () => {
     // Baie extérieure 10 m² sud, Sw = 0,5 => Sse_ext = 5

package/features/engine/domain/ch/emetteur-ch.service.js

@@ -1,3 +1,5 @@
+/** @import { EmetteurChauffage, GenerateurChauffageDE } from '../../../dpe/domain/models/installation-chauffage.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { ChTvStore } from '../../../dpe/infrastructure/ch/chTv.store.js';
 import { inject } from 'dioma';
 import { bug_for_bug_compat } from '../../../../utils.js';
@@ -95,7 +97,7 @@ export class EmetteurChService {
    * Aucune déduction si le mode bug_for_bug_compat est désactivé, si l'une des deux températures
    * du DPE est absente ou non numérique, ou si tous les émetteurs ont une période saisie.
    *
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
    *
    * @param ctx {Contexte}
    * @param generateurChauffageDE {GenerateurChauffageDE}

package/features/engine/domain/ch/emetteur-ch.service.spec.js

@@ -116,7 +116,7 @@ describe('Calcul des caractéristiques des générateurs de chauffage', () => {
  * Issue #220 - période d'installation des émetteurs absente du DPE.
  * Mode strict : année de construction. Mode bug_for_bug_compat : période retrouvée à partir des
  * temp_fonc_30 / temp_fonc_100 d'origine du DPE.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
  */
 describe('Déduction de la période des émetteurs depuis les données du DPE (issue #220)', () => {
   /**

package/features/engine/domain/ch/generateur-ch.service.js

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { EmetteurChauffage, GenerateurChauffage, GenerateurChauffageDE, GenerateurChauffageDI, InstallationChauffage } from '../../../dpe/domain/models/installation-chauffage.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { ChTvStore } from '../../../dpe/infrastructure/ch/chTv.store.js';
 import { excel_to_js_exec } from '../../../../utils.js';
@@ -385,7 +388,7 @@ export class GenerateurChService {
        * retrouvée à partir des temp_fonc_30 / temp_fonc_100 d'origine du DPE (données
        * intermédiaires du générateur, non encore recalculées à ce stade). Sans déduction possible,
        * la règle §13.2.1.5 s'applique (année de construction).
-       * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+       * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
        */
       const periodeDeduite = this.#emetteurChService.periodeInstallationEmetteurDeduite(
         ctx,

package/features/engine/domain/ch/generateur-ch.service.spec.js

@@ -12,7 +12,7 @@ let emetteurChService;
 
 /**
  * Températures de fonctionnement du générateur (délégation au service émetteurs).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
  */
 describe('Températures de fonctionnement des générateurs de chauffage', () => {
   const ctx = { anneeConstruction: 1900 };
@@ -82,7 +82,7 @@ describe('Températures de fonctionnement des générateurs de chauffage', () =>
 
 /**
  * Puissance nominale estimée d'un générateur à combustion sans pn.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
  */
 describe('Puissance nominale estimée des générateurs de chauffage (issue #264)', () => {
   /** @type {TvStore} */
@@ -132,7 +132,7 @@ describe('Puissance nominale estimée des générateurs de chauffage (issue #264
 /**
  * Puissance nominale estimée par la puissance de dimensionnement : Pdim = max(Pch ; Pecs) puis table
  * Pdim → Pn des chaudières (le calcul de la table est testé dans 13.2_generateur_combustion_pdim.spec.js).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
  */
 describe('Puissance nominale estimée : Pdim et table Pdim → Pn (issue #271)', () => {
   /** @type {TvStore} */

package/features/engine/domain/ch/installation-ch.service.js

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { GenerateurChService } from './generateur-ch.service.js';
 

package/features/engine/domain/conso/conso.service.js

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { ConsoFroidService } from './froid/conso-froid.service.js';
 

package/features/engine/domain/conso/froid/conso-froid.service.js

@@ -1,3 +1,7 @@
+/** @import { Climatisation, ClimatisationDE, ClimatisationDI } from '../../../../dpe/domain/models/climatisation.model.js' */
+/** @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 { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
 
@@ -7,7 +11,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 69
  * 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 ConsoFroidService {
   /**

package/features/engine/domain/contexte.builder.js

@@ -1,3 +1,5 @@
+/** @import { CaracteristiqueGenerale, Dpe } from '../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from './models/contexte.model.js' */
 import { TypeDpe, TypeHabitation } from '../../dpe/domain/models/type-habitation.model.js';
 import enums from '../../../enums.js';
 import { NadeqService } from './logement/nadeq.service.js';

package/features/engine/domain/ecs/generateur-ecs.service.js

@@ -1,3 +1,4 @@
+/** @import { GenerateurEcsDE, InstallationEcs } from '../../../dpe/domain/models/installation-ecs.model.js' */
 import { TypeStockage } from '../../../dpe/domain/models/type-stockage.model.js';
 import { inject } from 'dioma';
 import { EcsTvStore } from '../../../dpe/infrastructure/ecs/ecsTv.store.js';

package/features/engine/domain/ecs/installation-ecs.service.js

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { InstallationEcs, InstallationEcsDE } from '../../../dpe/domain/models/installation-ecs.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { GenerateurEcsService } from './generateur-ecs.service.js';
 import { inject } from 'dioma';
 import { isStockageEcsVolumeChauffe } from '../../../../11_stockage_ecs_volume_chauffe.js';

package/features/engine/domain/engine.service.js

@@ -1,3 +1,4 @@
+/** @import { Dpe } from '../../dpe/domain/models/dpe.model.js' */
 import { inject } from 'dioma';
 import { ContexteBuilder } from './contexte.builder.js';
 import { DeperditionEnveloppeService } from './enveloppe/deperdition-enveloppe.service.js';

package/features/engine/domain/enveloppe/baie_vitree/deperdition-baie-vitree.service.js

@@ -1,3 +1,5 @@
+/** @import { BaieVitree, BaieVitreeDE, BaieVitreeDI, BaieVitreeDoubleFenetreDE, MasqueLointainNonHomogene } from '../../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { DeperditionService } from '../deperdition.service.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +10,8 @@ import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baie
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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
+ * @extends {DeperditionService<BaieVitreeTvStore>}
  */
 export class DeperditionBaieVitreeService extends DeperditionService {
   /**

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

@@ -1,3 +1,6 @@
+/** @import { Enveloppe, Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Deperdition } from '../../../dpe/domain/models/sortie.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { DeperditionMurService } from './mur/deperdition-mur.service.js';
 import { DeperditionPorteService } from './porte/deperdition-porte.service.js';

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

@@ -1,3 +1,6 @@
+/** @import { DE } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
+/** @import { DeperditionData } from '../models/deperdition.model.js' */
 import { logger } from '../../../../core/util/logger/log-service.js';
 import { inject } from 'dioma';
 import { TvStore } from '../../../dpe/infrastructure/tv.store.js';
@@ -5,17 +8,18 @@ import { TvStore } from '../../../dpe/infrastructure/tv.store.js';
 /**
  * Calcul des déperditions de l’enveloppe GV
  * @see Méthode de calcul 3CL-DPE 2021 (cotobre 2021) chapitre 3
+ * @template {TvStore} [S=TvStore] type du store de tables de valeurs (spécialisé par sous-classe)
  */
 export class DeperditionService {
   /**
-   * @type {TvStore}
+   * @type {S}
    */
   tvStore;
 
   /**
-   * @param tvStore {TvStore}
+   * @param tvStore {S}
    */
-  constructor(tvStore = inject(TvStore)) {
+  constructor(tvStore = /** @type {S} */ (inject(TvStore))) {
     this.tvStore = tvStore;
   }
 
@@ -88,7 +92,7 @@ export class DeperditionService {
    *   Si Année de construction ≤74 alors Année d’isolation = 75-77
    *   Sinon Année d’isolation = Année de construction
    *
-   * @param enumPeriodeIsolationId {number}
+   * @param enumPeriodeIsolationId {string}
    * @param ctx {Contexte}
    * @return {string} ID de la période d'isolation
    */

package/features/engine/domain/enveloppe/espace_tampon/espace-tampon.service.js

@@ -1,3 +1,5 @@
+/** @import { Ets, EtsDI } from '../../../../dpe/domain/models/ets.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { DeperditionService } from '../deperdition.service.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +10,8 @@ import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baie
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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
+ * @extends {DeperditionService<BaieVitreeTvStore>}
  */
 export class EspaceTamponService extends DeperditionService {
   /**

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

@@ -1,3 +1,5 @@
+/** @import { MurDE, MurDI } from '../../../../dpe/domain/models/mur.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { logger } from '../../../../../core/util/logger/log-service.js';
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
@@ -10,7 +12,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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 DeperditionMurService extends DeperditionService {
   /**

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

@@ -1,3 +1,5 @@
+/** @import { PlancherBasDE, PlancherBasDI } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
 import { DeperditionService } from '../deperdition.service.js';
@@ -9,7 +11,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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 DeperditionPlancherBasService extends DeperditionService {
   /**

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

@@ -7,7 +7,7 @@ import { DeperditionPlancherBasService } from './deperdition-plancher-bas.servic
  * Le `TvStore` est remplacé par un double de test (spies `vi.fn`) et le coefficient b (classe de
  * base) est espionné : seule la logique propre au service (Upb0, Upb, Ue, type d'isolation) est
  * vérifiée, sans dépendre des tables de valeurs réelles.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
  */
 
 /** @type {{ getUpb0: import('vitest').Mock, getUpb: import('vitest').Mock, getUeByUpd: import('vitest').Mock }} */
@@ -156,7 +156,7 @@ describe('DeperditionPlancherBasService - calcul de upb_final (Ue)', () => {
 
   /**
    * Issue #46 : ue calculé plancher par plancher, 2S/P issu du seul plancher courant.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
    */
   describe('calcul plancher par plancher (#46)', () => {
     test('2187E0982591I plancher 1 : 2S/P = 2 * 44,8 / 12,8 = 7', () => {

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

@@ -1,3 +1,5 @@
+/** @import { PlancherHautDE, PlancherHautDI } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
 import { DeperditionService } from '../deperdition.service.js';
@@ -9,7 +11,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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 DeperditionPlancherHautService extends DeperditionService {
   /**
@@ -119,7 +121,7 @@ export class DeperditionPlancherHautService extends DeperditionService {
    * @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'}
+   * @return {'combles'|'terrasse'}
    */
   #getTypeAdjacence(phDE) {
     switch (phDE.enum_type_adjacence_id) {

package/features/engine/domain/enveloppe/pont_thermique/deperdition-pont-thermique.service.js

@@ -1,3 +1,10 @@
+/** @import { BaieVitreeDE } from '../../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Enveloppe } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { MurDE } from '../../../../dpe/domain/models/mur.model.js' */
+/** @import { PlancherBasDE, PlancherHautDE } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { PontThermiqueDE, PontThermiqueDI } from '../../../../dpe/domain/models/pont-thermique.model.js' */
+/** @import { PorteDE } from '../../../../dpe/domain/models/porte.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { DeperditionService } from '../deperdition.service.js';
 import { logger } from '../../../../../core/util/logger/log-service.js';
@@ -14,9 +21,10 @@ import { DeperditionPlancherBasService } from '../plancher_bas/deperdition-planc
  *
  * Méthode de calcul 3CL-DPE 2021
  * 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
  *
  * Si le coefficient U des portes est connu et justifié, le saisir directement. Sinon, prendre les valeurs tabulées
+ * @extends {DeperditionService<PontThermiqueTvStore>}
  */
 export class DeperditionPontThermiqueService extends DeperditionService {
   /**