431 lines
14 KiB
Markdown
431 lines
14 KiB
Markdown
# EMS Platform – Data Model
|
||
|
||
## Principy
|
||
|
||
- Vše je vztaženo ke `site` (lokalitě)
|
||
- Raw tržní data jsou sdílená, efektivní ceny se dopočítávají per site
|
||
- Telemetrie a plány mají vždy `site_id` + `interval_start`
|
||
- TimescaleDB hypertable pro časové série (telemetrie, ceny, plány)
|
||
- Primární časová granularita: **15 minut**
|
||
|
||
---
|
||
|
||
## Konfigurace lokalit
|
||
|
||
### `site`
|
||
Základní entita. Jedna instalace = jeden objekt.
|
||
|
||
```sql
|
||
CREATE TABLE site (
|
||
id SERIAL PRIMARY KEY,
|
||
code TEXT UNIQUE NOT NULL, -- např. 'home-01'
|
||
name TEXT NOT NULL,
|
||
timezone TEXT NOT NULL DEFAULT 'Europe/Prague',
|
||
active BOOLEAN NOT NULL DEFAULT true,
|
||
notes TEXT,
|
||
created_at TIMESTAMPTZ DEFAULT now()
|
||
);
|
||
```
|
||
|
||
### `site_endpoint`
|
||
Komunikační endpointy – každá lokalita může mít více.
|
||
|
||
```sql
|
||
CREATE TABLE site_endpoint (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
endpoint_type TEXT NOT NULL, -- 'modbus_tcp', 'loxone_http', 'teltonika_api'
|
||
host TEXT NOT NULL,
|
||
port INT,
|
||
protocol TEXT, -- 'modbus_tcp', 'http', 'https'
|
||
auth_reference TEXT, -- odkaz na secret / env proměnnou
|
||
enabled BOOLEAN DEFAULT true,
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `site_market_config`
|
||
Obchodní konfigurace s maržemi. Platnost od-do umožňuje historické sledování změn.
|
||
|
||
```sql
|
||
CREATE TABLE site_market_config (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
purchase_pricing_mode TEXT NOT NULL DEFAULT 'spot', -- 'spot', 'fixed', 'hybrid'
|
||
sale_pricing_mode TEXT NOT NULL DEFAULT 'spot',
|
||
buy_margin_fixed_czk NUMERIC(10,4) DEFAULT 0, -- Kč/kWh
|
||
buy_margin_percent NUMERIC(6,4) DEFAULT 0,
|
||
sell_margin_fixed_czk NUMERIC(10,4) DEFAULT 0, -- Kč/kWh (záporná = srážka)
|
||
sell_margin_percent NUMERIC(6,4) DEFAULT 0,
|
||
currency TEXT NOT NULL DEFAULT 'CZK',
|
||
valid_from TIMESTAMPTZ NOT NULL,
|
||
valid_to TIMESTAMPTZ, -- NULL = aktuálně platný
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `site_grid_connection`
|
||
Síťová omezení lokality.
|
||
|
||
```sql
|
||
CREATE TABLE site_grid_connection (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id) UNIQUE,
|
||
max_import_power_w INT NOT NULL,
|
||
max_export_power_w INT NOT NULL DEFAULT 0,
|
||
no_export BOOLEAN DEFAULT false,
|
||
reserved_capacity_w INT DEFAULT 0,
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
---
|
||
|
||
## Aktiva
|
||
|
||
### `asset_inverter`
|
||
|
||
```sql
|
||
CREATE TABLE asset_inverter (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
code TEXT NOT NULL,
|
||
manufacturer TEXT, -- 'Deye'
|
||
model TEXT, -- 'SUN-20K-SG01LP1-EU'
|
||
endpoint_id INT REFERENCES site_endpoint(id),
|
||
max_charge_power_w INT,
|
||
max_discharge_power_w INT,
|
||
max_export_power_w INT,
|
||
controllable BOOLEAN DEFAULT true, -- false = ongridový autonomní
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `asset_battery`
|
||
|
||
```sql
|
||
CREATE TABLE asset_battery (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
inverter_id INT REFERENCES asset_inverter(id),
|
||
code TEXT NOT NULL,
|
||
usable_capacity_wh INT NOT NULL, -- 64000
|
||
min_soc_percent NUMERIC(5,2) DEFAULT 10,
|
||
reserve_soc_percent NUMERIC(5,2) DEFAULT 20, -- rezerva pro výpadek
|
||
max_soc_percent NUMERIC(5,2) DEFAULT 95,
|
||
charge_efficiency NUMERIC(5,4) DEFAULT 0.95,
|
||
discharge_efficiency NUMERIC(5,4) DEFAULT 0.95,
|
||
degradation_cost_czk_kwh NUMERIC(8,4) DEFAULT 0.5 -- náklad na cyklus
|
||
);
|
||
```
|
||
|
||
### `asset_pv_array`
|
||
Každé FVE pole zvlášť – důležité pro predikci (azimut, sklon).
|
||
|
||
```sql
|
||
CREATE TABLE asset_pv_array (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
inverter_id INT REFERENCES asset_inverter(id),
|
||
code TEXT NOT NULL,
|
||
name TEXT,
|
||
nominal_power_wp INT NOT NULL, -- 10000
|
||
azimuth_deg NUMERIC(6,2), -- 0=S, 90=Z, -90=V
|
||
tilt_deg NUMERIC(5,2),
|
||
module_count INT,
|
||
shading_factor NUMERIC(4,3) DEFAULT 1.0,
|
||
controllable BOOLEAN DEFAULT false, -- ongridový = false
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `asset_ev_charger`
|
||
EV nabíječky. Na první instalaci jsou 2× Teltonika.
|
||
|
||
```sql
|
||
CREATE TABLE asset_ev_charger (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
code TEXT NOT NULL,
|
||
manufacturer TEXT, -- 'Teltonika'
|
||
model TEXT, -- 'TeltoCharge'
|
||
endpoint_id INT REFERENCES site_endpoint(id),
|
||
max_power_w INT NOT NULL, -- 22000
|
||
min_power_w INT DEFAULT 1380, -- min pro jednofázové nabíjení
|
||
phases INT DEFAULT 3,
|
||
connector_count INT DEFAULT 1,
|
||
schedulable BOOLEAN DEFAULT true,
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `asset_flexible_device`
|
||
Generická tabulka pro ostatní flexibilní spotřebiče (TUV, tepelné čerpadlo, ...).
|
||
|
||
```sql
|
||
CREATE TABLE asset_flexible_device (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
code TEXT NOT NULL,
|
||
device_type TEXT NOT NULL, -- 'tuv', 'heat_pump', 'pool', ...
|
||
control_mode TEXT DEFAULT 'loxone', -- jak se řídí
|
||
max_power_w INT,
|
||
min_power_w INT DEFAULT 0,
|
||
interruptible BOOLEAN DEFAULT true,
|
||
schedulable BOOLEAN DEFAULT true,
|
||
priority INT DEFAULT 50, -- 0=nejvyšší priorita
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
---
|
||
|
||
## Tržní data
|
||
|
||
### `market_interval_price`
|
||
Raw spotové ceny OTE CZ. Bez vazby na lokalitu – sdílené.
|
||
TimescaleDB hypertable.
|
||
|
||
```sql
|
||
CREATE TABLE 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), -- nákupní raw cena Kč/kWh
|
||
sell_raw_price_czk_kwh NUMERIC(10,6), -- prodejní raw cena (ref. cena)
|
||
currency TEXT DEFAULT 'CZK',
|
||
imported_at TIMESTAMPTZ DEFAULT now(),
|
||
PRIMARY KEY (market_source, interval_start)
|
||
);
|
||
-- SELECT create_hypertable('market_interval_price', 'interval_start');
|
||
```
|
||
|
||
### View: `market_vw_site_effective_price`
|
||
Efektivní ceny per site – dopočítané z raw + marže. Neukládá se, počítá se za běhu.
|
||
|
||
```sql
|
||
CREATE VIEW market_vw_site_effective_price AS
|
||
SELECT
|
||
smc.site_id,
|
||
mip.interval_start,
|
||
mip.interval_end,
|
||
mip.buy_raw_price_czk_kwh,
|
||
mip.sell_raw_price_czk_kwh,
|
||
-- efektivní nákupní cena
|
||
mip.buy_raw_price_czk_kwh
|
||
+ smc.buy_margin_fixed_czk
|
||
+ (mip.buy_raw_price_czk_kwh * smc.buy_margin_percent / 100)
|
||
AS effective_buy_price_czk_kwh,
|
||
-- efektivní prodejní cena
|
||
mip.sell_raw_price_czk_kwh
|
||
+ smc.sell_margin_fixed_czk
|
||
+ (mip.sell_raw_price_czk_kwh * smc.sell_margin_percent / 100)
|
||
AS effective_sell_price_czk_kwh
|
||
FROM market_interval_price mip
|
||
CROSS JOIN site_market_config smc
|
||
WHERE smc.valid_to IS NULL -- aktuálně platná konfigurace
|
||
OR now() BETWEEN smc.valid_from AND smc.valid_to;
|
||
```
|
||
|
||
---
|
||
|
||
## Telemetrie
|
||
|
||
### `telemetry_inverter`
|
||
Raw měření ze střídače Deye (Modbus). 1min granularita, hypertable.
|
||
|
||
```sql
|
||
CREATE TABLE telemetry_inverter (
|
||
site_id INT REFERENCES site(id),
|
||
inverter_id INT REFERENCES asset_inverter(id),
|
||
measured_at TIMESTAMPTZ NOT NULL,
|
||
-- výroba
|
||
pv_power_w INT, -- celkový výkon FVE (oba stringy)
|
||
-- baterie
|
||
battery_soc_percent NUMERIC(5,2),
|
||
battery_power_w INT, -- kladné = nabíjení, záporné = vybíjení
|
||
battery_voltage_v NUMERIC(7,3),
|
||
-- síť
|
||
grid_power_w INT, -- kladné = import, záporné = export
|
||
grid_voltage_v NUMERIC(7,3),
|
||
-- spotřeba
|
||
load_power_w INT, -- celková spotřeba objektu
|
||
-- teploty
|
||
inverter_temp_c NUMERIC(5,2),
|
||
-- provozní stav
|
||
operating_mode TEXT, -- raw hodnota z Modbus registru
|
||
fault_code INT,
|
||
PRIMARY KEY (inverter_id, measured_at)
|
||
);
|
||
-- SELECT create_hypertable('telemetry_inverter', 'measured_at');
|
||
```
|
||
|
||
### `telemetry_ev_charger`
|
||
Stav EV nabíječek.
|
||
|
||
```sql
|
||
CREATE TABLE telemetry_ev_charger (
|
||
site_id INT REFERENCES site(id),
|
||
charger_id INT REFERENCES asset_ev_charger(id),
|
||
measured_at TIMESTAMPTZ NOT NULL,
|
||
connector_id INT DEFAULT 1,
|
||
status TEXT, -- 'available', 'charging', 'faulted', ...
|
||
power_w INT,
|
||
energy_kwh NUMERIC(10,3), -- kumulativní
|
||
current_a NUMERIC(7,3),
|
||
voltage_v NUMERIC(7,3),
|
||
session_id TEXT,
|
||
PRIMARY KEY (charger_id, connector_id, measured_at)
|
||
);
|
||
-- SELECT create_hypertable('telemetry_ev_charger', 'measured_at');
|
||
```
|
||
|
||
---
|
||
|
||
## Predikce výroby
|
||
|
||
### `forecast_pv_run`
|
||
Každý běh predikce je jeden záznam (kdy se spustil, jaký model, jaké pole).
|
||
|
||
```sql
|
||
CREATE TABLE forecast_pv_run (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
pv_array_id INT REFERENCES asset_pv_array(id), -- NULL = celá lokalita
|
||
forecast_source TEXT NOT NULL, -- 'open_meteo', 'solcast', 'manual'
|
||
model_params JSONB, -- parametry modelu
|
||
horizon_start TIMESTAMPTZ NOT NULL,
|
||
horizon_end TIMESTAMPTZ NOT NULL,
|
||
created_at TIMESTAMPTZ DEFAULT now(),
|
||
status TEXT DEFAULT 'ok' -- 'ok', 'partial', 'failed'
|
||
);
|
||
```
|
||
|
||
### `forecast_pv_interval`
|
||
Samotná predikovaná data, 15min granularita.
|
||
|
||
```sql
|
||
CREATE TABLE forecast_pv_interval (
|
||
run_id INT REFERENCES forecast_pv_run(id),
|
||
pv_array_id INT REFERENCES asset_pv_array(id),
|
||
interval_start TIMESTAMPTZ NOT NULL,
|
||
power_w INT NOT NULL, -- predikovaný výkon
|
||
irradiance_wm2 NUMERIC(8,2), -- GHI ze weather service
|
||
temp_c NUMERIC(5,2),
|
||
PRIMARY KEY (run_id, pv_array_id, interval_start)
|
||
);
|
||
-- SELECT create_hypertable('forecast_pv_interval', 'interval_start');
|
||
```
|
||
|
||
---
|
||
|
||
## Plánování
|
||
|
||
### `planning_run`
|
||
Jeden plánovací běh per site.
|
||
|
||
```sql
|
||
CREATE TABLE planning_run (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
horizon_start TIMESTAMPTZ NOT NULL,
|
||
horizon_end TIMESTAMPTZ NOT NULL,
|
||
created_at TIMESTAMPTZ DEFAULT now(),
|
||
status TEXT DEFAULT 'draft', -- 'draft', 'approved', 'active', 'superseded'
|
||
solver_params JSONB,
|
||
notes TEXT
|
||
);
|
||
```
|
||
|
||
### `planning_interval`
|
||
Výstup plánování – jeden řádek = jeden 15min slot.
|
||
|
||
```sql
|
||
CREATE TABLE planning_interval (
|
||
run_id INT REFERENCES planning_run(id),
|
||
interval_start TIMESTAMPTZ NOT NULL,
|
||
-- baterie
|
||
battery_setpoint_w INT, -- kladné = nabíjení, záporné = vybíjení
|
||
battery_soc_target_pct NUMERIC(5,2),
|
||
-- grid
|
||
grid_setpoint_w INT, -- kladné = import, záporné = export
|
||
-- EV (agregát za všechny nabíječky na site)
|
||
ev_charge_power_w INT,
|
||
-- TUV
|
||
tuv_enabled BOOLEAN,
|
||
-- ekonomika
|
||
expected_cost_czk NUMERIC(10,4),
|
||
effective_buy_price NUMERIC(10,6),
|
||
effective_sell_price NUMERIC(10,6),
|
||
PRIMARY KEY (run_id, interval_start)
|
||
);
|
||
```
|
||
|
||
---
|
||
|
||
## Audit
|
||
|
||
### `audit_interval`
|
||
Skutečnost vs plán, 15min granularita. Plněno zpětně po dostupnosti dat.
|
||
|
||
```sql
|
||
CREATE TABLE audit_interval (
|
||
site_id INT REFERENCES site(id),
|
||
interval_start TIMESTAMPTZ NOT NULL,
|
||
planning_run_id INT REFERENCES planning_run(id),
|
||
-- skutečnost (z telemetrie, průměr/agregát za 15min)
|
||
actual_pv_power_w INT,
|
||
actual_battery_power_w INT,
|
||
actual_grid_power_w INT,
|
||
actual_load_power_w INT,
|
||
actual_battery_soc NUMERIC(5,2),
|
||
-- odchylky
|
||
deviation_grid_w INT, -- actual - planned
|
||
actual_cost_czk NUMERIC(10,4),
|
||
PRIMARY KEY (site_id, interval_start)
|
||
);
|
||
-- SELECT create_hypertable('audit_interval', 'interval_start');
|
||
```
|
||
|
||
---
|
||
|
||
## Spotřeba
|
||
|
||
### `consumption_baseline_interval`
|
||
Bazální (neflexibilní) spotřeba – historická a predikovaná, 15min.
|
||
|
||
```sql
|
||
CREATE TABLE consumption_baseline_interval (
|
||
site_id INT REFERENCES site(id),
|
||
interval_start TIMESTAMPTZ NOT NULL,
|
||
data_type TEXT NOT NULL, -- 'actual', 'forecast'
|
||
power_w INT NOT NULL,
|
||
source TEXT, -- 'measured', 'model_v1', ...
|
||
PRIMARY KEY (site_id, data_type, interval_start)
|
||
);
|
||
```
|
||
|
||
### Flexibilní spotřebiče
|
||
Flexibilní spotřeba se neukládá souhrnně – odvozuje se ze součtu `telemetry_ev_charger` + stavů `asset_flexible_device` per interval. Plánovaná flexibilní spotřeba je součástí `planning_interval`.
|
||
|
||
---
|
||
|
||
## Override
|
||
|
||
### `site_override`
|
||
Manuální přepisy pro provozní stavy.
|
||
|
||
```sql
|
||
CREATE TABLE site_override (
|
||
id SERIAL PRIMARY KEY,
|
||
site_id INT REFERENCES site(id),
|
||
override_type TEXT NOT NULL, -- 'force_charge', 'force_discharge', 'block_export', 'manual_setpoint'
|
||
value_json JSONB, -- parametry přepisu
|
||
valid_from TIMESTAMPTZ NOT NULL,
|
||
valid_to TIMESTAMPTZ,
|
||
reason TEXT,
|
||
created_by TEXT,
|
||
created_at TIMESTAMPTZ DEFAULT now()
|
||
);
|
||
```
|