@golemio/energetics 1.8.3 → 1.9.0

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_
 
@@ -209,6 +211,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 +706,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",
     "description": "Golemio Energetics Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -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"
+        }
+    }
 }