@open3cl/engine 1.11.2 → 1.11.4

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

@@ -1,193 +1,122 @@
-import { BaieVitree } from './baie-vitree.model';
-import { Climatisation } from './climatisation.model';
-import { Ets } from './ets.model';
-import { InstallationChauffage } from './installation-chauffage.model';
-import { InstallationEcs } from './installation-ecs.model';
-import { Mur } from './mur.model';
-import { PlancherBas, PlancherHaut } from './plancher.model';
-import { PontThermique } from './pont-thermique.model';
-import { Porte } from './porte.model';
-import { ProductionElecEnr } from './production-elec-enr.model';
-import { Sortie } from './sortie.model';
-import { Ventilation } from './ventilation.model';
+import type {
+  XsdAdministratif,
+  XsdAdministratifDiagnostiqueur,
+  XsdAdministratifGeolocalisation,
+  XsdAdministratifInformationFormulaireConsentement,
+  XsdDpe,
+  XsdDpeImmeuble,
+  XsdDpeImmeubleLogementVisite,
+  XsdLogement,
+  XsdLogementCaracteristiqueGenerale,
+  XsdLogementEnveloppe,
+  XsdLogementMeteo,
+  XsdTAdresse
+} 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;
+export type Diagnostiqueur = XsdAdministratifDiagnostiqueur;
+export type Geolocalisation = XsdAdministratifGeolocalisation;
+export type Adresse = XsdTAdresse;
+/** Nom historique ; le XSD 2.7 parle de `information_formulaire_consentement`. */
+export type InformationConsentementProprietaire = XsdAdministratifInformationFormulaireConsentement;
+export type DpeImmeuble = XsdDpeImmeuble;
+export type LogementVisite = XsdDpeImmeubleLogementVisite;
+export type CaracteristiqueGenerale = XsdLogementCaracteristiqueGenerale;
+export type Meteo = XsdLogementMeteo;
 
 /**
- * @see https://gitlab.com/observatoire-dpe/observatoire-dpe/-/blob/master/modele_donnee/DPE_complet.xsd?ref_type=heads
+ * Données de calcul propres à Open3CL (absentes du XSD) : séries mensuelles conservées entre les
+ * étapes du moteur.
  */
