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

package/db/example/00_clear_test_data.sql

@@ -9,3 +9,17 @@ truncate organizations;
 truncate access_limitation;
 truncate enapo_measurements;
 truncate enapo_pre_metadata_history;
+truncate enapo_gid_mapping;
+truncate eno_budova;
+truncate eno_adresa;
+truncate enapo_ppas_distribution_invoice;
+truncate enapo_ppas_distribution_installation;
+truncate enapo_ppas_distribution_invoice_device;
+truncate enapo_ppas_distribution_invoice_price;
+truncate enapo_ppas_commercial_invoice;
+truncate enapo_ppas_commercial_invoice_installations;
+truncate enapo_ppas_commercial_invoice_device;
+truncate enapo_ppas_commercial_invoice_price;
+truncate enapo_porsenna_buildings;
+truncate enapo_porsenna_devices;
+truncate enapo_porsenna_consumption;

package/db/example/06_eno.sql

@@ -0,0 +1,25 @@
+INSERT INTO eno_budova (gid, zdroj, nazev, oznaceni, druh_vytapeni, pripojka_elektro, pripojka_voda, pripojka_kanalizace,
+	budova_rozdelena_byt_nebyt, celkova_plocha_budova, zastavena_plocha, obestaveny_prostor,
+	pocet_byt, pocet_nebyt_budova, pocet_nadzem_podlazi, pocet_podzem_podlazi, pocet_podkrovi, vytah,
+	czcc, id_cuzk, id_objekt, kod_vyuziti, nazev_vyuziti, kod_ochrana, nazev_ochrana, platnost_od) VALUES
+	('GID100', 'mhmp', 'ZŠ Testovací', 'ZŠT', 'ústřední dálkové', 'ano', 'ano', 'ano',
+		'ne', 1200.5, 450.0, 5200.0,
+		0, 12, 3, 1, 0, true,
+		112, 100000001, 1001, '7', 'budova pro vzdělávání', NULL, NULL, '2020-01-01'),
+	('GID100', 'stat', 'ZŠ Testovací (stat)', 'ZŠT', 'ústřední dálkové', 'ano', 'ano', 'ano',
+		'ne', 1200.5, 450.0, 5200.0,
+		0, 12, 3, 1, 0, true,
+		112, 100000001, 1001, '7', 'budova pro vzdělávání', NULL, NULL, '2020-01-01'),
+	('GID200', 'mhmp', 'MŠ Vedlejší', 'MŠV', 'plynová kotelna', 'ano', 'ano', 'ne',
+		'ne', 480.0, 220.0, 1600.0,
+		0, 5, 2, 0, 1, false,
+		112, 100000002, 1002, '7', 'budova pro vzdělávání', NULL, NULL, '2021-06-15');
+
+INSERT INTO eno_adresa (gid, gid_typ, poradi, zdroj, id, popis, hlavni) VALUES
+	('GID100', 'budova', 1, 'mhmp', 501, 'Testovací 123/4, 100 00 Praha 10', true),
+	('GID100', 'budova', 2, 'mhmp', 502, 'Testovací 125/6, 100 00 Praha 10', false),
+	('GID100', 'budova', 1, 'stat', 501, 'Testovací 123/4, 100 00 Praha 10', true),
+	('GID100', 'budova', 3, 'mhmp', 504, NULL, false),
+	('GID100', 'budova', 4, 'mhmp', 505, NULL, false),
+	('GID200', 'budova', 1, 'mhmp', 503, 'Vedlejší 7, 100 00 Praha 10', true),
+	('GIDADDR1', 'stavba', 1, 'mhmp', 506, 'Stavební 9, 100 00 Praha 10', true);

package/db/example/07_enapo_om_detail.sql

