Files
ems/docs/01-overview.md
Dusan Vojacek 4881966d00
All checks were successful
deploy / deploy (push) Successful in 15s
test / smoke-test (push) Successful in 3s
multisite update dokumentace
2026-04-05 22:11:50 +02:00

63 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 16 + 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.