@golemio/energetics 1.5.2 → 1.5.3-dev.2164524892

package/dist/schema-definitions/models/eno/interfaces/IBuilding.d.ts

@@ -0,0 +1,30 @@
+export interface IBuilding {
+    gid: string;
+    zdroj: string;
+    budova_rozdelena_byt_nebyt: boolean;
+    celkova_plocha_budova: number;
+    celkova_plocha_byt_budova: number;
+    celkova_plocha_nebyt_budova: number;
+    czcc: number;
+    druh_vytapeni: string;
+    id_cuzk: number;
+    id_objekt: number;
+    kod_ochrana: string;
+    kod_vyuziti: number;
+    nazev: string;
+    nazev_ochrana: string;
+    nazev_vyuziti: string;
+    obestaveny_prostor: number;
+    oznaceni: string;
+    platnost_od: Date | null;
+    pocet_byt: number;
+    pocet_nadzem_podlazi: number;
+    pocet_nebyt_budova: number;
+    pocet_podkrovi: number;
+    pocet_podzem_podlazi: number;
+    pripojka_elektro: string;
+    pripojka_kanalizace: string;
+    pripojka_voda: string;
+    vytah: boolean;
+    zastavena_plocha: number;
+}

package/dist/schema-definitions/models/eno/interfaces/IBuilding.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IBuilding.js.map

package/dist/schema-definitions/models/eno/interfaces/IBuilding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBuilding.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IBuilding.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IEJLookup.d.ts

@@ -0,0 +1,19 @@
+export interface IEJLookup {
+    guid: string;
+    aktivni: boolean;
+    datum_zalozeni: Date | null;
+    datum_zruseni: Date | null;
+    druh_po: string;
+    hlavni: boolean;
+    ic: string;
+    id: number;
+    kod: string;
+    kod_maj_evidencni_jednotka_hl: string;
+    kod_maj_evidencni_jednotka_ot: string;
+    kod_maj_spravce_ucet_jednotka: string;
+    kod_ucetni_ej: string;
+    nazev: string;
+    platnost_od: Date | null;
+    poznamka: string;
+    typ: string;
+}

package/dist/schema-definitions/models/eno/interfaces/IEJLookup.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IEJLookup.js.map

package/dist/schema-definitions/models/eno/interfaces/IEJLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEJLookup.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IEJLookup.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/ILocation.d.ts

@@ -0,0 +1,9 @@
+export interface ILocation {
+    gid: string;
+    gid_typ: "budova" | "stavba";
+    poradi: number;
+    zdroj: string;
+    id_parcela_orig: number;
+    hlavni_parcela_umisteni: boolean;
+    popis_umisteni: string;
+}

package/dist/schema-definitions/models/eno/interfaces/ILocation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILocation.js.map

package/dist/schema-definitions/models/eno/interfaces/ILocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILocation.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/ILocation.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IManagerLookup.d.ts

@@ -0,0 +1,27 @@
+export interface IManagerLookup {
+    guid: string;
+    aktivni: boolean;
+    cislo_domovni_spr: number;
+    cislo_domovni_znak_spr: string;
+    cislo_es: string;
+    cislo_orientacni_pismeno_spr: string;
+    cislo_orientacni_spr: number;
+    datum_deaktivace: Date | null;
+    dic: string;
+    ic: string;
+    ic_doplnek: string;
+    id_maj_oblast_sprava: number;
+    id_maj_spravce: number;
+    id_organizace: number;
+    kod: string;
+    nazev: string;
+    nazev_obec_spr: string;
+    nazev_ulice_vp_spr: string;
+    platnost_od: Date | null;
+    poznamka: string;
+    psc_spr: string;
+    spravce_rban: boolean;
+    ucetni_jednotka: boolean;
+    zkratka: string;
+    c_adr_zuzi_spr: number;
+}

package/dist/schema-definitions/models/eno/interfaces/IManagerLookup.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IManagerLookup.js.map

package/dist/schema-definitions/models/eno/interfaces/IManagerLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IManagerLookup.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IManagerLookup.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IOrganizationLookup.d.ts