@@ -0,0 +1,140 @@
+-- Mock GID mapping (link_source = 'mock'); real rows will come from the data-team dbt output later
+INSERT INTO enapo_gid_mapping (place_id, id_type, commodity, gid, is_first_gid, link_source, valid_from, valid_to) VALUES
+	('27ZG100Z0000192O', 'eic', 'gas', 'GID100', true, 'mock', '2019-12-05', NULL),
+	('27ZG100Z0000192O', 'eic', 'gas', 'GID200', false, 'mock', '2019-12-05', NULL),
+	('859182400000000001', 'ean', 'electricity', 'GID100', true, 'mock', '2022-07-28', NULL),
+	('859182400000000002', 'ean', 'electricity', 'GID100', true, 'mock', '2019-12-05', '2025-01-01'),
+	('859182400000000003', 'ean', 'electricity', 'GID999', true, 'mock', '2022-07-28', NULL);
+
+-- PRE metadata history: two months for the active EAN (the newer one must win)
+INSERT INTO enapo_pre_metadata_history (ean, "year", "month", month_name, days_in_stored_month, consumption_point,
+	address, location_type, company_name, company_id, tarif_type, tarif_1t2t, phases, circuit_breaker, type_b_meter,
+	meter_replaced, created_at, updated_at) VALUES
+	('859182400000000001', 2026, 5, 'květen', 31, 'OM Testovací 123',
+		'Testovací 123/4, Praha 10', 'škola', 'Hlavní město Praha', '00064581', 'C02d', '1T', '3', '3x100A', 'ano',
+		'53435572', '2026-06-05 00:00:00', NULL),
+	('859182400000000001', 2026, 6, 'červen', 30, 'OM Testovací 123',
+		'Testovací 123/4, Praha 10', 'škola', 'Hlavní město Praha', '00064581', 'C02d', '1T', '3', '3x125A', 'ano',
+		'2026-06-19|53435572|54292510', '2026-07-05 00:00:00', NULL);
+
+-- PPAS distribution invoices: an older valid one, a newer canceled one (must be skipped)
+INSERT INTO enapo_ppas_distribution_invoice (id, preceding_id, customer_id, customer_company_id, customer_name,
+	customer_contract_account_id, customer_address_street, customer_address_house_number, customer_address_house_org_number,
+	customer_address_city, customer_address_city_part, customer_address_post_code, customer_address_country,
+	customer_address_ruian_id, facts_doc_date, facts_net_date, facts_billing_transaction, facts_to_pay_amount,
+	facts_currency, facts_price_brutto, is_canceled, canceled_reason) VALUES
+	('DI-2026-001', NULL, 'CUST-1', '00064581', 'Hlavní město Praha',
+		'CA-1', 'Mariánské náměstí', '2', NULL,
+		'Praha', 'Staré Město', '11000', 'CZ',
+		22349995, '2026-03-15', '2026-03-29', 'FAKTURACE', 15250.50,
+		'CZK', 18453.11, false, NULL),
+	('DI-2026-002', 'DI-2026-001', 'CUST-1', '00064581', 'Hlavní město Praha',
+		'CA-1', 'Mariánské náměstí', '2', NULL,
+		'Praha', 'Staré Město', '11000', 'CZ',
+		22349995, '2026-05-20', '2026-06-03', 'STORNO', -15250.50,
+		'CZK', -18453.11, true, 'oprava odečtu');
+
+-- Two installations on the valid invoice: only the first one is mapped to a GID, the second exists
+-- to prove devices/prices are scoped by place_id and do not leak across consumption points.
+INSERT INTO enapo_ppas_distribution_installation (invoice_id, customer_id, place_id, eic, billing_class,
+	measurement_type, contract_contract_id, contract_move_in_date, contract_move_out_date, tdd_class,
+	address_street, address_house_number, address_house_org_number, address_city, address_city_part,
+	address_post_code, address_country, address_ruian_id) VALUES
+	('DI-2026-001', 'CUST-1', '10101325', '27ZG100Z0000192O', 'MO',
+		'C', 'SML-1', '2019-12-05', '9999-12-31', 'DOM4',
+		'Testovací', '123', '4', 'Praha', 'Praha 10',
+		'10000', 'CZ', 22349996),
+	('DI-2026-001', 'CUST-1', '10101999', '27ZG100Z0000999O', 'MO',
+		'C', 'SML-9', '2019-12-05', '9999-12-31', 'DOM4',
+		'Jiná', '9', NULL, 'Praha', 'Praha 9',
+		'19000', 'CZ', 22349999),
+	('DI-2026-002', 'CUST-1', '10101325', '27ZG100Z0000192O', 'MO',
+		'C', 'SML-1', '2019-12-05', '9999-12-31', 'DOM4',
+		'Testovací', '123', '4', 'Praha', 'Praha 10',
+		'10000', 'CZ', 22349996);
+
+INSERT INTO enapo_ppas_distribution_invoice_device (device_serial_number, invoice_id, place_id, date_from, date_to,
+	"type", kind, reading_type, reading_from, reading_to, consumption, unit, meter_reading_type, gas_consumption_kwh,
+	volume_coefficient, combustion_heat, normometers_nm3) VALUES
+	('PLYN-001', 'DI-2026-001', '10101325', '2025-03-01', '2026-02-28', 'G4', 'plynoměr',
+		'řádný', 10250.0, 11930.0, 1680.0, 'm3', 'dálkový', 17750.4,
+		1.0043, 10.55, 1687.2),
+	('PLYN-999', 'DI-2026-001', '10101999', '2025-03-01', '2026-02-28', 'G4', 'plynoměr',
+		'řádný', 500.0, 700.0, 200.0, 'm3', 'dálkový', 2113.1,
+		1.0043, 10.55, 200.9);
+
+INSERT INTO enapo_ppas_distribution_invoice_price (invoice_id, customer_id, place_id, date_from, date_to, kind,
+	description, price_group, quantity, unit, unit_price, time_slot, price_netto, price_type, currency, tax_rate) VALUES
+	('DI-2026-001', 'CUST-1', '10101325', '2025-03-01', '2026-02-28', 'distribuce', 'Distribuce plynu',
+		'D1', 17750.4, 'kWh', 0.35, 0.19355, 6212.64, 'variabilní', 'CZK', 21.0),
+	('DI-2026-001', 'CUST-1', '10101999', '2025-03-01', '2026-02-28', 'distribuce', 'Distribuce plynu',
+		'D1', 2113.1, 'kWh', 0.35, NULL, 739.59, 'variabilní', 'CZK', 21.0);
+
+-- PPAS commercial invoices: a valid one and a newer canceled one (must be skipped)
+INSERT INTO enapo_ppas_commercial_invoice (id, preceding_id, customer_id, customer_company_id, customer_name,
+	customer_contract_account_id, customer_address_street, customer_address_house_number, customer_address_house_org_number,
+	customer_address_city, customer_address_city_part, customer_address_post_code, customer_address_country,
+	customer_address_ruian_id, facts_doc_date, facts_net_date, facts_billing_transaction, facts_to_pay_amount,
+	facts_currency, facts_price_brutto, is_canceled, canceled_reason) VALUES
+	('CI-2026-001', NULL, 'CUST-1', '00064581', 'Hlavní město Praha',
+		'CA-1', 'Mariánské náměstí', '2', NULL,
+		'Praha', 'Staré Město', '11000', 'CZ',
+		22349995, '2026-04-10', '2026-04-24', 'FAKTURACE', 28900.00,
+		'CZK', 34969.00, false, NULL),
+	('CI-2026-002', 'CI-2026-001', 'CUST-1', '00064581', 'Hlavní město Praha',
+		'CA-1', 'Mariánské náměstí', '2', NULL,
+		'Praha', 'Staré Město', '11000', 'CZ',
+		22349995, '2026-06-01', '2026-06-15', 'STORNO', -28900.00,
+		'CZK', -34969.00, true, 'reklamace');
+
+INSERT INTO enapo_ppas_commercial_invoice_installations (invoice_id, customer_id, place_id, eic, billing_class,
+	measurement_type, contract_contract_id, contract_move_in_date, contract_move_out_date, tdd_class,
+	address_street, address_house_number, address_house_org_number, address_city, address_city_part,
+	address_post_code, address_country, address_ruian_id) VALUES
+	('CI-2026-001', 'CUST-1', '10101325', '27ZG100Z0000192O', 'MO',
+		'C', 'SML-1', '2019-12-05', '9999-12-31', 'DOM4',
+		'Testovací', '123', '4', 'Praha', 'Praha 10',
+		'10000', 'CZ', 22349996),
+	('CI-2026-002', 'CUST-1', '10101325', '27ZG100Z0000192O', 'MO',
+		'C', 'SML-1', '2019-12-05', '9999-12-31', 'DOM4',
+		'Testovací', '123', '4', 'Praha', 'Praha 10',
+		'10000', 'CZ', 22349996);
+
+INSERT INTO enapo_ppas_commercial_invoice_device (device_serial_number, invoice_id, place_id, date_from, date_to,
+	"type", kind, reading_type, reading_from, reading_to, consumption, unit, meter_reading_type, gas_consumption_kwh,
+	volume_coefficient, combustion_heat, normometers_nm3) VALUES
+	('PLYN-001', 'CI-2026-001', '10101325', '2025-03-01', '2026-02-28',
+		'G4', 'plynoměr', 'řádný', 10250.0, 11930.0, 1680.0, 'm3', 'dálkový', 17750.4,
+		1.0043, 10.55, 1687.2);
+
+INSERT INTO enapo_ppas_commercial_invoice_price (invoice_id, customer_id, place_id, date_from, date_to, kind,
+	description, price_group, quantity, unit, unit_price, time_slot, price_netto, price_type, currency, tax_rate) VALUES
+	('CI-2026-001', 'CUST-1', '10101325', '2025-03-01', '2026-02-28', 'komodita',
+		'Dodávka plynu', 'K1', 17750.4, 'kWh', 1.45, NULL, 25738.08, 'variabilní', 'CZK', 21.0);
+
+-- Porsenna (e-manazer): buildings, devices (incl. heat/water and a sub-meter), yearly consumption.
+-- Device types and tenant naming mirror real Porsenna data (electricity_meter/heat_meter/water_meter, tenant prague-7).
+INSERT INTO enapo_porsenna_buildings (source, id, name, street, house_number, street_number, city, postcode, gid) VALUES
+	('prague-7', 1, 'ZŠ Testovací (e-manažer)', 'Testovací', '123', '4', 'Praha 10', '10000', 'GID100'),
+	('prague-7', 2, 'Vrátnice Kundratka', 'Kundratka', '19', NULL, 'Praha 8', '18000', 'GIDPOR1');
+
+INSERT INTO enapo_porsenna_devices (source, id, building_id, parent_device_id, "level", "type", name,
+	measurement_target, disabled_at, disable_reason_id, show_in_output, identifier, supply_point_number,
+	meter_number, identification_gid) VALUES
+	('prague-7', '11111111-1111-1111-1111-111111111111', 1, NULL, 'main', 'electricity_meter', 'Hlavní elektroměr',
+		'consumption', NULL, NULL, true, '859182400000000001', 'OP-100', 'EL-123', 'GID100'),
+	('prague-7', '22222222-2222-2222-2222-222222222222', 1, NULL, 'main', 'heat_meter', 'Předávací stanice CZT',
+		'consumption', NULL, NULL, true, '40001234', 'OP-101', 'TEP-77', 'GID100'),
+	('prague-7', '33333333-3333-3333-3333-333333333333', 1, NULL, 'main', 'water_meter', 'Hlavní vodoměr',
+		'consumption', '2024-05-31 00:00:00+00', 4, true, '50005678', 'OP-102', 'VOD-55', 'GID100'),
+	('prague-7', '44444444-4444-4444-4444-444444444444', 1, '22222222-2222-2222-2222-222222222222', 'sub',
+		'heat_meter', 'Podružné měření tělocvična', 'tělocvična', NULL, NULL, true, NULL, NULL, 'TEP-78', NULL),
+	('prague-7', '55555555-5555-5555-5555-555555555555', 2, NULL, 'main', 'electricity_meter', 'Elektroměr vrátnice',
+		'consumption', NULL, NULL, true, '859182400000000099', 'OP-200', 'EL-999', 'GIDPOR1');
+
+INSERT INTO enapo_porsenna_consumption (source, device_id, "var", "period", value, unit, commodity, "count") VALUES
+	('prague-7', '11111111-1111-1111-1111-111111111111', 'yearly', '2025', 12.4, 'MWH', 'electricity_meter', 365),
+	('prague-7', '22222222-2222-2222-2222-222222222222', 'yearly', '2023', 512.3, 'GJ', 'heat_meter', 365),
+	('prague-7', '22222222-2222-2222-2222-222222222222', 'yearly', '2024', 498.1, 'GJ', 'heat_meter', 366),
+	('prague-7', '33333333-3333-3333-3333-333333333333', 'yearly', '2023', 210, 'M3', 'water_meter', 365),
+	('prague-7', '55555555-5555-5555-5555-555555555555', 'yearly', '2024', 5.5, 'MWH', 'electricity_meter', 366);

