multisite update dokumentace
All checks were successful
deploy / deploy (push) Successful in 15s
test / smoke-test (push) Successful in 3s

This commit is contained in:
Dusan Vojacek
2026-04-05 22:11:50 +02:00
parent 9b9ce33983
commit 4881966d00
6 changed files with 28 additions and 12 deletions

View File

@@ -15,7 +15,7 @@ Systém přebírá rozhodovací logiku od Loxone a stává se „mozkem" pl
- 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
- 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í

View File

@@ -5,7 +5,8 @@
```
┌─────────────────────────────────────────────┐
│ React Frontend (Vite + TypeScript) │
│ Dashboard, plány, telemetrie, overrides
│ Dashboard, plány, telemetrie; výběr site
│ (combobox → /api/v1/me/sites + PostgREST) │
└─────────────┬───────────────────────────────┘
│ HTTP/REST
┌─────────────▼───────────────────────────────┐
@@ -25,7 +26,7 @@
│ FastAPI (Python) │
Scheduled tasks (APScheduler) │
telemetry_collector (každých 60s) │
price_importer (13:30, 14:00, 00:05)│
price_importer (13:30, 14:00, 00:05)
forecast_service (každé 2h, minute 05)│
planning_engine (denně 15:00) │
control_exporter (každých 15min) │
@@ -118,7 +119,9 @@ ems-platform/
App.tsx
api/
postgrest.ts ← PostgREST client
backend.ts ← FastAPI client
backend.ts ← FastAPI client (/me/sites, …)
context/
SiteSelectionContext.tsx ← výběr lokality, localStorage
pages/
Dashboard.tsx
Planning.tsx
@@ -162,7 +165,8 @@ PostgreSQL (ceny + forecast) → fn_create_planning_run() → planning_interval
### Operátorské manuální akce (UI)
```
Browser → FastAPI:
POST /api/v1/sites/{site_id}/prices/import?date=YYYY-MM-DD
GET /api/v1/me/sites ← seznam aktivních lokalit (UI combobox; bez auth zatím = všechny aktivní)
POST /api/v1/sites/{site_id}/prices/import?date=YYYY-MM-DD ← zapisuje globální market_interval_price; site_id jen validace URL
POST /api/v1/sites/{site_id}/forecast/run
POST /api/v1/sites/{site_id}/plan/run?type=daily|rolling
```
@@ -176,8 +180,8 @@ PostgreSQL (planning_interval + overrides) → control_exporter
### Frontend
```
Browser → PostgREST (čtení views/tabulek)
Browser → FastAPI (triggery: replanning, override, manual export)
Browser → PostgREST (čtení views/tabulek, filtr site_id dle výběru v UI)
Browser → FastAPI (seznam lokalit /me/sites, triggery: replanning, import cen, …)
```
---

View File

@@ -189,6 +189,7 @@ CREATE TABLE asset_flexible_device (
### `market_interval_price`
Raw spotové ceny OTE CZ. Bez vazby na lokalitu sdílené.
Backend stahuje OTE **jednou** za naplánovaný import (data platí pro všechny site); efektivní ceny per site jen přes `site_market_config` a view.
TimescaleDB hypertable.
```sql

View File

@@ -24,7 +24,7 @@ OTE CZ publikuje denní ceny zpravidla **den předem (D-1)** okolo 13:0014:00
- Body: `data.dataLine[0].point[]` s `x` = 1…96 (15min slot), `y` = cena.
- Jednotka ceny se bere z `axis.y.legend` (typicky **EUR/MWh**); kód podporuje i CZK/MWh a CZK/kWh.
- Přepočet do `buy_raw_price_czk_kwh`: EUR/MWh → `× EUR_CZK / 1000`; CZK/MWh → `/ 1000`; CZK/kWh beze změny.
- Časové razítko slotu: půlnoc v **timezone lokality** (`site.timezone`) + (x1)×15 min → UTC.
- Časové razítko slotu při importu: závisí na volbě dne; scheduler a globální import používají **Europe/Prague**. Volitelný parametr `site_id` v `import_ote_prices` umožní pro manuální volání bez explicitního data použít `site.timezone` místo Prahy.
### Legacy / alternativa
@@ -38,6 +38,14 @@ OTE CZ publikuje denní ceny zpravidla **den předem (D-1)** okolo 13:0014:00
Samostatný modul (ne součást FastAPI, ale může být volán z ní jako task).
### Multi-site: jeden import na tick
Tabulka `ems.market_interval_price` je **globální** (jeden zdroj `OTE_CZ` pro celou instalaci). Plánovaný job v `backend/app/main.py` proto pro dnešek a zítřek v `Europe/Prague` doplňuje chybějící dny **nejednou v cyklu po každé lokalitě**, ale jedním HTTP dotazem na OTE a jedním zápisem do DB. Po úspěšném importu se pro **každou aktivní** `ems.site` znovu naplní cache predikce záporných cen (`fn_predict_negative_price_windows`).
Funkce `import_ote_prices(db, site_id=None, target_date=…)` akceptuje volitelný `site_id` jen pro odvození „dnes/zítra“, pokud není zadán `target_date`; při `site_id is None` se použije `Europe/Prague` (shodně se schedulerem).
**Manuální** `POST /api/v1/sites/{site_id}/prices/import` ponechává `site_id` v cestě kvůli kompatibilitě s UI (ověření, že lokalita existuje), ale zapisuje stejná sdílená data jako scheduler.
### Implementované provozní změny (2026-03)
- Robustní HTTP fetch přes `httpx`:

View File

@@ -32,7 +32,7 @@ Tento soubor slouží jako živý seznam věcí které je potřeba rozhodnout p
## Fáze 2 (zatím neřešíme)
- [ ] Více lokalit multi-site UI a správa
- [ ] Více lokalit **správa** (admin CRUD site v UI, šablony migrací pro novou lokalitu) — základ UI je: combobox aktivních lokalit (`GET /api/v1/me/sites`), PostgREST dotazy filtrované podle výběru; autorizace per user/site a RLS u PostgREST stále otevřené, viz níže.
- [ ] Solcast jako alternativa k Open-Meteo
- [ ] Intraday OTE ceny
- [ ] Sezónní korekce predikce spotřeby
@@ -44,3 +44,5 @@ Tento soubor slouží jako živý seznam věcí které je potřeba rozhodnout p
## Vyřešeno
- **PostgREST anon role:** `ems_anon`, read-only na vybrané views a tabulky (migrace `V009__postgrest_roles.sql` + repeatable `R__z_postgrest_ems_anon_grants.sql` kvůli pořadí Flyway); zápisy přes FastAPI. Compose / `.env`: `POSTGREST_ANON_ROLE=ems_anon`, PostgREST `PGRST_DB_ANON_ROLE`.
- **Multi-site (částečně):** OTE import jednou pro celý systém do `market_interval_price`; frontend výběr lokality (`SiteSelectionContext`, persist `ems.selected_site_id`), API `GET /api/v1/me/sites` (zatím všechny aktivní site). Chybí: mapování uživatel → site, JWT/RLS u PostgREST (viz otevřená otázka výše).