Piattaforma gestionale · team · 2023 – oggi
Energine Manager
01 Contesto
Energine SRL opera nel settore dell'efficienza energetica e della mobilità elettrica nella Sicilia sud-orientale. La piattaforma gestionale interna è nata nel 2023 dal lavoro del team tecnico per coprire un flusso che nessun gestionale di mercato copriva end-to-end: anagrafica clienti, contratti, impianti, sessioni di ricarica EV, fatturazione elettronica e pagamenti.
Nel 2025 ho assunto la direzione tecnica del progetto. La prima versione della piattaforma aveva portato l'azienda alla scala attuale, ma la roadmap richiedeva client multipli (web, mobile, POS) e cicli di rilascio più rapidi. Il team ha quindi avviato una riscrittura graduale verso un'architettura API-first.
02 Il mio ruolo
Coordino un piccolo team interno, lavorando su tutta la filiera del prodotto invece che su una sola verticale:
Direzione & processo
SpecificheRaccolta requisiti, scrittura ticket
Code reviewStandard interni, mentoring
MonitoraggioHealth check, log, incident response
ArchitetturaDesign API, decisioni tecniche
Programmazione diretta
BackendLayer API REST, ORM custom
FrontendSetup React/TS, componenti core
IntegrazioniOCPP, SDI, payment gateway
Pipeline datiScript per ingest/report
03 Architettura in evoluzione
Il passaggio in corso è da un sistema monolitico server-side a un'architettura a tre livelli con backend API REST, frontend React e client nativi. Il backend mantiene la base esistente affiancata da microservizi separati dove il dominio dati lo richiede.
client
Web app
Mobile app
POS Android
↓
API · gateway REST
Autenticazione & permessi
Routing per dominio
Contratti versionati
↓
applicazione
Backend server-side, ORM custom
Servizi Python (ingest, report, ML leggero)
Scheduler & job cron
↓
integrazioni esterne
OCPP WebSocket (stazioni EV)
Payment gateway
SDI / FatturaPA
WireGuard VPN
↓
dati
Database relazionale (dati applicativi)
Log strutturati (sessioni OCPP)
File system (documenti, PDF)
04 Moduli principali
Gestione clienti & contratti
AnagraficaClienti, referenti, sedi
ContrattiTipologie, scadenze, rinnovi
ImpiantiMappatura per cliente/sede
DocumentiUpload, archiviazione, firma
EV Charging · OCPP
ProtocolloOCPP 1.6 WebSocket
MonitoraggioStato real-time connettori
SessioniLog, energia erogata, durata
AlertOffline detection con grace period
Fatturazione elettronica
StandardFatturaPA / SDI
IntegrazioneProvider certificato SDI
StatoTracking ciclo vita fattura
IVAGestione aliquote multiple
POS & pagamenti in campo
HardwareTerminale Android
AppSviluppata in-house
SincronizzazioneAPI REST con la piattaforma
Casi d'usoIncassi tecnici, sessioni manuali
05 Sfide tecniche affrontate
OCPP offline alert storm. Le colonnine inviavano ping/pong WebSocket ogni 30 secondi e il sistema generava false offline alert ad ogni timeout di rete transiente, inondando i tecnici di email. Il team ha introdotto un grace period configurabile: l'alert parte solo dopo soglia sostenuta.
Monofase detection su stazioni trifase. Alcune EV non negoziavano correttamente la potenza su stazioni trifase, restando in monofase a potenza ridotta. Abbiamo implementato un algoritmo di detection che identifica il pattern e applica un boost sulla L1 per compensare la negoziazione mancante.
DC Fast Charger, firmware BMS. Un charger EV non completava la sessione con veicoli Tesla a causa di un fallback mancante. Ho coordinato l'analisi con il vendor che ha rilasciato il firmware "INTERNATIONAL" con il fix implementato.
Migrazione progressiva monolite → API. Riscrivere un sistema in produzione senza fermarlo richiede di far convivere il vecchio rendering server-side e i nuovi endpoint REST per mesi. Stiamo procedendo per dominio (clienti → contratti → impianti → fatturazione), spostando un modulo alla volta dietro l'API e poi sostituendo la view server-side con la corrispondente schermata React.
06 Evoluzione del progetto
2023
Avvio della piattaforma, primo gestionale interno sviluppato dal team.
2024
Integrazione OCPP 1.6 WebSocket per le colonnine EV. Fatturazione elettronica SDI/FatturaPA. Dashboard di monitoraggio.
2025
Subentro come CTO & Tech Lead. Avvio della migrazione ad architettura API-first: layer API REST, frontend in React/TypeScript, POS Android. Introduzione di servizi Python per pipeline dati e report.
In corso
Completamento della migrazione modulo per modulo, consolidamento dei contratti API, code review & standard interni, ottimizzazioni performance e algoritmi di smart charging, app mobile.