package/db/migrations/postgresql/20260805090000-ppas-distribution-installation.js

@@ -0,0 +1,47 @@
+'use strict';
+
+var dbm;
+var type;
+var seed;
+var fs = require('fs');
+var path = require('path');
+var Promise;
+
+exports.setup = function(options, seedLink) {
+  dbm = options.dbmigrate;
+  type = dbm.dataType;
+  seed = seedLink;
+  Promise = options.Promise;
+};
+
+exports.up = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260805090000-ppas-distribution-installation-up.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports.down = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260805090000-ppas-distribution-installation-down.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports._meta = {
+  "version": 1
+};

package/db/migrations/postgresql/20260807090000-enapo-gid-mapping-om-detail.js

@@ -0,0 +1,53 @@
+'use strict';
+
+var dbm;
+var type;
+var seed;
+var fs = require('fs');
+var path = require('path');
+var Promise;
+
+/**
+  * We receive the dbmigrate dependency from dbmigrate initially.
+  * This enables us to not have to rely on NODE_PATH.
+  */
+exports.setup = function(options, seedLink) {
+  dbm = options.dbmigrate;
+  type = dbm.dataType;
+  seed = seedLink;
+  Promise = options.Promise;
+};
+
+exports.up = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260807090000-enapo-gid-mapping-om-detail-up.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports.down = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260807090000-enapo-gid-mapping-om-detail-down.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports._meta = {
+  "version": 1
+};

