Files
ems/docs/01-overview.md
Dusan Vojacek 02f0ab66e4
Some checks failed
CI and deploy / migration-check (pull_request) Failing after 27s
CI and deploy / deploy (pull_request) Has been skipped
gpt5.5 - odladeni dokumentace dle kodu
2026-05-02 19:17:04 +02:00

2.6 KiB
Raw Blame History

EMS Platform Overview

Co systém dělá

Energy Management System (EMS) je multi-site platforma pro optimalizaci výroby, spotřeby a obchodování s energií na objektech vybavených FVE, baterií, flexibilními spotřebiči a přístupem ke spotovému trhu OTE CZ.

Systém přebírá rozhodovací logiku od Loxone a stává se „mozkem" plánuje, optimalizuje a posílá setpointy zpět do Loxone jako exekutoru.

Hlavní funkce

  • Sběr telemetrie ze střídače Deye přes Modbus/RS485 → Waveshare IP převodník
  • Sběr dat z EV nabíječek Teltonika přes API
  • Stahování spotových cen OTE CZ (15min granularita)
  • Predikce výroby FVE (per pole, per azimut/sklon)
  • Plánování provozu baterie, EV nabíjení, TUV na základě cen a predikce
  • Export setpointů do Loxone přes HTTP Virtual Inputs
  • Audit skutečnosti vs plánu
  • Multi-site: jeden systém, více lokalit (sdílené raw ceny OTE; forecast a plán per site_id; ve webu výběr aktivní lokality comboboxem)

Co systém není

  • Není SCADA neprovádí real-time ochranné funkce (to dělá Loxone/střídač)
  • Neřídí ongridový střídač (10kWp zapojený do GEN portu) ten je autonomní
  • Nenahrazuje Loxone jako exekutor lokální automatizace

Scope první instalace (site: home-01)

Komponenta Detail
Střídač Deye SUN-20K-SG01LP1-EU (20kW LV, hybridní)
Baterie 64 kWh LV (připojená k Deye)
FVE pole A ~10 kWp (řízené Deye)
FVE pole B ~10 kWp (ongridový střídač → GEN port Deye, autonomní, neplánujeme řídit)
EV nabíječky 2× Teltonika TeltoCharge 22kW
TUV Tepelné čerpadlo / boiler (přes Loxone)
Komunikace střídač RS485 → Waveshare WS-ETH (Modbus TCP)
Komunikace Loxone HTTP Web Services / Virtual Inputs
Trh OTE CZ, spotové ceny, 15min intervaly

Technologický stack

Vrstva Technologie
DB PostgreSQL 18 + TimescaleDB
API / BFF PostgREST (automatické REST z DB schématu)
Backend logika Python (FastAPI) plánovač, sběr dat, integrace
Frontend React + TypeScript
Komunikace střídač Python modbus-tcp klient
Kontejnerizace Docker Compose
Migrace Flyway nebo plain SQL skripty

Časová granularita

Primární granularita celého systému je 15 minut.

  • Spotové ceny: 15min intervaly
  • Telemetrie: ukládána po 1min, agregována na 15min pro plánování
  • Plánování: 15min sloty
  • Setpointy pro Loxone: 15min
  • Audit skutečnost vs plán: 15min

Hodinové pohledy existují pouze jako agregovaná views nad 15min daty.