DeBrand Studio
Tutti i case study

CER Irpinia Sannio, dal fork open source alla produzione.

Due applicazioni nate da progetti open source e portate in produzione per una Comunità Energetica di Avellino e Benevento: un gestionale con sito e iscrizioni digitali e una WebGIS sulle cabine primarie, in container Docker dietro un unico ingresso Nginx Proxy Manager.

Cliente
CER Irpinia Sannio
Settore
Comunità energetica
Ruolo
Progettazione, sviluppo, deploy
Modalità
Pro bono

Il contesto

CER Irpinia Sannio è un'associazione senza scopo di lucro con sede a Venticano (AV), attiva sul perimetro delle cabine primarie delle province di Avellino e Benevento. È una comunità appena partita: i volumi sono piccoli, e la piattaforma è stata costruita per crescere senza essere riscritta.

Prima, il sito era un WordPress self-hosted, le anagrafiche vivevano in NocoDB e fogli di calcolo, le pratiche GSE si compilavano a mano. Dal 2 ottobre 2026 il gestionale serve direttamente www.cer-is.com, mentre la WebGIS è su gis.cer-is.com.

I vincoli

  • Gli aderenti arrivano con la bolletta in mano e poche nozioni tecniche: l'iscrizione deve poter essere interrotta e ripresa.
  • I dati firmati nel modulo devono coincidere con quelli caricati sul GSE.
  • Il team è piccolo e in parte volontario: infrastruttura containerizzata, log con retention, controlli automatici, nessun servizio cloud proprietario.
  • Dati personali e documenti d'identità: ogni socio vede solo i propri dati, la comunità li vede in forma anonima.
  • Il lavoro sul campo avviene da smartphone, al sole, spesso con una mano sola.

Il punto di partenza

Entrambe le applicazioni partono da CerCollettiva, software open source per comunità energetiche con licenza MIT. Abbiamo scelto il fork invece della riscrittura per tenere il dominio già modellato (CER, impianti, MQTT) e investire il tempo sul resto. L'avviso di copyright originale è mantenuto nei repository e citato nel footer del sito.

UpstreamGestionale CER IS
Django5.06.1
Python3.11+3.14
DatabaseSQLite / PostgreSQLPostgreSQL 18
MQTTMosquittoEMQX 6.3 (TLS)
FrontendBootstrap 5 + Chart.jsSito con design system proprio + admin Unfold

Architettura a container

Ogni applicazione è uno stack Docker Compose a sé, e Nginx Proxy Manager è l'unico ingresso web pubblico: termina il TLS e instrada www.cer-is.com e gis.cer-is.com verso i rispettivi container. La WebGIS non pubblica nessuna porta; l'eccezione è il broker MQTT, che ascolta in TLS per i dispositivi. Non è microservizi per moda: c'è un'applicazione per dominio, più servizi specializzati là dove non conviene fare tutto nel codice (PDF, MQTT, cache, storage).

  • Reti segregate: nel gestionale tre reti Docker (db, cache, pdf), così ogni servizio vede solo ciò che gli serve. Il generatore di PDF non ha uscita internet.
  • Healthcheck ovunque: su ogni servizio del gestionale, su database e app della WebGIS (con endpoint /api/health), così lo stato di ogni container è sempre leggibile.
  • Dati sul server del cliente: database e upload su bind mount locali, nessun BaaS e nessuna chiave API obbligatoria, quindi nessun lock-in. La migrazione a PostgreSQL 18, i backup e il restore sono documentati.
  • Operabilità per volontari: log su journald con retention a 20 giorni, script di smoke test, sincronizzazione del certificato per il broker MQTT.
  • Stato ricostruibile: Redis volutamente senza persistenza, perché tiene solo cache e sessioni.

Gestionale, sito e iscrizioni

Un unico sistema Django sostituisce WordPress, NocoDB e i fogli di calcolo. Il sito pubblico vive in un'app separata (sito) e il gestionale non viene toccato: le pagine frontali sono additive, quindi rifare il sito non può rompere il flusso dei soci. Per lo stesso motivo il sito usa CSS e JS scritti a mano, font self-hosted e nessuna CDN.

