La gestione delle versioni in un prodotto personalizzato non è lo stesso problema della gestione delle versioni in un prodotto software, e trattarla in questo modo genera i due tipi di fallimento di cui si occupa questo articolo. I team software tendono a concepire le versioni come un flusso, in cui la più recente è la migliore e quelle precedenti vengono mantenute soltanto per i clienti che non hanno ancora effettuato l’aggiornamento. In un prodotto fisico, quelle precedenti non sono storia: sono stock, e si trovano nei magazzini, presso i distributori e nelle mani dei clienti; prima o poi ciascuna diventerà oggetto di una domanda. Un sistema di versioni per un prodotto fisico personalizzato deve rispondere alla stessa domanda a cui rispondono le versioni software, più una: qual è la versione di questa unità che ho in mano e dove viene registrata.
La seconda domanda costituisce l’intera disciplina. Una versione esistente nel sistema di build di una fabbrica, ma che non può essere letta da un’unità né trovata in un documento, non ha risolto nulla. Ha creato una comodità interna e un mistero esterno, ed è il mistero esterno a raggiungere il servizio di assistenza.
Il motivo per cui conviene riflettere su questo aspetto fin dall’inizio è che un prodotto personalizzato moltiplica il numero degli elementi che possono differire tra due unità che, per qualsiasi cliente, sono identiche. Due unità della stessa serie di produzione possono avere firmware, grafica, inserti, documentazione e accessori diversi, e ciascuna di queste differenze è legittima. Il compito del sistema di versioni è rendere nominabili queste differenze, mentre spetta all’acquirente assicurarsi che la nomenclatura venga riportata nell’accordo.
Gestione delle versioni nella personalizzazione ingegneristica: i sette elementi che richiedono una versione propria
Sette elementi di un prodotto personalizzato hanno una versione propria. Sono elencati qui perché ciascuno varia indipendentemente dagli altri e un sistema cheassegna una versione soltanto ai primi due non sarà comunque in grado di rispondere a una domanda sul terzo.
- La build del firmware. Il codice così come esiste nell’unità, identificato da un numero di build che può essere riletto dal dispositivo. È la versione più importante per l’assistenza tecnica e quella più spesso assente dalla documentazione dell’acquirente. Non pubblichiamo alcuna policy sulle versioni del firmware, pertanto lo schema deve essere concordato per ogni programma.
- La revisione dell’hardware. La scheda, i componenti meccanici e tutto ciò che ha subito modifiche fisiche. È invisibile al cliente, quindi può essere identificata soltanto tramite un marchio sull’unità, un registro di build o la memoria di un fornitore; è spesso la versione che spiega un reclamo relativo a un difetto fisico.
- Il set di configurazione. La combinazione specifica di personalizzazioni applicate a quell’unità: quale colore, quale nome, quale trattamento del logo, quale versione dell’interfaccia, quale packaging. Due unità dello stesso modello con lo stesso firmware possono comunque essere prodotti diversi, ed è questa la versione che il sistema di ordinazione dell’acquirente deve essere in grado di registrare.
- I file di grafica e packaging. Il lato stampato. Cambiano più spesso di quanto ci si aspetti, perché una correzione linguistica, un inserto normativo per un nuovo mercato o una riga legale riveduta costituiscono una modifica alla versione del packaging anche quando il prodotto non cambia.
- Il set di documentazione. Il manuale, la scheda di avvio rapido e gli inserti, collegati a una configurazione specifica e a una build specifica del firmware. Un manuale che descrive una build diversa da quella nella scatola rappresenta un costo di assistenza che cresce con ogni cliente che lo legge.
- Il set di accessori. Quale custodia e quale configurazione della stessa viene spedita con l’unità. Le righe pubblicate nel nostro catalogo mostrano perché questo elemento richiede una versione propria: la capacità è pubblicata per cinque modelli — CY05 e CY03, e L1 Pro — ciascuno da 1400 mAh, L2 Utral da 900 o 1400 mAh e MT6 come custodia pieghevole da 1200 mAh. KY06 e MT5 hanno una custodia per la quale non è pubblicata alcuna capacità. V03 e V06, e S7 non hanno affatto una riga relativa alla custodia, mentre V03 Pro è documentato come spedito senza custodia. Solo L2 Utral è un prodotto con due configurazioni, e un’unità con la custodia più piccola non è lo stesso prodotto di un’unità con quella più grande.
- Il verbale di valutazione. Quale valutazione o verifica normativa copre quale revisione. Questo elemento è invisibile a tutti, tranne che a chi gestisce il fascicolo, ed è la versione che determina se un’unità viene spedita sulla base di una valutazione ancora applicabile.
La relazione tra i sette elementi conta quanto i sette elementi stessi. Il set di configurazione, il set di documentazione e il set di accessori sono soltanto generalmente la stessa versione del campione approvato, mentre la build del firmware e la revisione dell’hardware sono generalmente ciò da cui il campione è stato costruito. Un buon sistema di versioni ha quindi un’etichetta visibile — il campione, l’unità di riferimento — e gli altri sei elementi sono collegati a essa. Si tratta di un sistema più semplice rispetto a quello cui la maggior parte degli acquirenti finisce per arrivare, e molto più semplice da verificare.

