@golemio/energetics 1.12.2-dev.2739893110 → 1.12.2-dev.2740931754

package/dist/schema-definitions/models/enapo/ppas/PpasDistributionInvoicePriceModel.js

@@ -8,6 +8,7 @@ exports.PpasDistributionInvoicePriceModel = PpasDistributionInvoicePriceModel;
 PpasDistributionInvoicePriceModel.TABLE_NAME = "enapo_ppas_distribution_invoice_price";
 PpasDistributionInvoicePriceModel.attributeModel = {
     invoice_id: { type: sequelize_1.DataTypes.STRING, primaryKey: true },
+    place_id: { type: sequelize_1.DataTypes.STRING, primaryKey: true },
     customer_id: { type: sequelize_1.DataTypes.STRING, primaryKey: true },
     date_from: { type: sequelize_1.DataTypes.DATEONLY, primaryKey: true },
     date_to: { type: sequelize_1.DataTypes.DATEONLY, primaryKey: true },
@@ -17,7 +18,7 @@ PpasDistributionInvoicePriceModel.attributeModel = {
     quantity: { type: sequelize_1.DataTypes.DECIMAL },
     unit: { type: sequelize_1.DataTypes.STRING },
     unit_price: { type: sequelize_1.DataTypes.DECIMAL },
-    time_slot: { type: sequelize_1.DataTypes.INTEGER },
+    time_slot: { type: sequelize_1.DataTypes.DECIMAL },
     price_netto: { type: sequelize_1.DataTypes.DECIMAL },
     price_type: { type: sequelize_1.DataTypes.STRING, primaryKey: true },
     currency: { type: sequelize_1.DataTypes.STRING },
@@ -29,6 +30,7 @@ PpasDistributionInvoicePriceModel.jsonSchema = {
         type: "object",
         properties: {
             invoice_id: { type: "string" },
+            place_id: { type: "string" },
             customer_id: { type: "string" },
             date_from: { type: "string" },
             date_to: { type: "string" },
@@ -38,13 +40,13 @@ PpasDistributionInvoicePriceModel.jsonSchema = {
             quantity: { type: "number" },
             unit: { type: "string" },
             unit_price: { type: "number" },
-            time_slot: { type: "number" },
+            time_slot: { oneOf: [{ type: "number" }, { type: "null", nullable: true }] },
             price_netto: { type: "number" },
             price_type: { type: "string" },
             currency: { type: "string" },
             tax_rate: { type: "number" },
         },
-        required: ["invoice_id", "customer_id", "date_from", "date_to", "kind", "price_type"],
+        required: ["invoice_id", "place_id", "customer_id", "date_from", "date_to", "kind", "price_type"],
     },
 };
 //# sourceMappingURL=PpasDistributionInvoicePriceModel.js.map

package/dist/schema-definitions/models/enapo/ppas/PpasDistributionInvoicePriceModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"PpasDistributionInvoicePriceModel.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoicePriceModel.ts"],"names":[],"mappings":";;;AAAA,mEAAwF;AAIxF,MAAa,iCACT,SAAQ,iBAAoC;;AADhD,8EAgEC;AA5DiB,4CAAU,GAAG,uCAAuC,CAAC;AAkBrD,gDAAc,GAAsF;IAC9G,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IACxD,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IACzD,SAAS,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;IACzD,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE;IACvD,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IAClD,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE;IACvC,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,OAAO,EAAE;IACrC,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE;IAChC,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,OAAO,EAAE;IACtC,WAAW,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,OAAO,EAAE;IACxC,UAAU,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,MAAM,EAAE;IACpC,QAAQ,EAAE,EAAE,IAAI,EAAE,qBAAS,CAAC,OAAO,EAAE;CACxC,CAAC;AAEY,4CAAU,GAAoD;IACxE,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC9B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC/B;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC;KACxF;CACJ,CAAC"}
+{"version":3,"file":"PpasDistributionInvoicePriceModel.js","sourceRoot":"","sources":["../../../../../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoicePriceModel.ts"],"names":[],"mappings":"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"}

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoice.d.ts

