EMS Platform

Systém pro správu energie fotovoltaické elektrárny s baterií, EV nabíječkami a tepelným čerpadlem. Optimalizuje náklady pomocí spotových cen OTE CZ.

Podrobná architektura, datový model a moduly jsou v docs/; stručná orientace pro vývoj je v CLAUDE.md.

Rychlý start

cp .env.example .env
# Uprav .env: DB_PASSWORD, POSTGREST_JWT_SECRET (min 32 znaků)
docker compose up --build -d
# Počkej ~45s na Flyway migrace a start služeb
bash scripts/smoke_test.sh

• UI: http://localhost
• API (FastAPI): http://localhost/api/v1 (případně přímo http://localhost:8000/api/v1)
• PostgREST: http://localhost/rest (případně http://localhost:3000)

Inicializace dat (první spuštění)

# 1. Import spotových cen OTE (zítřek v časové zóně lokality)
curl -X POST http://localhost/api/v1/sites/1/prices/import

# 2. PV forecast (Open-Meteo + pvlib → forecast_pv_interval)
curl -X POST http://localhost/api/v1/sites/1/forecast/run

# 3. Spustit optimalizaci (denní plán)
curl -X POST "http://localhost/api/v1/sites/1/plan/run?type=daily"

Ve webovém rozhraní: stránka Plánování a tlačítko Přeplánovat spouští rolling přepočet (vyžaduje již dostupné ceny a forecast v horizontu solveru).

Stack

Komponenta	Technologie	Port
DB	PostgreSQL 16 + TimescaleDB	5432 (mapováno na localhost, interně v síti Docker)
API	FastAPI + PostgREST	80 přes Nginx (/api, /rest)
Frontend	React + Vite + Tailwind	80
Migrace	Flyway (db/migration, db/routines, db/views)	—

Co ještě nefunguje (před instalací HW)

• Telemetrie: IP adresy Waveshare (Modbus TCP) doplnit v DB / seedu (db/migration/V003__seed_site_home01.sql a site_endpoint).
• EV nabíječky: Modbus registry Teltonika zatím často mock / rozpracované.
• Samsung TČ: Modbus registry pending (mock data).
• Loxone: nakonfigurovat Virtual Inputs dle docs/loxone-integration.md.

Architektura

Viz docs/02-architecture.md.