sql first refactor

docs/02-architecture.md

@@ -46,6 +46,10 @@
 
 ---
 
+## Read-model JSONB (`ems.fn_*`)
+
+FastAPI endpointy pro dashboard a konfiguraci preferují **jedno volání** `select ems.fn_*(…)` vracející **jsonb** (pole řádků, agregace, merge locků), aby v Pythonu nezůstávaly ad-hoc `SELECT`/`JOIN`/`WITH`. Pomocník `app.db_json.fetch_json` vrací `dict`/`list`. Telemetrie a IO zůstávají v Pythonu; čisté agregace a sjednocení TZ patří do SQL. Opakované migrace: `db/routines/R__fn_*.sql`, `db/views/R__vw_*.sql`.
+
 ## Komponenty
 
 | Komponenta | Technologie | Port | Popis |
@@ -77,7 +81,7 @@ ems-platform/
       R__fn_cop_estimate.sql
       R__fn_baseline_consumption.sql
       R__fn_fill_audit_interval.sql
-      R__fn_plan_day.sql
+      (historicky) R__fn_plan_day.sql – primární plánování je PuLP v Pythonu
       R__fn_create_planning_run.sql
     views/
       R__vw_site_effective_price.sql