21. Beta testování a vývoj — cloudové AI BETA

Kapitola 21 · vývoj / testy · volitelná placená vrstva · lokální AI zůstává v kapitolách 11–20d

V nové větvi vývoje připravujeme volitelnou cloudovou AI (Google Gemini API) jako doplněk k lokální AI zdarma (SHADOW / ASSIST / AUTO). Cíl: denní plán a srozumitelné české vysvětlení nad daty, která už zařízení a aplikace mají (FVE, baterie, teploty; Spot jen pokud ho používáte) — ne náhrada safety ani zdroje měření.

Co se v beta verzi připravuje

• Denní briefing — krátký text o dni (počasí / FVE / Spot) pro Premium UI (/ai-live, Spot stránky), bez zásahu do PWM.
• Soft plán dne — doporučená okna nabíjení / topení z přebytku, jemný bias agresivity lokální AI (ne absolutní PWM).
• Vysvětlení pro laika — 2–4 věty česky, proč dnes AI nabíjí / šetří / čeká na levnější Spot.
• Vlastní API klíč uživatele — klíč z Google AI Studio se ukládá do zařízení (SPIFFS), ne do prohlížeče.
• Testy na Free tier — nejdřív bez placení; billing až když limity nestačí.

Co platí vždy (i v beta)

Jak to má fungovat (obecně)

1. Zařízení sestaví vstup: telemetrie + forecast z weather app (+ Spot křivka z OTE, jen pokud Spot používáte).
2. Volitelně přes backend (proxy) požádá cloud o plán / text — s klíčem uloženým v ESP.
3. Odpověď: okna, soft bias, české vysvětlení. Žádné nové „autoritativní“ teploty / Wh / ceny.
4. ESP zobrazí text; řízení PWM jen pokud projde lokální safety (v ostré fázi soft bias).

Jak se aplikace chová — příklady dne

Cloudová AI ráno (nebo několikrát denně) sestaví krátký plán z toho, co už aplikace ví: stav baterie, předpověď výroby, teploty — a volitelně Spot ceny, pokud je máte zapnuté. Níže jsou typické situace: co uvidíte a co se stane s topením.

Příklad A — mám baterii, má svítit

Příklad B — mám baterii, bude zataženo

Příklad C — nemám baterii, topím podle počasí, bez Spotu

Příklad D — bez Spotu, s baterií (pro srovnání)

Další možnosti

Kde uživatel uvidí data z cloudové AI BETA

V aplikaci na zařízení se nezobrazuje surový výstup modelu. Uvidíte české texty (briefing / vysvětlení) vedle stávajících čísel z měření a Spotu. V G2 šlo jen o čtení. Od G3 smí cloud mírně (±3 %) korigovat agresivitu lokální AI — Distr., SOC, teploty a Spot Gate zůstávají tvrdé.

Ukázka ESP — /ai-live (hlavní)

Ukázka ESP — ostatní stránky (jen krátký řádek)

Ukázka api.easun.eu — bez limitů ESP

Na serveru Analýzy se ze zařízení sbírají data bez omezení délky UI jako na ESP: plný text plánu, historie dnů, grafy Spot×spotřeba, srovnání, delší vysvětlení. Čísla (W, °C, Kč/MWh) dál pocházejí z telemetrie / OTE / app — cloud jen skládá text a kontext.

Kdy se text ukáže / skryje

• AI Cloud OFF nebo chybí klíč → cloud blok není / „vypnuto“, žádný dotaz do cloudu.
• AI Cloud ON + platný plán → texty výše; topení dál řídí lokální AI a limity.
• Plán prošlý → text „neaktuální“; nepoužívat jako doporučení.
• Bez WiFi → poslední uložený text do expirace, pak jen AI zdarma.
• Chybí Spot / počasí → kratší text; na Spot/Weather stránkách vidíte lokální výpadek čísel.

Když Gemini / cloud nefunguje — krizové stavy DŮLEŽITÉ

Co se stane v aplikaci (vždy)

1. PWM řídí dál lokální AI nebo klasika — jako by Cloud byl vypnutý.
2. Žádné „cloudové“ zvýšení/snížení agresivity (bias se nepoužije).
3. Na /ai-live uvidíte stav: Offline / Limit / Chyba / Neaktuální / Klíč? — ne pád stránky.
4. Zařízení nezkouší dokola každou vteřinu — počká na další plánovaný pokus.

Přehled výpadků