package/db/migrations/postgresql/20260807091000-enapo-om-detail-porsenna.js

@@ -0,0 +1,53 @@
+'use strict';
+
+var dbm;
+var type;
+var seed;
+var fs = require('fs');
+var path = require('path');
+var Promise;
+
+/**
+  * We receive the dbmigrate dependency from dbmigrate initially.
+  * This enables us to not have to rely on NODE_PATH.
+  */
+exports.setup = function(options, seedLink) {
+  dbm = options.dbmigrate;
+  type = dbm.dataType;
+  seed = seedLink;
+  Promise = options.Promise;
+};
+
+exports.up = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260807091000-enapo-om-detail-porsenna-up.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports.down = function(db) {
+  var filePath = path.join(__dirname, 'sqls', '20260807091000-enapo-om-detail-porsenna-down.sql');
+  return new Promise( function( resolve, reject ) {
+    fs.readFile(filePath, {encoding: 'utf-8'}, function(err,data){
+      if (err) return reject(err);
+      console.log('received data: ' + data);
+
+      resolve(data);
+    });
+  })
+  .then(function(data) {
+    return db.runSql(data);
+  });
+};
+
+exports._meta = {
+  "version": 1
+};

package/db/migrations/postgresql/sqls/20260805090000-ppas-distribution-installation-down.sql

