@golemio/energetics 1.12.2-dev.2740928370 → 1.12.2-dev.2741327856

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

@@ -0,0 +1,193 @@
+"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 : this.extractBuilding(element.building),
+                property: element.building === null ? null : this.transformProperty(element.building),
+                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.extractBuilding = (building) => {
+            return (0, objectMappers_1.omitKeys)(building, [
+                "gid",
+                "ej_id",
+                "ej_kod",
+                "ej_nazev",
+                "ej_typ",
+                "spm_id",
+                "spm_kod",
+                "spm_nazev",
+                "spm_ic",
+                "spm_dic",
+                "spu_id",
+                "spu_kod",
+                "spu_nazev",
+                "spu_ic",
+                "spu_dic",
+            ]);
+        };
+        this.transformProperty = (building) => {
+            const registrationUnit = this.buildRegistrationUnit(building);
+            const mandate = this.buildManager(building, "spm_");
+            const accountingUnit = this.buildManager(building, "spu_");
+            if (registrationUnit === null && mandate === null && accountingUnit === null) {
+                return null;
+            }
+            return {
+                registration_unit: registrationUnit,
+                managers: {
+                    mandate,
+                    accounting_unit: accountingUnit,
+                },
+            };
+        };
+        this.buildRegistrationUnit = (building) => {
+            const unit = (0, objectMappers_1.stripPrefix)(building, "ej_");
+            return unit.id === null ? null : unit;
+        };
+        this.buildManager = (building, prefix) => {
+            const manager = (0, objectMappers_1.stripPrefix)(building, prefix);
+            return manager.id === null ? null : manager;
+        };
+        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_"),
+                        installation: (0, objectMappers_1.omitKeys)((0, objectMappers_1.stripPrefix)(point, "dinst_"), ["place_id"]),
+                        devices: aggregate.distributionDevices
+                            .filter((device) => device.invoice_id === point.di_id && device.place_id === point.dinst_place_id)
+                            .map((device) => (0, objectMappers_1.omitKeys)(device, ["invoice_id", "place_id"])),
+                        prices: aggregate.distributionPrices
+                            .filter((price) => price.invoice_id === point.di_id && price.place_id === point.dinst_place_id)
+                            .map((price) => (0, objectMappers_1.omitKeys)(price, ["invoice_id", "customer_id", "place_id"])),
+                    },
+                commercial: point.ci_id === null
+                    ? null
+                    : {
+                        invoice: (0, objectMappers_1.stripPrefix)(point, "ci_"),
+                        installation: (0, objectMappers_1.omitKeys)((0, objectMappers_1.stripPrefix)(point, "cinst_"), ["place_id"]),
+                        devices: aggregate.commercialDevices
+                            .filter((device) => device.invoice_id === point.ci_id && device.place_id === point.cinst_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.cinst_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.dinst_address_street, point.dinst_address_house_number, point.dinst_address_house_org_number, point.dinst_address_city, point.dinst_address_post_code) ??
+                this.composeAddress(point.cinst_address_street, point.cinst_address_house_number, point.cinst_address_house_org_number, point.cinst_address_city, point.cinst_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`
@@ -651,6 +651,30 @@ Task stahuje geometrie (polygony) pro budovy a stavby ze systému ENO. Je automa
 -   unit testy
     -   [EnoGeometryTask.test.ts](../test/integration-engine/enapo/task/EnoGeometryTask.test.ts)
 
+#### _task: DedSearchIndexRefreshTask_
+
+Task přegeneruje materializovaný pohled `mv_ded_building_search`, nad kterým běží vyhledávací endpoint `/v2/energetics/ded/buildings`.
+
+-   vstupní rabbitmq fronta
+    -   název: dataplatform.enapoenergetics.refreshDedSearchIndex
+    -   TTL: 30 minut (starší zpráva už je překonaná novější, nemá smysl ji zpracovávat)
+    -   parametry: žádné — refresh vždy přestaví celý index, takže není co validovat a `schema` je záměrně `undefined`
+-   cron definice
+    -   cron.dataplatform.enapoenergetics.refreshDedSearchIndex — noční pojistka po okně synchronizace ENO
+        -   rabin `0 30 3 * * *`
+        -   prod `0 30 3 * * *`
+        -   samotná definice cronu je vedena mimo tento repozitář (deployment konfigurace); hodnoty výše jsou zamýšlený rozvrh, běžnou cestou přestavby indexu je událost z [EnoGeometryTask](#task-enogeometrytask)
+-   spouštění na základě událostí
+    -   [EnoGeometryTask](#task-enogeometrytask) po dokončení odesílá zprávu do fronty `refreshDedSearchIndex`; geometrie je poslední krok obou ENO řetězců (budovy i stavby ji spouštějí), takže se index přestaví jednou na konci, ne po každém dílčím tasku
+    -   selhání tohoto odeslání se pouze zaloguje a task se nepřeposílá do fronty znovu — geometrie je už uložená a noční běh je pojistka
+-   data modely
+    -   [DedSearchIndexRepository](../src/integration-engine/enapo/repositories/DedSearchIndexRepository.ts) — `REFRESH MATERIALIZED VIEW CONCURRENTLY energetics.mv_ded_building_search`, kontrakt [IDedSearchIndexRepository](../src/integration-engine/enapo/repositories/interfaces/IDedSearchIndexRepository.ts)
+-   funkce
+    -   **CONCURRENTLY**: refresh neblokuje čtenáře, takže vyhledávání funguje i během přestavby; vyžaduje unikátní index nad `gid` (vytvořen migrací) a **nesmí běžet v transakci** — proto se příkaz posílá na běžné (autocommit) spojení a nikdy se neobaluje transakcí
+    -   ve fixturách pro testy se používá neconcurrent `REFRESH MATERIALIZED VIEW` (v transakci loaderu concurrent varianta není povolená)
+-   unit testy
+    -   [DedSearchIndexRefreshTask.test.ts](../test/integration-engine/enapo/task/DedSearchIndexRefreshTask.test.ts)
+
 #### _PPAS Distribution API_
 
 -   zdroj dat
@@ -813,12 +837,28 @@ 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`                | DeD / ENAPO (`enapo_*`, `eno_*`)         | nepoužívá se — parametr je odmítnut s HTTP 400 |
+| `/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_
@@ -850,3 +890,51 @@ Task stahuje data o měřidlech a spotřebách z Porsenna API (e-Manazer).
 
 -   zdrojové tabulky
     -   consumption_energy_measurements
+
+#### _/v2/energetics/ded/buildings_
+
+-   našeptávač (suggestion endpoint) pro mapu DeD — vyhledání budovy podle názvu, adresy, GID, EAN, EIC nebo OM identifikátoru
+-   přístup: bez `accessLimit` — stejně jako detail budovy (viz níže); jiné než deklarované query parametry endpoint odmítne s HTTP 400
+-   parametry
+    -   `q` (povinný) — hledaný text, 1–100 znaků; jedno vstupní pole pro všechny typy hledání
+    -   `limit` (volitelný) — 1–50, výchozí 10
+-   zdrojové tabulky a pohledy
+    -   `mv_ded_building_search` — materializovaný pohled, jeden řádek na GID budovy; skládá se z `v_enapo_building_detail`, `eno_adresa` (`gid_typ = 'budova'`), `v_enapo_building_consumption_points`, `v_enapo_building_porsenna_devices` a `eno_geometrie`; vyřazené budovy (`eno_vyrazeno`) jsou z indexu vynechány
+    -   stavby (`eno_stavba`) endpoint záměrně nepokrývá — stejně jako detail budovy
+-   funkce
+    -   **Dvě úrovně shody**: přesná shoda na EAN / EIC / OM / GID má vlastní úroveň se skóre 1000 a fuzzy kandidáti se v takovém případě zahodí (`matched_exactly = true`). Jeden identifikátor může být namapován na více budov, takže i přesná shoda může vrátit více výsledků — mapa má zoomovat automaticky jen při jediném výsledku
+    -   **Vážené řazení**: kombinace fulltextu (`tsvector` s vahami A/B/C/D — A název a označení, B hlavní adresa, C ostatní adresy, D identifikátory) a trigramové podobnosti; váhy jsou v [DedSearchWeights.ts](../src/output-gateway/constants/DedSearchWeights.ts) včetně zdůvodnění
+    -   **Deterministická množina kandidátů**: fulltextová i trigramová větev si své kandidáty nejdřív seřadí (`ts_rank_cd`, resp. `<->`) a teprve pak ořízne na `DED_SEARCH_FTS_CANDIDATES` / `DED_SEARCH_FUZZY_CANDIDATES`; bez toho by `LIMIT` vzal libovolné řádky v pořadí, v jakém je vrátil index, a stejný dotaz by po autovacuum mohl odpovědět jinak
+    -   **Evidenční jednotka**: `registration_unit` má záměrně stejný tvar (`id` / `kod` / `nazev` / `typ`) jako na detailu budovy, takže klient může pro obě odpovědi použít jeden typ
+    -   **Projekce PostGIS až na výsledné stránce**: `ST_AsGeoJSON`, bbox a centroid se počítají až po filtru a `LIMIT`; trigramová větev se navíc při přesné shodě vůbec nespustí, protože její řádky by finální `WHERE` stejně zahodil
+    -   **Diakritika**: dotaz i indexované sloupce se normalizují přes `lower(public.unaccent(...))`, takže hledání bez diakritiky funguje běžně; stejný výraz musí zůstat v migraci i v [DedBuildingSearchRepository](../src/output-gateway/repositories/DedBuildingSearchRepository.ts), jinak by normalizované sloupce přestaly odpovídat hledanému textu
+    -   **Geometrie**: `geometry` (GeoJSON), `bbox` a `centroid` se počítají z PostGIS geometrie uložené v pohledu už v EPSG:4326 (zdroj `eno_geometrie` je v S-JTSK 5514); u budov bez použitelné geometrie jsou všechny tři `null` a `geometry_source` je `null`
+    -   **Nečitelná geometrie**: `f_ded_safe_geom` vrací pro nevalidní WKT `NULL` místo chyby, aby jeden vadný řádek nezastavil refresh indexu
+    -   index je aktualizován taskem [DedSearchIndexRefreshTask](#task-dedsearchindexrefreshtask)
+-   unit testy
+    -   [V2EnoBuildingsSearchRouter.test.ts](../test/output-gateway/routers/v2/V2EnoBuildingsSearchRouter.test.ts)
+    -   [DedBuildingSearchTransformation.test.ts](../test/output-gateway/transformations/DedBuildingSearchTransformation.test.ts)
+
+#### _/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