Dusan Vojacek 4095f0f912
All checks were successful
CI and deploy / migration-check (push) Successful in 19s
CI and deploy / deploy (push) Successful in 56s
EV spotřební forecast: týdenní rytmus vozidla → target SoC a deadline session
Myšlenka uživatele: pondělní služebka ~150 km (~35 kWh) chce skoro plnou,
konec týdne stačí míň, víkend = levné sloty na přípravu pondělka.

- V089: ev_vehicle_obs (odometer+SoC při příjezdu/ODJEZDU — auto v obou
  okamžicích vzhůru, žádné buzení navíc), ev_trip (km z odometru, kWh z ΔSoC;
  nabíjení cestou → charged_away flag), ev_usage_stats per (vozidlo, DOW);
  asset_vehicle: target_soc_forecast_enabled (default false), min_target_soc_pct
- R__096: fn_ev_build_trips (párování), fn_update_ev_usage_stats (job 00:50),
  fn_ev_next_departure (příští typický odjezd, >=4 vzorky, >=3 km),
  fn_ev_required_soc (P80 spotřeby dne + 10 p.b., clamp [min_target, 100])
- R__016: session při příjezdu bere forecast target+deadline (za per-vozidlo
  flagem, fallback defaulty, ruční patch vždy vyhrává) → víkendová session
  s pondělním deadline = v2 solver přirozeně nabije v levných slotech
- tesla_client: + vehicle_state endpoint (odometer v MÍLÍCH → km), collector:
  departure hook, lifespan: job 00:50

Aktivace po nasbírání dat: update asset_vehicle set target_soc_forecast_enabled=true.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-12 09:06:10 +02:00
2026-06-06 22:41:56 +02:00
2026-05-15 23:03:32 +02:00
x
2026-03-20 14:30:03 +01:00

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

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.

Description
No description provided
Readme 19 MiB
Languages
Python 66.9%
TypeScript 19.4%
PLpgSQL 11.9%
Shell 1.4%
JavaScript 0.2%