@golemio/energetics 1.8.3 → 1.9.0-dev.2567800850

package/dist/schema-definitions/models/porsenna/interfaces/IBuildings.js.map

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

package/dist/schema-definitions/models/porsenna/interfaces/IConsumption.d.ts

@@ -0,0 +1,10 @@
+export interface IConsumption {
+    source: string;
+    device_id: string;
+    var: string;
+    period: string;
+    value: number;
+    unit: string;
+    commodity: string | null;
+    count: number | null;
+}

package/dist/schema-definitions/models/porsenna/interfaces/IConsumption.js

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

package/dist/schema-definitions/models/porsenna/interfaces/IConsumption.js.map

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

package/dist/schema-definitions/models/porsenna/interfaces/IDevices.d.ts

@@ -0,0 +1,17 @@
+export interface IDevices {
+    source: string;
+    id: string;
+    building_id: number | null;
+    parent_device_id: string | null;
+    level: string | null;
+    type: string | null;
+    name: string | null;
+    measurement_target: string | null;
+    disabled_at: string | null;
+    disable_reason_id: number | null;
+    show_in_output: boolean | null;
+    identifier: string | null;
+    supply_point_number: string | null;
+    meter_number: string | null;
+    identification_gid: string | null;
+}

package/dist/schema-definitions/models/porsenna/interfaces/IDevices.js

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

package/dist/schema-definitions/models/porsenna/interfaces/IDevices.js.map

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

package/docs/implementation_documentation.md

@@ -46,6 +46,8 @@ https://gitlab.com/operator-ict/golemio/projekty/energetika/p0262.prevzeti-energ
     -   Jedná se o odběratele různých kategorií odběru („A“ „C“ „MO“), konkrétně: účet Hl. m. Praha = „C“; Hlavní m. Praha = „MO“ a HlavníměstoPraha64581_1 = „A“
 -   Azure Blob Storage
     -   Mapovací JSON pro měření přímo od poskytovatelů komodit
+-   Porsenna e-Manazer API
+    -   Měřidla a roční spotřeby pro P7
 
 #### _OICT Energetika_
 
@@ -113,11 +115,13 @@ https://gitlab.com/operator-ict/golemio/projekty/energetika/p0262.prevzeti-energ
 #### _PPAS (Pražská plynárenská) InternetAVE API_
 
 -   zdroj dat
-    -   url: https://iave.ppas.cz/website/api (module.energetics.commodityProviders.ppas_ave_api.baseUrl)
-    -   API dokumentace: https://www.ave-system.com/Content/download/AveRestApiDocumentation.pdf
+    -   url: https://aveapi.ppas.cz/api/v1 (module.energetics.commodityProviders.ppas_ave_api.baseUrl)
+    -   API dokumentace: https://aveapi.ppas.cz/api/docs/v1 (interaktivní Swagger: https://aveapi.ppas.cz/api/swagger/ui/index)
+    -   endpointy: `/devices` (seznam OM), `/devices/{deviceId}/data/archive` (archivní data)
+    -   autentizace: HTTP header `X-API-Key` (per-uživatel apiKey v configu, např. `module.energetics.commodityProviders.ppas_ave_api_mo.apiKey`)
 -   formát dat
     -   protokol: http
-    -   datový typ: json
+    -   datový typ: json (archive endpoint vrací columnar `{ headers, rows }` — rozbaluje se v [ArchiveDataTypeStrategy](../src/integration-engine/commodity-providers/datasources/ppas-ave-api/helpers/ArchiveDataTypeStrategy.ts))
     -   validační schéma: [Places](../src/schema-definitions/datasources/commodity-providers/AveApiPlacesJsonSchema.ts), [DeviceData](../src/schema-definitions/datasources/commodity-providers/AveApiDeviceDataJsonSchema.ts)
     -   příklad vstupnich dat: viz [test](../test/integration-engine/commodity-providers/FetchPpasMeasurementsTask.test.ts)
 -   frekvence stahování
@@ -209,6 +213,21 @@ https://gitlab.com/operator-ict/golemio/projekty/energetika/p0262.prevzeti-energ
     -   Geometrie:
         -   `getGeometrie` - získání geometrie (polygonů) pro seznam GID budov/staveb
 