Personalizzazione ingegneristica e i due modi in cui può fallire un sistema di versioni
I due tipi di fallimento sono opposti e si verificano in organizzazioni di tipo diverso, quindi gli acquirenti dovrebbero sapere quale dei due si trovano davanti.
Silenzio sulle versioni. Gli identificatori esistono da qualche parte — in un foglio di calcolo della fabbrica, in un sistema di build, in una cartella — ma non vengono mai registrati in un luogo accessibile al team dell’acquirente. Il sintomo è una richiesta di assistenza che si blocca perché nessuno riesce a stabilire cosa abbia il cliente. Il secondo sintomo è un reclamo che non può essere indagato, perché non è possibile collegare l’unità a una build. Il terzo, e più costoso, è una richiesta di modifica che la fabbrica ritiene corrispondere allo stato attuale del prodotto, mentre l’acquirente è convinto che sia stata richiesta e non ancora eseguita. Il silenzio sulle versioni è più un fallimento della comunicazione che un problema tecnico, ed è più comune presso fornitori piccoli, impegnati e competenti nella produzione.
Esplosione delle versioni. Ogni artefatto riceve un identificatore e gli identificatori si moltiplicano più rapidamente dei prodotti. Un acquirente riceve un numero di build, un numero di revisione, un codice di configurazione, un numero di documento e un codice di packaging per la stessa unità, senza poterli collegare tra loro. Il sintomo è una specifica che è stata superata da uno schema di numerazione e un fornitore che non riesce a indicare quale versione sia attuale senza consultare tre sistemi. Il costo dell’esplosione delle versioni si paga nei luoghi in cui la rapidità conta: una correzione del difetto richiede più tempo per essere distribuita, un reclamo richiede più tempo per essere valutato e una nuova serie di produzione richiede più tempo per partire, perché la configurazione di partenza deve essere ricostruita.
Entrambi i tipi di fallimento hanno la stessa causa principale: considerare l’identificatore come obiettivo anziché come mezzo per trovare le informazioni. Un numero di versione ha valore soltanto se qualcuno può agire in base a esso. Il test di un sistema di versioni è semplice: scegliere un numero di serie da un reclamo di un cliente e verificare quanti passi sono necessari per risalire alla build, alla configurazione, alla documentazione e alla valutazione che la coprivano. Se la risposta richiede più di un paio di minuti, il sistema è un adempimento burocratico anziché uno strumento di controllo.
Esiste un terzo schema, più discreto, che vale la pena nominare: versioni esistenti, ma dal significato ambiguo. Un numero di build riutilizzato per due build differenti, oppure un codice di configurazione che significa cose diverse nella fabbrica e nel sistema di ordinazione dell’acquirente, genera esattamente il tipo sbagliato di sicurezza. È peggio che non avere una versione, perché le persone smettono di cercare.
Nel corso della due diligence, la tabella delle versioni è uno dei documenti più discriminanti che un acquirente possa richiedere, eppure viene richiesta raramente. La maggior parte delle valutazioni dei fornitori si concentra sulle dichiarazioni relative alle capacità — capacità, tempi di consegna, certificazioni, sistemi di qualità — e ignora la domanda banale di come il fornitore sappia cosa abbia spedito. Un acquirente che richiede una tabella delle versioni con parti oscurate relativa a un recente programma personalizzato apprende qualcosa che nessuna dichiarazione sulle capacità può communicates: se il fornitore è in grado di collegare un’unità nelle mani di un cliente alla build e alla documentazione fornita con essa. Un fornitore che dispone della tabella ha già risolto il problema di cui si occupa questo articolo. Un fornitore che dice di poterla consultare in un momento, di solito non può.
Lo stesso test funziona durante il confronto tra i fornitori prescelti ed è opportuno definire i criteri prima che arrivino i preventivi. I criteri importanti sono semplici: ogni fornitore indica gli identificatori che utilizzerà, dichiara dove sarà conservato il registro, specifica chi ne deterà le chiavi e spiega che cosa accade a una versione dopo il suo retirement. Due fornitori possono offrire lo stesso prezzo e gli stessi tempi di consegna e offrire comunque modelli di assistenza completamente diversi; lo schema delle versioni è di solito il primo punto in cui tale differenza diventa visibile.

