@likewatt/models-front 1.103.0 → 1.104.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,12 @@ export declare const SiteConstants: {
         readonly DAILY_INDEX: "INDEX J.";
         readonly HYBRID: "HYBRIDE";
         readonly STRASBOURG: "STRASBOURG";
+        /**
+         * Courbe de charge reconstituée depuis un profil de l'Open Data Enedis
+         * (moyenne des 500 courbes fictives du secteur, mise à l'échelle). Les
+         * détails de la récupération sont dans `Site.openDataProfile`.
+         */
+        readonly OPENDATA: "OPENDATA";
     };
     readonly purchaseContractType: {
         readonly 'CARD/T': "CARD/T";

package/dist/core/SiteConstants.js

@@ -76,6 +76,12 @@ exports.SiteConstants = {
         DAILY_INDEX: 'INDEX J.',
         HYBRID: 'HYBRIDE',
         STRASBOURG: 'STRASBOURG',
+        /**
+         * Courbe de charge reconstituée depuis un profil de l'Open Data Enedis
+         * (moyenne des 500 courbes fictives du secteur, mise à l'échelle). Les
+         * détails de la récupération sont 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,116 @@
+/** 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. Utiliser
+ * `ENEDIS_OPENDATA_CATALOG` pour construire des listes en cascade sans jamais
+ * proposer une combinaison inexistante.
+ */
+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';
+/**
+ * Catalogue réel des 34 datasets exploitables, pour bâtir des listes en cascade.
+ *
+ * Confronté au portail le 2026-08-19 (diff vide). Les 15 variantes `-gan` en sont
+ * absentes : elles sont titrées « – archives » (ancien modèle GAN, remplacé par
+ * diffusion latente).
+ *
+ * Noter les asymétries, qui sont la raison d'être de cette table : 5510 et 5610
+ * n'existent qu'en `PRO`, 4711 qu'en `ENT`, et `ENT1` saute la tranche
+ * 50-120 kVA que `ENT3` couvre.
+ */
+export declare const ENEDIS_OPENDATA_CATALOG: {
+    readonly NAF: {
+        readonly PRO: readonly ["3600", "3700", "5510", "5610", "6831", "7010", "8411", "8413", "8790"];
+        readonly ENT: readonly ["10", "55", "3600", "4711", "7010", "8411"];
+    };
+    readonly PROFILE: {
+        readonly RES1: readonly ["3-6"];
+        readonly RES11: readonly ["6-9", "9-18"];
+        readonly RES2: readonly ["3-6", "6-9", "9-12"];
+        readonly PRO1: readonly ["0-6", "6-12", "12-sup"];
+        readonly PRO2: readonly ["0-6", "6-12", "12-24", "24-sup"];
+        readonly ENT1: readonly ["36-50", "120-250", "250-sup"];
+        readonly ENT3: readonly ["36-120", "120-250", "250-sup"];
+    };
+};
+/**
+ * Bornes réelles de chaque plage de puissance souscrite, en kVA, indexées par la
+ * valeur `powerRange` du slug.
+ *
+ * Nécessaire parce que trois plages sont notées `-sup` dans les slugs sans que la
+ * borne haute y figure : le front ne peut pas la deviner. Elle est bornée, pas
+ * infinie — `12-sup` s'arrête à 36 kVA, `24-sup` à 36 également, `250-sup` à
+ * 25 000.
+ *
+ * `label` reprend **verbatim** la chaîne du champ `plage_ps` d'Enedis, à titre
+ * indicatif ; l'affichage reste libre côté front, qui dispose de `min`/`max`
+ * pour composer le sien.
+ *
+ * Provenance : les 13 valeurs distinctes du champ `plage_ps` du dataset
+ * `courbes-de-charges-fictives-caracteristiques`. Dix s'apparient directement aux
+ * plages non-`sup` des slugs ; les trois restantes (`]12-36]`, `]24-36]`,
+ * `]250-25000]`) s'apparient sans ambiguïté aux trois `-sup` par leur borne basse.
+ * La borne 25 000 est corroborée par le nom du fichier source côté Enedis,
+ * `ENT3-250-25000.csv`.
+ */
+export declare const ENEDIS_OPENDATA_POWER_RANGES: Record<string, {
+    min: number;
+    max: number;
+    label: string;
+}>;
+/**
+ * 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 couverte.
+     *
+     * À afficher : l'Open Data ne publie **pas** d'année civile, la seule fenêtre
+     * disponible court du 2023-11-01 au 2024-10-29 (364 jours). Les composants qui
+     * raisonnent en années civiles doivent en tenir compte.
+     */
+    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 typique du secteur, en kWh, avant mise à l'échelle. */
+    referenceAnnualConsumptionKwh?: number;
+    /** Consommation annuelle réellement appliquée, en kWh. */
+    appliedAnnualConsumptionKwh?: number;
+}

package/dist/site/OpenDataProfile.types.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENEDIS_OPENDATA_POWER_RANGES = exports.ENEDIS_OPENDATA_CATALOG = void 0;
+/**
+ * Catalogue réel des 34 datasets exploitables, pour bâtir des listes en cascade.
+ *
+ * Confronté au portail le 2026-08-19 (diff vide). Les 15 variantes `-gan` en sont
+ * absentes : elles sont titrées « – archives » (ancien modèle GAN, remplacé par
+ * diffusion latente).
+ *
+ * Noter les asymétries, qui sont la raison d'être de cette table : 5510 et 5610
+ * n'existent qu'en `PRO`, 4711 qu'en `ENT`, et `ENT1` saute la tranche
+ * 50-120 kVA que `ENT3` couvre.
+ */
+exports.ENEDIS_OPENDATA_CATALOG = {
+    NAF: {
+        PRO: [
+            '3600',
+            '3700',
+            '5510',
+            '5610',
+            '6831',
+            '7010',
+            '8411',
+            '8413',
+            '8790',
+        ],
+        ENT: ['10', '55', '3600', '4711', '7010', '8411'],
+    },
+    PROFILE: {
+        RES1: ['3-6'],
+        RES11: ['6-9', '9-18'],
+        RES2: ['3-6', '6-9', '9-12'],
+        PRO1: ['0-6', '6-12', '12-sup'],
+        PRO2: ['0-6', '6-12', '12-24', '24-sup'],
+        ENT1: ['36-50', '120-250', '250-sup'],
+        ENT3: ['36-120', '120-250', '250-sup'],
+    },
+};
+/**
+ * Bornes réelles de chaque plage de puissance souscrite, en kVA, indexées par la
+ * valeur `powerRange` du slug.
+ *
+ * Nécessaire parce que trois plages sont notées `-sup` dans les slugs sans que la
+ * borne haute y figure : le front ne peut pas la deviner. Elle est bornée, pas
+ * infinie — `12-sup` s'arrête à 36 kVA, `24-sup` à 36 également, `250-sup` à
+ * 25 000.
+ *
+ * `label` reprend **verbatim** la chaîne du champ `plage_ps` d'Enedis, à titre
+ * indicatif ; l'affichage reste libre côté front, qui dispose de `min`/`max`
+ * pour composer le sien.
+ *
+ * Provenance : les 13 valeurs distinctes du champ `plage_ps` du dataset
+ * `courbes-de-charges-fictives-caracteristiques`. Dix s'apparient directement aux
+ * plages non-`sup` des slugs ; les trois restantes (`]12-36]`, `]24-36]`,
+ * `]250-25000]`) s'apparient sans ambiguïté aux trois `-sup` par leur borne basse.
+ * La borne 25 000 est corroborée par le nom du fichier source côté Enedis,
+ * `ENT3-250-25000.csv`.
+ */
+exports.ENEDIS_OPENDATA_POWER_RANGES = {
+    '0-6': { min: 0, max: 6, label: ']0-6 kVA]' },
+    '3-6': { min: 3, max: 6, label: ']3-6 kVA]' },
+    '6-9': { min: 6, max: 9, label: ']6-9 kVA]' },
+    '6-12': { min: 6, max: 12, label: ']6-12 kVA]' },
+    '9-12': { min: 9, max: 12, label: ']9-12 kVA]' },
+    '9-18': { min: 9, max: 18, label: ']9-18 kVA]' },
+    '12-24': { min: 12, max: 24, label: ']12-24 kVA]' },
+    '12-sup': { min: 12, max: 36, label: ']12-36 kVA]' },
+    '24-sup': { min: 24, max: 36, label: ']24-36 kVA]' },
+    '36-50': { min: 36, max: 50, label: ']36-50 kVA]' },
+    '36-120': { min: 36, max: 120, label: ']36-120 kVA]' },
+    '120-250': { min: 120, max: 250, label: ']120-250 kVA]' },
+    '250-sup': { min: 250, max: 25000, label: ']250-25000 kVA]' },
+};

package/package.json

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