+#### _Porsenna (e-Manazer) REST API_
+
+-   zdroj dat
+    -   url: https://api.e-manazer.cz/gauges (module.energetics.enapo.porsenna.url)
+    -   autentizace: Bearer token (module.energetics.enapo.porsenna.token)
+    -   source identifikátor: `porsenna_p7`
+-   formát dat
+    -   protokol: http (REST)
+    -   datový typ: json (Hydra kolekce se stránkováním)
+    -   validační schémata: [PorsennaJsonSchema](../src/schema-definitions/datasources/enapo/porsenna/PorsennaJsonSchema.ts)
+-   datasource
+    -   [PorsennaDataSource](../src/integration-engine/enapo/datasources/porsenna/PorsennaDataSource.ts)
+        -   `generateAsyncPages()` - stránkované získání všech měřidel
+        -   `getGaugeConsumption(id, from, to)` - roční spotřeba pro jedno měřidlo
+
 ## Zpracování dat / transformace
 
 Všechny tabulky se nachází ve schématu `energetics`
@@ -689,6 +708,28 @@ Task stahuje fakturační data distribuce od PPAS včetně informací o fakturá
     -   [PpasDistributionInvoiceDeviceModel](../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoiceDeviceModel.ts) tabulka `ppas_distribution_invoice_device` - zařízení a odečty
     -   [PpasDistributionInvoicePriceModel](../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoicePriceModel.ts) tabulka `ppas_distribution_invoice_price` - cenové položky
 
+#### _task: PorsennaDistributionTask_
+
+Task stahuje data o měřidlech a spotřebách z Porsenna API (e-Manazer).
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.fetchPorsennaDistribution
+    -   TTL: 1 hodina
+    -   parametry: `{ yearFrom, yearTo }`
+    -   validační schéma: [EnapoPorsennaDistributionParamsSchema](../src/integration-engine/enapo/workers/schema/EnapoPorsennaDistributionParamsSchema.ts)
+-   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
+    -   žádné
+-   datové zdroje
+    -   Porsenna e-Manazer API
+    -   [PorsennaDataSource](../src/integration-engine/enapo/datasources/porsenna/PorsennaDataSource.ts)
+-   transformace
+    -   [PorsennaGaugeTransformation](../src/integration-engine/enapo/transformations/porsenna/PorsennaGaugeTransformation.ts) - transformace měřidel na budovy a zařízení
+    -   [PorsennaConsumptionTransformation](../src/integration-engine/enapo/transformations/porsenna/PorsennaConsumptionTransformation.ts) - transformace spotřeb
+-   data modely
+    -   [PorsennaBuildingsModel](../src/schema-definitions/models/porsenna/PorsennaBuildingsModel.ts) tabulka `enapo_porsenna_buildings`
+    -   [PorsennaDevicesModel](../src/schema-definitions/models/porsenna/PorsennaDevicesModel.ts) tabulka `enapo_porsenna_devices`
+    -   [PorsennaConsumptionModel](../src/schema-definitions/models/porsenna/PorsennaConsumptionModel.ts) tabulka `enapo_porsenna_consumption`
+
 ## Uložení dat
 
 -   typ databáze

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/energetics",
-    "version": "1.8.3",
+    "version": "1.9.0-dev.2567800850",
     "description": "Golemio Energetics Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -31,22 +31,22 @@
         "url": "https://gitlab.com/operator-ict/golemio/code/modules/energetics"
     },
     "engines": {
-        "node": ">=22.0.0",
-        "npm": ">=10.0.0"
+        "node": ">=24.0.0",
+        "npm": ">=11.0.0"
     },
     "devDependencies": {
         "@apideck/portman": "^1.26.5",
         "@commitlint/cli": "^11.0.0",
         "@commitlint/config-conventional": "^11.0.0",
         "@golemio/cli": "1.11.2",
-        "@golemio/core": "3.1.0",
+        "@golemio/core": "^3.0.7-dev.2498788773",
         "@golemio/db-common": "1.2.2",
         "@golemio/eslint-config": "1.1.3",
         "@types/adm-zip": "^0.5.8",
         "@types/chai": "^5.2.3",
         "@types/chai-as-promised": "^8.0.2",
         "@types/mocha": "^10.0.10",
-        "@types/node": "^22.19.8",
+        "@types/node": "^24.12.4",
         "@types/papaparse": "^5.3.14",
         "@types/sinon": "^21.0.0",
         "@types/supertest": "^6.0.3",
@@ -80,9 +80,13 @@
     },
     "dependencies": {
         "adm-zip": "^0.5.16",
-        "basic-ftp": "^5.2.2",
+        "basic-ftp": "^6.0.1",
         "JSONStream": "^1.3.5",
-        "soap": "^1.8.0"
+        "soap": "^1.9.1"
     },
-    "overrides": {}
+    "overrides": {
+        "soap": {
+            "@xmldom/xmldom": "0.9.10"
+        }
+    }
 }