OIG Cloud v2.0.4-preview

🌦️ OIG Cloud v2.0.4 - ČHMÚ Weather Warnings

Release Date: 24. října 2025

---

🎉 Co je nového

🌦️ ČHMÚ Meteorologická Varování (NOVÉ!)

Kompletní integrace s Českým hydrometeorologickým ústavem pro real-time meteorologická varování!

Hlavní funkce:

• Dva senzory:

  • 🎯 Lokální - GPS filtrovaná varování pro váš region
  • 🗺️ Globální - Všechna varování pro celou Českou republiku

• 5 úrovní závažnosti:

  • Level 0: Žádná varování ✅
  • Level 1: Minor (Žluté varování) 🟡
  • Level 2: Moderate (Oranžové varování) 🟠
  • Level 3: Severe (Červené varování) 🔴 + pulsace
  • Level 4: Extreme (Fialové varování) 🟣 + rychlá pulsace

• Dashboard integrace:

  • Color-coded badge v hlavičce dashboardu
  • Kliknutelný badge otevře detailní modal
  • Zobrazuje: typ události, oblast, začátek, konec, ETA, popis, pokyny
  • WebSocket real-time updates
  • Mobile-responsive design

Technické detaily:

• Data source: ČHMÚ CAP XML API
• Update interval: 1× za hodinu
• Geografické filtrování: Point-in-polygon, Point-in-circle, Geocode fallback
• GPS priority: Solar Forecast → HA nastavení → Praha default
• Persistent storage: Ano (data přežijí restart)
• Dependencies: Zero (Shapely-free implementace)

Konfigurace:

1. Nastavení → Zařízení a služby → OIG Cloud → Konfigurovat
2. Zaškrtnout "🌦️ Varování ČHMÚ" v sekci Moduly
3. Pro přesné lokální varování nastavit GPS v Solar Forecast nebo HA obecných nastaveních

📖 Dokumentace: docs/CHMU_WARNINGS.md

---

🔋 Grid Charging Sensor - Refactor

Kompletní přepracování senzoru nabíjení ze sítě s lepší přesností a detailními informacemi.

⚠️ BREAKING CHANGE:

Předtím:

• Typ: Numeric sensor
• Stav: Celková energie v kWh
• Zahrnoval i intervaly kdy baterie byla plná

Nyní:

• Typ: Binary sensor
• Stav: on když je plánováno nabíjení, off když ne
• Energie a cena přesunuty do atributů
• Počítá pouze skutečné nabíjení baterie

Nové atributy:

state: on
attributes:
  total_energy_kwh: 8.5          # Jen energie pro nabíjení baterie
  total_cost_czk: 23.80          # Jen cena za nabíjení baterie
  charging_battery_count: 5      # Počet intervalů se skutečným nabíjením
  charging_intervals:            # Detailní seznam všech intervalů
    - start: "2025-10-25T02:00:00+02:00"
      end: "2025-10-25T03:00:00+02:00"
      energy_kwh: 2.1
      price_czk: 5.67
      is_charging_battery: true   # ← Baterie se skutečně nabíjí
      battery_capacity_kwh: 8.5
    - start: "2025-10-25T03:00:00+02:00"
      end: "2025-10-25T04:00:00+02:00"
      energy_kwh: 1.5
      price_czk: 4.05
      is_charging_battery: false  # ← Grid jen pokrývá spotřebu
      battery_capacity_kwh: 10.0  # ← Baterie plná
      note: "Grid pokrývá jen spotřebu (baterie plná)"

Co to znamená pro vás:

• Přesnější statistiky - počítá jen skutečné nabíjení baterie
• Lepší přehled - vidíte které intervaly skutečně nabíjejí baterii
• Správné náklady - cena jen za nabíjení, ne za celkovou spotřebu
• Automations - můžete reagovat na binary state místo parsování energie

---

🐛 Opravy Dashboard

• ✅ Výchozí zoom pricing grafu nyní ukazuje aktuální čas
• ✅ Opravena inicializace grafů po hard refresh (F5)
• ✅ Opraveno timezone handling v grafech
• ✅ Opraven výpočet počtu animačních kuliček ve flow
• ✅ Opravena validace viditelnosti při přepnutí na Flow tab
• ✅ Asynchronní aplikace výchozího zoomu po Chart.js inicializaci

---

🗑️ Odstraněno