@@ -0,0 +1,8 @@
+export interface IOrganizationLookup {
+    id: number;
+    aktivni: boolean;
+    id_maj_spravce_ucet_jednotka: number;
+    id_nadrazena: number;
+    kod: string;
+    platnost_od: Date | null;
+}

package/dist/schema-definitions/models/eno/interfaces/IOrganizationLookup.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IOrganizationLookup.js.map

package/dist/schema-definitions/models/eno/interfaces/IOrganizationLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOrganizationLookup.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IOrganizationLookup.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IProperty.d.ts

@@ -0,0 +1,19 @@
+export interface IProperty {
+    gid: string;
+    gid_typ: "budova" | "stavba";
+    zdroj: string;
+    id_maj_evidencni_jednotka: number;
+    datum_nabyti: Date | null;
+    datum_pozbyti: Date | null;
+    id_maj_spravce_mandatni: number;
+    id_maj_spravce_ucet_jednotka: number;
+    id_vlastnik: number;
+    penb: boolean;
+    penb_platnost_od: Date | null;
+    penb_poznamka: string;
+    podil_majetek_citatel: number;
+    podil_majetek_jmenovatel: number;
+    v_majetku: boolean;
+    v_majetku_statu: boolean;
+    v_procesu_svereni: boolean;
+}

package/dist/schema-definitions/models/eno/interfaces/IProperty.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProperty.js.map

package/dist/schema-definitions/models/eno/interfaces/IProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProperty.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IProperty.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IRemovedGID.d.ts

@@ -0,0 +1,5 @@
+export interface IRemovedGID {
+    gid: string;
+    gid_typ: string;
+    zdroj: string;
+}

package/dist/schema-definitions/models/eno/interfaces/IRemovedGID.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IRemovedGID.js.map

package/dist/schema-definitions/models/eno/interfaces/IRemovedGID.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRemovedGID.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IRemovedGID.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/eno/interfaces/IStructureTypeLookup.d.ts

@@ -0,0 +1,9 @@
+export interface IStructureTypeLookup {
+    guid: string;
+    aktivni: boolean;
+    id: number;
+    kod: string;
+    kod_typ: string;
+    nazev: string;
+    platnost_od: Date | null;
+}

package/dist/schema-definitions/models/eno/interfaces/IStructureTypeLookup.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IStructureTypeLookup.js.map

package/dist/schema-definitions/models/eno/interfaces/IStructureTypeLookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStructureTypeLookup.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/eno/interfaces/IStructureTypeLookup.ts"],"names":[],"mappings":""}

package/dist/schema-definitions/models/interfaces/IMeasurementDto.d.ts

@@ -7,4 +7,5 @@ export interface IMeasurementDto {
     meter: string;
     source: string;
     measurement_category: string;
+    device_serial_number: string | null;
 }

package/docs/asyncapi.yaml

@@ -158,6 +158,28 @@ channels:
         messages:
             targetDays:
                 $ref: "#/components/messages/energetics.VeoliaMeasurementsMessages"
+    energetics.processEnoLookup:
+        address: dataplatform.enapoenergetics.processEnoLookup
+        description: downloads lookup data (structure types, organizations, managers, EJ) from ENO SOAP/WSDL API and stores in database tables (eno_struktura_typ_lookup, eno_organizace_lookup, eno_spravce_lookup, eno_ej_lookup)
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            enoLookupMessage:
+                $ref: "#/components/messages/energetics.EnoLookupMessage"
+    energetics.processEnoBuildings:
+        address: dataplatform.enapoenergetics.processEnoBuildings
+        description: downloads building data from ENO SOAP/WSDL API including buildings, properties, addresses, and locations. Supports full and incremental synchronization using daysBack parameter. Stores data in database tables (eno_budova, eno_majetek, eno_adresa, eno_umisteni, eno_vyrazene_gid)
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            enoBuildingMessage:
+                $ref: "#/components/messages/energetics.EnoBuildingMessage"
 operations:
     energetics.fetchAccessConfiguration:
         action: "send"
@@ -215,6 +237,14 @@ operations:
         action: "send"
         channel:
             $ref: "#/channels/energetics.processPreEanMeasurementsTask"
