Skip to content

1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Apr 15:12
1.0.0
4a78169

Rețele Electrice v1.0.0 — Prima versiune

Ce este nou

Autentificare și conectivitate

  • Login complet pe portalul Salesforce Experience Cloud (Visualforce + Aura/Lightning)
  • Sesiune persistentă prin aiohttp CookieJar cu re-login automat la expirare
  • Suport pentru mecanismul A4J (Ajax4jsf/RichFaces) folosit de paginile VF
  • Suport pentru proxy VF iframe (Lightning event → iframe → A4J callout → postMessage)

Senzori per POD (punct de consum)

Integrarea creează un device per POD selectat, cu până la 9 senzori:

Senzor Descriere Energy Dashboard
POD Tip contract, putere, tarif, serie contor, adresă —
Date utilizator Nume, email, telefon, CNP, județ, tip cont —
Index citire consum Ultimul index contor consum (kWh) ✅ total_increasing
Index citire producție Ultimul index contor producție (kWh, doar prosumer) ✅ total_increasing
{an} → Energie consumată Arhivă citiri consum pe an (maxim 2 ani) —
{an} → Energie produsă Arhivă citiri producție pe an (doar prosumer) —
Întreruperi curent Status întreruperi programate sau active —
Smart Meter Consum Total energie consumată din smart meter (kWh) ✅ total
Smart Meter Producție Total energie produsă din smart meter (kWh, doar prosumer) ✅ total

Compatibilitate Energy Dashboard

Senzorii de energie au device_class, state_class și native_unit_of_measurement configurate corect:

  • SensorDeviceClass.ENERGY + SensorStateClass.TOTAL_INCREASING + kWh pentru indexuri contor
  • SensorDeviceClass.ENERGY + SensorStateClass.TOTAL + kWh pentru smart meter
  • Valori numerice float ca native_value — gata de adăugat în Energy Dashboard

ConfigFlow și OptionsFlow

  • Pasul 1 — Autentificare cu email + parolă + interval de actualizare
  • Pasul 2 — Selectare POD-uri (toate sau individual)
  • OptionsFlow — meniu cu 3 opțiuni: Setări cont, Selectare POD-uri, Licență
  • Reconfigurare completă fără reinstalare (credențiale, POD-uri, licență)

Formatare română completă

  • Diacritice în toate textele: „Întreruperi curent", „Index citire producție", „Energie consumată"
  • Date calendaristice în română: „1 decembrie 2025" (nu „01.12.2025")
  • Normalizare automată: text ALL CAPS → Title Case („PROSUMER" → „Prosumer")
  • Luni în română: ianuarie, februarie, ..., decembrie
  • Traduceri complete: strings.json (română), translations/en.json (engleză), translations/ro.json (română)

Diagnostice

  • Export diagnostic complet: informații licență, stare coordinator, senzori activi
  • Email mascat automat în export
  • Date sensibile (parolă, token-uri, sesiune) excluse

Sursa datelor

Metodă Descriere
Aura — getUserName Nume utilizator autentificat
Aura — getAccountInfo Informații cont (nume, CNP, email, adresă)
Aura — getContactInfo Informații contact (email, telefon)
Aura — getPODs Lista punctelor de consum
Aura — getPodDetails Detalii per POD (contract, putere, contor)
VF Proxy — ReadingArchive Arhivă citiri contor (indexuri lunare EA/EAP)
VF Proxy — PowerOutages Status întreruperi curent per POD
VF Proxy — SmartMeterData Date smart meter (SUM_EA, SUM_EAP, MAX, COSFI)

Instalare

HACS (recomandat)

  1. HACS → ⋮ → Custom repositories → https://github.com/cnecrea/reteleelectrice → Integration
  2. Găsește „Rețele Electrice" → Install
  3. Restartează Home Assistant

Manual

  1. Copiază custom_components/reteleelectrice/ în config/custom_components/
  2. Restartează Home Assistant

Cerințe

Dependențe Python (instalate automat)

  • cryptography>=41.0.0
  • beautifulsoup4>=4.12.0

Structura fișierelor

custom_components/reteleelectrice/
├── __init__.py          # Setup/unload, LicenseManager, heartbeat
├── api.py               # Client async Salesforce (login, Aura, VF proxy)
├── config_flow.py       # ConfigFlow v3 + OptionsFlow
├── const.py             # Constante, URL-uri, headere browser
├── coordinator.py       # DataUpdateCoordinator per-POD
├── diagnostics.py       # Export diagnostic
├── helpers.py           # Utilități (format date, normalize, județe)
├── license.py           # Manager licență server-side v3.3
├── manifest.json        # Metadata integrare
├── sensor.py            # 9 clase senzor per POD
├── strings.json         # UI strings (română)
└── translations/
    ├── en.json          # Traduceri engleză
    └── ro.json          # Traduceri română

Limitări cunoscute

  • O singură instanță per cont email
  • Arhivă citiri limitată la ultimii 2 ani
  • Smart Meter doar pentru POD-uri cu contor inteligent
  • Senzori producție doar pentru POD-uri prosumer
  • Interval minim actualizare: 1 oră (3600s)
  • Sesiunea Salesforce poate expira — re-login automat la ciclu următor

Documentație

  • README.md — prezentare completă, entități, automatizări
  • SETUP.md — ghid instalare și configurare pas cu pas
  • DEBUG.md — depanare, log-uri, probleme frecvente
  • FAQ.md — întrebări frecvente

📈 Integrarea în cifre

⭐ Stars 📥 Instalări 🔄 Clone (14z)
0 0 0

Dacă integrarea Rețele Electrice România îți este utilă, lasă un ⭐ pe repository — îi ajută și pe alți utilizatori să o descopere.

💛 Dezvoltarea consumă timp și resurse. Dacă vrei să susții proiectul:
☕ Buy Me a Coffee · 💰 GitHub Sponsors

Assets 3
Loading