@golemio/energetics 1.12.1 → 1.12.2-dev.2727447026

package/dist/output-gateway/routers/v2/V2EnoBuildingsRouter.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.V2EnoBuildingsRouter = void 0;
+const Links_1 = require("../../constants/Links");
+const RouteVersion_1 = require("../../constants/RouteVersion");
+const Di_1 = require("../../ioc/Di");
+const ModuleContainerToken_1 = require("../../ioc/ModuleContainerToken");
+const AbstractRouter_1 = require("@golemio/core/dist/helpers/routing/AbstractRouter");
+const Validation_1 = require("@golemio/core/dist/output-gateway/Validation");
+const ioc_1 = require("@golemio/core/dist/output-gateway/ioc");
+const express_validator_1 = require("@golemio/core/dist/shared/express-validator");
+const tsyringe_1 = require("@golemio/core/dist/shared/tsyringe");
+let V2EnoBuildingsRouter = class V2EnoBuildingsRouter extends AbstractRouter_1.AbstractRouter {
+    constructor() {
+        super(RouteVersion_1.RouteVersion.v2, Links_1.DED_BUILDING_PATH);
+        this.maxAge = 6 * 60 * 60; // 6 hours
+        this.staleWhileRevalidate = 60; // 1 minute
+        this.controller = Di_1.OGEnergeticsContainer.resolve(ModuleContainerToken_1.ModuleContainerToken.EnoBuildingsController);
+        this.cacheHeaderMiddleware = Di_1.OGEnergeticsContainer.resolve(ioc_1.ContainerToken.CacheHeaderMiddleware);
+        this.initRoutes();
+    }
+    initRoutes() {
+        this.router.get("/:gid", (0, express_validator_1.param)("gid").exists().isString().not().isArray(), Validation_1.checkErrors, this.cacheHeaderMiddleware.getMiddleware(this.maxAge, this.staleWhileRevalidate), this.controller.getOne);
+    }
+};
+exports.V2EnoBuildingsRouter = V2EnoBuildingsRouter;
+exports.V2EnoBuildingsRouter = V2EnoBuildingsRouter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], V2EnoBuildingsRouter);
+//# sourceMappingURL=V2EnoBuildingsRouter.js.map

package/dist/output-gateway/routers/v2/V2EnoBuildingsRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"V2EnoBuildingsRouter.js","sourceRoot":"","sources":["../../../../src/output-gateway/routers/v2/V2EnoBuildingsRouter.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iDAAwD;AACxD,+DAA0D;AAE1D,qCAAmD;AACnD,yEAAoE;AACpE,sFAAmF;AAEnF,6EAA2E;AAC3E,+DAAuE;AACvE,mFAAoE;AACpE,iEAAgE;AAGzD,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,+BAAc;IAMpD;QACI,KAAK,CAAC,2BAAY,CAAC,EAAE,EAAE,yBAAiB,CAAC,CAAC;QAJtC,WAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU;QAChC,yBAAoB,GAAG,EAAE,CAAC,CAAC,WAAW;QAI1C,IAAI,CAAC,UAAU,GAAG,0BAAqB,CAAC,OAAO,CAAyB,2CAAoB,CAAC,sBAAsB,CAAC,CAAC;QACrH,IAAI,CAAC,qBAAqB,GAAG,0BAAqB,CAAC,OAAO,CAAwB,oBAAc,CAAC,qBAAqB,CAAC,CAAC;QACxH,IAAI,CAAC,UAAU,EAAE,CAAC;IACtB,CAAC;IAES,UAAU;QAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CACX,OAAO,EACP,IAAA,yBAAK,EAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAChD,wBAAW,EACX,IAAI,CAAC,qBAAqB,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,oBAAoB,CAAC,EAChF,IAAI,CAAC,UAAU,CAAC,MAAM,CACzB,CAAC;IACN,CAAC;CACJ,CAAA;AAtBY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,qBAAU,GAAE;;GACA,oBAAoB,CAsBhC"}

package/dist/output-gateway/transformations/EnoBuildingDetailTransformation.d.ts

@@ -0,0 +1,14 @@
+import { IEnoBuildingDetailAggregate } from "../repositories/interfaces/IEnoBuildingDetailAggregate";
+import { IEnoBuildingDetailResponse } from "../routers/interfaces/IEnoBuildingDetailResponse";
+import { AbstractTransformation } from "@golemio/core/dist/helpers/transformation/AbstractTransformation";
+export declare class EnoBuildingDetailTransformation extends AbstractTransformation<IEnoBuildingDetailAggregate, IEnoBuildingDetailResponse> {
+    name: string;
+    protected transformInternal: (element: IEnoBuildingDetailAggregate) => IEnoBuildingDetailResponse;
+    private transformPoint;
+    private transformElectricity;
+    private transformGas;
+    private buildPorsennaBlock;
+    private transformEnergyManagement;
+    private resolveAddress;
+    private composeAddress;
+}

