@golemio/energetics 1.5.3-dev.2115789253 → 1.5.3-dev.2177936068

package/docs/implementation_documentation.md

@@ -164,6 +164,45 @@ 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
+    -   Stavby:
+        -   `getStavbyVMajetku` - získání seznamu GID staveb v majetku organizace
+        -   `getDetailStavby` - získání detailu staveb podle seznamu GID
+        -   `getVyrazeneStavby` - získání seznamu GID vyřazených staveb
+    -   Geometrie:
+        -   `getGeometrie` - získání geometrie (polygonů) pro seznam GID budov/staveb
+
 ## Zpracování dat / transformace
 
 Všechny tabulky se nachází ve schématu `energetics`
@@ -429,7 +468,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 +489,143 @@ 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)
+
+#### _task: EnoStructureTask_
+
+Task stahuje data o stavbách ze systému ENO včetně detailních informací o stavbách, adresách, umístění a majetkových vztazích. Podporuje plnou i inkrementální synchronizaci (pomocí parametru `daysBack`). Po úspěšném stažení staveb automaticky spouští stahování geometrií.
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.processEnoStructures
+    -   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)
+    -   dataplatform.enapoenergetics.processEnoGeometry - po úspěšném stažení staveb
+-   datové zdroje
+    -   ENO SOAP/WSDL API (Structure endpoint)
+    -   [EnoDatasource](../src/integration-engine/enapo/datasources/eno/EnoDatasource.ts)
+    -   [EnoDatasourceFactory](../src/integration-engine/enapo/datasources/eno/EnoDatasourceFactory.ts)
+-   transformace
+    -   [EnoStructureTransformation](../src/integration-engine/enapo/transformations/eno/EnoStructureTransformation.ts) - transformace dat staveb
+        -   Transformuje stavbu, majetek, adresy a umístění
+        -   Zpracovává pole adres a umístění s přidělením pořadí (poradi)
+-   data modely
+    -   [StructureModel](../src/schema-definitions/models/eno/StructureModel.ts) tabulka `eno_stavba`
+    -   [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 stavby v majetku organizace (bez parametru `daysBack`)
+    -   **Inkrementální synchronizace**: Stáhne pouze stavby změněné za posledních X dní (s parametrem `daysBack`)
+    -   **Vyřazené stavby**: Pro typ `removed` ukládá GID vyřazených staveb do speciální tabulky
+    -   **Transakční zpracování**: Všechny operace zápisu probíhají v databázové transakci pro zajištění konzistence
+    -   **Automatické stažení geometrií**: Po úspěšném zpracování staveb odesílá zprávu do fronty pro stažení geometrií
+-   unit testy
+    -   [EnoStructureTask.test.ts](../test/integration-engine/enapo/task/EnoStructureTask.test.ts)
+
+#### _task: EnoGeometryTask_
+
+Task stahuje geometrie (polygony) pro budovy a stavby ze systému ENO. Je automaticky spouštěn po dokončení synchronizace budov nebo staveb.
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.processEnoGeometry
+    -   TTL: 1 hodina
+    -   parametry: `{ source, listGid }`
+        -   `source` - zdroj dat (např. `mhmp`)
+        -   `listGid` - seznam GID pro které se má stáhnout geometrie
+    -   validační schéma: [EnoGeometryTaskInputSchema](../src/integration-engine/enapo/workers/schema/EnoGeometryTaskInputSchema.ts)
+-   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
+    -   žádné
+-   datové zdroje
+    -   ENO SOAP/WSDL API (Geometry endpoint)
+    -   [EnoDatasource](../src/integration-engine/enapo/datasources/eno/EnoDatasource.ts)
+    -   [EnoDatasourceFactory](../src/integration-engine/enapo/datasources/eno/EnoDatasourceFactory.ts)
+-   transformace
+    -   [EnoGeometryTransformation](../src/integration-engine/enapo/transformations/eno/EnoGeometryTransformation.ts) - transformace geometrických dat
+        -   Zpracovává polygony ve formátu WKT (Well-Known Text)
+        -   Přiděluje pořadí (poradi) pro více geometrií se stejným GID
+        -   Podporuje EPSG kód pro souřadnicový systém
+-   data modely
+    -   [GeometryModel](../src/schema-definitions/models/eno/GeometryModel.ts) tabulka `eno_geometrie`
+-   funkce
+    -   **Stažení geometrií**: Stáhne geometrie pro zadaný seznam GID
+    -   **Podpora více geometrií**: Jeden GID může mít více geometrií (např. budova s více polygony), každá dostane unikátní pořadí
+    -   **EPSG kód**: Podporuje různé souřadnicové systémy (výchozí S-JTSK = 5514)
+-   unit testy
+    -   [EnoGeometryTask.test.ts](../test/integration-engine/enapo/task/EnoGeometryTask.test.ts)
+
 ## Uložení dat
 
 -   typ databáze

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/energetics",
-    "version": "1.5.3-dev.2115789253",
+    "version": "1.5.3-dev.2177936068",
     "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": {}
 }