vojacekd/ems
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source 
Made-with: Cursor
This commit is contained in:
Dusan Vojacek
2026-03-20 13:27:37 +01:00
commit 8b4af663d8
77 changed files with 13337 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

608
db/migration/V001__init_schema.sql Normal file
View File

@@ -0,0 +1,608 @@
-- =============================================================
-- V001__init_schema.sql
-- EMS Platform – inicializace schématu a všech tabulek
-- =============================================================
CREATE SCHEMA IF NOT EXISTS ems;
-- ============================================================
-- LOKALITY
-- ============================================================
CREATE TABLE ems.site (
id SERIAL PRIMARY KEY,
code TEXT UNIQUE NOT NULL,
name TEXT NOT NULL,
timezone TEXT NOT NULL DEFAULT 'Europe/Prague',
latitude NUMERIC(9,6),
longitude NUMERIC(9,6),
active BOOLEAN NOT NULL DEFAULT true,
notes TEXT,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
COMMENT ON TABLE ems.site IS 'Lokalita / jeden objekt v systému EMS.';
COMMENT ON COLUMN ems.site.id IS 'Primární klíč lokality.';
COMMENT ON COLUMN ems.site.code IS 'Krátký unikátní kód lokality. Příklad: home-01.';
COMMENT ON COLUMN ems.site.name IS 'Lidsky čitelný název lokality.';
COMMENT ON COLUMN ems.site.timezone IS 'Časová zóna IANA. Výchozí Europe/Prague.';
COMMENT ON COLUMN ems.site.latitude IS 'Zeměpisná šířka – vstup pro weather API a výpočty irradiance.';
COMMENT ON COLUMN ems.site.longitude IS 'Zeměpisná délka – vstup pro weather API a výpočty irradiance.';
COMMENT ON COLUMN ems.site.active IS 'Pokud false, lokalita se přeskočí při plánování a sběru dat.';
COMMENT ON COLUMN ems.site.notes IS 'Volné poznámky.';
COMMENT ON COLUMN ems.site.created_at IS 'Čas vytvoření záznamu.';
-- ------------------------------------------------------------
CREATE TABLE ems.site_endpoint (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
endpoint_type TEXT NOT NULL,
host TEXT NOT NULL,
port INT,
protocol TEXT,
unit_id INT,
auth_reference TEXT,
enabled BOOLEAN NOT NULL DEFAULT true,
notes TEXT
);
COMMENT ON TABLE ems.site_endpoint IS 'Komunikační endpointy lokality. Jedna lokalita může mít více endpointů různých typů.';
COMMENT ON COLUMN ems.site_endpoint.id IS 'Primární klíč endpointu.';
COMMENT ON COLUMN ems.site_endpoint.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.site_endpoint.endpoint_type IS 'Typ endpointu: modbus_tcp, loxone_http, http_api.';
COMMENT ON COLUMN ems.site_endpoint.host IS 'IP adresa nebo hostname cílového zařízení (Waveshare, Loxone).';
COMMENT ON COLUMN ems.site_endpoint.port IS 'TCP port. Modbus TCP typicky 502, Loxone 80.';
COMMENT ON COLUMN ems.site_endpoint.protocol IS 'Protokol: modbus_tcp, http, https.';
COMMENT ON COLUMN ems.site_endpoint.unit_id IS 'Modbus Unit ID (slave address). Relevantní pro modbus_tcp.';
COMMENT ON COLUMN ems.site_endpoint.auth_reference IS 'Název env proměnné nebo secret s přihlašovacími údaji.';
COMMENT ON COLUMN ems.site_endpoint.enabled IS 'Pokud false, endpoint se nepoužívá.';
COMMENT ON COLUMN ems.site_endpoint.notes IS 'Volné poznámky.';
-- ------------------------------------------------------------
CREATE TABLE ems.site_market_config (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
purchase_pricing_mode TEXT NOT NULL DEFAULT 'spot',
sale_pricing_mode TEXT NOT NULL DEFAULT 'spot',
buy_margin_fixed_czk NUMERIC(10,4) NOT NULL DEFAULT 0,
buy_margin_percent NUMERIC(6,4) NOT NULL DEFAULT 0,
sell_margin_fixed_czk NUMERIC(10,4) NOT NULL DEFAULT 0,
sell_margin_percent NUMERIC(6,4) NOT NULL DEFAULT 0,
currency TEXT NOT NULL DEFAULT 'CZK',
valid_from TIMESTAMPTZ NOT NULL,
valid_to TIMESTAMPTZ,
notes TEXT
);
COMMENT ON TABLE ems.site_market_config IS 'Obchodní konfigurace lokality s maržemi. valid_from/valid_to umožňuje historii změn.';
COMMENT ON COLUMN ems.site_market_config.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.site_market_config.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.site_market_config.purchase_pricing_mode IS 'Režim nákupní ceny: spot, fixed, hybrid.';
COMMENT ON COLUMN ems.site_market_config.sale_pricing_mode IS 'Režim prodejní ceny: spot, fixed, hybrid.';
COMMENT ON COLUMN ems.site_market_config.buy_margin_fixed_czk IS 'Fixní nákupní marže Kč/kWh přičítaná k raw ceně.';
COMMENT ON COLUMN ems.site_market_config.buy_margin_percent IS 'Procentní nákupní marže aplikovaná na raw cenu.';
COMMENT ON COLUMN ems.site_market_config.sell_margin_fixed_czk IS 'Fixní prodejní marže Kč/kWh. Záporná = srážka z prodejní ceny.';
COMMENT ON COLUMN ems.site_market_config.sell_margin_percent IS 'Procentní prodejní marže.';
COMMENT ON COLUMN ems.site_market_config.currency IS 'Měna konfigurace.';
COMMENT ON COLUMN ems.site_market_config.valid_from IS 'Začátek platnosti konfigurace.';
COMMENT ON COLUMN ems.site_market_config.valid_to IS 'Konec platnosti. NULL = aktuálně platný záznam.';
COMMENT ON COLUMN ems.site_market_config.notes IS 'Volné poznámky.';
-- ------------------------------------------------------------
CREATE TABLE ems.site_grid_connection (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id) UNIQUE,
max_import_power_w INT NOT NULL,
max_export_power_w INT NOT NULL DEFAULT 0,
no_export BOOLEAN NOT NULL DEFAULT false,
reserved_capacity_w INT NOT NULL DEFAULT 0,
notes TEXT
);
COMMENT ON TABLE ems.site_grid_connection IS 'Síťová omezení připojení lokality k distribuční síti.';
COMMENT ON COLUMN ems.site_grid_connection.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.site_grid_connection.site_id IS 'Vazba na lokalitu. Každá lokalita má nejvýše jeden záznam.';
COMMENT ON COLUMN ems.site_grid_connection.max_import_power_w IS 'Maximální povolený odběr ze sítě v W dle jističe/smlouvy.';
COMMENT ON COLUMN ems.site_grid_connection.max_export_power_w IS 'Maximální povolený export do sítě v W. 0 = export zakázán.';
COMMENT ON COLUMN ems.site_grid_connection.no_export IS 'Pokud true, export do sítě je zakázán bez ohledu na max_export_power_w.';
COMMENT ON COLUMN ems.site_grid_connection.reserved_capacity_w IS 'Výkon rezervovaný pro interní potřeby, odečítá se z dostupné kapacity.';
COMMENT ON COLUMN ems.site_grid_connection.notes IS 'Volné poznámky.';
-- ============================================================
-- AKTIVA
-- ============================================================
CREATE TABLE ems.asset_inverter (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
code TEXT NOT NULL,
manufacturer TEXT,
model TEXT,
endpoint_id INT REFERENCES ems.site_endpoint(id),
max_charge_power_w INT,
max_discharge_power_w INT,
max_export_power_w INT,
controllable BOOLEAN NOT NULL DEFAULT true,
notes TEXT
);
COMMENT ON TABLE ems.asset_inverter IS 'Střídač / hybridní měnič na lokalitě.';
COMMENT ON COLUMN ems.asset_inverter.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.asset_inverter.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.asset_inverter.code IS 'Kód aktiva, unikátní v rámci lokality.';
COMMENT ON COLUMN ems.asset_inverter.manufacturer IS 'Výrobce. Příklad: Deye.';
COMMENT ON COLUMN ems.asset_inverter.model IS 'Model. Příklad: SUN-20K-SG01LP1-EU.';
COMMENT ON COLUMN ems.asset_inverter.endpoint_id IS 'Modbus TCP endpoint přes Waveshare.';
COMMENT ON COLUMN ems.asset_inverter.max_charge_power_w IS 'Maximální nabíjecí výkon baterie v W.';
COMMENT ON COLUMN ems.asset_inverter.max_discharge_power_w IS 'Maximální vybíjecí výkon baterie v W.';
COMMENT ON COLUMN ems.asset_inverter.max_export_power_w IS 'Maximální výkon exportu do sítě v W.';
COMMENT ON COLUMN ems.asset_inverter.controllable IS 'Pokud false, střídač není řízen EMS (ongridový na GEN portu).';
COMMENT ON COLUMN ems.asset_inverter.notes IS 'Volné poznámky.';
-- ------------------------------------------------------------
CREATE TABLE ems.asset_battery (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
inverter_id INT NOT NULL REFERENCES ems.asset_inverter(id),
code TEXT NOT NULL,
usable_capacity_wh INT NOT NULL,
min_soc_percent NUMERIC(5,2) NOT NULL DEFAULT 10,
reserve_soc_percent NUMERIC(5,2) NOT NULL DEFAULT 20,
max_soc_percent NUMERIC(5,2) NOT NULL DEFAULT 95,
charge_efficiency NUMERIC(5,4) NOT NULL DEFAULT 0.95,
discharge_efficiency NUMERIC(5,4) NOT NULL DEFAULT 0.95,
degradation_cost_czk_kwh NUMERIC(8,4) NOT NULL DEFAULT 0.5
);
COMMENT ON TABLE ems.asset_battery IS 'Bateriový systém připojený ke střídači.';
COMMENT ON COLUMN ems.asset_battery.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.asset_battery.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.asset_battery.inverter_id IS 'Střídač ke kterému je baterie připojena.';
COMMENT ON COLUMN ems.asset_battery.code IS 'Kód aktiva.';
COMMENT ON COLUMN ems.asset_battery.usable_capacity_wh IS 'Použitelná kapacita baterie v Wh bez rezerv výrobce.';
COMMENT ON COLUMN ems.asset_battery.min_soc_percent IS 'Minimální SoC v % – absolutní spodní limit, nikdy nepřekročit.';
COMMENT ON COLUMN ems.asset_battery.reserve_soc_percent IS 'Rezervní SoC v % – zachován pro výpadky sítě, nevyužívat v běžném plánu.';
COMMENT ON COLUMN ems.asset_battery.max_soc_percent IS 'Maximální SoC v % – horní limit pro denní provoz.';
COMMENT ON COLUMN ems.asset_battery.charge_efficiency IS 'Účinnost nabíjení (0–1). Typicky 0.95.';
COMMENT ON COLUMN ems.asset_battery.discharge_efficiency IS 'Účinnost vybíjení (0–1). Typicky 0.95.';
COMMENT ON COLUMN ems.asset_battery.degradation_cost_czk_kwh IS 'Odhadovaný náklad degradace v Kč/kWh cyklu. Vstupuje do optimalizace jako cena za použití baterie.';
-- ------------------------------------------------------------
CREATE TABLE ems.asset_pv_array (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
inverter_id INT REFERENCES ems.asset_inverter(id),
code TEXT NOT NULL,
name TEXT,
nominal_power_wp INT NOT NULL,
azimuth_deg NUMERIC(6,2),
tilt_deg NUMERIC(5,2),
module_count INT,
shading_factor NUMERIC(4,3) NOT NULL DEFAULT 1.0,
controllable BOOLEAN NOT NULL DEFAULT false,
notes TEXT
);
COMMENT ON TABLE ems.asset_pv_array IS 'FVE pole. Každé pole jako samostatný záznam – klíčové pro přesnou predikci výroby.';
COMMENT ON COLUMN ems.asset_pv_array.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.asset_pv_array.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.asset_pv_array.inverter_id IS 'Střídač ke kterému je pole připojeno.';
COMMENT ON COLUMN ems.asset_pv_array.code IS 'Kód pole, unikátní v rámci lokality. Příklad: pv-a, pv-b.';
COMMENT ON COLUMN ems.asset_pv_array.name IS 'Popis pole. Příklad: Jižní střecha.';
COMMENT ON COLUMN ems.asset_pv_array.nominal_power_wp IS 'Nominální výkon pole v Wp (součet výkonů panelů).';
COMMENT ON COLUMN ems.asset_pv_array.azimuth_deg IS 'Azimut panelů ve stupních. 0=jih, 90=západ, -90=východ.';
COMMENT ON COLUMN ems.asset_pv_array.tilt_deg IS 'Sklon panelů od horizontály ve stupních.';
COMMENT ON COLUMN ems.asset_pv_array.module_count IS 'Počet panelů v poli.';
COMMENT ON COLUMN ems.asset_pv_array.shading_factor IS 'Koeficient stínění (0–1). 1.0 = bez stínění.';
COMMENT ON COLUMN ems.asset_pv_array.controllable IS 'Pokud false, pole není řízeno EMS (ongridový autonomní střídač na GEN portu).';
COMMENT ON COLUMN ems.asset_pv_array.notes IS 'Volné poznámky.';
-- ------------------------------------------------------------
CREATE TABLE ems.asset_ev_charger (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
code TEXT NOT NULL,
manufacturer TEXT,
model TEXT,
endpoint_id INT REFERENCES ems.site_endpoint(id),
max_power_w INT NOT NULL,
min_power_w INT NOT NULL DEFAULT 1380,
phases INT NOT NULL DEFAULT 3,
connector_count INT NOT NULL DEFAULT 1,
schedulable BOOLEAN NOT NULL DEFAULT true,
notes TEXT
);
COMMENT ON TABLE ems.asset_ev_charger IS 'EV nabíjecí stanice. Komunikace přes Modbus TCP (Waveshare převodník).';
COMMENT ON COLUMN ems.asset_ev_charger.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.asset_ev_charger.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.asset_ev_charger.code IS 'Kód aktiva, unikátní v rámci lokality.';
COMMENT ON COLUMN ems.asset_ev_charger.manufacturer IS 'Výrobce nabíječky. Příklad: Teltonika.';
COMMENT ON COLUMN ems.asset_ev_charger.model IS 'Model nabíječky. Příklad: TeltoCharge 22kW.';
COMMENT ON COLUMN ems.asset_ev_charger.endpoint_id IS 'Modbus TCP endpoint přes Waveshare převodník.';
COMMENT ON COLUMN ems.asset_ev_charger.max_power_w IS 'Maximální výkon nabíječky v W.';
COMMENT ON COLUMN ems.asset_ev_charger.min_power_w IS 'Minimální výkon nabíjení v W. 1380 W = 6A jednofázové minimum IEC 61851.';
COMMENT ON COLUMN ems.asset_ev_charger.phases IS 'Počet fází nabíjení.';
COMMENT ON COLUMN ems.asset_ev_charger.connector_count IS 'Počet konektorů na nabíječce.';
COMMENT ON COLUMN ems.asset_ev_charger.schedulable IS 'Pokud true, nabíječka je zapojená do plánování EMS.';
COMMENT ON COLUMN ems.asset_ev_charger.notes IS 'Volné poznámky.';
-- ------------------------------------------------------------
CREATE TABLE ems.asset_heat_pump (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
code TEXT NOT NULL,
manufacturer TEXT,
model TEXT,
endpoint_id INT REFERENCES ems.site_endpoint(id),
rated_heating_power_w INT NOT NULL,
cop_rated NUMERIC(4,2),
cop_temp_reference_c NUMERIC(5,2),
min_run_duration_min INT NOT NULL DEFAULT 30,
min_stop_duration_min INT NOT NULL DEFAULT 15,
tuv_tank_volume_l INT,
tuv_min_temp_c NUMERIC(5,2) NOT NULL DEFAULT 45,
tuv_max_temp_c NUMERIC(5,2) NOT NULL DEFAULT 60,
tuv_target_temp_c NUMERIC(5,2) NOT NULL DEFAULT 55,
tuv_temp_sensor_ref TEXT,
schedulable BOOLEAN NOT NULL DEFAULT true,
notes TEXT
);
COMMENT ON TABLE ems.asset_heat_pump IS 'Tepelné čerpadlo s Modbus řízením (Samsung). Řízeno na základě COP, venkovní teploty a stavu zásobníku TUV.';
COMMENT ON COLUMN ems.asset_heat_pump.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.asset_heat_pump.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.asset_heat_pump.code IS 'Kód aktiva, unikátní v rámci lokality.';
COMMENT ON COLUMN ems.asset_heat_pump.manufacturer IS 'Výrobce tepelného čerpadla. Příklad: Samsung.';
COMMENT ON COLUMN ems.asset_heat_pump.model IS 'Model tepelného čerpadla.';
COMMENT ON COLUMN ems.asset_heat_pump.endpoint_id IS 'Modbus TCP endpoint přes Waveshare převodník.';
COMMENT ON COLUMN ems.asset_heat_pump.rated_heating_power_w IS 'Jmenovitý topný výkon v W při referenčních podmínkách.';
COMMENT ON COLUMN ems.asset_heat_pump.cop_rated IS 'Jmenovitý COP při referenční teplotě cop_temp_reference_c.';
COMMENT ON COLUMN ems.asset_heat_pump.cop_temp_reference_c IS 'Referenční venkovní teplota pro jmenovitý COP. Typicky 7°C (norma A7/W35).';
COMMENT ON COLUMN ems.asset_heat_pump.min_run_duration_min IS 'Minimální nepřerušená doba běhu v minutách. Chrání kompresor před krátkými cykly.';
COMMENT ON COLUMN ems.asset_heat_pump.min_stop_duration_min IS 'Minimální doba stání po vypnutí v minutách. Ochrana kompresoru při restartu.';
COMMENT ON COLUMN ems.asset_heat_pump.tuv_tank_volume_l IS 'Objem zásobníku TUV v litrech. Slouží k výpočtu doby ohřevu.';
COMMENT ON COLUMN ems.asset_heat_pump.tuv_min_temp_c IS 'Minimální teplota TUV zásobníku v °C. Pod touto hodnotou se ohřev spustí bez ohledu na cenu.';
COMMENT ON COLUMN ems.asset_heat_pump.tuv_max_temp_c IS 'Maximální teplota TUV zásobníku v °C. Nad touto hodnotou se ohřev zastaví.';
COMMENT ON COLUMN ems.asset_heat_pump.tuv_target_temp_c IS 'Cílová teplota TUV pro normální plánovaný provoz.';
COMMENT ON COLUMN ems.asset_heat_pump.tuv_temp_sensor_ref IS 'Název nebo kód čidla teploty zásobníku (Modbus registr nebo Loxone Virtual Output).';
COMMENT ON COLUMN ems.asset_heat_pump.schedulable IS 'Pokud true, tepelné čerpadlo je zapojeno do plánování EMS.';
COMMENT ON COLUMN ems.asset_heat_pump.notes IS 'Volné poznámky.';
-- ============================================================
-- TRŽNÍ DATA
-- ============================================================
CREATE TABLE ems.market_interval_price (
market_source TEXT NOT NULL DEFAULT 'OTE_CZ',
interval_start TIMESTAMPTZ NOT NULL,
interval_end TIMESTAMPTZ NOT NULL,
buy_raw_price_czk_kwh NUMERIC(10,6) NOT NULL,
sell_raw_price_czk_kwh NUMERIC(10,6) NOT NULL,
currency TEXT NOT NULL DEFAULT 'CZK',
imported_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (market_source, interval_start)
);
COMMENT ON TABLE ems.market_interval_price IS 'Raw spotové ceny elektřiny OTE CZ. Sdílené pro všechny lokality, bez marží. Granularita 15 minut.';
COMMENT ON COLUMN ems.market_interval_price.market_source IS 'Zdroj tržních dat. Příklad: OTE_CZ.';
COMMENT ON COLUMN ems.market_interval_price.interval_start IS 'Začátek 15minutového intervalu (UTC).';
COMMENT ON COLUMN ems.market_interval_price.interval_end IS 'Konec 15minutového intervalu (UTC).';
COMMENT ON COLUMN ems.market_interval_price.buy_raw_price_czk_kwh IS 'Raw nákupní cena v Kč/kWh bez marží.';
COMMENT ON COLUMN ems.market_interval_price.sell_raw_price_czk_kwh IS 'Raw prodejní referenční cena v Kč/kWh bez marží. Pro OTE CZ = DAM cena.';
COMMENT ON COLUMN ems.market_interval_price.currency IS 'Měna cen záznamu.';
COMMENT ON COLUMN ems.market_interval_price.imported_at IS 'Čas importu záznamu do DB. Slouží pro audit importů.';
-- ============================================================
-- TELEMETRIE
-- ============================================================
CREATE TABLE ems.telemetry_inverter (
site_id INT NOT NULL REFERENCES ems.site(id),
inverter_id INT NOT NULL REFERENCES ems.asset_inverter(id),
measured_at TIMESTAMPTZ NOT NULL,
pv_power_w INT,
battery_soc_percent NUMERIC(5,2),
battery_power_w INT,
battery_voltage_v NUMERIC(7,3),
grid_power_w INT,
grid_voltage_v NUMERIC(7,3),
load_power_w INT,
inverter_temp_c NUMERIC(5,2),
operating_mode TEXT,
fault_code INT,
PRIMARY KEY (inverter_id, measured_at)
);
COMMENT ON TABLE ems.telemetry_inverter IS 'Telemetrie ze střídače Deye čtená přes Modbus TCP. 1min granularita. TimescaleDB hypertable.';
COMMENT ON COLUMN ems.telemetry_inverter.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.telemetry_inverter.inverter_id IS 'Vazba na střídač.';
COMMENT ON COLUMN ems.telemetry_inverter.measured_at IS 'Čas měření (UTC).';
COMMENT ON COLUMN ems.telemetry_inverter.pv_power_w IS 'Celkový okamžitý výkon FVE v W (součet všech stringů čtených tímto střídačem, včetně GEN portu).';
COMMENT ON COLUMN ems.telemetry_inverter.battery_soc_percent IS 'Aktuální stav nabití baterie v %.';
COMMENT ON COLUMN ems.telemetry_inverter.battery_power_w IS 'Výkon baterie v W. Kladné = nabíjení, záporné = vybíjení.';
COMMENT ON COLUMN ems.telemetry_inverter.battery_voltage_v IS 'Napětí bateriového systému v V.';
COMMENT ON COLUMN ems.telemetry_inverter.grid_power_w IS 'Výkon přenosu se sítí v W. Kladné = import ze sítě, záporné = export do sítě.';
COMMENT ON COLUMN ems.telemetry_inverter.grid_voltage_v IS 'Napětí sítě v V.';
COMMENT ON COLUMN ems.telemetry_inverter.load_power_w IS 'Celková spotřeba objektu v W (vše za AC výstupem střídače, včetně EV a TUV).';
COMMENT ON COLUMN ems.telemetry_inverter.inverter_temp_c IS 'Teplota střídače v °C.';
COMMENT ON COLUMN ems.telemetry_inverter.operating_mode IS 'Provozní režim dle Modbus registru (raw hodnota pro ladění).';
COMMENT ON COLUMN ems.telemetry_inverter.fault_code IS 'Kód chyby z Modbus registru. 0 = bez chyby.';
-- ------------------------------------------------------------
CREATE TABLE ems.telemetry_ev_charger (
site_id INT NOT NULL REFERENCES ems.site(id),
charger_id INT NOT NULL REFERENCES ems.asset_ev_charger(id),
measured_at TIMESTAMPTZ NOT NULL,
connector_id INT NOT NULL DEFAULT 1,
status TEXT,
power_w INT,
energy_kwh NUMERIC(10,3),
current_a NUMERIC(7,3),
voltage_v NUMERIC(7,3),
session_id TEXT,
error_code TEXT,
PRIMARY KEY (charger_id, connector_id, measured_at)
);
COMMENT ON TABLE ems.telemetry_ev_charger IS 'Telemetrie EV nabíječky Teltonika čtená přes Modbus TCP (Waveshare). 1min granularita. TimescaleDB hypertable.';
COMMENT ON COLUMN ems.telemetry_ev_charger.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.telemetry_ev_charger.charger_id IS 'Vazba na EV nabíječku.';
COMMENT ON COLUMN ems.telemetry_ev_charger.measured_at IS 'Čas měření (UTC).';
COMMENT ON COLUMN ems.telemetry_ev_charger.connector_id IS 'Číslo konektoru (1-based). Teltonika TeltoCharge má 1 konektor.';
COMMENT ON COLUMN ems.telemetry_ev_charger.status IS 'Stav konektoru dle OCPP: available, preparing, charging, suspended_ev, suspended_evse, finishing, faulted.';
COMMENT ON COLUMN ems.telemetry_ev_charger.power_w IS 'Aktuální nabíjecí výkon v W.';
COMMENT ON COLUMN ems.telemetry_ev_charger.energy_kwh IS 'Kumulativní energie aktuální session v kWh. Resetuje se při nové session.';
COMMENT ON COLUMN ems.telemetry_ev_charger.current_a IS 'Nabíjecí proud v A.';
COMMENT ON COLUMN ems.telemetry_ev_charger.voltage_v IS 'Napětí v bodě připojení v V.';
COMMENT ON COLUMN ems.telemetry_ev_charger.session_id IS 'Identifikátor aktuální nabíjecí session z Modbus registru.';
COMMENT ON COLUMN ems.telemetry_ev_charger.error_code IS 'Kód chyby z Modbus registru nabíječky.';
-- ------------------------------------------------------------
CREATE TABLE ems.telemetry_heat_pump (
site_id INT NOT NULL REFERENCES ems.site(id),
heat_pump_id INT NOT NULL REFERENCES ems.asset_heat_pump(id),
measured_at TIMESTAMPTZ NOT NULL,
outdoor_temp_c NUMERIC(5,2),
water_inlet_temp_c NUMERIC(5,2),
water_outlet_temp_c NUMERIC(5,2),
tuv_tank_temp_c NUMERIC(5,2),
power_w INT,
operating_mode TEXT,
cop_actual NUMERIC(4,2),
defrost_active BOOLEAN,
alarm_code INT,
PRIMARY KEY (heat_pump_id, measured_at)
);
COMMENT ON TABLE ems.telemetry_heat_pump IS 'Telemetrie tepelného čerpadla Samsung čtená přes Modbus TCP (Waveshare). 1min granularita. TimescaleDB hypertable.';
COMMENT ON COLUMN ems.telemetry_heat_pump.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.telemetry_heat_pump.heat_pump_id IS 'Vazba na tepelné čerpadlo.';
COMMENT ON COLUMN ems.telemetry_heat_pump.measured_at IS 'Čas měření (UTC).';
COMMENT ON COLUMN ems.telemetry_heat_pump.outdoor_temp_c IS 'Venkovní teplota naměřená čerpadlem v °C. Klíčový vstup pro výpočet COP a rozhodnutí o ohřevu.';
COMMENT ON COLUMN ems.telemetry_heat_pump.water_inlet_temp_c IS 'Teplota vody na vstupu do výměníku čerpadla v °C.';
COMMENT ON COLUMN ems.telemetry_heat_pump.water_outlet_temp_c IS 'Teplota vody na výstupu z čerpadla v °C.';
COMMENT ON COLUMN ems.telemetry_heat_pump.tuv_tank_temp_c IS 'Teplota TUV zásobníku v °C. Klíčový vstup pro rozhodnutí kdy ohřívat.';
COMMENT ON COLUMN ems.telemetry_heat_pump.power_w IS 'Aktuální příkon čerpadla v W.';
COMMENT ON COLUMN ems.telemetry_heat_pump.operating_mode IS 'Provozní režim: heating, cooling, dhw (domestic hot water), standby.';
COMMENT ON COLUMN ems.telemetry_heat_pump.cop_actual IS 'Aktuálně vypočtený COP pokud je dostupný z Modbus registru.';
COMMENT ON COLUMN ems.telemetry_heat_pump.defrost_active IS 'Příznak aktivního odmrazovacího cyklu. Při defrostu je skutečný příkon vyšší.';
COMMENT ON COLUMN ems.telemetry_heat_pump.alarm_code IS 'Kód alarmu z Modbus registru. 0 = bez alarmu.';
-- ============================================================
-- PREDIKCE
-- ============================================================
CREATE TABLE ems.forecast_pv_run (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
pv_array_id INT REFERENCES ems.asset_pv_array(id),
forecast_source TEXT NOT NULL DEFAULT 'open_meteo',
model_params JSONB,
horizon_start TIMESTAMPTZ NOT NULL,
horizon_end TIMESTAMPTZ NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
status TEXT NOT NULL DEFAULT 'ok'
);
COMMENT ON TABLE ems.forecast_pv_run IS 'Metadata jednoho běhu predikce výroby FVE.';
COMMENT ON COLUMN ems.forecast_pv_run.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.forecast_pv_run.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.forecast_pv_run.pv_array_id IS 'Konkrétní FVE pole. NULL = agregovaná predikce celé lokality.';
COMMENT ON COLUMN ems.forecast_pv_run.forecast_source IS 'Zdroj meteorologických dat: open_meteo, solcast, manual.';
COMMENT ON COLUMN ems.forecast_pv_run.model_params IS 'Parametry predikčního modelu použité při tomto běhu (JSON).';
COMMENT ON COLUMN ems.forecast_pv_run.horizon_start IS 'Začátek predikčního horizontu.';
COMMENT ON COLUMN ems.forecast_pv_run.horizon_end IS 'Konec predikčního horizontu.';
COMMENT ON COLUMN ems.forecast_pv_run.created_at IS 'Čas spuštění predikce.';
COMMENT ON COLUMN ems.forecast_pv_run.status IS 'Stav běhu: ok, partial, failed.';
-- ------------------------------------------------------------
CREATE TABLE ems.forecast_pv_interval (
run_id INT NOT NULL REFERENCES ems.forecast_pv_run(id),
pv_array_id INT NOT NULL REFERENCES ems.asset_pv_array(id),
interval_start TIMESTAMPTZ NOT NULL,
power_w INT NOT NULL,
irradiance_wm2 NUMERIC(8,2),
temp_c NUMERIC(5,2),
PRIMARY KEY (run_id, pv_array_id, interval_start)
);
COMMENT ON TABLE ems.forecast_pv_interval IS 'Predikovaný výkon FVE po 15min intervalech. TimescaleDB hypertable.';
COMMENT ON COLUMN ems.forecast_pv_interval.run_id IS 'Vazba na běh predikce.';
COMMENT ON COLUMN ems.forecast_pv_interval.pv_array_id IS 'Konkrétní FVE pole.';
COMMENT ON COLUMN ems.forecast_pv_interval.interval_start IS 'Začátek 15min intervalu (UTC).';
COMMENT ON COLUMN ems.forecast_pv_interval.power_w IS 'Predikovaný výkon FVE pole v W.';
COMMENT ON COLUMN ems.forecast_pv_interval.irradiance_wm2 IS 'GHI irradiance ze weather service v W/m² použitá při výpočtu.';
COMMENT ON COLUMN ems.forecast_pv_interval.temp_c IS 'Predikovaná venkovní teplota v °C použitá při výpočtu.';
-- ------------------------------------------------------------
CREATE TABLE ems.forecast_weather_interval (
site_id INT NOT NULL REFERENCES ems.site(id),
forecast_source TEXT NOT NULL DEFAULT 'open_meteo',
interval_start TIMESTAMPTZ NOT NULL,
outdoor_temp_c NUMERIC(5,2),
irradiance_wm2 NUMERIC(8,2),
cloud_cover_pct NUMERIC(5,2),
wind_speed_ms NUMERIC(6,2),
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
PRIMARY KEY (site_id, forecast_source, interval_start)
);
COMMENT ON TABLE ems.forecast_weather_interval IS 'Predikce počasí per lokalita, 15min granularita. Sdílený vstup pro FVE predikci i COP odhad tepelného čerpadla.';
COMMENT ON COLUMN ems.forecast_weather_interval.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.forecast_weather_interval.forecast_source IS 'Zdroj predikce počasí.';
COMMENT ON COLUMN ems.forecast_weather_interval.interval_start IS 'Začátek 15min intervalu (UTC).';
COMMENT ON COLUMN ems.forecast_weather_interval.outdoor_temp_c IS 'Predikovaná venkovní teplota v °C. Klíčový vstup pro COP odhad tepelného čerpadla.';
COMMENT ON COLUMN ems.forecast_weather_interval.irradiance_wm2 IS 'Predikovaná irradiance GHI v W/m².';
COMMENT ON COLUMN ems.forecast_weather_interval.cloud_cover_pct IS 'Predikovaná oblačnost v %.';
COMMENT ON COLUMN ems.forecast_weather_interval.wind_speed_ms IS 'Predikovaná rychlost větru v m/s.';
COMMENT ON COLUMN ems.forecast_weather_interval.created_at IS 'Čas importu predikce do DB.';
-- ============================================================
-- PLÁNOVÁNÍ
-- ============================================================
CREATE TABLE ems.planning_run (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
horizon_start TIMESTAMPTZ NOT NULL,
horizon_end TIMESTAMPTZ NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
status TEXT NOT NULL DEFAULT 'draft',
solver_params JSONB,
notes TEXT
);
COMMENT ON TABLE ems.planning_run IS 'Jeden plánovací běh pro konkrétní lokalitu a horizont.';
COMMENT ON COLUMN ems.planning_run.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.planning_run.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.planning_run.horizon_start IS 'Začátek plánovaného horizontu (typicky dnešní půlnoc).';
COMMENT ON COLUMN ems.planning_run.horizon_end IS 'Konec plánovaného horizontu (typicky zítřejší půlnoc nebo +48h).';
COMMENT ON COLUMN ems.planning_run.created_at IS 'Čas vytvoření plánu.';
COMMENT ON COLUMN ems.planning_run.status IS 'Stav plánu: draft (sestavován), approved (schválen), active (aktuálně platný), superseded (nahrazen novějším).';
COMMENT ON COLUMN ems.planning_run.solver_params IS 'Parametry optimalizačního solveru použité při tomto běhu (JSON).';
COMMENT ON COLUMN ems.planning_run.notes IS 'Volné poznámky k plánu.';
-- ------------------------------------------------------------
CREATE TABLE ems.planning_interval (
run_id INT NOT NULL REFERENCES ems.planning_run(id),
interval_start TIMESTAMPTZ NOT NULL,
battery_setpoint_w INT,
battery_soc_target_pct NUMERIC(5,2),
grid_setpoint_w INT,
ev_charge_power_w INT,
heat_pump_enabled BOOLEAN,
heat_pump_setpoint_w INT,
expected_cost_czk NUMERIC(10,4),
effective_buy_price NUMERIC(10,6),
effective_sell_price NUMERIC(10,6),
PRIMARY KEY (run_id, interval_start)
);
COMMENT ON TABLE ems.planning_interval IS 'Výstup optimalizace – jeden řádek = jeden 15min slot plánu.';
COMMENT ON COLUMN ems.planning_interval.run_id IS 'Vazba na plánovací běh.';
COMMENT ON COLUMN ems.planning_interval.interval_start IS 'Začátek 15min intervalu (UTC).';
COMMENT ON COLUMN ems.planning_interval.battery_setpoint_w IS 'Plánovaný výkon baterie v W. Kladné = nabíjení, záporné = vybíjení.';
COMMENT ON COLUMN ems.planning_interval.battery_soc_target_pct IS 'Cílový SoC baterie na konci intervalu v %.';
COMMENT ON COLUMN ems.planning_interval.grid_setpoint_w IS 'Plánovaný výkon se sítí v W. Kladné = import, záporné = export.';
COMMENT ON COLUMN ems.planning_interval.ev_charge_power_w IS 'Plánovaný agregovaný výkon nabíjení EV v W (součet všech nabíječek na site).';
COMMENT ON COLUMN ems.planning_interval.heat_pump_enabled IS 'Zda má tepelné čerpadlo v tomto intervalu běžet.';
COMMENT ON COLUMN ems.planning_interval.heat_pump_setpoint_w IS 'Plánovaný výkon tepelného čerpadla v W.';
COMMENT ON COLUMN ems.planning_interval.expected_cost_czk IS 'Očekávané náklady intervalu v Kč. Záporné = příjem z prodeje.';
COMMENT ON COLUMN ems.planning_interval.effective_buy_price IS 'Efektivní nákupní cena použitá při plánování v Kč/kWh.';
COMMENT ON COLUMN ems.planning_interval.effective_sell_price IS 'Efektivní prodejní cena použitá při plánování v Kč/kWh.';
-- ============================================================
-- AUDIT
-- ============================================================
CREATE TABLE ems.audit_interval (
site_id INT NOT NULL REFERENCES ems.site(id),
interval_start TIMESTAMPTZ NOT NULL,
planning_run_id INT REFERENCES ems.planning_run(id),
actual_pv_power_w INT,
actual_battery_power_w INT,
actual_grid_power_w INT,
actual_load_power_w INT,
actual_battery_soc_pct NUMERIC(5,2),
actual_ev_power_w INT,
actual_heat_pump_power_w INT,
actual_cost_czk NUMERIC(10,4),
deviation_grid_w INT,
deviation_cost_czk NUMERIC(10,4),
PRIMARY KEY (site_id, interval_start)
);
COMMENT ON TABLE ems.audit_interval IS 'Skutečnost vs plán po 15min intervalech. Plněno zpětně funkcí ems.fn_fill_audit_interval().';
COMMENT ON COLUMN ems.audit_interval.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.audit_interval.interval_start IS 'Začátek 15min intervalu (UTC).';
COMMENT ON COLUMN ems.audit_interval.planning_run_id IS 'Plán který byl v tomto intervalu aktivní.';
COMMENT ON COLUMN ems.audit_interval.actual_pv_power_w IS 'Skutečný výkon FVE v W (průměr za 15min z telemetrie).';
COMMENT ON COLUMN ems.audit_interval.actual_battery_power_w IS 'Skutečný výkon baterie v W (průměr za 15min).';
COMMENT ON COLUMN ems.audit_interval.actual_grid_power_w IS 'Skutečný výkon přenosu se sítí v W (průměr za 15min).';
COMMENT ON COLUMN ems.audit_interval.actual_load_power_w IS 'Skutečná celková spotřeba v W (průměr za 15min).';
COMMENT ON COLUMN ems.audit_interval.actual_battery_soc_pct IS 'Skutečný SoC baterie na konci intervalu v %.';
COMMENT ON COLUMN ems.audit_interval.actual_ev_power_w IS 'Skutečný výkon nabíjení EV v W (suma všech nabíječek, průměr za 15min).';
COMMENT ON COLUMN ems.audit_interval.actual_heat_pump_power_w IS 'Skutečný příkon tepelného čerpadla v W (průměr za 15min).';
COMMENT ON COLUMN ems.audit_interval.actual_cost_czk IS 'Skutečné náklady intervalu v Kč vypočtené ze skutečného grid_power a efektivní ceny.';
COMMENT ON COLUMN ems.audit_interval.deviation_grid_w IS 'Odchylka skutečný - plánovaný výkon sítě v W.';
COMMENT ON COLUMN ems.audit_interval.deviation_cost_czk IS 'Odchylka skutečných nákladů od plánovaných v Kč.';
-- ============================================================
-- SPOTŘEBA
-- ============================================================
CREATE TABLE ems.consumption_baseline_interval (
site_id INT NOT NULL REFERENCES ems.site(id),
interval_start TIMESTAMPTZ NOT NULL,
data_type TEXT NOT NULL,
power_w INT NOT NULL,
source TEXT,
PRIMARY KEY (site_id, data_type, interval_start)
);
COMMENT ON TABLE ems.consumption_baseline_interval IS 'Bazální (neflexibilní) spotřeba po 15min intervalech. Historická skutečnost i predikce.';
COMMENT ON COLUMN ems.consumption_baseline_interval.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.consumption_baseline_interval.interval_start IS 'Začátek 15min intervalu (UTC).';
COMMENT ON COLUMN ems.consumption_baseline_interval.data_type IS 'Typ záznamu: actual (historická skutečnost), forecast (predikce pro plánování).';
COMMENT ON COLUMN ems.consumption_baseline_interval.power_w IS 'Bazální spotřeba v W = celková spotřeba mínus měřitelná flexibilní zařízení.';
COMMENT ON COLUMN ems.consumption_baseline_interval.source IS 'Metoda výpočtu: measured (z telemetrie), model_v1 (statistický model).';
-- ============================================================
-- OVERRIDE
-- ============================================================
CREATE TABLE ems.site_override (
id SERIAL PRIMARY KEY,
site_id INT NOT NULL REFERENCES ems.site(id),
override_type TEXT NOT NULL,
value_json JSONB,
valid_from TIMESTAMPTZ NOT NULL,
valid_to TIMESTAMPTZ,
reason TEXT,
created_by TEXT,
created_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
COMMENT ON TABLE ems.site_override IS 'Manuální přepisy provozních stavů. Mají přednost před automatickým plánem.';
COMMENT ON COLUMN ems.site_override.id IS 'Primární klíč.';
COMMENT ON COLUMN ems.site_override.site_id IS 'Vazba na lokalitu.';
COMMENT ON COLUMN ems.site_override.override_type IS 'Typ přepisu: force_charge, force_discharge, block_export, manual_setpoint, block_heat_pump.';
COMMENT ON COLUMN ems.site_override.value_json IS 'Parametry přepisu jako JSON. Obsah závisí na override_type.';
COMMENT ON COLUMN ems.site_override.valid_from IS 'Začátek platnosti přepisu.';
COMMENT ON COLUMN ems.site_override.valid_to IS 'Konec platnosti. NULL = platí do odvolání.';
COMMENT ON COLUMN ems.site_override.reason IS 'Důvod přepisu pro auditní účely.';
COMMENT ON COLUMN ems.site_override.created_by IS 'Uživatel nebo systémová komponenta která přepis vytvořila.';
COMMENT ON COLUMN ems.site_override.created_at IS 'Čas vytvoření záznamu.';