package/dist/output-gateway/transformations/EnoBuildingDetailTransformation.js

@@ -0,0 +1,149 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnoBuildingDetailTransformation = void 0;
+const objectMappers_1 = require("../helpers/objectMappers");
+const AbstractTransformation_1 = require("@golemio/core/dist/helpers/transformation/AbstractTransformation");
+const tsyringe_1 = require("@golemio/core/dist/shared/tsyringe");
+let EnoBuildingDetailTransformation = class EnoBuildingDetailTransformation extends AbstractTransformation_1.AbstractTransformation {
+    constructor() {
+        super(...arguments);
+        this.name = "EnoBuildingDetailTransformation";
+        this.transformInternal = (element) => {
+            return {
+                gid: element.gid,
+                building: element.building === null ? null : (0, objectMappers_1.omitKeys)(element.building, ["gid"]),
+                addresses: element.addresses.map((address) => ({
+                    popis: address.popis ?? null,
+                    hlavni: address.hlavni ?? null,
+                    poradi: address.poradi,
+                })),
+                energy_management: this.transformEnergyManagement(element),
+                consumption_points: element.points.map((point) => this.transformPoint(point, element)),
+            };
+        };
+        this.transformPoint = (point, aggregate) => {
+            const porsenna = this.buildPorsennaBlock(point, aggregate);
+            return {
+                place_id: point.place_id,
+                id_type: point.id_type,
+                commodity: point.commodity,
+                is_first_gid: point.is_first_gid,
+                is_active: point.is_active,
+                link_source: point.link_source,
+                valid_from: point.valid_from,
+                valid_to: point.valid_to,
+                address: this.resolveAddress(point),
+                ...(point.commodity === "electricity" ? { electricity: this.transformElectricity(point, porsenna) } : {}),
+                ...(point.commodity === "gas" ? { gas: this.transformGas(point, aggregate, porsenna) } : {}),
+                ...(point.commodity === "heat" ? { heat: { porsenna } } : {}),
+                ...(point.commodity === "water" ? { water: { porsenna } } : {}),
+            };
+        };
+        this.transformElectricity = (point, porsenna) => {
+            return {
+                metadata: point.md_year === null ? null : (0, objectMappers_1.stripPrefix)(point, "md_"),
+                ...(porsenna === null ? {} : { porsenna }),
+            };
+        };
+        this.transformGas = (point, aggregate, porsenna) => {
+            return {
+                distribution: point.di_id === null
+                    ? null
+                    : {
+                        invoice: (0, objectMappers_1.stripPrefix)(point, "di_"),
+                        devices: aggregate.distributionDevices
+                            .filter((device) => device.invoice_id === point.di_id)
+                            .map((device) => (0, objectMappers_1.omitKeys)(device, ["invoice_id"])),
+                        prices: aggregate.distributionPrices
+                            .filter((price) => price.invoice_id === point.di_id)
+                            .map((price) => (0, objectMappers_1.omitKeys)(price, ["invoice_id", "customer_id"])),
+                    },
+                commercial: point.ci_id === null
+                    ? null
+                    : {
+                        invoice: (0, objectMappers_1.stripPrefix)(point, "ci_"),
+                        installation: (0, objectMappers_1.omitKeys)((0, objectMappers_1.stripPrefix)(point, "cii_"), ["place_id"]),
+                        devices: aggregate.commercialDevices
+                            .filter((device) => device.invoice_id === point.ci_id && device.place_id === point.cii_place_id)
+                            .map((device) => (0, objectMappers_1.omitKeys)(device, ["invoice_id", "place_id"])),
+                        prices: aggregate.commercialPrices
+                            .filter((price) => price.invoice_id === point.ci_id && price.place_id === point.cii_place_id)
+                            .map((price) => (0, objectMappers_1.omitKeys)(price, ["invoice_id", "customer_id", "place_id"])),
+                    },
+                ...(porsenna === null ? {} : { porsenna }),
+            };
+        };
+        this.buildPorsennaBlock = (point, aggregate) => {
+            const device = aggregate.porsennaDevices.find((candidate) => candidate.identifier === point.place_id && (candidate.level === null || candidate.level === "main"));
+            if (device === undefined) {
+                return null;
+            }
+            return {
+                device: {
+                    name: device.name,
+                    type: device.type,
+                    level: device.level,
+                    measurement_target: device.measurement_target,
+                    meter_number: device.meter_number,
+                    supply_point_number: device.supply_point_number,
+                    disabled_at: device.disabled_at,
+                    tenant: device.source,
+                },
+                sub_devices: aggregate.porsennaDevices
+                    .filter((candidate) => candidate.parent_device_id === device.device_id)
+                    .map((candidate) => ({
+                    name: candidate.name,
+                    type: candidate.type,
+                    meter_number: candidate.meter_number,
+                    disabled_at: candidate.disabled_at,
+                })),
+                yearly_consumption: aggregate.porsennaConsumption
+                    .filter((row) => row.device_id === device.device_id && row.var === "yearly")
+                    .map((row) => ({
+                    period: row.period,
+                    value: row.value,
+                    unit: row.unit,
+                    days_covered: row.count,
+                })),
+            };
+        };
+        this.transformEnergyManagement = (aggregate) => {
+            const devices = aggregate.porsennaDevices;
+            if (devices.length === 0) {
+                return null;
+            }
+            const primary = devices[0];
+            return {
+                source: primary.source,
+                building_name: primary.building_name,
+                address: this.composeAddress(primary.building_street, primary.building_house_number, primary.building_street_number, primary.building_city, primary.building_postcode),
+                devices_total: devices.length,
+                devices_active: devices.filter((device) => device.disabled_at === null).length,
+            };
+        };
+        this.resolveAddress = (point) => {
+            if (point.md_address !== null) {
+                return point.md_address;
+            }
+            return (this.composeAddress(point.di_installations_address_street, point.di_installations_address_house_number, point.di_installations_address_house_org_number, point.di_installations_address_city, point.di_installations_address_post_code) ??
+                this.composeAddress(point.cii_address_street, point.cii_address_house_number, point.cii_address_house_org_number, point.cii_address_city, point.cii_address_post_code));
+        };
+        this.composeAddress = (street, houseNumber, houseOrgNumber, city, postCode) => {
+            const numberPart = [houseNumber, houseOrgNumber].filter((part) => part !== null && part !== "").join("/");
+            const streetPart = [street, numberPart].filter((part) => part !== null && part !== "").join(" ");
+            const parts = [streetPart, city, postCode].filter((part) => part !== null && part !== "");
+            return parts.length > 0 ? parts.join(", ") : null;
+        };
+    }
+};
+exports.EnoBuildingDetailTransformation = EnoBuildingDetailTransformation;
+exports.EnoBuildingDetailTransformation = EnoBuildingDetailTransformation = __decorate([
+    (0, tsyringe_1.injectable)()
+], EnoBuildingDetailTransformation);
+//# sourceMappingURL=EnoBuildingDetailTransformation.js.map