@@ -0,0 +1,86 @@
+-- Rounding is lossy, but an integer column cannot hold the fractional periods.
+ALTER TABLE enapo_ppas_distribution_invoice_price
+	ALTER COLUMN time_slot TYPE int4 USING round(time_slot)::int4;
+
+-- Give up the per-installation scoping. The pre-existing keys cannot represent more than one
+-- installation per invoice, so colliding rows beyond the lowest place_id are dropped first -- the same
+-- lossy restore the invoice header gets below.
+DELETE FROM enapo_ppas_distribution_invoice_device d
+USING enapo_ppas_distribution_invoice_device x
+WHERE d.device_serial_number = x.device_serial_number
+	AND d.invoice_id = x.invoice_id
+	AND d.date_from = x.date_from
+	AND d.date_to = x.date_to
+	AND d.reading_type = x.reading_type
+	AND d.kind = x.kind
+	AND d.place_id > x.place_id;
+
+DELETE FROM enapo_ppas_distribution_invoice_price p
+USING enapo_ppas_distribution_invoice_price x
+WHERE p.invoice_id = x.invoice_id
+	AND p.customer_id = x.customer_id
+	AND p.date_from = x.date_from
+	AND p.date_to = x.date_to
+	AND p.kind = x.kind
+	AND p.price_type = x.price_type
+	AND p.place_id > x.place_id;
+
+-- Dropping the column cascades away both the place_id index and the primary key that contains it.
+ALTER TABLE enapo_ppas_distribution_invoice_device DROP COLUMN place_id;
+ALTER TABLE enapo_ppas_distribution_invoice_device
+	ADD CONSTRAINT enapo_ppas_distribution_invoice_device_pk
+		PRIMARY KEY (device_serial_number, invoice_id, date_from, date_to, reading_type, kind);
+
+ALTER TABLE enapo_ppas_distribution_invoice_price DROP COLUMN place_id;
+ALTER TABLE enapo_ppas_distribution_invoice_price
+	ADD CONSTRAINT enapo_ppas_distribution_invoice_price_pk
+		PRIMARY KEY (invoice_id, customer_id, date_from, date_to, kind, price_type);
+
+ALTER TABLE enapo_ppas_distribution_invoice
+	ADD COLUMN eic varchar NULL,
+	ADD COLUMN place_id varchar NULL,
+	ADD COLUMN installations_billing_class varchar NULL,
+	ADD COLUMN installations_measurement_type varchar NULL,
+	ADD COLUMN installations_contract_contract_id varchar NULL,
+	ADD COLUMN installations_contract_move_in_date date NULL,
+	ADD COLUMN installations_contract_move_out_date date NULL,
+	ADD COLUMN installations_tdd_class varchar NULL,
+	ADD COLUMN installations_address_street varchar NULL,
+	ADD COLUMN installations_address_house_number varchar NULL,
+	ADD COLUMN installations_address_house_org_number varchar NULL,
+	ADD COLUMN installations_address_city varchar NULL,
+	ADD COLUMN installations_address_city_part varchar NULL,
+	ADD COLUMN installations_address_post_code varchar NULL,
+	ADD COLUMN installations_address_country varchar NULL,
+	ADD COLUMN installations_address_ruian_id int8 NULL;
+
+-- Only one installation fits the invoice header, so the lowest place_id per invoice is restored.
+UPDATE enapo_ppas_distribution_invoice i
+SET
+	eic = s.eic,
+	place_id = s.place_id,
+	installations_billing_class = s.billing_class,
+	installations_measurement_type = s.measurement_type,
+	installations_contract_contract_id = s.contract_contract_id,
+	installations_contract_move_in_date = s.contract_move_in_date,
+	installations_contract_move_out_date = s.contract_move_out_date,
+	installations_tdd_class = s.tdd_class,
+	installations_address_street = s.address_street,
+	installations_address_house_number = s.address_house_number,
+	installations_address_house_org_number = s.address_house_org_number,
+	installations_address_city = s.address_city,
+	installations_address_city_part = s.address_city_part,
+	installations_address_post_code = s.address_post_code,
+	installations_address_country = s.address_country,
+	installations_address_ruian_id = s.address_ruian_id
+FROM (
+	SELECT DISTINCT ON (invoice_id, customer_id) *
+	FROM enapo_ppas_distribution_installation
+	ORDER BY invoice_id, customer_id, place_id
+) s
+WHERE i.id = s.invoice_id AND i.customer_id = s.customer_id;
+
+CREATE INDEX idx_ppas_invoice_eic ON enapo_ppas_distribution_invoice(eic);
+CREATE INDEX idx_ppas_invoice_place_id ON enapo_ppas_distribution_invoice(place_id);
+
+DROP TABLE enapo_ppas_distribution_installation;

