Francesco Paderi
[Copertina: un groviglio di passaggi manuali si tende, scatta e si fonde in un solo file, setup_info.jsonc; un cavo lo collega a tre ZeroBox una alla volta, e l’ultima, dopo un errore, torna pronta appena la si ricollega]
Il setup dei dispositivi: da 20 minuti di lavoro a 3 di attesa.

Caso studio · 2025

Ridare agli sviluppatori il tempo per sviluppare

“Come ho ridisegnato in un mese il setup dei dispositivi embedded di Zerynth, lasciando una base che qualcun altro avrebbe esteso.”

Ruolo
Process & Tool Design
Team
Sviluppatori Zerynth; Head of Hardware Engineering, Zerynth
Durata
1 mese

20 → 3

Minuti di lavoro per dispositivo · media osservata; ora quasi tutti di attesa

Dopo la laurea, torno a Zerynth

Zerynth porta le PMI manifatturiere italiane verso l’industria 4.0, con una piattaforma che raccoglie e mostra i dati dei macchinari. Ci avevo già lavorato durante la tesi, progettando Zero, e ad agosto, subito dopo la laurea, mi hanno richiamato per un mese. Il compito era ottimizzare un processo poco visibile da cui dipende tutto il resto, il setup dei dispositivi embedded che raccolgono i dati in fabbrica.

Un mese per ottimizzare il workflow

Il processo era frammentato, lento, e sopravviveva grazie a un documento tenuto a mano da chi lo conosceva bene. Doveva restare degli sviluppatori, solo più veloce e meno esposto agli errori da distrazione, e lasciare una base che il team avrebbe esteso.

Un altro sviluppatore lavorava già a una soluzione più strutturale. Sapevo quindi che il mio codice sarebbe stato sostituito, e doveva essere semplice e leggibile più che fatto per durare.

Un processo con troppe fonti, e tanti punti di possibile fallimento

Le prime due settimane ho affiancato gli sviluppatori, annotando i tempi, e ho fatto il setup più volte io stesso, finché da ore sono sceso a 15 minuti per dispositivo.

Il vero problema era che tutto dipendeva dalla memoria e dall’attenzione di chi lo eseguiva. Tra chiamate, meeting e pause bastava poco, una password sbagliata o un file fuori posto, per ripartire da capo.

[Immagine: il vecchio processo in sei passi numerati (leggi, crea l’asset, firmware, VPN, setup, Excel), con i punti in cui ci si perdeva segnati sulle interfacce: il nome battuto a mano, il firmware da scegliere, la VPN che non si sistema, la password o la rete sbagliata, la trascrizione in Excel]

C’erano tre fonti di file per un solo dispositivo, e ogni passaggio dall’una all’altra era un’occasione per perdersi.

Come restituire agli sviluppatori il tempo e l’attenzione che il setup si prendeva?

Riordinare il documento non sarebbe bastato. Andava cambiato l’ordine delle azioni stesse, portando le decisioni umane all’inizio e alla fine e rendendo automatico tutto il resto.

Tutto prima, tutto dopo, niente step intermedi

  1. Prima

    Un file da compilare contiene tutte le informazioni necessarie.

  2. In mezzo

    Due comandi automatici trasformano quel file in dispositivi pronti; l’utente si limita a connetterli.

  3. Dopo

    Un riepilogo dice cosa ha funzionato, cosa no, e si integra nel modo di lavorare che esisteva già.

Lavorare per il futuro con dei vincoli

Ogni scelta doveva rendere il processo più stabile oggi e lasciare una base per la soluzione finale del team.

Spostare ogni problema in un punto: il JSON

Le informazioni prima date passo dopo passo sono finite tutte all’inizio, in un unico JSON: un formato validabile, che in futuro un’interfaccia grafica o un agente avrebbero potuto compilare al posto di un dev.

[Immagine: il nuovo processo, il file setup_info.jsonc con i controlli che prima erano sparsi, poi i comandi --asset e --deploy, poi il riepilogo del deploy pronto da copiare in Excel]

Decisione: Ogni punto di errore finisce nel JSON, e così il rischio si sposta dal setup alla compilazione.

Il costo: il processo andava ricostruito intorno al file. Però un JSON si può validare, tre fonti sparse no, quindi se manca un dato nessun comando parte e il dev vede subito cosa manca.

Anche il firmware segue la stessa logica, con uno standard per tutti sostituito da quello custom solo quando serve.

Preparare i dispositivi: comandi di creazione e setup

terminale

python -m setup_v11_with setup_info.jsonc --asset

crea gli asset (con --assetVPN anche i certificati VPN) · valida il JSON e si ferma prima di toccare un dispositivo