+    energetics.processEnoLookup:
+        action: "send"
+        channel:
+            $ref: "#/channels/energetics.processEnoLookup"
+    energetics.processEnoBuildings:
+        action: "send"
+        channel:
+            $ref: "#/channels/energetics.processEnoBuildings"
 components:
     messages:
         emptyMessage:
@@ -254,6 +284,16 @@ components:
                 type: object
                 $ref: "#/components/schemas/energetics.preEanMeasurementMessage"
                 additionalProperties: false
+        energetics.EnoLookupMessage:
+            payload:
+                type: object
+                $ref: "#/components/schemas/energetics.IEnoLookupTaskInput"
+                additionalProperties: false
+        energetics.EnoBuildingMessage:
+            payload:
+                type: object
+                $ref: "#/components/schemas/energetics.IEnoBuildingTaskInput"
+                additionalProperties: false
     schemas:
         energetics.IFetchConsumptionInput:
             type: object
@@ -358,4 +398,52 @@ components:
                 T1_Wh_raw_data:
                     type: array
                     description: Array of timestamps and values of measurements
+        energetics.IEnoLookupTaskInput:
+            type: object
+            required:
+                - type
+            properties:
+                type:
+                    type: string
+                    description: Type of lookup data to fetch from ENO system
+                    enum:
+                        - "getDruhStavba"
+                        - "getOrganizace"
+                        - "getSpravce"
+                        - "getEvidencniJednotky"
+                    examples:
+                        - "getDruhStavba"
+                        - "getOrganizace"
+                        - "getSpravce"
+                        - "getEvidencniJednotky"
+            additionalProperties: false
+        energetics.IEnoBuildingTaskInput:
+            type: object
+            required:
+                - type
+                - source
+            properties:
+                type:
+                    type: string
+                    description: Type of synchronization (current buildings or removed buildings)
+                    enum:
+                        - "current"
+                        - "removed"
+                    examples:
+                        - "current"
+                        - "removed"
+                source:
+                    type: string
+                    description: Data source identifier (e.g., "mhmp" for Hlavní město Praha)
+                    examples:
+                        - "mhmp"
+                daysBack:
+                    type: number
+                    description: Optional parameter for incremental synchronization - number of days to look back. If not provided, performs full synchronization.
+                    minimum: 1
+                    examples:
+                        - 7
+                        - 30
+                        - 90
+            additionalProperties: false
 

package/docs/implementation_documentation.md

@@ -164,6 +164,39 @@ https://gitlab.com/operator-ict/golemio/projekty/energetika/p0262.prevzeti-energ
 -   názvy rabbitmq front
     -   dataplatform.energeticscommodity.fetchMeasurementOptionsStaticData
 
+#### _ENO (Evidenční nástroj organizací) - SOAP/WSDL API_
+
+-   zdroj dat
+    -   WSDL URL pro číselníky: module.energetics.eno.wsdlLookupUrl
+    -   WSDL URL pro budovy: module.energetics.eno.wsdlBuildingUrl
+    -   autentizace: BasicAuth (module.energetics.eno.{source}.user, module.energetics.eno.{source}.password)
+    -   API dokumentace: WSDL schéma
+-   formát dat
+    -   protokol: SOAP/XML
+    -   datový typ: XML → JSON
+    -   validační schémata:
+        -   Číselníky:
+            -   [EnoStructureTypeInput](../src/schema-definitions/datasources/eno/EnoStructureTypeInputJsonSchema.ts) - druhy staveb
+            -   [EnoOrganizationInput](../src/schema-definitions/datasources/eno/EnoOrganizationInputJsonSchema.ts) - organizace
+            -   [EnoManagerInput](../src/schema-definitions/datasources/eno/EnoManagerInputJsonSchema.ts) - správci
+            -   [EnoEJInput](../src/schema-definitions/datasources/eno/EnoEJInputJsonSchema.ts) - evidenční jednotky
+        -   Budovy:
+            -   [EnoGIDListInput](../src/schema-definitions/datasources/eno/EnoGIDListInputJsonSchema.ts) - seznam GID
+            -   [EnoBuildingInfoInput](../src/schema-definitions/datasources/eno/EnoBuldingInfoJsonSchema.ts) - detail budovy
+    -   příklad vstupních dat: [test data](../test/integration-engine/data/eno/)
+-   frekvence stahování
+    -   podle potřeby přes RabbitMQ tasky
+-   datové operace
+    -   Číselníky (Lookups):
+        -   `getDruhStavba` - získání druhů staveb
+        -   `getOrganizace` - získání organizací
+        -   `getSpravce` - získání správců
+        -   `getEvidencniJednotky` - získání evidenčních jednotek
+    -   Budovy:
+        -   `getBudovyVMajetku` - získání seznamu GID budov v majetku organizace
+        -   `getDetailBudovy` - získání detailu budov podle seznamu GID
+        -   `getVyrazeneBudovy` - získání seznamu GID vyřazených budov
+
 ## Zpracování dat / transformace
 
 Všechny tabulky se nachází ve schématu `energetics`