-export interface Dpe {
-  hashkey: string;
-  id: string;
-  version: string;
-  numero_dpe: string;
-  statut: string;
-  administratif: Administratif;
-  dpe_immeuble?: DpeImmeuble;
-  logement?: Logement;
-  tertiaire?: Tertiaire;
-  logement_neuf?: LogementNeuf;
-  descriptif_enr_collection: any; // Pas traité pour l'instant
-  descriptif_simplifie_collection: any; // Pas traité pour l'instant
-  fiche_technique_collection: any; // Pas traité pour l'instant
-  justificatif_collection: any; // Pas traité pour l'instant
-  descriptif_geste_entretien_collection: any; // Pas traité pour l'instant
-  descriptif_travaux: any; // Pas traité pour l'instant
-}
-
-export interface Administratif {
-  dpe_a_remplacer?: string;
-  reference_interne_projet?: string;
-  motif_remplacement?: string;
-  dpe_immeuble_associe?: string;
-  enum_version_id: string;
-  date_visite_diagnostiqueur: string;
-  nom_proprietaire?: string;
-  siren_proprietaire?: string;
-  nom_proprietaire_installation_commune?: string;
-  date_etablissement_dpe: string;
-  enum_modele_dpe_id: string;
-  diagnostiqueur: Diagnostiqueur;
-  geolocalisation: Geolocalisation;
-  consentement_proprietaire?: boolean;
-  information_consentement_proprietaire?: InformationConsentementProprietaire;
-}
-
-export interface Diagnostiqueur {
-  usr_logiciel_id: string;
-  version_logiciel: string;
-  version_moteur_calcul?: string;
-  nom_diagnostiqueur: string;
-  prenom_diagnostiqueur: string;
-  mail_diagnostiqueur: string;
-  telephone_diagnostiqueur: string;
-  adresse_diagnostiqueur: string;
-  entreprise_diagnostiqueur: string;
-  numero_certification_diagnostiqueur: string;
-  organisme_certificateur: string;
-}
-
-export interface DpeImmeuble {
-  logement_visite_collection: LogementVisite[];
-}
-
-export interface LogementVisite {
-  description: string;
-  enum_position_etage_logement_id: string;
-  enum_typologie_logement_id: string;
-  surface_habitable_logement: number;
-}
-
-export interface Geolocalisation {
-  invar_logement?: string;
-  numero_fiscal_local?: string;
-  id_batiment_rnb?: string;
-  rpls_log_id?: string;
-  rpls_org_id?: string;
-  idpar?: string;
-  immatriculation_copropriete?: string;
-  adresses?: {
-    adresse_bien: Adresse;
-    adresse_proprietaire: Adresse;
-    adresse_proprietaire_installation_commune: Adresse;
-  };
-}
-
-export interface Adresse {
-  adresse_brut: string;
-  code_postal_brut: string;
-  nom_commune_brut: string;
-  label_brut: string;
-  label_brut_avec_complement: string;
-  enum_statut_geocodage_ban_id: string;
-  ban_date_appel: string;
-  ban_id?: string;
-  ban_id_ban_adresse?: string;
-  ban_label?: string;
-  ban_housenumber?: string;
-  ban_street?: string;
-  ban_citycode?: string;
-  ban_postcode?: string;
-  ban_city?: string;
-  ban_type?: string;
-  ban_score?: string;
-  ban_x?: string;
-  compl_nom_residence?: string;
-  compl_ref_batiment?: string;
-  compl_etage_appartement?: string;
-  compl_ref_cage_escalier?: string;
-  compl_ref_logement?: string;
-}
-
-export interface InformationConsentementProprietaire {
-  nom_proprietaire: string;
-  personne_morale: boolean;
-  siren_proprietaire?: string;
-  telephone?: string;
-  mail?: string;
-  label_adresse: string;
-  label_adresse_avec_complement: string;
-}
-
-export interface CaracteristiqueGenerale {
-  annee_construction?: number;
-  enum_periode_construction_id: number;
-  enum_methode_application_dpe_log_id: number;
-  enum_calcul_echantillonnage_id?: number;
-  surface_habitable_logement?: number;
-  nombre_niveau_immeuble?: number;
-  nombre_niveau_logement?: number;
-  hsp: number;
-  surface_habitable_immeuble?: number;
-  surface_tertiaire_immeuble?: number;
-  nombre_appartement?: number;
-  appartement_non_visite: boolean;
+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 Meteo {
-  enum_zone_climatique_id?: number;
-  altitude: number;
-  enum_classe_altitude_id: number;
-  batiment_materiaux_anciens: boolean;
+/** Enveloppe : collections typées avec les modèles enrichis (voir *.model.ts). */
+export interface Enveloppe extends Omit<
+  XsdLogementEnveloppe,
+  | 'mur_collection'
+  | 'plancher_bas_collection'
+  | 'plancher_haut_collection'
+  | 'baie_vitree_collection'
+  | 'porte_collection'
+  | 'ets_collection'
+  | 'pont_thermique_collection'
+> {
+  mur_collection: { mur: Mur[] };
+  plancher_bas_collection: { plancher_bas: PlancherBas[] };
+  plancher_haut_collection: { plancher_haut: PlancherHaut[] };
+  baie_vitree_collection: { baie_vitree: BaieVitree[] };
+  porte_collection: { porte: Porte[] };
+  /** Le XSD autorise plusieurs `ets` ; le parseur du moteur ne les met pas en tableau si un seul. */
+  ets_collection: { ets: Ets | Ets[] };
+  pont_thermique_collection: { pont_thermique: PontThermique[] };
 }
 
-export interface Logement {
-  caracteristique_generale: CaracteristiqueGenerale;
-  meteo: Meteo;
+/**
+ * Logement : type XSD, avec les installations ECS/chauffage enrichies des `donnee_utilisateur`
+ * propres à Open3CL, et `donnees_de_calcul` (hors XSD).
+ */
+export interface Logement extends Omit<
+  XsdLogement,
+  | 'enveloppe'
+  | 'ventilation_collection'
+  | 'climatisation_collection'
+  | 'production_elec_enr'
+  | 'sortie'
+  | 'installation_ecs_collection'
+  | 'installation_chauffage_collection'
+> {
   enveloppe: Enveloppe;
   ventilation_collection: { ventilation: Ventilation[] };
   climatisation_collection: { climatisation: Climatisation[] };
-  production_elec_enr?: ProductionElecEnr;
+  production_elec_enr?: ProductionElecEnr | null;
+  sortie: Sortie;
   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 };
-}
-
+/**
+ * Le moteur traite `tertiaire` et `logement_neuf` comme un logement (le XSD les décrit
+ * différemment : cf. XsdTertiaire / XsdLogementNeuf dans dpe-xsd.generated.ts).
+ */
 export interface Tertiaire extends Logement {}
 
 export interface LogementNeuf extends Logement {}
 
-export interface Enveloppe {
-  inertie: {
-    inertie_plancher_bas_lourd: boolean;
-    inertie_plancher_haut_lourd: boolean;
-    inertie_paroi_verticale_lourd: boolean;
-    enum_classe_inertie_id: number;
-  };
-  mur_collection: { mur: Mur[] };
-  plancher_bas_collection: { plancher_bas: PlancherBas[] };
-  plancher_haut_collection: { plancher_haut: PlancherHaut[] };
-  baie_vitree_collection: { baie_vitree: BaieVitree[] };
-  porte_collection: { porte: Porte[] };
-  ets_collection: { ets: Ets };
-  pont_thermique_collection: { pont_thermique: PontThermique[] };
+/**
+ * @see https://gitlab.com/observatoire-dpe/observatoire-dpe/-/blob/master/modele_donnee/DPEv2.7.xsd
+ */
+export interface Dpe extends Omit<
+  XsdDpe,
+  'logement' | 'tertiaire' | 'logement_neuf' | 'administratif'
+> {
+  /** Hors XSD : numéro DPE ajouté par le moteur / l'API */
+  numero_dpe: string;
+  /** Hors XSD : statut du DPE */
+  statut: string;
+  administratif: Administratif;
+  logement?: Logement;
+  tertiaire?: Tertiaire;
+  logement_neuf?: LogementNeuf;
 }
 
 export interface DE {
@@ -195,13 +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

@@ -1,19 +1,11 @@
-import { BaieEts } from './baie-ets.model';
-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 {
+  XsdLogementEnveloppeEts,
+  XsdLogementEnveloppeEtsDonneeEntree,
+  XsdLogementEnveloppeEtsDonneeIntermediaire
+} from './dpe-xsd.generated.js';
 
-export interface Ets {
-  donnee_entree?: EtsDE;
-  donnee_intermediaire?: EtsDI;
-  baie_ets_collection?: { baie_ets: BaieEts[] };
-}
-
-export interface EtsDE extends DE {
-  tv_coef_reduction_deperdition_id?: number; // TV
-  enum_cfg_isolation_lnc_id?: number; // ENUM cfg_isolation_lnc
-  tv_coef_transparence_ets_id: number; // TV
-}
-
-export interface EtsDI {
-  coef_transparence_ets: number;
-  bver: number;
-}
+export type Ets = XsdLogementEnveloppeEts;
+export type EtsDE = XsdLogementEnveloppeEtsDonneeEntree;
+export type EtsDI = XsdLogementEnveloppeEtsDonneeIntermediaire;

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

@@ -1,110 +1,89 @@
-import { DE } from './dpe.model';
-import { GenerateurEcsDU } from './installation-ecs.model';
+import type {
+  XsdLogementInstallationChauffage,
+  XsdLogementInstallationChauffageDonneeEntree,
+  XsdLogementInstallationChauffageDonneeIntermediaire,
+  XsdLogementInstallationChauffageEmetteurChauffage,
+  XsdLogementInstallationChauffageEmetteurChauffageDonneeEntree,
+  XsdLogementInstallationChauffageEmetteurChauffageDonneeIntermediaire,
+  XsdLogementInstallationChauffageGenerateurChauffage,
+  XsdLogementInstallationChauffageGenerateurChauffageDonneeEntree,
+  XsdLogementInstallationChauffageGenerateurChauffageDonneeIntermediaire
+} from './dpe-xsd.generated.js';
 
-export interface InstallationChauffage {
-  donnee_entree?: InstallationChauffageDE;
-  donnee_intermediaire?: InstallationChauffageDI;
-  emetteur_chauffage_collection?: { emetteur_chauffage: EmetteurChauffage[] };
-  generateur_chauffage_collection?: { generateur_chauffage: GenerateurChauffage[] };
+/** + champ Open3CL hors XSD : `ficheTechniqueComptage` (fiche technique). */
+export type InstallationChauffageDE = XsdLogementInstallationChauffageDonneeEntree & {
+  ficheTechniqueComptage?: any;
+};
+export type InstallationChauffageDI = XsdLogementInstallationChauffageDonneeIntermediaire;
+export interface EmetteurChauffage extends Omit<
+  XsdLogementInstallationChauffageEmetteurChauffage,
+  'donnee_intermediaire'
+> {
+  donnee_intermediaire: EmetteurChauffageDI;
 }
-
-export interface InstallationChauffageDE extends DE {
-  surface_chauffee: number;
-  nombre_logement_echantillon?: number;
-  rdim: number;
-  nombre_niveau_installation_ch: number;
-  enum_cfg_installation_ch_id: number;
-  ratio_virtualisation?: number;
-  coef_ifc?: number;
-  cle_repartition_ch?: number;
-  enum_type_installation_id: number;
-  enum_methode_calcul_conso_id: number;
-  enum_methode_saisie_fact_couv_sol_id?: number;
-  tv_facteur_couverture_solaire_id?: number;
-  fch_saisi?: number;
-}
-
-export interface InstallationChauffageDI {
-  besoin_ch: number;
-  besoin_ch_depensier: number;
-  production_ch_solaire?: number;
-  fch?: number;
-  conso_ch: number;
-  conso_ch_depensier: number;
-}
-
-export interface EmetteurChauffage {
-  donnee_entree?: EmetteurChauffageDE;
-  donnee_intermediaire?: EmetteurChauffageDI;
-}
-
-export interface EmetteurChauffageDE extends DE {
-  surface_chauffee: number;
-  tv_rendement_emission_id: number;
-  tv_rendement_distribution_ch_id: number;
-  tv_rendement_regulation_id: number;
-  enum_type_emission_distribution_id: number;
-  tv_intermittence_id: number;
-  reseau_distribution_isole?: boolean;
-  enum_equipement_intermittence_id: number;
-  enum_type_regulation_id: number;
-  enum_periode_installation_emetteur_id?: number;
-  enum_type_chauffage_id: number;
-  enum_temp_distribution_ch_id: number;
-  enum_lien_generateur_emetteur_id: number;
-}
-
-export interface EmetteurChauffageDI {
-  i0: number;
-  rendement_emission: number;
-  rendement_distribution: number;
-  rendement_regulation: number;
+export type EmetteurChauffageDE = XsdLogementInstallationChauffageEmetteurChauffageDonneeEntree;
+/** + champ calculé Open3CL hors XSD : `lb` (longueur de boucle). */
+export type EmetteurChauffageDI =
+  XsdLogementInstallationChauffageEmetteurChauffageDonneeIntermediaire & {
+    lb?: number;
+  };
+/** 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 interface GenerateurChauffage {
-  donnee_entree?: GenerateurChauffageDE;
-  donnee_utilisateur?: GenerateurChauffageDU;
-  donnee_intermediaire?: GenerateurChauffageDI;
+/** 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;
 }
 
-export interface GenerateurChauffageDE extends DE {
-  reference_generateur_mixte?: number;
-  ref_produit_generateur_ch?: number;
-  enum_type_generateur_ch_id: number;
-  enum_usage_generateur_id: number;
-  enum_type_energie_id: number;
-  position_volume_chauffe: number;
-  tv_rendement_generation_id?: number;
-  tv_scop_id?: number;
-  tv_temp_fonc_100_id?: number;
-  tv_temp_fonc_30_id?: number;
-  tv_generateur_combustion_id?: number;
-  tv_reseau_chaleur_id?: number;
-  identifiant_reseau_chaleur?: string;
-  date_arrete_reseau_chaleur?: string;
-  priorite_generateur_cascade?: number;
-  presence_ventouse?: number;
-  presence_regulation_combustion?: boolean;
-  enum_methode_saisie_carac_sys_id: number;
-  enum_lien_generateur_emetteur_id: number;
-}
+/** + 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;
 
-export interface GenerateurChauffageDI {
-  scop?: number;
-  pn?: number;
-  qp0?: number;
-  pveilleuse?: number;
-  temp_fonc_30?: number;
-  temp_fonc_100?: number;
-  rpn?: number;
-  rpint?: number;
-  conso_ch: number;
-  conso_ch_depensier: number;
-}
+/** 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). */
+  [key: string]: any;
   ratio_virtualisation?: number;
   typeGenerateur?: TypeGenerateur;
+  isCombustionGenerator?: boolean;
   combustion: boolean;
   pac: boolean;
   generateur?: {
@@ -119,7 +98,21 @@ export interface GenerateurChauffageDU {
   };
 }
 
-export enum TypeGenerateur {
-  CHAUDIERE = 'CHAUDIERE',
-  OTHER = 'OTHER'
+export interface GenerateurChauffage extends Omit<
+  XsdLogementInstallationChauffageGenerateurChauffage,
+  'donnee_entree' | 'donnee_intermediaire'
+> {
+  donnee_entree: GenerateurChauffageDE;
+  donnee_intermediaire?: GenerateurChauffageDI;
+  donnee_utilisateur?: GenerateurChauffageDU;
+}
+
+export interface InstallationChauffage extends Omit<
+  XsdLogementInstallationChauffage,
+  'donnee_entree' | 'emetteur_chauffage_collection' | 'generateur_chauffage_collection'
+> {
+  donnee_entree: InstallationChauffageDE;
+  donnee_utilisateur?: Record<string, any>; // hors XSD
+  emetteur_chauffage_collection: { emetteur_chauffage: EmetteurChauffage[] };
+  generateur_chauffage_collection: { generateur_chauffage: GenerateurChauffage[] };
 }