• ❌ Automatické nabíjení baterie při nepřízni počasí
  • Feature byl experimentální a nepoužívaný
  • Nahrazen ČHMÚ varováními pro lepší informovanost

---

📊 Statistiky Release

• Commits od v2.0.3-preview: 432
• Nové soubory: 3
  • api/api_chmu.py - ČHMÚ API client (705 řádků)
  • sensors/SENSOR_TYPES_CHMU.py - Sensor definitions
  • docs/CHMU_WARNINGS.md - Dokumentace
• Upravené soubory: 15+
• Řádky kódu: +2,500 / -800
• Dokumentace: +300 řádků

---

🚀 Instalace / Aktualizace

Přes HACS:

1. HACS → Integrations → OIG Cloud → Update
2. Restart Home Assistant
3. Nastavení → Zařízení a služby → OIG Cloud → Konfigurovat
4. Aktivovat modul "🌦️ Varování ČHMÚ"

Manuálně:

cd /config/custom_components/
rm -rf oig_cloud
wget https://github.com/psimsa/oig_cloud/releases/download/v2.0.4/oig_cloud.zip
unzip oig_cloud.zip
rm oig_cloud.zip

---

⚠️ Důležité poznámky

Grid Charging Binary Sensor

Pokud máte automatizace nebo dashboardy používající sensor.{box_id}_grid_charging_planned, budete muset:

1. Změnit typ entity z numeric na binary
2. Aktualizovat šablony:
   • state je nyní on/off místo čísla
   • Energie: state_attr('sensor.xxx_grid_charging_planned', 'total_energy_kwh')
   • Cena: state_attr('sensor.xxx_grid_charging_planned', 'total_cost_czk')

ČHMÚ Varování

• Lokální varování vyžadují správnou GPS polohu
• Doporučujeme nastavit GPS v Solar Forecast konfiguraci nebo HA obecných nastaveních
• Bez GPS nastavení se použije Praha jako default (50.0875°N, 14.4213°E)

---

🐛 Známé problémy

Žádné známé problémy v tomto release.

---

📚 Dokumentace

• ČHMÚ Warnings: docs/CHMU_WARNINGS.md
• Complete Changelog: CHANGELOG.md
• README: README.md

---

🙏 Poděkování

Děkujeme všem testerům a uživatelům za zpětnou vazbu!

Speciální poděkování:

• ČHMÚ za veřejné CAP XML API
• Home Assistant community za podporu
• Všem contributors

---

🔗 Odkazy

• GitHub Release: https://github.com/psimsa/oig_cloud/releases/tag/v2.0.4
• Issues: https://github.com/psimsa/oig_cloud/issues
• HACS: https://github.com/hacs/integration

---

Vyrobeno s ❤️ pro Home Assistant a ČEZ Battery Box komunitu

Pro podrobný seznam všech změn viz CHANGELOG.md

v2.0.3-preview - Major Release (Preview for Testers)

🎯 v2.0.3-preview - Major Release (Preview for Testers)

⚠️ Toto je PREVIEW verze pro testery. Po testování a opravách vydáme v2.0.4 jako stable release.

📊 Statistiky

Obrovský release s 238 commity od července 2024:

• 55,160 řádků přidáno, 2,886 odstraněno
• 146 souborů změněno
• 55 nových funkcí, 50+ bugfixů
• 8 uživatelských příruček (4,515 řádků)
• 22+ vývojářských dokumentů (7,000+ řádků)

---

🚀 Co je nového

1️⃣ Energy Flow Dashboard (Zcela nový)

Grafická vizualizace energetických toků v reálném čase:

• ✨ Animované toky - kulečky podle výkonu a směru
• 📱 Responzivní design - mobil, tablet, desktop
• 🔋 Inteligentní nodes - Grid, Solar, Battery, Home, Boiler
• 🎨 Dual-color status - zelená/červená podle stavu
• 💰 Cenové informace a tarify
• ☀️ Solární forecast - předpověď výroby
• 🎛️ Control panel - ovládání přímo z dashboardu
• ⚡ Partial re-rendering - 60 FPS výkon

2️⃣ ServiceShield™ Refactor (Kompletní přepracování)

Revoluční změny v ochraně před race conditions:

• ⚡ Event-based monitoring - okamžitá reakce (ne polling!)
• ⏱️ Live duration tracking - real-time aktualizace běžící služby
• 🎯 Strukturovaný output - frontend bez parsování
• 🔀 Inteligentní serializace - grid delivery split (mode → limit)
• 🗺️ Shield sensor mapping - kompletní mapování služeb
• 🧹 Multi-device support - auto-cleanup orphaned zařízení
• 🔒 Thread safety - lock mechanismus
• 📖 Logbook integrace - všechny události v HA
• 🗑️ Delete button - možnost mazat z fronty
• 🔄 Auto coordinator refresh - okamžitá aktualizace

3️⃣ Wizard Config Flow (Nový průvodce)

Intuitivní setup krok za krokem:

• 🧙 Kompletní wizard - snadná instalace
• 🎛️ Unifikace Options Flow - stejné UX
• 💰 3-step pricing wizard - Fixní/Spot/Tarify
• ✅ Validace bypass - uživatelsky přívětivé
• 💡 Dynamické formuláře s hints
• 📝 GAP analysis - automatické doplnění parametrů
• ⚠️ Povinná live data - prevence neúplných dat
• 🔄 Auto reload - integrace se restartuje sama
• 🇨🇿 100% české překlady

4️⃣ API Komunikace (Optimalizovaná)

Efektivnější komunikace s OIG Cloud:

• 📦 Zero dependencies - vendorovaný client (žádné externí repos!)
• 🌐 Browser-perfect headers - 12 HTTP headerů jako Chrome
• 💾 ETag caching - až 70% úspora requestů
• 🎲 Polling jitter - eliminace API spikes
• 🍪 Session management - robustní cookie handling
• 🔒 TLS/HTTP2 - moderní protokoly
• 🔄 Auto refresh - coordinator se aktualizuje po každém API volání
• 🔢 Multi-device API - správa více zařízení

5️⃣ Dokumentace (Kompletní)

8 uživatelských příruček:

• 📖 CONFIGURATION.md (488 lines) - Konfigurace
• 📊 DASHBOARD.md (601 lines) - Dashboard setup
• 🏷️ ENTITIES.md (495 lines) - Entity a jejich význam
• 🔧 SERVICES.md (651 lines) - Služby s příklady
• 🛡️ SHIELD.md (763 lines) - ServiceShield průvodce
• 🤖 AUTOMATIONS.md (799 lines) - Automatizace
• ❓ FAQ.md (677 lines) - Často kladené otázky
• 🔍 TROUBLESHOOTING.md (1041 lines) - Řešení problémů

22+ vývojářských dokumentů včetně vendoring guide, test infrastructure, IDE setup, atd.

6️⃣ HA 2025.4 Compatibility

Připraveno pro nejnovější Home Assistant:

• ✅ async_create_task (žádné deprecated methods)
• ✅ Minimum HA 2024.1.0 (upgrade z 2022.0.0)
• ✅ Python 3.12 optimalizace
• ✅ Complete type hints napříč codebase

7️⃣ Test Infrastructure

Profesionální testovací prostředí:

• �� Docker-based testing - HA 2025.1.4 container
• 🧪 pytest-homeassistant - oficiální framework
• ⚙️ GitHub Actions CI - automatické testy
• 📊 61 testů - kompletní coverage
• 🔧 PYTHONPATH config - správné importy vendored modules

---

⚠️ Breaking Changes

• Minimum HA version: 2024.1.0 (bylo 2022.0.0)
• Config entry v2 (automatická migrace je součástí)
• Vendored client (již není external dependency)

---

🧪 Pro testery

Prosíme o testování a feedback k:

✅ Energy Flow Dashboard

• Animace - hladkost, výkon
• Responzivita - mobil, tablet, desktop
• Přesnost dat - shoda s realitou

✅ ServiceShield

• Fronta - správné pořadí služeb
• Timeouty - služby se dokončí
• Logbook - srozumitelné záznamy

✅ Wizard Config Flow

• Srozumitelnost - kroky jsou jasné?
• Chyby - validace funguje?
• Překlady - vše česky?

✅ Grid Delivery

• Mode/Limit - správné mapování?
• Split - mode a limit se správně rozdělují?

✅ Boiler Mode

• Stabilita - žádné blikání?
• Správné stavy - CBB vs Manuální?

Známé limitace:

• Home 5/6 režimy jsou zobrazeny, ale disabled (čekáme na dokumentaci OIG)
• Formating mode má fixed 2min timeout (nelze detekovat completion)

---

📝 Instalace

HACS (doporučeno)

