20 Oct 06:21

Muriel2Horak

70b8009

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

Pre-release

🎯 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)

V HACS → Integrations → ⋮ (tři tečky) → Custom repositories
Přidat: https://github.com/psimsa/oig_cloud
Kategorie: Integration
Vyhledat "OIG Cloud" a nainstalovat
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!

Assets 2

16 Aug 07:30

Muriel2Horak

v2.0.2-preview

6b9cbf1

🔋 OIG Cloud v2.0.2-preview Pre-release

Pre-release

🎯 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.

Assets 2

14 Jul 09:33

Muriel2Horak

v2.0.1-preview

f0b15f3

v2.0.1-preview Pre-release

Pre-release

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

Assets 2

12 Jun 07:11

Muriel2Horak

v1.0.6-beta-2-hotfix

7c995e3

v1.0.6-beta-2-hotfix Pre-release

Pre-release

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

Assets 2

18 May 13:00

Muriel2Horak

v1.0.6-beta-3

88e11e3

Prerelease v1.0.6-beta-3 Pre-release

Pre-release

🧪 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.

Assets 2

17 May 15:37

Muriel2Horak

v1.0.6-beta-2

1812ed5

Release 1.0.6-beta-2 Pre-release

Pre-release

🔖 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!

Assets 2