@@ -429,7 +462,7 @@ Metoda sbírá data o spotřebách od poskytovatele komodit - PPAS (Pražská pl
 -   data modely
     -   [EnapoMeasurementsModel](../src/schema-definitions/models/EnapoMeasurementsModel.ts) tabulka `enapo_measurements`
 
-#### _task: EnapoPrediTask
+#### _task: EnapoPrediTask_
 
 Task zpracovává zasílaná data o spotřebě elektřiny. Data jsou nám zasílána
 
@@ -450,13 +483,75 @@ Task zpracovává zasílaná data o spotřebě elektřiny. Data jsou nám zasíl
         -   default time for meter change is set to static value `10:00` Europe/Prague time
         -   If change occurs e.g. `"meter_replaced": "2025-06-19|54292510|55505332|2025-06-30|55505332|96933662"` measurements before 19.6.2025 will have serial number `54292510`      measurements after `2025-06-19 10:00` will have serial number `55505332` and measurements after `2025-06-30 10:00` will have serial number `96933662`
         -   [DeviceSerialNumberExtractor](../src/integration-engine/enapo/transformations/pre/helpers/DeviceSerialNumberExtractor.ts)
-
-        -   
 -   data modely
     -   [EnapoMeasurementsModel](../src/schema-definitions/models/enapo/EnapoMeasurementsModel.ts) tabulka `enapo_measurements`
     -   [EnapoMetadataModel](../src/schema-definitions/models/enapo/EnapoMetadataModel.ts) tabulka `enapo_metadata`
     -   [PreIncomingDataLogModel](../src/schema-definitions/models/enapo/PreIncomingDataLogModel.ts) tabulka `enapo_log_pre`
 
+#### _task: EnoLookupTask_
+
+Task stahuje číselníková (lookup) data ze systému ENO (Evidenční nástroj organizací) včetně druhů staveb, organizací, správců a evidenčních jednotek.
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.processEnoLookup
+    -   TTL: 1 hodina
+    -   parametry: `{ type }` - typ číselníku (`getDruhStavba` | `getOrganizace` | `getSpravce` | `getEvidencniJednotky`)
+    -   validační schéma: [EnoLookupTaskInputSchema](../src/integration-engine/enapo/workers/schema/EnoLookupTaskInputSchema.ts)
+-   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
+    -   žádné
+-   datové zdroje
+    -   ENO SOAP/WSDL API (Lookups endpoint)
+    -   [EnoDatasource](../src/integration-engine/enapo/datasources/eno/EnoDatasource.ts)
+    -   [EnoDatasourceFactory](../src/integration-engine/enapo/datasources/eno/EnoDatasourceFactory.ts)
+-   transformace
+    -   [EnoStructureTypeTransformation](../src/integration-engine/enapo/transformations/eno/EnoStructureTypeTransformation.ts) - transformace druhů staveb
+    -   [EnoOrganizationTransformation](../src/integration-engine/enapo/transformations/eno/EnoOrganizationTransformation.ts) - transformace organizací
+    -   [EnoManagerTransformation](../src/integration-engine/enapo/transformations/eno/EnoManagerTransformation.ts) - transformace správců
+    -   [EnoEJTransformation](../src/integration-engine/enapo/transformations/eno/EnoEJTransformation.ts) - transformace evidenčních jednotek
+-   data modely
+    -   [StructureTypeModel](../src/schema-definitions/models/eno/StructureTypeModel.ts) tabulka `eno_struktura_typ_lookup`
+    -   [OrganizationLookupModel](../src/schema-definitions/models/eno/OrganizationLookupModel.ts) tabulka `eno_organizace_lookup`
+    -   [ManagerLookupModel](../src/schema-definitions/models/eno/ManagerLookupModel.ts) tabulka `eno_spravce_lookup`
+    -   [EJLookupModel](../src/schema-definitions/models/eno/EJLookupModel.ts) tabulka `eno_ej_lookup`
+-   unit testy
+    -   [EnoLookupTask.test.ts](../test/integration-engine/enapo/task/EnoLookupTask.test.ts)
+
+#### _task: EnoBuildingTask_
+
+Task stahuje data o budovách ze systému ENO včetně detailních informací o budovách, adresách, umístění a majetkových vztazích. Podporuje plnou i inkrementální synchronizaci (pomocí parametru `daysBack`).
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.processEnoBuildings
+    -   TTL: 1 hodina
+    -   parametry: `{ type, source, daysBack? }`
+        -   `type` - typ synchronizace (`current` | `removed`)
+        -   `source` - zdroj dat (např. `mhmp`)
+        -   `daysBack` - volitelný parametr pro inkrementální synchronizaci (počet dní zpětně)
+    -   validační schéma: [EnoBuildingTaskInputSchema](../src/integration-engine/enapo/workers/schema/EnoBuildingTaskInputSchema.ts)
+-   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
+    -   žádné
+-   datové zdroje
+    -   ENO SOAP/WSDL API (Buildings endpoint)
+    -   [EnoDatasource](../src/integration-engine/enapo/datasources/eno/EnoDatasource.ts)
+    -   [EnoDatasourceFactory](../src/integration-engine/enapo/datasources/eno/EnoDatasourceFactory.ts)
+-   transformace
+    -   [EnoBuildingTransformation](../src/integration-engine/enapo/transformations/eno/EnoBuildingTransformation.ts) - transformace dat budov
+        -   Transformuje budovu, majetek, adresy a umístění
+        -   Zpracovává pole adres a umístění s přidělením pořadí (poradi)
+-   data modely
+    -   [BuildingModel](../src/schema-definitions/models/eno/BuildingModel.ts) tabulka `eno_budova`
+    -   [PropertyModel](../src/schema-definitions/models/eno/PropertyModel.ts) tabulka `eno_majetek`
+    -   [AddressModel](../src/schema-definitions/models/eno/AddressModel.ts) tabulka `eno_adresa`
+    -   [LocationModel](../src/schema-definitions/models/eno/LocationModel.ts) tabulka `eno_umisteni`
+    -   [RemovedGIDModel](../src/schema-definitions/models/eno/RemovedGIDModel.ts) tabulka `eno_vyrazene_gid`
+-   funkce
+    -   **Plná synchronizace**: Stáhne všechny budovy v majetku organizace (bez parametru `daysBack`)
+    -   **Inkrementální synchronizace**: Stáhne pouze budovy změněné za posledních X dní (s parametrem `daysBack`)
+    -   **Vyřazené budovy**: Pro typ `removed` ukládá GID vyřazených budov do speciální tabulky. Datový zdroj povinně vyžaduje datum od kdy. Ve výchozím stavu je nastaveno od `2025-01-01T00:00:00+01:00` lze to upravit v konfiguraci změnou `module.energetics.eno.removedBuldingsStartDate`.
+    -   **Transakční zpracování**: Všechny operace zápisu probíhají v databázové transakci pro zajištění konzistence
+-   unit testy
+    -   [EnoBuildingTask.test.ts](../test/integration-engine/enapo/task/EnoBuildingTask.test.ts)
+
 ## Uložení dat
 
 -   typ databáze

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/energetics",
-    "version": "1.5.2",
+    "version": "1.5.3-dev.2164524892",
     "description": "Golemio Energetics Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -76,7 +76,8 @@
     },
     "dependencies": {
         "basic-ftp": "^5.0.2",
-        "JSONStream": "^1.3.5"
+        "JSONStream": "^1.3.5",
+        "soap": "^1.6.0"
     },
     "overrides": {}
 }