Ukázka — chybové stavy na ESP

Proč je zobrazení omezené (RAM na ESP) DŮLEŽITÉ

Zařízení EaSun (ESP32 / ESP32-S3) má omezenou operační paměť. Webové stránky se skládají přímo v zařízení. Velký text z cloudu by mohl způsobit nestabilitu (výpadek stránky, restart). Proto je zobrazení cloudové AI záměrně krátké a úsporné.

Jak to bude provedeno

1. Server zkrátí odpověď — do zařízení nejde celý výstup modelu, jen malý „snapshot“ pro UI (několik krátkých českých vět + stav).
2. Limity délky textu (delší se ořízne tečkami): vysvětlení dne ≈ max. 2–3 věty (~240 znaků), shrnutí Spot / počasí ≈ 1 věta (~120 znaků), tip oken ≈ 1 krátký řádek. Celkem typicky méně než 1 KB textu v zařízení.
3. Uložení v SPIFFS — malý soubor na flash, ne velký text držený trvale v RAM. Při otevření stránky se načte jen to potřebné.
4. Plný text jen na /ai-live — na Weather a Spot maximálně jeden řádek + odkaz „více na AI LIVE“. Home jen malý odkaz / stav (bez odstavců), ať se nepřetíží už velká úvodní stránka.
5. Nezobrazuje se: surový JSON, hodinové Spot pole, dlouhé seznamy, debug / tokeny — to zůstává na serveru. V prohlížeči na ESP jen srozumitelný text.
6. Při nedostatku paměti: zařízení ukáže zkrácenou verzi (např. jen stav + vysvětlení) nebo hlášku, že text byl zkrácen — řízení topení tím není ohroženo (lokální AI a limity běží dál).

Doporučení pro testery (Free tier)

1. Přihlaste se na aistudio.google.com (Google účet) a přijměte podmínky.
2. Vytvořte / zkopírujte API klíč na API keys.
3. V Playgroundu ověřte, že model krátce odpoví (Flash-Lite / Flash).
4. Klíč uložte do zařízení EaSun (pole Gemini API key → Uložit do SPIFFS).
5. Na testy: 1 zařízení, poll 1× denně (nebo max 6×), model Flash-Lite. Billing zapínejte až při častých chybách limitu (429).
6. Ověřte: Premium OFF = žádný cloud; Premium ON = text v UI, čísla na Home / Spot dál z aplikace.

Když Free nestačí (placené Gemini)

1. V Google AI Studio zapněte billing / placený účet pro Gemini API.
2. Nastavte si rozpočtové upozornění (alert), ať nemáte překvapení ve faktuře.
3. Stejný API klíč nechte v zařízení — po aktivaci billingu obvykle stačí počkat několik minut a znovu otestovat cloud plán (1×, ne spam).
4. Poll nechte nízký (1–2× denně). Topení i při výpadku cloudu řídí lokální AI.

Co je hotové — cloud vs. aplikace na zařízení

G4 — test po dnech (naplnit log → CSV → go/no-go)

1. Zapněte odesílání AI logu na api.easun.eu (host AI logu v Režimech). Lokální AI: ASSIST nebo AUTO — po celý test stejný režim.
2. Perioda A — 7 dní: AI Cloud vypnuto (bez soft bias). Neměňte Spot / baterii (segment a/b/c musí zůstat stejný).
3. Perioda B — 7 dní: AI Cloud zapnuto + platný Gemini klíč (až nebude limit 429). Stejné limity teplot / SOC / Spot Gate.
4. Po každém půlnoci se do logu zapisuje denní souhrn (G4_DAY). Bez běhu přes půlnoc řádek v CSV nepřibude — proto je potřeba více dní.
5. Otevřete G4 HTML (po přihlášení do Analýzy), IP zařízení nahraďte svou:
   api_ai_g4_csv.php?device_ip=…&format=html · volitelně stáhněte CSV.
6. Z denních řádků (import Wh, min SOC, t1Min; se Spotem i highImport / Kč) vyplňte tabulku go/no-go v dokumentu vývoje ai-gemini-placene.html §10. Spot není povinný pro rozhodnutí — hodnotí se v rámci stejného segmentu.

Fáze vývoje (orientačně)

Související kapitoly

• 11. Režimy řízení a AI
• 11a. SHADOW / ASSIST / AUTO
• 11c. Analýza AI (api.easun.eu)
• 12. Spot a průvodce Provoz
• 20. Doporučení AI (laici)