python -m setup_v11_with setup_info.jsonc --deploy

esegue il deploy sui dispositivi collegati · un dispositivo che fallisce finisce nel riepilogo

Decisione: Tra il JSON e il riepilogo il setup passa da due comandi, uno crea gli asset (con o senza VPN) e l’altro esegue il deploy sui dispositivi collegati.

Primo tentativo: L’alternativa era unirli in uno solo.

Il costo: due momenti diversi mescolati. La creazione valida il JSON e si ferma prima di toccare un dispositivo; il deploy raccoglie alla fine tutto il lavoro fisico, e un dispositivo che fallisce finisce nel riepilogo senza bloccare gli altri.

Quando tutto è pronto, si possono comunque lanciare uno dopo l’altro.

[Suono: il buzzer fa «Bzzz!»]

Restava però la distrazione, e serviva un modo per richiamare l’attenzione quando un dispositivo andava staccato o qualcosa falliva.

Decisione: Ho riusato il buzzer che in fabbrica localizza già i dispositivi, come segnale acustico del processo.

Collaborare per eliminare il debito tecnico: la VPN

Mancava ancora la VPN. Crearla era complicato, e cancellarla senza lasciare residui sul server in produzione non era scontato.

Primo tentativo: Potevo lasciarlo fuori scope, e avrei risparmiato tempo.

Il costo: un passaggio manuale lasciato a metà, proprio mentre spostavo tutti gli altri a inizio o fine.

Decisione: Con l’Head of Hardware Engineering abbiamo testato una soluzione su un server di prova e l’abbiamo portata in produzione. Creare e cancellare una VPN sono diventati due comandi, e l’automazione si è chiusa.

Cosa ho lasciato nella roadmap Zerynth

Dal mio lavoro Zerynth poteva espandersi in due modi:

  1. Un agente che compila il JSON al posto del dev, leggendo il documento di handoff e i dati della dashboard, cioè l’idea di Zero portata a monte del processo. Il team Zerynth ci ha lavorato dopo di me.

  2. Un’interfaccia grafica sopra il JSON, per chi non conosce il formato.

Entrambe erano previste quando ho progettato il JSON.

Impatto

[Immagine: minuti di lavoro al crescere dei dispositivi, prima circa 20 a dispositivo fino a 120 per sei, dopo il JSON una volta (circa 10) e circa 3 automatici a dispositivo fino a 28; l’area tra le due linee è il tempo risparmiato]

Il lavoro su un dispositivo passa da 20 a 3 minuti [nota 1]. Si compila il JSON una volta, poi basta collegare e scambiare i dispositivi mentre il setup procede da solo, e i rari errori si recuperano alla fine. Chi lo vede per la prima volta lavora ormai alla pari di chi lo conosceva a memoria. Ho consegnato il tool, il nuovo flusso e la documentazione: oggi il tool non si usa più, ma è stato la base del workflow finale.

  1. 1 Prima, circa 20 minuti in media, dai tempi che ho annotato affiancando gli sviluppatori, quindi 3-4 dispositivi all’ora, e chi aveva trovato un proprio metodo andava più veloce. Dopo, si compila il JSON una volta per tutto il lotto, al massimo una decina di minuti, poi circa 3 minuti a dispositivo, automatici e quasi tutti di attesa per boot e scrittura dell’immagine, mentre chi lavora collega e scambia i dispositivi. Sono medie tutte e due, però la prima cambiava molto da persona a persona, mentre la seconda varia di poco perché a lavorare è il tool.

Cosa ho imparato

  • A volte il design più semplice si trova ricomponendo ciò che esiste.

    Spostare le decisioni umane a inizio e fine ha risolto più errori di qualunque riscrittura del documento.

  • Una base pensata per durare vale un piccolo costo oggi.

    Il JSON, i comandi separati e il riepilogo pensavano tutti a chi avrebbe esteso il lavoro dopo.

Scrivimi

CV
Regia
Francesco Paderi
In collaborazione con
Claude Code
Portfolio che mi ispirano
Jean Chen
Rachel Chen
Mi hanno smosso
Gawx
The Lumineers
Eve
Alimentato da
Tanto, tanto tè
Musica di ogni tipo
(dal metal ai temi di Baldur’s Gate, con un po’ di pop e indie in mezzo)
Caratteri
Fraunces · Instrument Sans · DM Mono
Sottotitoli
EnglishItaliano [un clic cambia la lingua del sito]
Avvertenza
Nessun agente AI è stato maltrattato
durante la realizzazione di questo sito
(tranne Claude, un pochino)