Open source · RCP & vRCP svizzeri · self-hosted · AGPL-3.0
Importa le curve di carico, ripartisci il solare tra i partecipanti per intervallo di 15 minuti, valorizzalo con le tue tariffe e invia una QR-fattura. L’ho scritto per fatturare il mio RCP e lo pubblico nel caso possa servire anche al tuo.
Bilancio energetico · comunità demo · T3 2026
La stessa ripartizione eseguita dal motore di fatturazione — min(produzione, consumo) per intervallo di 15 minuti — è la base di ogni riga di fattura.
Cosa fa
Fatturare un RCP per un mese è facile. Diventa più difficile quando la tariffa dell’anno scorso deve continuare a esistere, quando chi si è trasferito a marzo deve essere fatturato fino a marzo e quando la fattura deve essere qualcosa che un vicino accetta senza chiedere il foglio di calcolo che c’è dietro.
I formati che i gestori di rete svizzeri inviano davvero, più tutto ciò che esporta il tuo contatore.
Ogni intervallo è valorizzato con la versione di tariffa valida in quel momento. Nulla viene mediato sul mese.
Le fatture vengono generate in PDF/A-3b con la sezione di pagamento QR e passano attraverso gli stati bozza, approvata, inviata, pagata. Uno storno conserva il documento e il suo numero invece di eliminare la riga. Conteggi annuali e contratti di partecipazione escono dallo stesso motore di rendering e ogni versione emessa viene conservata così come è stata inviata.
Amministratori, proprietari dell’RCP e partecipanti hanno ciascuno la propria vista sugli stessi dati. Le assegnazioni tra partecipanti e punti di misura hanno date di validità: chi si trasferisce il 15 marzo viene fatturato fino al 15 marzo.
Stima risparmi, tempo di recupero, ROI e VAN per una comunità in progetto. Se ne gestisci già una, il calcolo può essere precompilato dai suoi partecipanti e dall’autoconsumo misurato.
Schermate
Dalla comunità demo inclusa nel progetto, creata con un solo comando. L’interfaccia è disponibile in quattro lingue; le schermate la mostrano in inglese.
Ogni periodo mostra l’azione richiesta, così inizi dal lavoro da fare invece di cercarlo. Il periodo che sta ancora raccogliendo dati lo dice semplicemente.
Produzione, consumo, autoconsumo e scambio con la rete per il periodo scelto, con un diagramma di Sankey che segue ogni kWh dal produttore al partecipante. Filtra per partecipante o scendi fino al singolo intervallo.
Tutte le fatture del periodo con completezza delle misure, stato, totale e stato del PDF, più azioni di gruppo per i passaggi che altrimenti ripeteresti per ogni economia domestica.
Una tariffa è una serie di versioni, ciascuna con le proprie fasce e la propria finestra di validità. Una fattura emessa l’anno scorso viene valorizzata ancora alla tariffa dell’anno scorso e il grafico mostra quando ogni modifica è entrata in vigore.
Avvio rapido
Scegli quello che corrisponde a dove vuoi installarlo. Tutti e tre scaricano immagini già pronte da GHCR.
Avvia lo stack e crea una comunità completa — partecipanti, contatori, tariffe e letture — così c’è qualcosa da guardare.
# clona, poi: scripts/start-demo-environment.sh # → http://localhost:8080 # admin@openzev.local / admin1234
Lo stack completo — frontend, API, worker e beat Celery, PostgreSQL e Redis — senza dati demo.
docker compose up -d --build # frontend :8080 # api :8001 docker compose down
Il chart distribuisce frontend, backend, worker e beat nel tuo cluster con un Ingress e un PVC per i media. PostgreSQL e Redis restano a tuo carico.
helm repo add openzev \ https://splattner.github.io/openzev helm repo update helm install openzev openzev/openzev \ -n openzev --create-namespace
Sotto il cofano
Ho costruito OpenZEV per gestire il mio RCP e lo condivido così com’è, senza garanzia. Si adatta a chi ama gestire il proprio stack. Controlla importazioni, tariffe e fatture prima che raggiungano un partecipante: la responsabilità di ciò che dicono i numeri resta tua.
È inoltre costruito con molta assistenza di IA, fino alle specifiche, agli ADR e alla documentazione utente. Alcune scelte sembreranno poco convenzionali a un team esperto. È il compromesso che ho scelto: il progetto è ottimizzato per l’apprendimento, la sperimentazione e la gestione di un vero RCP, non per i processi aziendali.