Personalizzazione ingegneristica e le regole che rendono utilizzabile un sistema di versioni
Sei regole bastano a far funzionare un sistema di versioni in questa categoria. Sono semplici e vale la pena enunciarle perché la maggior parte dei sistemi fallisce su una di esse, anziché su qualcosa di sofisticato.
- Un identificatore per dimensione, mai un identificatore composito. La build del firmware, la revisione dell’hardware e il set di configurazione sono tre elementi distinti; combinarli in un’unica "versione del prodotto" significa che qualsiasi modifica a uno di essi invalida gli altri. Gli identificatori compositi sono anche la causa diretta dell’esplosione delle versioni.
- Una versione è immutabile. La modifica di un artefatto crea una nuova versione. Modificare sul posto una versione già rilasciata distrugge l’unico record di ciò che è stato spedito ed è la causa più comune di una discordanza tra documentazione e prodotto che raggiunge il cliente.
- Una versione ha significato soltanto se l’artefatto è recuperabile. Un identificatore che rimanda a un file in una cartella che nessuno riesce a trovare è un’etichetta, non una versione. Per un programma personalizzato, l’archivio deve sopravvivere alla persona che lo ha creato.
- Ogni rilascio è accompagnato da un record. Chi lo ha rilasciato, quando, rispetto a quale baseline, che cosa è cambiato e che cosa sostituisce. Questa è la differenza tra un numero di versione e una nota di rilascio, ed è l’artefatto che consente di eseguire un audit.
- L’identificatore deve essere fisicamente accessibile. Un numero di build recuperabile soltanto dalla fabbrica non è utilizzabile da un team di assistenza. Le soluzioni pratiche sono una voce di menu visibile, un’etichetta stampata sull’unità, un codice sul packaging o una ricerca tramite numero di serie; la scelta va fatta tenendo presente il processo di assistenza, non quello di build.
- Mantenere ridotto il numero di versioni attive. Ogni versione in servizio rappresenta una popolazione da supportare. Il retirement delle versioni obsolete è tanto una decisione commerciale quanto tecnica e deve essere una decisione accompagnata da una data e da una comunicazione, non il risultato di un’inerzia.
La sesta regola è quella che lascia la maggior parte dei programmi con un problema non previsto. Se non viene mai ritirata alcuna versione, il numero di versioni attive cresce a ogni rilascio e il costo di assistenza del prodotto aumenta anche se l’hardware non è cambiato. La soluzione è una policy in tre parti: per quanto tempo una versione viene supportata, che cosa accade alle unità che eseguono una versione scaduta e come viene informato il cliente finale. Non pubblichiamo alcun impegno di obsolescenza né righe relative ai livelli di servizio dell’assistenza; per noi, quindi, si tratta di un accordo specifico per programma, che dovrebbe essere redatto come tale.
Il ritiro di una versione è anch’esso una negoziazione con l’acquirente e dovrebbe essere negoziato, non annunciato. Gli argomenti a favore del ritiro sono reali: ogni versione ancora in uso comporta un costo di assistenza, un costo per i pezzi di ricambio e un costo di formazione. L’argomento contrario è che le unità già distribuite non possono essere richiamate; pertanto, il ritiro di una versione significa avere sul mercato un prodotto che non è più supportato da chi lo ha realizzato. La maggior parte degli acquirenti accetterà una politica di ritiro che indichi chiaramente l’orizzonte di assistenza e lo comunichi, mentre non accetterà una politica che scopra tramite i propri clienti. L’equilibrio tra il costo di supportare una versione obsoleta e il costo di un prodotto non supportato sul campo è una decisione commerciale e dovrebbe essere preso mentre la versione è ancora corrente, non quando è già diffusa sul campo.
Un’altra trappola correlata merita una frase, perché è comune in questa categoria: la versione ritirata ma ancora in magazzino. Le scorte detenute dall’acquirente o da un distributore per una versione ritirata non possono essere vendute come versione attiva senza una nuova verifica e, se la grafica, il manuale o il foglietto insertito sono cambiati, le scorte non costituiscono più un prodotto completo. Decidere in anticipo cosa accade alle scorte esistenti quando una versione viene ritirata è una piccola clausola che evita una discussione molto più ampia.