1. V HACS → Integrations → ⋮ (tři tečky) → Custom repositories
2. Přidat: https://github.com/psimsa/oig_cloud
3. Kategorie: Integration
4. Vyhledat "OIG Cloud" a nainstalovat
5. Restartovat Home Assistant

Manuální

cd /config/custom_components
git clone https://github.com/psimsa/oig_cloud.git
cd oig_cloud
git checkout v2.0.3-preview

Pak restartovat HA.

---

🐛 Hlášení chyb

Našli jste bug? Vytvořte Issue s těmito informacemi:

• HA verze
• OIG Cloud verze (2.0.3-preview)
• Logs (Configuration → Logs → filtr "oig_cloud")
• Kroky k reprodukci

---

🎉 Po testování

Po testování a opravách vydáme v2.0.4 jako stable release pro všechny uživatele.

Děkujeme za testování! 🙏

---

📋 Changelog

Kompletní changelog najdete v CHANGELOG.md.

---

⭐ Pokud se vám integrace líbí, dejte prosím hvězdičku na GitHubu!

🔋 OIG Cloud v2.0.2-preview

🎯 Hlavní změny

✅ Opravená služba formátování baterie

• Plně funkční služba set_formating_mode - opravena podle původní API implementace
• Správné použití {"bat_ac": mode} payload místo nesprávných parametrů
• Konzistentní logika mezi shield a fallback verzemi služby

🧹 Zjednodušení kódu

• Odstranění zbytečných OpenTelemetry podmínek napříč celým API kódem
• Redukce složitosti o ~30% v API vrstvě
• Centralizovaná telemetrie - vše nyní běží přes ServiceShield
• Čistší a konzistentnější kódová základna

🐛 Opravy

• ✅ Služba formátování baterie nyní používá správný API endpoint
• ✅ Opravena neexistující close() metoda v OTE API testu
• ✅ Zlepšené error handling a logging konzistence
• ✅ Konzistentnější předávání parametrů mezi service metodami

🔧 Technické vylepšení

• Lepší separation of concerns - telemetrie vs business logika
• Jednotný error handling napříč všemi API metodami
• Čistší kód bez duplicitních podmínek
• Konzistentnější struktura všech API metod

📋 Pro uživatele

• Služba formátování baterie je nyní plně funkční 🎉
• Stabilnější ServiceShield telemetrie - žádné duplikáty
• Lepší výkon díky zjednodušenému kódu
• Zachována zpětná kompatibilita se všemi existujícími funkcemi

---

⚠️ Preview Release

Toto je preview verze určená pro testování. Pokud narazíte na problémy, prosím nahlaste je jako GitHub Issues.

v2.0.1-preview

OIG Cloud 2.0.0-beta - Velkým update ServiceShield, telemetrie a nové funkce

🛡️ ServiceShield - Kompletní přepis a vylepšení

Nové funkce:

Kompletně přepsaný ServiceShield - mnohem stabilnější a spolehlivější
Telemetrie do New Relic - automatické odesílání dat o všech API voláních
Lepší queue management - sofistikovanější fronta služeb
API monitoring - sledování všech volání do OIG API s detailními informacemi
Trace ID - propojení všech událostí pro lepší debugging
☀️ Nové funkce pro energie a předpovědi

Solární předpověď:

Solární předpověď - integrace s weather API pro předpověď výroby
Spot ceny elektřiny:

Real-time spot ceny - aktuální ceny elektřiny na burze
Cenová optimalizace - automatické přepínání podle cen
Historické grafy - sledování vývoje cen
Pokročilé statistiky:

Rozšířené statistiky - detailní analýza spotřeby a výroby
🔧 Technické vylepšení

Telemetrie a monitoring:

Asynchronní telemetrie - neblokuje běh Home Assistant
SimpleTelemetry třída - optimalizovaná pro New Relic
Lepší error handling - robustnější zpracování chyb
Performance optimalizace - menší zatížení systému
Type hints - kompletní typování pro lepší vývoj
ServiceShield změny:

Nová architektura - oddělené senzory pro ServiceShield
Monitoring API volání - telemetrie zachytává:
api_endpoint - jaké API se volá
api_table - jaká tabulka se mění
api_column - jaký sloupec se upravuje
api_value - jaká hodnota se nastavuje
trace_id - jedinečný identifikátor požadavku
Lepší debugging - detailní logy pro troubleshooting
Senzory a integrace:

Optimalizace senzorů - menší memory footprint
Weather API integrace - pro solární předpovědi
Spot price API - pro real-time ceny elektřiny
Statistické výpočty - pokročilé analýzy dat
📊 Nové konfigurační možnosti

V config flow:

enable_spot_prices - zapnutí spot cen elektřiny
spot_prices_update_interval - interval aktualizace cen
enable_statistics - rozšířené statistiky
enable_pricing - cenové optimalizace
solar_prediction - solární předpověď
🐛 Opravy chyb

Import chyby - opravené importy setup_simple_telemetry
RuntimeWarning - opravené async/await volání
Memory leaks - lepší cleanup telemetrie
Type errors - kompletní type annotations
Performance issues - optimalizace dotazů na API
⚠️ Breaking Changes

Žádné breaking changes - plně kompatibilní s verzí 1.6.x

🚀 Instalace a upgrade

Stačí aktualizovat integraci přes HACS nebo manuálně. Všechna existující nastavení zůstávají zachována. Nové funkce se aktivují v nastavení integrace.

Poznámka: Toto je beta verze. Nové funkce jsou experimentální. Telemetrie je ve výchozím nastavení zapnutá a nelze ji vypnout

Full Changelog: v2.0.0-beta...v2.0.1-preview

v1.0.6-beta-2-hotfix

1.0.6-beta-2-hotfix (2025-06-12)

🐛 Bug Fixes

• Opravena kompatibilita závislosti opentelemetry-exporter-otlp-proto-grpc na verzi 1.31.0
• Vyřešeny konflikty verzí s knihovnou protobuf

Prerelease v1.0.6-beta-3

🧪 Prerelease v1.0.6-beta-3

• ✅ ServiceShield

  • Validace běžících služeb (neduplikují se požadavky)
  • Porovnávání numerických hodnot (např. přetoky)
  • Pokročilá diagnostika a debug výstupy

• 🔍 Nový diagnostický senzor

  • sensor.oig_shield_service_queue – stav fronty a běžící služby
  • Přiřazeno k novému zařízení OIG Cloud Shield

⚠️ Tento build je určen pro testování před vydáním finální verze.

Release 1.0.6-beta-2

🔖 Release 1.0.6-beta-2 – Výpočtové senzory, stabilita a čistota kódu

Tato beta verze přináší rozšíření o nové výpočtové senzory, robustnější zpracování dat

---

✨ Nové výpočtové senzory baterie

• usable_battery_capacity – využitelná kapacita baterie (80 % z instalované)
• missing_battery_kwh – kolik chybí do 100 % SOC
• remaining_usable_capacity – kolik využitelné kapacity ještě zbývá
• time_to_full – odhadovaný čas do plného nabití (formátovaný výstup)
• time_to_empty – odhadovaný čas do vybití (formátovaný výstup)

➡️ Všechny senzory pracují v kWh, mají správné device_class: energy a state_class: measurement.

---

🛠️ Vylepšení a opravy

• Převod p_bat z Wh na kWh v příslušných entitách
• Odstranění get_device_html_stats() a přechod na čisté API volání
• Ošetření případů, kdy node_id vrací list, None, prázdný nebo neobsahuje očekávaný node_key
• Robustnější fallback v state() všech standardních entit
• Změna zobrazení box_prms_crct na čitelný výstup „Zapnuto/Vypnuto“ bez přepínače

---

🧹 Úklid

• .DS_Store soubory odstraněny z repozitáře a přidány do .gitignore
• Nepotřebný testovací skript oig_html_debug.py ponechán pouze jako untracked

---

🧪 Poznámky

• Tato verze je označena jako pre-release (beta) pro potřeby testování nových výpočtových funkcí
• ServiceGuard, který bude hlídat pending změny u služeb, není zatím součástí této verze, ale je připraven k integraci

---

Děkujeme za testování a zpětnou vazbu!

Release 1.0.6-beta-1

What's Changed

• ✨ Nová verze 1.6.0: Rozšířené senzory, měření energie baterie, konfigurace intervalů obnovy by @Muriel2Horak in #110

Full Changelog: v1.0.2...v1.0.6-beta-1

Release 1.0.5

What's Changed

• Live data by @psimsa in #71
• Update manifest.json - version of telemetry by @Muriel2Horak in #77

Full Changelog: v1.0.4...v1.0.5

Release 1.0.5-live-data3

Full Changelog: v1.0.4...v1.0.5-live-data3