Releases: elax46/card-bolletta
Release list
2026.6.0
🚀 2026.6.0
Novità
- Miglioramento logica Bonus Sociale: Introdotto un calcolo più preciso del Bonus Sociale ARERA nelle statistiche.
- Il bonus nel mese corrente viene calcolato in modo proporzionale ai giorni trascorsi (come in precedenza).
- Il confronto con il mese scorso ora include il calcolo del bonus per l'intero mese, gestendo automaticamente la lunghezza variabile dei mesi (28, 29, 30 o 31 giorni). Questo garantisce un confronto statistico più accurato e coerente tra le due mensilità.
- Implementata una protezione
Math.max(0, ...)per prevenire valori negativi nel totale calcolato in caso di bonus elevato.
🛠 Correzioni e Ottimizzazioni
- Bug Fix: Risolto un problema per cui il Bonus Sociale non veniva correttamente sottratto nel calcolo del "Mese Scorso" all'interno del popup delle statistiche.
- Coerenza Dati: Il sistema ora rileva automaticamente il numero di giorni del mese precedente per applicare l'importo corretto del bonus, garantendo una stima affidabile del risparmio effettivo.
- Affidabilità: Migliorata la robustezza del calcolo anche in scenari in cui il bonus non è attivo o non è ancora stato maturato per l'intero mese corrente.
Full Changelog: 2026.5.0...2026.6.0
2026.5.0
🚀 2026.5.0
Questa versione si concentra sul fix di alcuni animazioni grafiche
Full Changelog: 2026.4.3...2026.5.0
2026.4.3
🚀 2026.4.3
Questa versione si concentra sull'integrazione completa con l'interfaccia grafica di Home Assistant e sul perfezionamento della User Experience.
📝 Cosa c'è di nuovo
🎨 Integrazione nel Selettore Schede (Visual Editor)
- Novità: La card ora appare ufficialmente nell'elenco delle "Schede Personalizzate" quando aggiungi una nuova card alla tua Dashboard.
- Preview: Aggiunta una configurazione di anteprima (Stub Config) che mostra immediatamente come appare la card nel selettore, anche prima di configurare i sensori reali.
🛠 Fix Tecnici
- Metadata Registration: Registrazione corretta nel
window.customCardsper una migliore compatibilità con Lovelace. - Refactoring CSS: Migliorato l'allineamento dei box nel footer e ottimizzata la visualizzazione del Bonus Sociale nelle statistiche.
Full Changelog: 2026.4.2...2026.4.3
2026.4.2
🚀 2026.4.2 - Inotroduzione del Bonus Arera
Questa versione introduce importanti affinamenti nel calcolo dei costi e una riorganizzazione dell'interfaccia delle statistiche per una maggiore leggibilità e precisione.
📝 Cosa c'è di nuovo
🟢 Gestione Dinamica Bonus Sociale ARERA
È stata introdotta una logica di calcolo pro-rata per il calcolo del Bonus Sociale. La card non sottrae l'intero bonus mensile il primo giorno del mese, ma calcola lo sconto maturato in tempo reale in base ai giorni trascorsi.
- Perché? Per garantire che il totale visualizzato sia sempre coerente con la spesa accumulata "ad oggi", evitando discrepanze tra consumi lordi e sconti non ancora effettivamente maturati.
📊 Ottimizzazione Sezione Statistiche
La griglia dei dettagli è stata ridisegnata per non sacrificare informazioni importanti:
- Indici sempre visibili: La riga con Spread, Commercializzazione (PCV), Materia Prima e Costo medio al kWh è ora fissa a 4 colonne.
- Bonus UI: Se abilitato, il Bonus Sociale appare ora in un box dedicato sotto gli indici principali, con un design centrato e distintivo in verde.
🛠 Fix e Migliorie
- Layout CSS: Ottimizzata la gestione degli spazi nel modale delle statistiche per evitare scroll eccessivi su dispositivi mobile.
💡 Nota sul Calcolo del Totale
Esempio pratico (Giorno 12 del mese X):
Se hai impostato un bonus giornaliero di 0,51€, al giorno 12 del mese la card sottrarrà esattamente 6,12€ ($0,51 \times 12$ ) dal totale lordo. Il valore finale rifletterà quindi la spesa netta reale alla data odierna.
Full Changelog: 2026.4.1...2026.4.2
2026.4.1
🚀 2026.4.1 - La Card Compatta!
Questa versione introduce la Modalità Compatta, insieme a una serie di affinamenti estetici e ottimizzazioni del codice per una dashboard più pulita e reattiva.
🌟 Novità Principali
📏 Layout Compatto (Ultra-Slim)
È ora possibile attivare la Modalità Compatta dalle impostazioni della card.
- Design Salva-Spazio: La card si riduce in altezza per allinearsi perfettamente alle righe delle entità standard di Home Assistant.
- Header Intelligente: Titolo e Totale vengono visualizzati sulla stessa riga, ideale per le viste "Mobile" o per colonne strette.
- Badge Dinamico: Il prezzo unitario (€/kWh) rimane visibile in un badge elegante sulla destra.
🛠 Miglioramenti e Fix
- 📉 Ottimizzazione Padding: Ridotti i margini interni della card per eliminare lo spazio vuoto superfluo e rendere il design più filante.
⚙️ Come aggiornare
- Copia il nuovo codice dal file
italy-energy-bill-card.js. - Sostituisci il contenuto nel tuo file locale o tramite l'editor delle risorse di Home Assistant.
- Svuota la cache del browser per vedere le nuove icone colorate e il toggle del layout.
Nota: Se utilizzi la modalità compatta, puoi comunque cliccare sulla card per aprire il pannello dettagliato delle statistiche e della ripartizione dei costi!
Full Changelog: 2026.4.0...2026.4.1
2026.4.0
🚀 v2026.4.0 - Benvenuta, Card Bolletta!
Sono entusiasta di annunciare il primo rilascio ufficiale della Card Bolletta! 🇮🇹⚡️
Questa card nasce per colmare un vuoto nelle dashboard di Home Assistant degli utenti italiani: avere una stima precisa, trasparente e visivamente appagante della bolletta elettrica, includendo tutte quelle voci (spese di trasporto, oneri, accise e IVA) che spesso rendono il calcolo complesso.
✨ Caratteristiche principali
- Calcolo Dinamico: Gestione automatica di Spesa Materia Energia, Trasporto e Gestione Contatore, Oneri di Sistema e Accise.
- Statistiche Avanzate: Visualizzazione del costo per singola fascia (F1, F2, F3) e ripartizione percentuale delle spese.
- Canone Rai: Gestione automatica del Canone TV (addebitato solo nei mesi previsti, da gennaio a ottobre).
- Flessibilità: Supporto per diversi tipi di costo (Prezzo Fisso o PUN) e opzioni per l'IVA (10% o 22%).
- Design Nativo: Perfettamente integrata con il look & feel di Home Assistant, con supporto completo ai temi Light e Dark.
🛠 Installazione
- Segui le istruzioni nel README per l'installazione manuale o tramite HACS (Ancora da approvare).
Full Changelog: https://github.com/elax46/Card-Bolletta/commits/2026.4.0