package/dist/output-gateway/transformations/EnoBuildingDetailTransformation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnoBuildingDetailTransformation.js","sourceRoot":"","sources":["../../../src/output-gateway/transformations/EnoBuildingDetailTransformation.ts"],"names":[],"mappings":"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"}

package/dist/schema-definitions/models/enapo/EnapoGidMappingModel.d.ts

@@ -0,0 +1,17 @@
+import { JSONSchemaType } from "@golemio/core/dist/shared/ajv";
+import { Model, ModelAttributes } from "@golemio/core/dist/shared/sequelize";
+import { IEnapoGidMapping } from "./interfaces/IEnapoGidMapping";
+export declare class EnapoGidMappingModel extends Model<IEnapoGidMapping> implements IEnapoGidMapping {
+    static TABLE_NAME: string;
+    static REPOSITORY_NAME: string;
+    place_id: string;
+    id_type: "ean" | "eic";
+    commodity: "electricity" | "gas" | "heat" | "water";
+    gid: string;
+    is_first_gid: boolean;
+    link_source: string;
+    valid_from: string | null;
+    valid_to: string | null;
+    static attributeModel: ModelAttributes<EnapoGidMappingModel, IEnapoGidMapping>;
+    static jsonSchema: JSONSchemaType<IEnapoGidMapping[]>;
+}

