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

package/docs/asyncapi.yaml

@@ -180,6 +180,28 @@ channels:
         messages:
             enoBuildingMessage:
                 $ref: "#/components/messages/energetics.EnoBuildingMessage"
+    energetics.processEnoStructures:
+        address: dataplatform.enapoenergetics.processEnoStructures
+        description: downloads structure (stavba) data from ENO SOAP/WSDL API including structures, properties, addresses, and locations. Supports full and incremental synchronization using daysBack parameter. After successful processing, triggers geometry download. Stores data in database tables (eno_stavba, eno_majetek, eno_adresa, eno_umisteni, eno_vyrazene_gid)
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            enoStructureMessage:
+                $ref: "#/components/messages/energetics.EnoBuildingMessage"
+    energetics.processEnoGeometry:
+        address: dataplatform.enapoenergetics.processEnoGeometry
+        description: downloads geometry (polygons) for buildings and structures from ENO SOAP/WSDL API. Automatically triggered after building or structure synchronization. Stores data in database table (eno_geometrie)
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            enoGeometryMessage:
+                $ref: "#/components/messages/energetics.EnoGeometryMessage"
 operations:
     energetics.fetchAccessConfiguration:
         action: "send"
@@ -245,6 +267,14 @@ operations:
         action: "send"
         channel:
             $ref: "#/channels/energetics.processEnoBuildings"
+    energetics.processEnoStructures:
+        action: "send"
+        channel:
+            $ref: "#/channels/energetics.processEnoStructures"
+    energetics.processEnoGeometry:
+        action: "send"
+        channel:
+            $ref: "#/channels/energetics.processEnoGeometry"
 components:
     messages:
         emptyMessage:
@@ -294,6 +324,11 @@ components:
                 type: object
                 $ref: "#/components/schemas/energetics.IEnoBuildingTaskInput"
                 additionalProperties: false
+        energetics.EnoGeometryMessage:
+            payload:
+                type: object
+                $ref: "#/components/schemas/energetics.IEnoGeometryTaskInput"
+                additionalProperties: false
     schemas:
         energetics.IFetchConsumptionInput:
             type: object
@@ -446,4 +481,23 @@ components:
                         - 30
                         - 90
             additionalProperties: false
+        energetics.IEnoGeometryTaskInput:
+            type: object
+            required:
+                - source
+                - listGid
+            properties:
+                source:
+                    type: string
+                    description: Data source identifier (e.g., "mhmp" for Hlavní město Praha)
+                    examples:
+                        - "mhmp"
+                listGid:
+                    type: array
+                    items:
+                        type: string
+                    description: List of GID identifiers for which to fetch geometry data
+                    examples:
+                        - ["GID312203", "GID311624"]
+            additionalProperties: false
 

package/docs/implementation_documentation.md

@@ -196,6 +196,12 @@ https://gitlab.com/operator-ict/golemio/projekty/energetika/p0262.prevzeti-energ
         -   `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
 
@@ -552,6 +558,74 @@ Task stahuje data o budovách ze systému ENO včetně detailních informací o
 -   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.2164524892",
+    "version": "1.5.3-dev.2177936068",
     "description": "Golemio Energetics Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/dist/integration-engine/enapo/workers/interfaces/IEnoBuildingTaskInput.d.ts

@@ -1,5 +0,0 @@
-export interface IEnoBuildingTaskInput {
-    type: string;
-    source: string;
-    daysBack?: number;
-}

package/dist/integration-engine/enapo/workers/interfaces/IEnoBuildingTaskInput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"IEnoBuildingTaskInput.js","sourceRoot":"","sources":["../../../../../src/integration-engine/enapo/workers/interfaces/IEnoBuildingTaskInput.ts"],"names":[],"mappings":""}

package/dist/integration-engine/enapo/workers/schema/EnoBuildingTaskInputSchema.d.ts

@@ -1,6 +0,0 @@
-import { IEnoBuildingTaskInput } from "../interfaces/IEnoBuildingTaskInput";
-export declare class EnoBuildingTaskInputSchema implements IEnoBuildingTaskInput {
-    type: string;
-    source: string;
-    daysBack?: number;
-}

package/dist/integration-engine/enapo/workers/schema/EnoBuildingTaskInputSchema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnoBuildingTaskInputSchema.js","sourceRoot":"","sources":["../../../../../src/integration-engine/enapo/workers/schema/EnoBuildingTaskInputSchema.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+EAAmG;AAGnG,MAAa,0BAA0B;CAUtC;AAVD,gEAUC;AARG;IADC,IAAA,wBAAM,EAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;;wDACjB;AAGd;IADC,IAAA,0BAAQ,GAAE;;0DACK;AAIhB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4DACO"}