Adminis Locuințe - Home Assistant Integration

Integrare custom Home Assistant pentru platforma adminislocuinte.ro

Monitorizează facturile de utilități, istoricul plăților și sumele restante direct din Home Assistant.

Disclaimer: Această integrare a fost dezvoltată prin reverse engineering și nu este afiliată sau endorsată de Adminis Locuinte. Dezvoltată de Emanuel Besliu.

✨ Caracteristici

🔐 Autentificare securizată - Credențiale criptate în Home Assistant
🏘️ Multi-locație - Suport automat pentru apartamente, parcări, boxe
💰 Monitorizare plăți - Sold restant și istoric detaliat
📊 Breakdown complet - 34+ categorii de cheltuieli (apă, gaz, încălzire, servicii)
🔄 Actualizare automată - Refresh la fiecare oră
🌍 Bilingv - Română și Engleză

📦 Instalare

Metoda 1: HACS (Recomandat - În curând)

Deschide HACS în Home Assistant
Mergi la "Integrations"
Click pe "⋮" → "Custom repositories"
Adaugă URL: https://github.com/emanuelbesliu/homeassistant-adminislocuinte
Categorie: "Integration"
Click "Add"
Caută "Adminis Locuințe" și instalează

Metoda 2: Manual

Descarcă ultima versiune de pe GitHub Releases
Copiază folderul adminislocuinte în directorul custom_components:
```
/config/custom_components/adminislocuinte/
```
Restartează Home Assistant

⚙️ Configurare

Mergi la Settings → Devices & Services → Add Integration
Caută "Adminis Locuințe"
Introdu email și parola contului tău adminislocuinte.ro
Click Submit

După 5 minute, senzorii vor apărea cu datele tale!

📊 Senzori Creați

Senzori Globali (4)

Senzor	Descriere
`sensor.adminis_locuinte_location_count`	Număr total de locații
`sensor.adminis_locuinte_total_pending`	Total sume restante (RON)
`sensor.adminis_locuinte_last_payment_amount`	Ultima plată efectuată (RON)
`sensor.adminis_locuinte_last_payment_date`	Data ultimei plăți

Senzori Per-Locație (3 × număr locații)

Pentru fiecare apartament/parcare:

Senzor	Descriere
`sensor.adminis_locuinte_{apt}_monthly_bill`	Factura lunară cu breakdown complet
`sensor.adminis_locuinte_{apt}_pending`	Suma restantă pentru această locație
`sensor.adminis_locuinte_{apt}_last_payment`	Ultima plată pentru această locație

Exemplu pentru Apartament 12:

sensor.adminis_locuinte_12_monthly_bill
sensor.adminis_locuinte_12_pending
sensor.adminis_locuinte_12_last_payment

📈 Date Disponibile

Breakdown Cheltuieli (34+ categorii)

Fiecare factură include detalii complete:

Apă & Canalizare:

Apă caldă
Apă rece
Diferențe apă caldă/rece
Canalizare

Energie & Încălzire:

Încălzire
Agent termic
Energie electrică (iluminat, centrale, ascensor, pompe)
Gigacalorimetre

Servicii:

Curățenie
Pază
Ascensor
Salubrizare
Dezinsecție / Deratizare

Administrare:

Administrare generală
Consultanță
Cenzor
Președinte
Fond reparații

Și multe altele...

Atribute Senzori

Fiecare senzor include atribute detaliate:

# Exemplu: sensor.adminis_locuinte_12_monthly_bill
state: 862.12
attributes:
  location_name: "Str. Exemplu nr. 1, bloc A1, ap. 12, Iași"
  location_type: "apartment"
  apartment: "12"
  date: "30.01.2026"
  receipt: "260305BTSD"
  breakdown:
    "Apa calda": 60.74
    "Apa rece": 141.73
    "Incalzire": 136.41
    "Curatenie": 24.90
    # ... (30+ categorii)

🎨 Dashboard

Vezi DASHBOARD_EXAMPLE.md pentru 8 exemple complete de configurări dashboard:

Overview Card simplu
Carduri detaliate per-locație
Gauge-uri vizuale
Tabele cu breakdown
Dashboard complet cu navigare
Layout mobil
Grafice și chart-uri

🔄 Actualizare Date

Interval implicit: 1 oră
Prima actualizare: Imediat după setup
Refresh manual: Developer Tools → Services → homeassistant.update_entity

🛠️ Troubleshooting

Senzorii nu apar

Așteaptă 5 minute după configurare
Verifică log-urile: Settings → System → Logs
Reload integrarea: Settings → Devices & Services → Adminis Locuințe → Reload

Eroare de autentificare

Verifică că email și parola sunt corecte
Testează login pe adminislocuinte.ro
Șterge integrarea și reconfigurează

Date lipsă

Pending payments: Normal să fie 0 dacă nu ai facturi restante
Counters: API-ul nu returnează date valide momentan (nu afectează funcționalitatea)

Debug

Adaugă în configuration.yaml:

logger:
  default: info
  logs:
    custom_components.adminislocuinte: debug

🤝 Contribuții

Contribuțiile sunt binevenite!

Fork repository-ul
Creează un branch pentru feature: git checkout -b feature/amazing-feature
Commit: git commit -m 'Add amazing feature'
Push: git push origin feature/amazing-feature
Deschide un Pull Request

📝 Licență

Vezi LICENSE pentru detalii complete.

⚠️ Disclaimer Legal

Această integrare a fost dezvoltată independent prin reverse engineering al platformei adminislocuinte.ro pentru uz personal și educațional. Nu este afiliată, endorsată sau suportată oficial de Adminis Locuinte sau platformele afiliate.

Utilizarea se face pe propriul risc. Dezvoltatorul nu este responsabil pentru:

Modificări ale API-ului care pot întrerupe funcționalitatea
Probleme cauzate de utilizarea incorectă a integrării
Pierderea datelor sau probleme cu contul adminislocuinte.ro

📞 Suport

🐛 Bug reports: GitHub Issues
💬 Discuții: GitHub Discussions
📖 Documentație: Wiki

🙏 Mulțumiri

Mulțumesc comunității Home Assistant pentru documentație și suport!

☕ Support the Developer

If you find this project useful, consider buying me a coffee!

Dezvoltat cu ❤️ de Emanuel Besliu

emanuelbesliu/homeassistant-adminislocuinte