Come HelioPeak si inserisce nel quadro

Se ha seguito questa serie fino a qui, sa già nelle grandi linee perché un'app indipendente sui suoi dati PVOutput è una buona idea, cos'è PVOutput, e come portare i suoi dati lì. A un certo punto, quei dati devono anche essere resi visibili. Su un telefono, su un tablet, su un Mac, su un widget sulla sua schermata di blocco. Lì entra HelioPeak.

Questo articolo descrive cos'è HelioPeak, cosa non è, e quali decisioni di design ci sono dietro. Lo scrivo io stesso come sviluppatore dell'app, il che lo rende in parte marketing, e sono trasparente al riguardo. Ma cerco soprattutto di descrivere quali compromessi ho fatto e quali sono le conseguenze pratiche per chi usa l'app o ne considera l'uso. Per chi non voglia l'app, è con un po' di fortuna comunque uno sguardo interessante a come è fatto un prodotto del genere sotto la superficie.

Cos'è HelioPeak

HelioPeak è un'app nativa iOS, iPadOS e macOS che legge i suoi dati di produzione solare da PVOutput.org. È costruita in SwiftUI e Swift Charts, gira su iPhone, iPad e Mac Apple Silicon come applicazione universale, ed è disponibile in sei lingue: inglese, olandese, francese, tedesco, italiano e spagnolo. L'ID dell'App Store è 6762064486.

L'app ha un tier gratuito con un unico sistema proprio più una demo integrata, e un acquisto in-app unico di 6,99 € che sblocca il supporto per un numero illimitato di sistemi. Nessun abbonamento. Nessuna pubblicità. Nessun tracking di dati personali. Le sue credenziali sono memorizzate localmente sul suo dispositivo nel contenitore App Group di iOS, e HelioPeak parla direttamente con PVOutput.org senza server intermedio proprio.

Il pitch in una frase: HelioPeak è quello che volevo usare per seguire i miei pannelli solari, ed è costruita per le persone che vogliono lo stesso.

Cosa fa HelioPeak

Tre funzioni principali che considero le più importanti nell'app:

Dashboard con dati live. Apre l'app e vede immediatamente la produzione attuale, la curva del giorno fino ad ora, la resa del giorno fino ad ora, un confronto con ieri, e (se ha monitoraggio del consumo) lo stesso per il suo consumo. Fatto. Nessun rumore di impostazioni inutili, nessuna finestra di dialogo modale, solo l'informazione per cui è venuto. Su iPad, ottiene un eroe "Live Status" più ricco che mostra anche uno sparkline dell'ultima ora, un widget del tempo, e uno sfondo a sfumatura che si muove con l'ora del giorno.

Storia pluriennale con confronti significativi. Tocca sulla scheda "Charts" e ottiene cinque finestre: giorno, settimana, mese, anno, totale. Per ciascuna può vedere produzione sola, consumo solo, o le due insieme. E, più importante, può mettere due anni fianco a fianco per vedere come questo luglio si confronta con il luglio dell'anno scorso, o come questo marzo si è comportato rispetto ai tre marzi precedenti. Per chi abbia più di un anno o due di dati, è lì che le storie cominciano ad apparire.

Specific Yield, Performance Ratio e Peak Power come concetti di prima classe. Quelle metriche, che spieghiamo in dettaglio in un altro articolo, sono le misure standard con cui l'industria solare valuta impianti. Nella maggior parte delle app consumer sono nascoste in qualche sottomenù, se ci sono. In HelioPeak, non sono subordinate al lato "bello", sono nella scheda Systems su schede pulite, con una breve spiegazione per metrica per chi sia meno familiare con i termini.

Accanto a questo, c'è tutto un insieme di cose più piccole che devono semplicemente essere presenti per rendere l'app piacevole da usare: un widget per la schermata iniziale in tre dimensioni, un widget per la schermata di blocco, temi scuro e chiaro, supporto per più sistemi con trascinamento per riordinare, esportazione a CSV e JSON e un PDF di rapporto annuale multipagina, stime di risparmio di CO₂, rendimento stimato sulla base del suo prezzo dell'elettricità.

La funzione Notes

Una funzione che voglio menzionare separatamente perché dà più valore di quanto la sua semplicità lasci pensare, è la funzione Notes. Può allegare in HelioPeak brevi note testuali a qualsiasi data nella sua storia di produzione, con una categoria opzionale (Manutenzione, Osservazione, Problema o Pietra miliare). Queste note appaiono poi come badge nella vista Charts alla data giusta.

A cosa serve? Alcuni esempi per cui gli utenti la usano:

• "Pannelli lavati dal pulitore di tetti, 120 €" alla data di una manutenzione.
• "Inverter riavviato dopo aggiornamento firmware v2.4.1" alla data di una caduta di produzione.
• "Temporale stanotte, 1 pannello forse staccato" alla data di un arresto inspiegato.
• "Nuova pompa di calore messa in servizio" alla data dove il consumo cambia bruscamente.
• "Ondata di calore, produzione bassa nonostante il sole" alla data che interpreterebbe altrimenti un anno più tardi.

La differenza tra "ricordo che abbiamo fatto qualcosa con l'inverter" e "il 14 marzo 2025 siamo passati al firmware 2.4.1, eccone la nota", è enorme. Per la revisione annuale (vedi l'articolo sulla lettura delle curve solari), l'archivio Notes vale oro.

Le note si sincronizzano tramite iCloud Key-Value Store, che è lo standard Apple per sync leggero tra i propri dispositivi Apple. I dati non passano mai per un mio server. Per chi se ne preoccupi: HelioPeak non ha attualmente un backend proprio, e la funzione Notes è stata la prima vera prova per la sincronizzazione. Usa il quota gratuito di 1 MB per app per Apple ID che Apple offre, che è ampiamente sufficiente per anni di note.

Cosa non fa HelioPeak

Tanto importante quanto quello che l'app fa è quello che non fa. Alcune cose che HelioPeak coscientemente non offre, o non ancora:

Nessuna versione Android. HelioPeak è un prodotto Apple-only e lo rimane. Se la sua famiglia ha un mix di iOS e Android, o se è su Android, cerca meglio un altro prodotto. Su Android, l'app PV Output di Mark McDonald è la scelta più conosciuta, con enormi funzioni.

Nessuna app Apple Watch (ancora). Un'app Watch è prevista per una futura release maggiore, ma non è attualmente nell'App Store. Chi sia impaziente per questo si serve meglio per ora di un widget sull'iPhone.

Nessuna animazione in tempo reale del flusso di energia. Alcune altre app mostrano l'elettricità come un flusso animato tra sole, casa e rete. È bello da vedere e funziona bene come display in-home. HelioPeak ha uno stile più statico, più orientato a dashboard. Se le animazioni sono importanti per lei, l'app McDonald su Android (e la sua controparte iOS) è una scelta migliore.

Nessuna previsione. HelioPeak le mostra cosa è stato e cos'è ora, non cosa sarà domani. Un'integrazione con Forecast.Solar è nella roadmap per un futuro tier Pro, ma nell'app attuale non ottiene una cifra "domani produrrà 23 kWh".

Nessun controllo diretto dell'inverter. HelioPeak è solo lettura, il che è l'architettura naturale per un'app che si appoggia a PVOutput (che è anch'essa solo lettura). Chi voglia riavviare il suo inverter, regolare un parametro o spingere un aggiornamento firmware, usa per quello l'app del produttore.

Nessuna funzione sociale. Nessun seguimento di amici, nessuna classifica nell'app, nessuna condivisione di dati con i vicini. Sono tutte cose che esistono in PVOutput stesso tramite la funzione Ladder, e che coscientemente non replico in HelioPeak.

La filosofia di prezzo

Il prezzo di HelioPeak è un acquisto unico di 6,99 € invece di un abbonamento, ed è una scelta deliberata. Spiego perché.

Per un impianto solare che dura tipicamente 25 anni, un abbonamento di app è una struttura di costo traditrice. 3 € al mese suona ragionevole nell'anno 1. Sull'arco di 25 anni sono 900 €. Confrontato con un acquisto unico di 6,99 €, è un fattore 130. Il valore che uno sviluppatore deve allora fornire è ricorrente e continuo, mentre l'impianto stesso non cambia in modo ricorrente.

Il mio ragionamento: le funzioni core di HelioPeak oggi, dashboard, charts, widget, esportazioni, note, non richiedono costi di server continui né tariffe di API. Funzionano localmente sul suo dispositivo. Per questo sono ragionevolmente valutate come acquisto unico. Se HelioPeak ottenesse in futuro funzioni che portano costi ricorrenti (previsioni basate su cloud, aggregazione multi-sistema, un backend proprio per funzioni di team), un tier Pro separato verrà con un abbonamento per quelle funzioni specifiche. Ma l'app di base resta un acquisto unico per chi la possiede o per chi la compra senza volere quegli extra Pro.

È un compromesso, non un colpo di marketing. Rende il modello di business più piccolo di quanto avrebbe potuto essere, e limita quanto aggressivamente posso investire in funzioni. Ma rende l'app più onesta verso l'utente su tutto il ciclo di vita del suo impianto solare.

Cosa si trova sotto la superficie

Alcuni dettagli tecnici per chi sia interessato al funzionamento dell'app:

Tre flussi di dati distinti. L'app ha tre tipi di scambio di dati con PVOutput. Il primo è in tempo reale: una query ogni cinque minuti durante le ore diurne che recupera gli ultimi valori di potenza ed energia tramite getstatus.jsp di PVOutput. L'intervallo deve essere abbastanza aggressivo per dare l'impressione di live, ma morbido per lasciare posto ai widget e all'utente che apre l'app di tanto in tanto per rinfrescare manualmente. Anche con polling ogni cinque minuti, un utente attivo con widget sulla schermata iniziale può facilmente consumare 30-40 chiamate all'ora, il che occupa la maggior parte delle 60 all'ora del tier gratuito. La soluzione intelligente è cache locale aggressiva con deduplicazione: chiedere nuovi dati solo se possono essere nuovi, e indietreggiare educatamente di fronte al rate limit se viene comunque toccato. L'app passa anche in idle dopo il tramonto, il che libera il budget orario di notte.

Il secondo flusso è l'archiviazione giornaliera: i dati del totale giornaliero che vengono recuperati una volta al giorno e archiviati in un database SQLite locale. È quello che alimenta i confronti anno su anno, le medie mobili, le esportazioni a PDF o CSV. È un volume di dati che cambia lentamente, e archiviarlo localmente invece di recuperarlo on-demand è la differenza tra un grafico istantaneo e uno spinner di caricamento di cinque secondi.

Il terzo flusso è il backfill storico, di cui parliamo in dettaglio nell'articolo sull'ottenimento di dati in PVOutput. La combinazione dei limiti dell'endpoint getoutput.jsp di PVOutput e dei rate limit per account orienta la maggior parte delle decisioni di design in questo strato.

L'architettura widget è un sottoprogetto in sé. I widget iOS girano in un processo separato con memoria limitata e un budget di tempo stretto, quindi i dati che mostrano devono essere pre-calcolati e serializzati dall'app principale e letti dal widget quando il sistema chiede un aggiornamento. Rendere questo responsivo senza svuotare la batteria è più difficile di quanto sembri. Il risultato, quando funziona, è lo sparkline della curva del giorno che vive discretamente accanto al suo widget del tempo sulla schermata di blocco, che si rinfresca ogni quindici minuti senza che niente chieda mai attenzione all'utente.

La ragione per cui tutto questo conta è che la fluidità del guardare dati solari su un telefono è la somma di mille decisioni di ingegneria silenziose, generalmente invisibili. Il risultato visibile è che i dati sono semplicemente lì quando lo chiede. È, alla fine, anche lo scopo dell'esercizio.

Contatto

Una nota pratica che ha il suo posto alla fine di un articolo come questo: HelioPeak è un piccolo progetto, ma non è un progetto silenzioso. Il feedback alimenta quasi ogni release, e ci sono due modi per contattarmi direttamente.

Per tutto ciò che è personale, come un bug che ha trovato, una funzione che vorrebbe, o una domanda sulla sua configurazione specifica di cui non vuole parlare in pubblico, l'indirizzo email è info@heliopeak.app. Ogni messaggio arriva alla mia casella di posta e cerco di rispondere in uno o due giorni.

Per gli utenti che preferiscono una conversazione pubblica, o che vogliono leggere cosa dicono altri utenti HelioPeak prima di contattare, un thread continuo gira nella comunità tech fiamminga Tweakers. Sono attivo lì come sviluppatore, e il thread è un buon posto per fare domande, condividere screenshot del suo impianto, chiedere funzioni che altri utenti potrebbero sostenere, e vedere l'app evolvere nel tempo. Il thread è in olandese, quindi più accessibile per gli utenti belgi e olandesi, ma lettori internazionali passano anche di lì di tanto in tanto.

Il forum comunitario PVOutput ha anche un thread dedicato a HelioPeak dove pubblico le note di versione e rispondo alle domande del pubblico internazionale. Funziona di default in inglese ed è letto dagli utenti PVOutput in tutto il mondo, il che fa salire a volte casi specifici di marche di inverter o strutture tariffarie regionali che non abbiamo ancora incontrato.

Ogni canale funziona. L'email è più rapida per domande personali, i forum sono migliori per discussioni collettive dove la risposta può essere utile per altri.

Dove va questo

La serie fino a qui ha coperto tutto quello che precede l'app: come funzionano i pannelli, dove devono essere, quali tariffe ricompensano cosa, come portare i dati a PVOutput, e come il monitoraggio del consumo chiude il cerchio. HelioPeak è un esempio di cosa succede alla fine di quella pipeline. Il prossimo articolo fa un passo laterale, verso un argomento correlato ma diverso: le batterie domestiche, sia la variante a muro sia le alternative plug-in che sono emerse in questi ultimi due anni. Cambiano l'equazione dell'autoconsumo in modi interessanti, e hanno la loro propria storia. Lo riprendiamo in Home batteries in 2026.

Per ora, se ha dati che fluiscono verso PVOutput e un iPhone, iPad o Mac davanti, il resto è a qualche tocco di distanza.