@likewatt/models-front 1.103.0 → 1.105.0

package/dist/core/Site.types.d.ts

@@ -3,6 +3,7 @@ import { BuildingData } from '../site/BuildingData.types';
 import { ConsumptionIndexes } from '../site/ConsumptionIndexes.types';
 import { CustomerInfos } from '../site/CustomerInfos.types';
 import { DataSourceHistory } from '../site/DataSourceHistory.types';
+import { OpenDataProfile } from '../site/OpenDataProfile.types';
 import { ExtractionData } from '../site/ExtractionData.types';
 import { EnergyPrice } from '../site/EnergyPrice.types';
 import { EnergyPriceTempo } from '../site/EnergyPriceTempo.types';
@@ -107,6 +108,11 @@ export interface Site {
      */
     extractionType?: 'COURBE' | 'INDEX' | 'HYBRIDE';
     dataSourceHistory: DataSourceHistory[];
+    /**
+     * Trace de la récupération d'une courbe de charge depuis l'Open Data Enedis,
+     * quand `dataSource` vaut `OPENDATA`. Absent sur tout site alimenté autrement.
+     */
+    openDataProfile?: OpenDataProfile;
     disabled: boolean;
     strasbourgData?: boolean;
     enedisData?: boolean;

package/dist/core/SiteConstants.d.ts

@@ -408,6 +408,19 @@ export declare const SiteConstants: {
         readonly DAILY_INDEX: "INDEX J.";
         readonly HYBRID: "HYBRIDE";
         readonly STRASBOURG: "STRASBOURG";
+        /**
+         * Courbe de charge reconstituée depuis l'Open Data Enedis : moyenne des
+         * 500 courbes fictives du secteur, re-datée sur une année civile. Aucune
+         * mise à l'échelle — le niveau est celui du secteur.
+         *
+         * Distincte de `PROFILE`, qui reste le flux des fichiers de coefficients.
+         * Les deux partagent le même onglet côté front, mais surtout pas le même
+         * traitement : `normalizeDataSourceTab` doit mapper `OPENDATA` vers l'onglet
+         * `PROFILE`, sans confondre les deux valeurs stockées.
+         *
+         * Détails de la récupération dans `Site.openDataProfile`.
+         */
+        readonly OPENDATA: "OPENDATA";
     };
     readonly purchaseContractType: {
         readonly 'CARD/T': "CARD/T";

package/dist/core/SiteConstants.js

@@ -76,6 +76,19 @@ exports.SiteConstants = {
         DAILY_INDEX: 'INDEX J.',
         HYBRID: 'HYBRIDE',
         STRASBOURG: 'STRASBOURG',
+        /**
+         * Courbe de charge reconstituée depuis l'Open Data Enedis : moyenne des
+         * 500 courbes fictives du secteur, re-datée sur une année civile. Aucune
+         * mise à l'échelle — le niveau est celui du secteur.
+         *
+         * Distincte de `PROFILE`, qui reste le flux des fichiers de coefficients.
+         * Les deux partagent le même onglet côté front, mais surtout pas le même
+         * traitement : `normalizeDataSourceTab` doit mapper `OPENDATA` vers l'onglet
+         * `PROFILE`, sans confondre les deux valeurs stockées.
+         *
+         * Détails de la récupération dans `Site.openDataProfile`.
+         */
+        OPENDATA: 'OPENDATA',
     },
     purchaseContractType: {
         'CARD/T': 'CARD/T',

package/dist/index.d.ts

@@ -39,6 +39,7 @@ export * from './site/BuildingStats.types';
 export * from './site/ConsumptionIndexes.types';
 export * from './site/CustomerInfos.types';
 export * from './site/DataSourceHistory.types';
+export * from './site/OpenDataProfile.types';
 export * from './site/EnergyPrice.types';
 export * from './site/ExtractionData.types';
 export * from './site/EnergyPriceTempo.types';

package/dist/index.js

@@ -58,6 +58,7 @@ __exportStar(require("./site/BuildingStats.types"), exports);
 __exportStar(require("./site/ConsumptionIndexes.types"), exports);
 __exportStar(require("./site/CustomerInfos.types"), exports);
 __exportStar(require("./site/DataSourceHistory.types"), exports);
+__exportStar(require("./site/OpenDataProfile.types"), exports);
 __exportStar(require("./site/EnergyPrice.types"), exports);
 __exportStar(require("./site/ExtractionData.types"), exports);
 __exportStar(require("./site/EnergyPriceTempo.types"), exports);

package/dist/site/OpenDataProfile.types.d.ts

@@ -0,0 +1,77 @@
+/** Catégorie fonctionnelle du profil Open Data, telle que présentée à l'utilisateur. */
+export type EnedisOpenDataCategory = 
+/** Secteur d'activité (code NAF), décliné en Professionnels / Entreprises. */
+'NAF'
+/** Type de profil (RES/PRO/ENT) décliné par plage de puissance souscrite. */
+ | 'PROFILE';
+/**
+ * Segment de la catégorie NAF. Discriminant et non décoratif : 3600, 7010 et
+ * 8411 existent dans les deux segments, donc le code NAF seul ne désigne pas un
+ * dataset.
+ */
+export type EnedisOpenDataSegment = 'PRO' | 'ENT';
+/**
+ * Type de profil de la catégorie PROFILE. Restreint à ce que l'Open Data
+ * publie : ni `RES5` ni `RES3-F` n'y figurent, contrairement aux fichiers de
+ * coefficients `.xlsx`.
+ */
+export type EnedisOpenDataProfileType = 'RES1' | 'RES11' | 'RES2' | 'PRO1' | 'PRO2' | 'ENT1' | 'ENT3';
+/**
+ * Profils de courbes de charge publiés par l'Open Data Enedis.
+ *
+ * La valeur **est** le suffixe du slug du dataset Data Fair :
+ * `courbes-de-charges-fictives-<valeur>`. C'est cette valeur que le front envoie
+ * au back, qui en déduit seul la catégorie, le segment et le code ou la plage.
+ *
+ * Union plate plutôt que produit (catégorie × segment × code) parce que le
+ * catalogue Enedis est creux : `ENT1` n'a pas la tranche 50-120 kVA alors que
+ * `ENT3` a 36-120, et les codes NAF diffèrent d'un segment à l'autre.
+ *
+ * Pour bâtir des listes en cascade, appeler `GET /profile/opendata/catalog` sur
+ * la gateway : elle dérive l'arbre de l'enum et reste donc la seule source de
+ * vérité. Ne pas en tenir une copie ici — les deux paquets sont versionnés
+ * séparément, et une divergence se manifesterait par un secteur sélectionnable
+ * qui renvoie un 404 Enedis.
+ */
+export type EnedisOpenDataProfile = 'pro-naf3600' | 'pro-naf3700' | 'pro-naf5510' | 'pro-naf5610' | 'pro-naf6831' | 'pro-naf7010' | 'pro-naf8411' | 'pro-naf8413' | 'pro-naf8790' | 'ent-naf10' | 'ent-naf55' | 'ent-naf3600' | 'ent-naf4711' | 'ent-naf7010' | 'ent-naf8411' | 'res1-3-6' | 'res11-6-9' | 'res11-9-18' | 'res2-3-6' | 'res2-6-9' | 'res2-9-12' | 'pro1-0-6' | 'pro1-6-12' | 'pro1-12-sup' | 'pro2-0-6' | 'pro2-6-12' | 'pro2-12-24' | 'pro2-24-sup' | 'ent1-36-50' | 'ent1-120-250' | 'ent1-250-sup' | 'ent3-36-120' | 'ent3-120-250' | 'ent3-250-sup';
+/**
+ * Trace de la récupération d'une courbe de charge depuis l'Open Data Enedis.
+ * Écrit par le back, jamais par le front.
+ */
+export interface OpenDataProfile {
+    category: EnedisOpenDataCategory;
+    /** Catégorie NAF uniquement. */
+    segment?: EnedisOpenDataSegment;
+    /** Catégorie NAF uniquement — `'10'`, `'55'`, `'3600'`… Chaîne, pas nombre. */
+    nafCode?: string;
+    /** Catégorie PROFILE uniquement. */
+    profileType?: EnedisOpenDataProfileType;
+    /** Catégorie PROFILE uniquement — `'3-6'`, `'6-12'`, `'250-sup'`. */
+    powerRange?: string;
+    /** Slug du dataset Data Fair, clé externe immuable. */
+    datasetSlug: string;
+    /**
+     * Bornes de la fenêtre réellement publiée par Enedis — 2023-11-01 → 2024-10-29.
+     * Traçabilité et attribution Etalab. Ce n'est **pas** la période de l'étude.
+     */
+    sourcePeriodStart?: Date | string;
+    sourcePeriodEnd?: Date | string;
+    /**
+     * Bornes de l'année civile servie, toujours 1er janvier → 31 décembre.
+     *
+     * C'est la période de l'étude, et celle que les composants raisonnant en
+     * années civiles doivent utiliser. Figée à la création du projet.
+     */
+    periodStart?: Date | string;
+    periodEnd?: Date | string;
+    retrievedAt?: Date | string;
+    /** Nombre de courbes agrégées pour produire la moyenne (500 nominalement). */
+    curveCount?: number;
+    /**
+     * Consommation annuelle du secteur, en kWh. Niveau livré, non surchargeable.
+     * Ordre de grandeur : l'écart intra-secteur mesuré va de 1 à 24.
+     */
+    referenceAnnualConsumptionKwh?: number;
+    /** Puissance souscrite déduite, en kVA, arrondie au palier normalisé. */
+    deducedSubscribedPowerKva?: number;
+}

package/dist/site/OpenDataProfile.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likewatt/models-front",
-  "version": "1.103.0",
+  "version": "1.105.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",