Homepage di www.cer-is.com, con titolo, invito all'iscrizione e i dati principali della comunitàLa homepage di www.cer-is.com su mobile
  • Iscrizioni a stati: bozza, dati confermati, firmato inviato, da integrare, approvata. La bozza si riprende da qualsiasi dispositivo; i dati vengono congelati alla conferma, così il documento firmato è identico a ciò che va al GSE.
  • PDF del modulo con Gotenberg (Chromium) su una rete Docker interna senza uscita internet: resa fedele al browser, senza wkhtmltopdf.
  • Conformità GSE: registro soci con tessera e QR verificabile, export nel tracciato POD richiesto dal GSE, lookup della cabina primaria dal POD, import dell'impianto dall'attestato GAUDÌ.
  • Monitoraggio IoT: client MQTT con driver per dispositivi Shelly e Huawei, aggregazioni con cache, dashboard in tempo reale via WebSocket.
  • Operabilità: tre reti Docker segregate, healthcheck su ogni servizio, log su journald con retention a 20 giorni, Redis volutamente senza persistenza, wiki operativa integrata per i volontari.
  • Python 3.14
  • Django 6.1
  • PostgreSQL 18
  • Redis
  • Daphne + Channels
  • Gotenberg
  • EMQX (MQTT)
  • MinIO / S3
  • Docker Compose

WebGIS per le cabine primarie

Una CER si definisce per perimetro di cabina primaria, quindi la domanda è geografica: dove sono i POD, a quale cabina appartengono, e se in ogni cabina produzione e consumo sono in equilibrio. Qui il fork di CerCollettiva è stato riscritto su uno stack diverso: una PWA su ortofoto satellitare 3D, installabile su smartphone.

WebGIS di CER Irpinia Sannio: mappa satellitare con perimetri delle cabine primarie, filtri per ruolo energetico e indicatori di potenza e bilanciamento

La mappa con i perimetri delle cabine primarie, i filtri per ruolo e stato pratica, e in alto gli indicatori: POD, potenza installata, energia immessa e prelevata, indice di bilanciamento.

Pagina di accesso della WebGIS su gis.cer-is.com

L'accesso è riservato a soci e team: qui la pagina di login pubblica.

  • Assegnazione nel database: un trigger PostGIS (ST_Within) calcola cabina primaria e comune a ogni inserimento o spostamento di un POD. Nessuna logica duplicata nell'applicazione.
  • Privacy a livello di query: quattro ruoli applicati nelle query SQL, così l'API non restituisce mai ciò che il ruolo non può vedere. Ai soci la posizione arriva offuscata in modo deterministico lato server.
  • Indice di bilanciamento per cabina (immissione annua su domanda F1+F2) con tre stati: bilanciata, surplus, deficit.
  • Layer e basemap: cabine GSE e comuni ISTAT importati da Shapefile con riproiezione, rete AT/MT da OpenStreetMap, ortofoto storiche Wayback con lettura della data di scatto reale (lo snapshot può mostrare foto di anni prima), terreno 3D, catasto.
  • Censimento impianti FV dal tetto: delineazione delle falde con stima automatica della potenza, codice impianto per comune, documenti allegati.
  • Import dal gestionale in sola lettura, con colonne elencate una a una: i dati fiscali e bancari non vengono mai letti.
  • Mobile e accessibilità: bottom sheet a tre snap-point sotto i 768 px, colore e forma distinti per produttore, consumatore e prosumer, contrasto AA, target touch da 44 px, alternativa tabellare alla mappa.
  • Next.js 16
  • React 19
  • TypeScript
  • PostgreSQL 18 + PostGIS
  • Drizzle ORM
  • MapLibre + deck.gl
  • Auth.js
  • Docker Compose

Scelte e compromessi

  • Fork invece di riscrittura nel gestionale; riscrittura dello stack, ma non del dominio, nella WebGIS.
  • Nessun BaaS e nessuna chiave API obbligatoria per le mappe: tutto su Postgres e Docker del cliente, senza lock-in.
  • Dati incompleti dichiarati nell'interfaccia (rete OSM parziale, cabine da importare) invece che nascosti.
  • Il servizio di immagini Esri va verificato per usi commerciali: per ora è un limite noto.
  • La CER è all'inizio e i volumi sono piccoli: qui l'obiettivo è un sistema manutenibile da volontari, non un risultato di scala.

Hai un software open source da portare in produzione?

Dal fork al deploy, con la stessa concretezza.

oppure chiama il 347 485 4512