Personalizzazione ingegneristica e la questione di Conformità dietro una versione
La settima versione — il verbale di valutazione — è quella collegata alla Conformità ed è anche quella che più spesso manca. Manca in parte perché il quadro normativo in questa categoria è realmente frammentato e in parte perché nessuno l’ha richiesto.
La posizione onesta sul materiale che pubblichiamo è questa: il catalogo non riporta una riga di certificazione per ogni singolo modello e il corpo del catalogo non elenca voci relative a CE, FCC, RoHS o RED per i singoli modelli. La pagina dedicata alle certificazioni per l’export è una paginaillustrativa che mostra dieci brevetti, otto modelli di utilità e due brevetti per modello. Si tratta di brevetti, che registrano ciò che un richiedente ha scelto di proteggere, e non equivalgono a un verbale di prova normativa. Un acquirente che presume che la pagina delle certificazioni risolva la questione della Conformità di un modello resterà deluso, mentre un acquirente che presume che l’assenza di una riga di certificazione significhi che non sia stato svolto alcun lavoro di Conformità sarà ingiustamente negativo. Nessuna delle due interpretazioni è corretta e il modo per risolvere la questione è chiedere per iscritto il perimetro della valutazione, riferito alla configurazione specifica ordinata.
La parte della questione specifica per la versione è questa: una valutazione riguarda una configurazione definita e una revisione definita. Se cambia la revisione dell’hardware, se il firmware cambia in modo da coinvolgere il comportamento della radio o il trattamento dei dati personali, oppure se cambia l’ambiente radioantennico perché è cambiata la montatura, il perimetro di ciò che è coperto deve essere ridefinito. È qui che uno schema di versionamento del firmware diventa una questione di Conformità anziché di assistenza, perché i requisiti di cybersicurezza delle apparecchiature radio dietro la marcatura CE, descritti tramite le norme armonizzate EN 18031 relative a comunicazioni sicure, cifratura, archiviazione sicura, consenso dell’utente e gestione delle vulnerabilità identificate, si applicano al prodotto così come viene immesso sul mercato, non al prodotto nella configurazione in cui è stato inizialmente valutato.
La versione pratica di questa regola è semplice e vale la pena inserirla nel processo di gestione dei cambiamenti: ogni verbale di valutazione indica le revisioni che copre e qualsiasi modifica a una revisione coperta determina una revisione del verbale. Senza questa clausola, un prodotto può discostarsi silenziosamente dal perimetro della propria valutazione e nessuno se ne accorge finché non lo chiede un’autorità di mercato, il team di Conformità di un distributore o il consulente legale di un cliente.
Personalizzazione ingegneristica e il registro delle versioni di cui un team di assistenza ha bisogno
L’ultimo elemento è il registro stesso, perché un sistema di versionamento è valido solo quanto il documento che un team di assistenza può aprire alle tre del pomeriggio quando un cliente è al telefono.
Per un prodotto personalizzato, il registro deve rispondere a sei domande senza ulteriori indagini: quale build del firmware è presente nell’unità, quale revisione dell’hardware è installata, quale set di configurazione è stato applicato, quale versione della documentazione è stata inclusa nell’imballaggio, quale set di accessori è stato fornito e quale verbale di valutazione copre tale combinazione. In pratica si tratta di un’unica tabella indicizzata dal numero di serie o dal lotto, con gli identificatori collegati anziché ripetuti, conservata in un luogo accessibile al team dell’acquirente.
Nel corso della due diligence, un acquirente può chiedere di consultare, in forma redatta, questa tabella per un programma recente. Se esiste, il fornitore è in grado di supportare un prodotto personalizzato. Se non esiste, il fornitore può costruire prodotti, ma il modello di assistenza per un prodotto personalizzato dovrà essere inventato da zero dalle due parti. Si tratta di un accordo legittimo, purché sia una scelta consapevole e non una sorpresa nel primo trimestre di garanzia.
La posizione è chiara. Non pubblichiamo una politica sulle versioni del firmware, un impegno di obsolescenza né una riga sui livelli di servizio dell’assistenza, perché si tratta di decisioni relative a una relazione e non di proprietà di un prodotto. Quello che faremo è concordarli con voi per iscritto, per ciascun programma: gli identificatori che verranno utilizzati, il significato di ciascuno, dove sarà conservato il registro, come verrà messo a disposizione del team di assistenza e cosa accadrà alle versioni ritirate. Inviateci la configurazione che intendete adottare e vi mostreremo lo schema di versionamento che proporremmo e il registro che ci aspettiamo di poter aprire quando il vostro primo cliente ci chiamerà.
Una nota su quale modello scegliere come punto di partenza, dato che influisce sullo schema di versionamento più di quanto gli acquirenti si aspettino. La gamma è ampia — otto modelli Audio, tre modelli sport, undici modelli con fotocamera, tre modelli kids, oltre a occhiali AR e alle linee elettrocromiche e a conduzione ossea classificate per capacità — e le questioni di versionamento differiscono nettamente tra loro. Un programma con fotocamera deve versionare il set di accessori, perché le righe pubblicate relative alle custodie vanno da una custodia da 1400 mAh per L1 Pro e CY03, e CY05 a una configurazione documentata senza custodia per V03 Pro. Un programma sportivo deve versionare il sistema di montaggio e il profilo di utilizzo. Un programma Audio per un brand che lancia il prodotto in più lingue deve versionare i foglietti insertiti. Il modello scelto da un brand determina quali dei sette elementi soggetti a versionamento dovrà effettivamente gestire e questa costituisce una parte legittima dei criteri di selezione, anziché un dettaglio da definire in un secondo momento.
Letture correlate
- Che cosa comprende una richiesta di personalizzazione — personalizzazione ingegneristica
- Dove viene definito il riferimento prima della produzione — processo di sviluppo
- Come viene effettivamente gestita una domanda di un cliente dopo il lancio — assistenza post-vendita