@@ -12,7 +12,7 @@ export interface IPpasDistributionInvoice {
     customer_address_city_part: string;
     customer_address_post_code: string;
     customer_address_country: string;
-    customer_address_ruian_id: number;
+    customer_address_ruian_id: number | null;
     facts_doc_date: string;
     facts_net_date: string;
     facts_billing_transaction: string;
@@ -21,20 +21,4 @@ export interface IPpasDistributionInvoice {
     facts_price_brutto: number;
     is_canceled?: boolean;
     canceled_reason?: string;
-    eic: string;
-    place_id: string;
-    installations_billing_class: string;
-    installations_measurement_type: string;
-    installations_contract_contract_id: string | null;
-    installations_contract_move_in_date: string;
-    installations_contract_move_out_date: string;
-    installations_tdd_class: string;
-    installations_address_street: string;
-    installations_address_house_number: string | null;
-    installations_address_house_org_number: string | null;
-    installations_address_city: string;
-    installations_address_city_part: string;
-    installations_address_post_code: string;
-    installations_address_country: string;
-    installations_address_ruian_id: number;
 }

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoiceDevice.d.ts

@@ -1,18 +1,20 @@
 export interface IPpasDistributionInvoiceDevice {
     device_serial_number: string;
     invoice_id: string;
+    /** One invoice can bill several installations, so invoice_id alone no longer identifies a device. */
+    place_id: string;
     date_from: string;
     date_to: string;
     reading_type: string;
     type: string;
     kind: string;
-    reading_from: number;
-    reading_to: number;
-    consumption: number;
+    reading_from: number | null;
+    reading_to: number | null;
+    consumption: number | null;
     unit: string;
     meter_reading_type: string | null;
-    gas_consumption_kwh: number;
-    volume_coefficient: number;
-    combustion_heat: number;
-    normometers_nm3: number;
+    gas_consumption_kwh: number | null;
+    volume_coefficient: number | null;
+    combustion_heat: number | null;
+    normometers_nm3: number | null;
 }

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoiceInstallation.d.ts

@@ -0,0 +1,20 @@
+export interface IPpasDistributionInvoiceInstallation {
+    invoice_id: string;
+    customer_id: string;
+    place_id: string;
+    eic: string;
+    billing_class: string;
+    measurement_type: string;
+    contract_contract_id: string | null;
+    contract_move_in_date: string;
+    contract_move_out_date: string;
+    tdd_class: string;
+    address_street: string;
+    address_house_number: string | null;
+    address_house_org_number: string | null;
+    address_city: string;
+    address_city_part: string;
+    address_post_code: string;
+    address_country: string;
+    address_ruian_id: number | null;
+}

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoiceInstallation.js

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

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoiceInstallation.js.map

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

package/dist/schema-definitions/models/enapo/ppas/interfaces/IPpasDistributionInvoicePrice.d.ts

@@ -1,5 +1,7 @@
 export interface IPpasDistributionInvoicePrice {
     invoice_id: string;
+    /** Without it two installations on one invoice collide on the primary key and overwrite each other. */
+    place_id: string;
     date_from: string;
     date_to: string;
     kind: string;
@@ -8,7 +10,7 @@ export interface IPpasDistributionInvoicePrice {
     quantity: number;
     unit: string;
     unit_price: number;
-    time_slot: number;
+    time_slot: number | null;
     price_netto: number;
     currency: string;
     tax_rate: number;

package/dist/schema-definitions/models/eno/AddressModel.d.ts

@@ -8,7 +8,7 @@ export declare class AddressModel extends Model<IAddress> implements IAddress {
     poradi: number;
     zdroj: string;
     id: number;
-    popis: string;
+    popis: string | null;
     hlavni: boolean;
     static attributeModel: ModelAttributes<AddressModel, IAddress>;
     static jsonSchema: JSONSchemaType<IAddress[]>;

package/dist/schema-definitions/models/eno/AddressModel.js

@@ -39,7 +39,7 @@ AddressModel.jsonSchema = {
             poradi: { type: "number" },
             zdroj: { type: "string" },
             id: { type: "number" },
-            popis: { type: "string" },
+            popis: { oneOf: [{ type: "string" }, { type: "null", nullable: true }] },
             hlavni: { type: "boolean" },
         },
         required: ["gid", "gid_typ", "poradi", "zdroj"],

package/dist/schema-definitions/models/eno/AddressModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"AddressModel.js","sourceRoot":"","sources":["../../../../src/schema-definitions/models/eno/AddressModel.ts"],"names":[],"mappings":";;;AACA,mEAAwF;AAGxF,MAAa,YAAa,SAAQ,iBAAe;;AAAjD,oCAmDC;AAlD0B,uBAAU,GAAG,YAAY,CAAC;AAUnC,2BAAc,GAA4C;IACpE,GAAG,EAAE;QACD,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,OAAO,EAAE;QACL,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,MAAM,EAAE;QACJ,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,MAAM;KACzB;IACD,KAAK,EAAE;QACH,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,EAAE,EAAE;QACA,IAAI,EAAE,qBAAS,CAAC,MAAM;KACzB;IACD,KAAK,EAAE,qBAAS,CAAC,IAAI;IACrB,MAAM,EAAE,qBAAS,CAAC,OAAO;CAC5B,CAAC;AAEY,uBAAU,GAA+B;IACnD,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC9B;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;KAClD;CACJ,CAAC"}
+{"version":3,"file":"AddressModel.js","sourceRoot":"","sources":["../../../../src/schema-definitions/models/eno/AddressModel.ts"],"names":[],"mappings":";;;AACA,mEAAwF;AAGxF,MAAa,YAAa,SAAQ,iBAAe;;AAAjD,oCAmDC;AAlD0B,uBAAU,GAAG,YAAY,CAAC;AAUnC,2BAAc,GAA4C;IACpE,GAAG,EAAE;QACD,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,OAAO,EAAE;QACL,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,MAAM,EAAE;QACJ,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,MAAM;KACzB;IACD,KAAK,EAAE;QACH,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,qBAAS,CAAC,IAAI;KACvB;IACD,EAAE,EAAE;QACA,IAAI,EAAE,qBAAS,CAAC,MAAM;KACzB;IACD,KAAK,EAAE,qBAAS,CAAC,IAAI;IACrB,MAAM,EAAE,qBAAS,CAAC,OAAO;CAC5B,CAAC;AAEY,uBAAU,GAA+B;IACnD,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;YACxE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC9B;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;KAClD;CACJ,CAAC"}

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

@@ -4,6 +4,6 @@ export interface IAddress {
     poradi: number;
     zdroj: string;
     id: number;
-    popis: string;
+    popis: string | null;
     hlavni: boolean;
 }

package/docs/implementation_documentation.md

@@ -512,7 +512,7 @@ Task zpracovává zasílaná data o spotřebě elektřiny. Data jsou nám zasíl
     -   v případě, že se u measurementů vyskytnou dvě hodnoty ve stejném čase, tak se hodnoty sečtou viz [sumDuplicates](../src/integration-engine/commodity-providers/helper/PreMeasurementFilter.ts)
     -   device_serial_number is extracted from raw_data `meter_replaced` value
         -   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`
+        -   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`
@@ -691,6 +691,7 @@ Task stahuje fakturační data distribuce od PPAS včetně informací o fakturá
     -   parametry: `{ from?, to? }`
         -   `from` - datum od (formát YYYY-MM-DD), volitelné - výchozí: dnes - 3 dny
         -   `to` - datum do (formát YYYY-MM-DD), volitelné - výchozí: dnes
+        -   zdrojové API povoluje rozsah maximálně 366 dní, delší rozsah vrací chybu 400 - pro dotažení historie je nutné poslat zprávu pro každý rok zvlášť
     -   validační schéma: [EnapoPpasDistributionParamsSchema](../src/integration-engine/enapo/workers/schema/EnapoPpasDistributionParamsSchema.ts)
 -   závislé fronty (do kterých jsou odesílány zprávy z metody workeru)
     -   žádné
@@ -705,6 +706,7 @@ Task stahuje fakturační data distribuce od PPAS včetně informací o fakturá
         -   Rozlišuje mezi standardní cenou STANDARD a korekcí CORRECTION
 -   data modely
     -   [PpasDistributionInvoiceModel](../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoiceModel.ts) tabulka `ppas_distribution_invoice` - hlavičky faktur
+    -   [PpasDistributionInvoiceInstallationModel](../src/schema-definitions/models/enapo/ppas/PpasDistributionInvoiceInstallationModel.ts) tabulka `enapo_ppas_distribution_installation` - odběrná místa faktury
     -   [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
 
@@ -811,12 +813,27 @@ Task stahuje data o měřidlech a spotřebách z Porsenna API (e-Manazer).
     -   zdrojový soubor: [openapi-output.yaml](./openapi-output.yaml)
     -   rabin: https://rabin.golemio.cz/v2/docs/openapi/
     -   golem: https://api.golemio.cz/v2/docs/openapi/
-    -   přístup je řízen pomocí interního parametru `accessLimit`, který musí být vždy nastaven a omezen z permission proxy
+    -   přístup je řízen pomocí interního parametru `accessLimit`, který nastavuje permission proxy (klient ho neposílá)
         -   při obdržení dotazu na API se stáhnou povolené organizace z tabulky `access_limit` a omezí se podle toho dotazy do databáze
         -   pokud je `accessLimit` nastaven na `admin`, tak se vždy dotazuje na všechny organizace
+        -   `accessLimit` vyžadují všechny endpointy nad původní datovou doménou OICT Energetika (tabulky `organizations*` a `consumption_energy_*`), kde jsou data vázaná na organizace; endpointy projektu ENAPO (aktuální oficiální zkratka **DeD** — v URL se používá `/ded/`, tabulky si ponechávají prefix `enapo_` / `eno_`) parametr nepoužívají vůbec — data nejsou vázaná na organizace a validace `checkErrors` (`checkExact`) parametr odmítne jako nedeklarovaný s HTTP 400
 
 ### API
 
+Přehled endpointů a parametru `accessLimit`:
+
+| Endpoint                                      | Datová doména (tabulky)                  | `accessLimit`                                  |
+| --------------------------------------------- | ---------------------------------------- | ---------------------------------------------- |
+| `/v2/energetics/buildings`                    | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/buildings/:id`                | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/organizations`                | OICT Energetika (`organizations*`)       | povinný                                        |
+| `/v2/energetics/organizations/:id`            | OICT Energetika (`organizations*`)       | povinný                                        |
+| `/v2/energetics/devices`                      | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/devices/:id`                  | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/measurements`                 | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/measurements/monthly-reading` | OICT Energetika (`consumption_energy_*`) | povinný                                        |
+| `/v2/energetics/ded/buildings/:gid`           | DeD / ENAPO (`enapo_*`, `eno_*`)         | nepoužívá se — parametr je odmítnut s HTTP 400 |
+
 #### _/v2/energetics/buildings_
 
 #### _/v2/energetics/buildings/:id_
@@ -848,3 +865,27 @@ Task stahuje data o měřidlech a spotřebách z Porsenna API (e-Manazer).
 
 -   zdrojové tabulky
     -   consumption_energy_measurements
+
+#### _/v2/energetics/ded/buildings/:gid_
+
+-   detail budovy (ENO) s odběrnými místy (OM) a technickými parametry pro DeD
+-   přístup: bez `accessLimit` — endpoint čte výhradně tabulky ENAPO (`enapo_*`, `eno_*`), které nejsou vázané na organizace z domény OICT Energetika, takže se nefiltruje přes tabulku `access_limit`; parametr `accessLimit` (ani žádný jiný query parametr) endpoint nepřijímá a vrací pro něj 400
+-   zdrojové tabulky a pohledy
+    -   `v_enapo_building_detail` — pohled nad `eno_budova` (dedup přes `zdroj` pomocí `DISTINCT ON (gid)`)
+    -   `eno_adresa` — všechny adresy budovy (deduplikované podle `popis`)
+    -   `v_enapo_building_consumption_points` — pohled nad `enapo_gid_mapping` obohacený o:
+        -   `enapo_pre_metadata_history` — poslední měsíc metadat PRE (jen EAN / elektřina)
+        -   `enapo_ppas_distribution_invoice(_installation)` — poslední nestornovaná distribuční faktura (jen EIC / plyn, join přes `eic` v tabulce instalací)
+        -   `enapo_ppas_commercial_invoice(_installations)` — poslední nestornovaná obchodní faktura (jen EIC / plyn, join přes `eic`)
+        -   `UNION ALL` větev pro OM známá pouze z Porsenny (e-manažer): hlavní měřidla (`level = main`) z `enapo_porsenna_devices`, jejichž `identifier` není namapován na daný GID v `enapo_gid_mapping`; `commodity` z typu měřidla (v reálných datech existují pouze `electricity_meter` / `gasometer` / `heat_meter` / `water_meter`), `id_type` odvozen přímo z komodity (elektřina → ean, plyn → eic, teplo a voda → `om` — standardní identifikátor nemají), `link_source = 'porsenna'`, `is_active` z `disabled_at`
+    -   `v_enapo_building_porsenna_devices` — měřidla Porsenny s budovou (`enapo_porsenna_devices` × `enapo_porsenna_buildings` přes `(source, building_id)`); slouží pro obohacení OM o blok `porsenna` (měřidlo + podružná měřidla + roční spotřeby z `enapo_porsenna_consumption`) a pro blok `energy_management` na úrovni budovy
+    -   `enapo_ppas_distribution_invoice_device` / `_price`, `enapo_ppas_commercial_invoice_device` / `_price` — dotahované podle id faktury a filtrované podle `place_id` instalace (jedna faktura může účtovat více OM, bez filtru by se řádky mísily)
+-   mapovací tabulka `enapo_gid_mapping`
+    -   vlastní kontrakt modulu; aktuálně plněná mock daty (`link_source = 'mock'`)
+    -   v budoucnu ji bude plnit synchronizační task z dbt výstupu datového týmu (`tmp.ded_gid_mapping`, `link_source = 'energobroker_kod_eno'`)
+    -   sloupec `is_active` v pohledu je odvozený z `valid_to` (NULL nebo v budoucnu = aktivní); expirovaná mapování se vracejí s příznakem
+-   struktura odpovědi
+    -   komoditně specifická data jsou vnořená pod klíči `electricity` / `gas` u každého OM; v odpovědi je pouze klíč odpovídající poli `commodity`, ostatní jsou zcela vynechány
+    -   detail existuje, pokud pro GID máme jakákoli data — zná ho alespoň jeden zdroj (`eno_budova`, `eno_adresa`, `enapo_gid_mapping`, nebo Porsenna): pokud GID není v `eno_budova`, ale má adresy, namapovaná OM či měřidla, vrací se 200 s `building: null` a chybějící části jako `null` / prázdná pole (cca 29 % GIDů z mapování nemá záznam v ENO); 404 pouze pokud GID nezná žádný zdroj
+    -   OM známé z obou zdrojů (mapování i Porsenna) je v odpovědi jednou — data Porsenny jsou vnořená jako blok `porsenna` v příslušném komoditním klíči; duplicitní záznamy nevznikají
+    -   budoucí komodity (teplo, voda) se přidají jako nové klíče bez breaking change

package/docs/openapi-output.yaml

@@ -15,7 +15,18 @@ servers:
       description: Main (production) server
 tags:
     - name: ⚡ Energetics (v2)
-      description: 💡 Organizations & measurement devices
+      description: >-
+          💡 Organizations & measurement devices — the original OICT Energetika data domain
+          (`organizations*` and `consumption_energy_*` tables). All endpoints in this group are
+          organization-scoped and require the internal `accessLimit` query parameter, which is set
+          by the permission proxy (never by the client).
+    - name: 🗺️ Energetics DeD (v2)
+      description: >-
+          🏢 DeD — city-wide energy management overview for Prague buildings. A separate data
+          domain from ⚡ Energetics: ENO buildings, consumption points (OM), PRE/PPAS enrichment
+          and Porsenna e-manazer devices. Data is not organization-scoped, so these endpoints do
+          not use the `accessLimit` parameter at all — sending it (or any other unknown query
+          parameter) is rejected with HTTP 400.
 paths:
     /v2/energetics/buildings:
         get:
@@ -73,6 +84,55 @@ paths:
                             schema:
                                 $ref: "#/components/schemas/EnergeticsBuildingFull"
 
+    /v2/energetics/ded/buildings/{gid}:
+        get:
+            tags:
+                - 🗺️ Energetics DeD (v2)
+            summary: ENO building detail with consumption points (OM) and technical parameters
+            description: >-
+                Returns the ENO building (eno_budova) identified by GID together with its addresses and all
+                consumption points mapped to it. Commodity-specific data is nested under the
+                `electricity`/`gas`/`heat`/`water` keys of each consumption point; only the key matching the
+                `commodity` field is present, the others are omitted entirely.
+
+                Consumption points come from two independent sources: the energobroker mapping (EAN/EIC,
+                enriched with PRE metadata and PPAS invoices) and Porsenna e-manazer devices
+                (`link_source: porsenna`) — heat and water meters, plus any EAN/EIC the mapping lacks.
+                An OM known to both sources is returned once, with the Porsenna data nested as a `porsenna`
+                sub-block (device, sub-meters, yearly consumption) inside its commodity block. Buildings
+                tracked in Porsenna also carry an `energy_management` summary.
+
+                The endpoint returns whatever data exists for the GID: if there is any building record,
+                address, or consumption point, the response is 200 with the missing parts as `null` or
+                empty arrays (e.g. `building: null` when only consumption points or addresses are known).
+                404 is returned only when no source holds any data for the GID.
+            parameters:
+                - in: path
+                  name: gid
+                  required: true
+                  schema:
+                      type: string
+                      example: GID100
+            responses:
+                "200":
+                    description: OK
+                    headers:
+                        Cache-Control:
+                            description: Cache control directive for caching proxies
+                            schema:
+                                type: string
+                                example: public, s-maxage=21600, stale-while-revalidate=60
+                    content:
+                        application/json:
+                            schema:
+                                $ref: "#/components/schemas/EnergeticsEnoBuildingDetail"
+                "401":
+                    $ref: "#/components/responses/UnauthorizedError"
+                "404":
+                    $ref: "#/components/responses/NotFoundError"
+                "500":
+                    $ref: "#/components/responses/ServerError"
+
     /v2/energetics/devices:
         get:
             tags:
@@ -445,6 +505,208 @@ components:
                                 type: string
 
     schemas:
+        EnergeticsEnoBuildingDetail:
+            type: object
+            properties:
+                gid:
+                    type: string
+                    example: GID100
+                building:
+                    type: object
+                    nullable: true
+                    description: >-
+                        All available eno_budova attributes (Czech identifiers mirror the upstream ENO source).
+                        Null when the GID has no ENO building record and is known only through the
+                        consumption-point mapping.
+                    properties:
+                        zdroj:
+                            type: string
+                            nullable: true
+                        nazev:
+                            type: string
+                            nullable: true
+                        oznaceni:
+                            type: string
+                            nullable: true
+                        druh_vytapeni:
+                            type: string
+                            nullable: true
+                        pripojka_elektro:
+                            type: string
+                            nullable: true
+                        pripojka_voda:
+                            type: string
+                            nullable: true
+                        pripojka_kanalizace:
+                            type: string
+                            nullable: true
+                    additionalProperties: true
+                addresses:
+                    type: array
+                    items:
+                        type: object
+                        properties:
+                            popis:
+                                type: string
+                                nullable: true
+                            hlavni:
+                                type: boolean
+                                nullable: true
+                            poradi:
+                                type: number
+                energy_management:
+                    type: object
+                    nullable: true
+                    description: Porsenna (e-manazer) tracking summary; null when the building is not tracked there
+                    properties:
+                        source:
+                            type: string
+                            example: porsenna_p7
+                        building_name:
+                            type: string
+                            nullable: true
+                        address:
+                            type: string
+                            nullable: true
+                        devices_total:
+                            type: number
+                        devices_active:
+                            type: number
+                consumption_points:
+                    type: array
+                    items:
+                        $ref: "#/components/schemas/EnergeticsEnoConsumptionPoint"
+        EnergeticsEnoPorsennaBlock:
+            type: object
+            description: Porsenna (e-manazer) device detail with sub-meters and yearly consumption aggregates
+            properties:
+                device:
+                    type: object
+                    additionalProperties: true
+                sub_devices:
+                    type: array
+                    items:
+                        type: object
+                        additionalProperties: true
+                yearly_consumption:
+                    type: array
+                    items:
+                        type: object
+                        properties:
+                            period:
+                                type: string
+                                example: "2024"
+                            value:
+                                type: number
+                            unit:
+                                type: string
+                                example: GJ
+                            days_covered:
+                                type: number
+                                nullable: true
+        EnergeticsEnoConsumptionPoint:
+            type: object
+            properties:
+                place_id:
+                    type: string
+                    example: 27ZG100Z0000192O
+                id_type:
+                    type: string
+                    enum: [ean, eic, om]
+                commodity:
+                    type: string
+                    enum: [electricity, gas, heat, water]
+                is_first_gid:
+                    type: boolean
+                is_active:
+                    type: boolean
+                    description: Derived from valid_to (null or in the future means the mapping is active)
+                link_source:
+                    type: string
+                    example: mock
+                valid_from:
+                    type: string
+                    format: date
+                    nullable: true
+                valid_to:
+                    type: string
+                    format: date
+                    nullable: true
+                address:
+                    type: string
+                    nullable: true
+                    description: Consumption point address from the best available source
+                electricity:
+                    type: object
+                    description: Electricity-specific data (present only for commodity = electricity, omitted otherwise)
+                    properties:
+                        metadata:
+                            type: object
+                            nullable: true
+                            description: Latest available month of PRE metadata for the EAN
+                            additionalProperties: true
+                        porsenna:
+                            $ref: "#/components/schemas/EnergeticsEnoPorsennaBlock"
+                gas:
+                    type: object
+                    description: Gas-specific data (present only for commodity = gas, omitted otherwise)
+                    properties:
+                        porsenna:
+                            $ref: "#/components/schemas/EnergeticsEnoPorsennaBlock"
+                        distribution:
+                            type: object
+                            nullable: true
+                            description: Latest non-canceled PPAS distribution invoice with its installation, devices and prices
+                            properties:
+                                invoice:
+                                    type: object
+                                    additionalProperties: true
+                                installation:
+                                    type: object
+                                    additionalProperties: true
+                                devices:
+                                    type: array
+                                    items:
+                                        type: object
+                                        additionalProperties: true
+                                prices:
+                                    type: array
+                                    items:
+                                        type: object
+                                        additionalProperties: true
+                        commercial:
+                            type: object
+                            nullable: true
+                            description: Latest non-canceled PPAS commercial invoice with its installation, devices and prices
+                            properties:
+                                invoice:
+                                    type: object
+                                    additionalProperties: true
+                                installation:
+                                    type: object
+                                    additionalProperties: true
+                                devices:
+                                    type: array
+                                    items:
+                                        type: object
+                                        additionalProperties: true
+                                prices:
+                                    type: array
+                                    items:
+                                        type: object
+                                        additionalProperties: true
+                heat:
+                    type: object
+                    description: Heat-specific data (present only for commodity = heat, omitted otherwise; Porsenna-sourced)
+                    properties:
+                        porsenna:
+                            $ref: "#/components/schemas/EnergeticsEnoPorsennaBlock"
+                water:
+                    type: object
+                    description: Water-specific data (present only for commodity = water, omitted otherwise; Porsenna-sourced)
+                    properties:
+                        porsenna:
+                            $ref: "#/components/schemas/EnergeticsEnoPorsennaBlock"
         EnergeticsBuildingShort:
             type: object
             properties:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/energetics",
-    "version": "1.12.2-dev.2739893110",
+    "version": "1.12.2-dev.2740931754",
     "description": "Golemio Energetics Module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",