package/dist/schema-definitions/models/enapo/EnapoGidMappingModel.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnapoGidMappingModel = void 0;
+const sequelize_1 = require("@golemio/core/dist/shared/sequelize");
+class EnapoGidMappingModel extends sequelize_1.Model {
+}
+exports.EnapoGidMappingModel = EnapoGidMappingModel;
+EnapoGidMappingModel.TABLE_NAME = "enapo_gid_mapping";
+EnapoGidMappingModel.REPOSITORY_NAME = "EnapoGidMappingRepository";
+EnapoGidMappingModel.attributeModel = {
+    place_id: {
+        type: sequelize_1.DataTypes.STRING(50),
+        allowNull: false,
+        primaryKey: true,
+    },
+    id_type: {
+        type: sequelize_1.DataTypes.STRING(10),
+        allowNull: false,
+    },
+    commodity: {
+        type: sequelize_1.DataTypes.STRING(20),
+        allowNull: false,
+    },
+    gid: {
+        type: sequelize_1.DataTypes.STRING,
+        allowNull: false,
+        primaryKey: true,
+    },
+    is_first_gid: {
+        type: sequelize_1.DataTypes.BOOLEAN,
+        allowNull: false,
+        defaultValue: false,
+    },
+    link_source: {
+        type: sequelize_1.DataTypes.STRING(50),
+        allowNull: false,
+        primaryKey: true,
+    },
+    valid_from: {
+        type: sequelize_1.DataTypes.DATEONLY,
+    },
+    valid_to: {
+        type: sequelize_1.DataTypes.DATEONLY,
+    },
+};
+EnapoGidMappingModel.jsonSchema = {
+    type: "array",
+    items: {
+        type: "object",
+        properties: {
+            place_id: { type: "string" },
+            id_type: { type: "string", enum: ["ean", "eic"] },
+            commodity: { type: "string", enum: ["electricity", "gas", "heat", "water"] },
+            gid: { type: "string" },
+            is_first_gid: { type: "boolean" },
+            link_source: { type: "string" },
+            valid_from: { oneOf: [{ type: "string" }, { type: "null", nullable: true }] },
+            valid_to: { oneOf: [{ type: "string" }, { type: "null", nullable: true }] },
+        },
+        required: ["place_id", "id_type", "commodity", "gid", "is_first_gid", "link_source"],
+    },
+};
+//# sourceMappingURL=EnapoGidMappingModel.js.map

package/dist/schema-definitions/models/enapo/EnapoGidMappingModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnapoGidMappingModel.js","sourceRoot":"","sources":["../../../../src/schema-definitions/models/enapo/EnapoGidMappingModel.ts"],"names":[],"mappings":";;;AACA,mEAAwF;AAGxF,MAAa,oBAAqB,SAAQ,iBAAuB;;AAAjE,oDAmEC;AAlEiB,+BAAU,GAAG,mBAAmB,CAAC;AACjC,oCAAe,GAAG,2BAA2B,CAAC;AAW9C,mCAAc,GAA4D;IACpF,QAAQ,EAAE;QACN,IAAI,EAAE,qBAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACnB;IACD,OAAO,EAAE;QACL,IAAI,EAAE,qBAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,SAAS,EAAE,KAAK;KACnB;IACD,SAAS,EAAE;QACP,IAAI,EAAE,qBAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,SAAS,EAAE,KAAK;KACnB;IACD,GAAG,EAAE;QACD,IAAI,EAAE,qBAAS,CAAC,MAAM;QACtB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACnB;IACD,YAAY,EAAE;QACV,IAAI,EAAE,qBAAS,CAAC,OAAO;QACvB,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,KAAK;KACtB;IACD,WAAW,EAAE;QACT,IAAI,EAAE,qBAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,IAAI;KACnB;IACD,UAAU,EAAE;QACR,IAAI,EAAE,qBAAS,CAAC,QAAQ;KAC3B;IACD,QAAQ,EAAE;QACN,IAAI,EAAE,qBAAS,CAAC,QAAQ;KAC3B;CACJ,CAAC;AAEY,+BAAU,GAAuC;IAC3D,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;YACjD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAC5E,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACjC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;YAC7E,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE;SAC9E;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,CAAC;KACvF;CACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+export type EnapoCommodity = "electricity" | "gas" | "heat" | "water";
+export interface IEnapoGidMapping {
+    place_id: string;
+    id_type: "ean" | "eic";
+    commodity: EnapoCommodity;
+    gid: string;
+    is_first_gid: boolean;
+    link_source: string;
+    valid_from: string | null;
+    valid_to: string | null;
+}

package/dist/schema-definitions/models/enapo/interfaces/IEnapoGidMapping.js

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

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

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

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`
@@ -811,12 +811,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 +863,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` — poslední nestornovaná distribuční faktura (jen EIC / plyn, join přes `eic`)
+        -   `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
+-   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