package/db/migrations/postgresql/sqls/20260805090000-ppas-distribution-installation-up.sql

@@ -0,0 +1,124 @@
+CREATE TABLE enapo_ppas_distribution_installation (
+	invoice_id varchar,
+	customer_id varchar,
+	place_id varchar,
+	eic varchar NULL,
+	billing_class varchar NULL,
+	measurement_type varchar NULL,
+	contract_contract_id varchar NULL,
+	contract_move_in_date date NULL,
+	contract_move_out_date date NULL,
+	tdd_class varchar NULL,
+	address_street varchar NULL,
+	address_house_number varchar NULL,
+	address_house_org_number varchar NULL,
+	address_city varchar NULL,
+	address_city_part varchar NULL,
+	address_post_code varchar NULL,
+	address_country varchar NULL,
+	address_ruian_id int8 NULL,
+	created_at timestamptz DEFAULT now() NULL,
+	updated_at timestamptz NULL,
+	CONSTRAINT enapo_ppas_distribution_installation_pk PRIMARY KEY (invoice_id, customer_id, place_id)
+);
+
+CREATE INDEX idx_ppas_distribution_installation_eic ON enapo_ppas_distribution_installation(eic);
+CREATE INDEX idx_ppas_distribution_installation_place_id ON enapo_ppas_distribution_installation(place_id);
+
+-- Move the already stored installations out of the invoice header, its still necessary to download history because there can be more than one installation per invoice
+INSERT INTO enapo_ppas_distribution_installation (
+	invoice_id, customer_id, place_id, eic, billing_class, measurement_type,
+	contract_contract_id, contract_move_in_date, contract_move_out_date, tdd_class,
+	address_street, address_house_number, address_house_org_number, address_city,
+	address_city_part, address_post_code, address_country, address_ruian_id
+)
+SELECT
+	id, customer_id, place_id, eic, installations_billing_class, installations_measurement_type,
+	installations_contract_contract_id, installations_contract_move_in_date, installations_contract_move_out_date,
+	installations_tdd_class, installations_address_street, installations_address_house_number,
+	installations_address_house_org_number, installations_address_city, installations_address_city_part,
+	installations_address_post_code, installations_address_country, installations_address_ruian_id
+FROM enapo_ppas_distribution_invoice
+WHERE place_id IS NOT NULL
+ON CONFLICT (invoice_id, customer_id, place_id) DO NOTHING;
+
+ALTER TABLE enapo_ppas_distribution_invoice_device ADD COLUMN place_id varchar NULL;
+ALTER TABLE enapo_ppas_distribution_invoice_price ADD COLUMN place_id varchar NULL;
+
+-- Existing rows were written when only installations[0] was stored
+UPDATE enapo_ppas_distribution_invoice_device d
+SET place_id = s.place_id
+FROM (
+	SELECT invoice_id, min(place_id) AS place_id
+	FROM enapo_ppas_distribution_installation
+	GROUP BY invoice_id
+) s
+WHERE d.invoice_id = s.invoice_id;
+
+UPDATE enapo_ppas_distribution_invoice_price p
+SET place_id = s.place_id
+FROM (
+	SELECT invoice_id, customer_id, min(place_id) AS place_id
+	FROM enapo_ppas_distribution_installation
+	GROUP BY invoice_id, customer_id
+) s
+WHERE p.invoice_id = s.invoice_id AND p.customer_id = s.customer_id;
+
+-- Rows whose invoice never reached the installation table cannot be attributed to a consumption point.
+-- Deleting them here would be silent data loss, so the migration stops instead and leaves the call to us.
+DO $$
+DECLARE
+	orphan_devices bigint;
+	orphan_prices bigint;
+BEGIN
+	SELECT count(*) INTO orphan_devices FROM enapo_ppas_distribution_invoice_device WHERE place_id IS NULL;
+	SELECT count(*) INTO orphan_prices FROM enapo_ppas_distribution_invoice_price WHERE place_id IS NULL;
+
+	IF orphan_devices > 0 OR orphan_prices > 0 THEN
+		RAISE EXCEPTION
+			'Cannot scope distribution rows by place_id: % device and % price rows belong to invoices missing from enapo_ppas_distribution_installation. Resolve or remove them, then re-run.',
+			orphan_devices, orphan_prices;
+	END IF;
+END $$;
+
+ALTER TABLE enapo_ppas_distribution_invoice_device
+	ALTER COLUMN place_id SET NOT NULL,
+	DROP CONSTRAINT enapo_ppas_distribution_invoice_device_pk,
+	ADD CONSTRAINT enapo_ppas_distribution_invoice_device_pk
+		PRIMARY KEY (device_serial_number, invoice_id, place_id, date_from, date_to, reading_type, kind);
+
+ALTER TABLE enapo_ppas_distribution_invoice_price
+	ALTER COLUMN place_id SET NOT NULL,
+	DROP CONSTRAINT enapo_ppas_distribution_invoice_price_pk,
+	ADD CONSTRAINT enapo_ppas_distribution_invoice_price_pk
+		PRIMARY KEY (invoice_id, customer_id, place_id, date_from, date_to, kind, price_type);
+
+CREATE INDEX idx_ppas_distribution_invoice_device_place_id ON enapo_ppas_distribution_invoice_device(place_id);
+CREATE INDEX idx_ppas_distribution_invoice_price_place_id ON enapo_ppas_distribution_invoice_price(place_id);
+
+-- timeSlot is a fraction of the billed period (e.g. 0.19355 = 6 of 31 days), not an int
+ALTER TABLE enapo_ppas_distribution_invoice_price
+	ALTER COLUMN time_slot TYPE numeric;
+
+DROP INDEX IF EXISTS idx_ppas_invoice_eic;
+DROP INDEX IF EXISTS idx_ppas_invoice_place_id;
+
+
+
+ALTER TABLE enapo_ppas_distribution_invoice
+	DROP COLUMN eic,
+	DROP COLUMN place_id,
+	DROP COLUMN installations_billing_class,
+	DROP COLUMN installations_measurement_type,
+	DROP COLUMN installations_contract_contract_id,
+	DROP COLUMN installations_contract_move_in_date,
+	DROP COLUMN installations_contract_move_out_date,
+	DROP COLUMN installations_tdd_class,
+	DROP COLUMN installations_address_street,
+	DROP COLUMN installations_address_house_number,
+	DROP COLUMN installations_address_house_org_number,
+	DROP COLUMN installations_address_city,
+	DROP COLUMN installations_address_city_part,
+	DROP COLUMN installations_address_post_code,
+	DROP COLUMN installations_address_country,
+	DROP COLUMN installations_address_ruian_id;

package/db/migrations/postgresql/sqls/20260807090000-enapo-gid-mapping-om-detail-down.sql

@@ -0,0 +1,3 @@
+DROP VIEW IF EXISTS v_enapo_building_consumption_points;
+DROP VIEW IF EXISTS v_enapo_building_detail;
+DROP TABLE IF EXISTS enapo_gid_mapping;