La maggior parte dei problemi di approvvigionamento degli smart glasses non è un problema ingegneristico. L’hardware viene sviluppato, la linea di produzione viene avviata, gli esemplari arrivano e qualcosa è ancora sbagliato: una dichiarazione non può essere comprovata, una stringa di modello non corrisponde a un documento, una contestazione in sede di ispezione non ha un punto di riferimento e nessuno riesce a produrre il registro che avrebbe dovuto risolverla. La lacuna quasi mai è una macchina mancante. È un documento mancante.
Questo articolo riguarda l’insieme di documenti che un acquirente dovrebbe conservare, gate dopo gate, nel framework di sviluppo CYNRIN. Spiega cosa deve definire ciascun documento, come organizzare il fascicolo affinché sopravviva a un cambio di personale o a un audit e quali domande formulare sulla documentazione stessa. Segue la panoramica del processo di sviluppo e integra la descrizione della fase di progettazione e prototipo riportata in design and the prototype stage con l’articolo di accompagnamento su come si svolge effettivamente lo sviluppo.
Documentazione del processo di sviluppo: l’insieme di documenti gate per gate
Il framework prevede sei gate e ciascuno genera un documento prima di qualsiasi altro risultato. Un gate è completato quando esiste un documento firmato, non quando arriva una data. Questo è l’unico principio organizzativo alla base del fascicolo da conservare.
L’insieme completo, nell’ordine dei gate:
- Requisiti congelati — il documento dei requisiti firmato. Definisce il mercato di riferimento, i modelli inclusi, la configurazione, il packaging, la documentazione di consegna e, crucialmente, quali dichiarazioni il prodotto è autorizzato a formulare. È il documento di riferimento per l’intero programma. Ogni documento successivo discende da esso.
- Fattibilità valutata — la risposta scritta sulla fattibilità. Indica se la richiesta può essere realizzata e quali sono i costi in termini di ingegneria e stampi. Il risultato è un confine, non un verdetto: ciò che è commercialmente possibile, ciò che richiede investimenti ingegneristici e la prima data in cui è possibile fornire una risposta concreta. «Sì» e «no» non sono risposte utili in questo contesto.
- Ingegneria e stampi — il contratto degli stampi e il riferimento alla build del firmware. Il contratto degli stampi registra quali stampi verranno realizzati, chi ne è proprietario, cosa accade al relativo costo se il progetto si ferma in questa fase e come cambia la proprietà se il progetto prosegue. Il riferimento alla build del firmware identifica la build, la versione e la configurazione delle funzionalità rispetto ai requisiti congelati.
- Esemplari realizzati e verificati — il golden sample firmato e il relativo verbale di verifica. Il golden sample è il riferimento fisico che definisce ciò che è accettabile e ciò che non lo è. Il verbale di verifica è la prova scritta relativa all’abbinamento, all’Audio, alla Ricarica, a eventuali funzioni della fotocamera e al comportamento dei comandi.
- Fascicolo di Conformità chiuso — la dichiarazione di conformità e i rapporti sottostanti. La dichiarazione riporta l’esatta stringa di modello che verrà commercializzata e si basa sui rapporti che la supportano, oltre ai requisiti specifici del mercato applicabili. Una dichiarazione riferita a una famiglia di prodotti anziché a un modello non costituisce una dichiarazione per il vostro SKU.
- Produzione pilota prima della produzione di massa — i criteri di ispezione e il verbale della produzione pilota. I criteri di ispezione sono formulati rispetto al golden sample. Il verbale della produzione pilota è la prova che una produzione realizzata con stampi di produzione e nel volume di produzione ha superato tali criteri.
Oltre a questi sei, altri tre elementi completano il fascicolo e vengono spesso omessi perché nessuno li classifica come risultati dei gate:
- Approvazioni dell’artwork e del packaging. Dieline, artwork di stampa, struttura del cartone, etichettatura e file master dell’artwork approvato. Sono firmati e soggetti a versionamento perché l’artwork viene modificato tardivamente, spesso per un motivo irrilevante, e un file artwork senza numero di versione presente da entrambe le parti garantisce che il packaging a magazzino non corrisponda a quello riportato nel disegno.
- Registro delle voci aperte e delle deviazioni. Ogni requisito chiuso su un componente specificato, ogni voce che non è stato possibile chiudere e ogni deviazione dai requisiti congelati, con la relativa approvazione. Questo documento impedisce che il prodotto in linea di produzione si discosti tacitamente dal prodotto firmato.
- Registro delle modifiche. Qualsiasi modifica ai requisiti, alla specifica, alla build del firmware o all’artwork successiva alla chiusura del relativo gate, con la data, il motivo, l’approvazione e l’indicazione dei documenti a valle riemessi di conseguenza.
Prendete nota di ciò che è deliberatamente escluso da questo elenco, e del perché. I dati relativi a capacità, durata delle fasi, tempi indicativi, prezzi, livelli di MOQ, tempi di consegna, costi dei campioni, condizioni di garanzia, numeri dei certificati, dimensioni della fabbrica, numero di dipendenti e produzione annua non sono pubblicati da noi e non fanno parte del set documentale di questo framework. Non si tratta di un modo per nascondere le condizioni commerciali: queste ultime sono artefatti di quotazione e di accordo, non registrazioni tecniche. Appartengono al preventivo, all’ordine di acquisto e al contratto — e, quando valutate un fornitore, dovete richiederle direttamente come condizioni commerciali, anziché aspettarvi che emergano da un fascicolo tecnico. Un fornitore incapace di fornire MOQ, tempi di consegna, incoterms e condizioni di garanzia senza formulazioni generiche vi sta comunicaando qualcosa sulla propria operatività commerciale che nessun documento tecnico può rivelare.
Ciò che produrremmo a ogni gate è il documento per cui quel gate esiste, in una forma archiviabile e consultabile: i requisiti congelati in un documento di requisiti firmato; la fattibilità esaminata in un documento scritto che definisce i limiti; ingegneria e stampi in un accordo sulle stampate e in un riferimento per la build del firmware; i campioni verificati in un golden sample firmato e nel relativo verbale di verifica; la conformità chiusa con una dichiarazione limitata alla stringa del modello; e la produzione pilota registrata rispetto a criteri di ispezione scritti. Quando un dato è commerciale anziché tecnico, vi rimanderemo al preventivo invece di inserirlo nel fascicolo tecnico, affinché il fascicolo resti leggibile come registrazione tecnica.

Che cosa deve definire ciascun documento di gate
Il valore di un documento non risiede nella sua lunghezza, ma nel fatto che definisca una domanda che altrimenti verrebbe risolta dalla memoria, da un’assunzione o da chiunque si trovi nella stanza.
Il documento di requisiti definisce che cos’è il prodotto. Se redatto correttamente, può essere confrontato con un’unità consegnata senza dover chiedere nulla a nessuno. Il suo punto debole è di solito la sezione dedicata alle dichiarazioni. Gli acquirenti redigono regolarmente i requisiti concentrandosi sulle funzionalità e dimenticano di specificare le dichiarazioni di marketing, scoprendo poi durante la revisione della conformità che una dichiarazione discussa in una riunione non era mai stata messa per iscritto e ora compare sulla pagina del prodotto. Le dichiarazioni devono essere riportate nel documento di requisiti, con un’esplicita indicazione di quelle che il prodotto è autorizzato a formulare. Una dichiarazione discussa verbalmente ma non inserita nei requisiti congelati riemerge durante la revisione della conformità, nel momento peggiore, perché ormai dipendono da essa la grafica, la confezione e le unità spedite.
Un’altra modalità di errore correlata è facile da individuare perché si nasconde all’interno della stessa organizzazione dell’acquirente. Il documento di requisiti viene spesso firmato dal responsabile del prodotto, mentre l’obbligo di conformità ricade su qualcun altro. Il responsabile del prodotto può specificare una funzionalità; soltanto chi gestisce il fascicolo di conformità può specificare che cosa è consentito dichiarare al riguardo. Se si tratta di due persone diverse, il documento di requisiti deve contenere una sezione esplicita dedicata alle dichiarazioni e un’approvazione che includa il responsabile della conformità, non soltanto il responsabile dell’elenco delle funzionalità. Se questa persona non vede mai il documento, l’elenco delle dichiarazioni viene redatto al gate della conformità, quando la grafica viene approvata e il testo di marketing è in fase di elaborazione; il risultato è un ritardo oppure una dichiarazione pubblicata senza autorizzazione. Si tratta di uno dei problemi più economici da risolvere nell’intero processo e di uno dei più onerosi se affrontato tardivamente.
La risposta di fattibilità definisce che cosa è possibile e quale sarebbe la risposta più tempestiva. La sua utilità per un acquirente risiede interamente nei limiti che stabilisce. Una risposta di fattibilità che indica soltanto "possibile" non vi dice nulla. Ciò che serve è la distinzione: che cosa è possibile così com’è, che cosa richiede uno sviluppo ingegneristico e che cosa non può essere oggetto di risposta finché non viene completata un’indagine specifica. È la terza categoria a sfuggire agli acquirenti, perché viene formulata come una data anziché come una condizione. Il modo corretto di leggere una risposta di fattibilità è come un elenco di dipendenze.
L’accordo sulle stampate definisce chi è il proprietario delle stampate e che cosa accade al relativo costo se il progetto viene interrotto. È il documento più consequenziale dell’intero fascicolo e quello più spesso lasciato implicito. Le stampate sono il punto in cui confluisce la spesa e costituiscono la fase meno reversibile del programma: una volta tagliato l’acciaio, la geometria è fissata e ogni unità successiva viene realizzata secondo quella geometria. L’accordo deve contenere tre elementi: chi detiene la proprietà intellettuale delle stampate, che cosa accade al costo delle stampate se il progetto si conclude in questa fase e quale sia il processo da seguire se il progetto prosegue. Se la risposta a una qualsiasi di queste domande è "ne parleremo più avanti", sarà proprio in quel momento che farlo costerà caro.
Il riferimento alla build del firmware determina quale software viene eseguito dal prodotto. Un identificativo della build, la relativa versione e la configurazione delle funzionalità, espressi rispetto ai requisiti congelati, in modo che chiunque possa vedere cosa è abilitato, cosa è disabilitato e quali sono le impostazioni predefinite. Senza questi elementi, il firmware non è un oggetto che si può conservare: è uno stato che esisteva su una banco di lavoro e la conversazione successiva su un difetto diventa un litigio su quale versione fosse in esecuzione.
Il campione di riferimento e il relativo verbale di verifica determinano cosa significa «accettabile». Il campione di riferimento è il riferimento fisico; il verbale è ciò che lo rende utilizzabile, perché documenta la linea di base in forma scritta: comportamento dell'abbinamento, uscita audio e comportamento dei canali, comportamento della ricarica e relative indicazioni, eventuali funzioni della fotocamera e il loro comportamento di controllo, nonché la linea di base estetica osservabile. Il verbale deve inoltre indicare l'accordo sulla custodia: dove viene conservata l'unità, chi ha accesso e in quale condizione deve trovarsi per restare un riferimento valido. Un campione di riferimento rimasto in un veicolo caldo non è più un riferimento, e nessuno lo segnalerà.
La dichiarazione di conformità e i rapporti su cui si basa determinano cosa è possibile dichiarare e in quale mercato. La dichiarazione deve coprire l'esatta stringa del modello che verrà spedito. Una dichiarazione relativa a una famiglia di prodotti anziché a un modello non costituisce una dichiarazione per il tuo SKU: è la distinzione più rilevante dell'intero fascicolo, perché la stringa del modello compare sul prodotto, nella documentazione, nella spedizione e nel tuo annuncio. Se il catalogo include più di un modello derivato dalla stessa piattaforma, ogni stringa di modello destinata alla spedizione deve essere coperta separatamente. Se il fornitore ti offre una dichiarazione per una famiglia di prodotti e intendi spedire tre SKU, chiedi quali delle tre stringhe vi sono riportate.
Forniremo la dichiarazione limitata all'esatta stringa del modello, insieme ai rapporti su cui si basa e ai requisiti specifici del mercato cui si riferisce, indicando chiaramente quali mercati non sono coperti da una determinata dichiarazione. Quest'ultimo aspetto è fondamentale: un documento che indica ciò che non copre è molto più utile per un acquirente rispetto a uno che indica soltanto ciò che copre, perché chi chiede la seconda domanda ottiene comunque la prima risposta.
I criteri di ispezione e il verbale della prova pilota determinano cosa può contenere un lotto e se il lotto è stato superato. I criteri di ispezione sono redatti rispetto al campione di riferimento, voce per voce, affinché due ispettori diversi su linee diverse possano formulare la stessa valutazione. Il verbale della prova pilota attesta che una produzione realizzata con gli stampi di produzione e nel volume di produzione è stata ispezionata secondo tali criteri e li ha superati. È qui che emergono le sostituzioni: i campioni prototipali non rivelano mai modifiche all'approvvigionamento o variazioni di processo, perché sono assemblati a mano con il componente giusto al posto giusto. Una prova pilota, sì.
Le approvazioni dell'artwork e dell'imballaggio determinano l'aspetto dell'imballaggio. Dieline, artwork, scatola, etichettatura e file master versionato. Le approvazioni dell'imballaggio sono una fonte comune di modifiche tardive e costose proprio perché sono considerate banali e quindi lasciate senza una versione.

Come è organizzato il fascicolo
Un insieme di documenti completo ma inutilizzabile vale meno di un insieme più piccolo che qualcuno sia effettivamente in grado di consultare. Tre regole fanno la differenza tra un fascicolo e una pila di documenti.
Organizza per gate, non per data o per tipo di documento. Ogni gate ha una cartella. Al suo interno, i documenti del gate sono riuniti insieme alle relative evidenze di supporto. Una struttura basata sulla data obbliga il lettore a ricostruire a quale gate apparteneva ogni documento, operazione che si vuole proprio evitare. Una struttura basata sul tipo — tutte le specifiche qui, tutti i rapporti lì — disperde le evidenze di un unico gate in quattro cartelle e rende invisibile il confine tra i gate.
Ogni documento ha un identificativo, una versione e una data, ogni rinvio indica l'identificativo. Non il nome del file, non la data: l'identificativo. Un documento di requisito che indica «per firmware build 2.3.1» e un riferimento al firmware che indica «per requisito CY-RQ-001» possono essere reconciliati in pochi secondi. Due documenti che riportano entrambi «l'ultima versione» non possono essere reconciliati in alcun modo.
Ogni documento riporta un'approvazione. Nome, ruolo, data e oggetto dell'approvazione. Un documento privo di approvazione è una bozza che per caso è stata inviata, e dopo pochi mesi, quando le persone sono cambiate, diventa impossibile ricostruire la distinzione.
C’è un’ulteriore convenzione che si ripaga rapidamente ed è quella che seguiremo in ogni cartella di progetto che forniamo: un breve indice nella radice della cartella, una riga per documento, che riporti l’identificativo, il titolo, la versione, la data e la fase a cui appartiene. Ci vede a un’ora a mantenerlo e trasforma la cartella da qualcosa che una persona deve esplorare in qualcosa che una persona può cercare. Revisori, responsabili in arrivo e clienti leggono tutti prima l’indice.
Una struttura praticabile si presenta così:
- Fase 1 — Requisiti. Il documento dei requisiti firmato, l’elenco delle dichiarazioni, le approvazioni e la brief della grafica, se la grafica è stata richiesta in questa fase.
- Fase 2 — Fattibilità. La risposta sulla fattibilità con le sue tre categorie di confine, l’elenco delle dipendenze e le decisioni assunte.
- Fase 3 — Ingegneria e stampi. Il contratto per gli stampi, la specifica realizzabile, il riferimento della build del firmware, il registro delle voci aperte con le relative chiusure e il registro delle deviazioni.
- Fase 4 — Campioni. Il registro del golden sample firmato, il registro di verifica, l’accordo sulla custodia e le condizioni e le prove di accettazione del prototipo.
- Fase 5 — Conformità. La dichiarazione di conformità per ogni stringa di modello destinata alla Spedizione, i report a supporto e la dichiarazione sull’applicabilità ai mercati.
- Fase 6 — Esecuzione pilota. I criteri di ispezione, il registro dell’esecuzione pilota, le risultanze e le relative disposizioni e la decisione sul rilascio.
- Tra le fasi. Il registro delle modifiche, il registro della corrispondenza e la cartella commerciale — preventivo, ordine di acquisto e condizioni commerciali concordate come MOQ, tempi di consegna, incoterms, garanzia e ricambi.
Ci sono altri due aspetti pratici per mantenere utilizzabile questa struttura. In primo luogo, conservare la cartella in una posizione che non sia la casella di posta o il portatile di una sola persona, perché il valore di questa cartella risiede proprio nel fatto che sopravvive all’uscita di chi l’ha assemblata. In secondo luogo, conservare le prove nello stesso posto della dichiarazione. Una dichiarazione separata dai report a supporto è una dichiarazione che non puoi difendere quando qualcuno chiede perché.
Un terzo aspetto riguarda gli elementi fisici della cartella, facilmente dimenticati quando tutto il resto è digitale. Il golden sample è un oggetto fisico con una funzione legale e richiede un custode designato, una posizione di stoccaggio e un controllo delle condizioni alla stessa frequenza che il sistema qualità già utilizza per la taratura o per i beni di riferimento. Lo stesso vale per una seconda unità trattenuta dall’esecuzione pilota, che spesso è l’unità di confronto più utile che possiate avere, perché proviene da una linea reale anziché da un banco di prova. Se conservate un’unità di produzione come riferimento, registrate quale stringa di modello e quale build del firmware montava, perché un’unità di riferimento priva di questi identificativi non può essere abbinata a nulla.
Esiste anche il caso di un fornitore che non lavora in questo modo. Alcune aziende non producono genuinamente documenti, eppure il loro output è di buona qualità. Si tratta di uno stile operativo legittimo, ma è un rischio che va quantificato come tale anziché scoprire in seguito. Il test pratico non è stabilire se il fornitore dispone di un reparto documentazione, bensì se è possibile ottenere le prove necessarie per difendere una Spedizione a un cliente o a un ispettore. Se la risposta è che le prove esistono ma nessuno le ha messe per iscritto, richiedetele come condizione per proseguire e comprendete che produrle richiede lavoro di ingegneria, con un costo correlato. Se la risposta è che le prove non esistono, il progetto non può concludere la fase di Conformità come previsto e occorre saperlo prima di impegnare gli stampi, non dopo.
Il test dell’organizzazione è abbastanza semplice da applicare in qualsiasi momento: scegliete un documento a caso e chiedetevi che cosa risolve e da quali altri elementi dipende. Se la risposta richiede più di un minuto, la struttura ha fallito.

Domande da porre sul set di documenti
La documentazione non è solitamente controversa all’inizio di un progetto. Diventa controversa quando la pressione commerciale raggiunge il picco, di solito vicino all’esecuzione pilota, e diventa costosa quando manca durante un controllo doganale o di accesso al mercato. Queste sono le domande che vale la pena porre, e l’ordine conta meno del fatto di porle prima che si manifesti la pressione.
- Possiamo ricevere l'insieme completo dei documenti, gate per gate, così com'è attualmente? Un fornitore dotato di un processo operativo lo produce senza alcun effort. Un fornitore che ne è privato troverà motivi per cui occorre tempo, e il motivo sarà la risposta.
- Esiste un documento dei requisiti firmato che elenchi le dichiarazioni che il prodotto può presentare? Non le funzionalità, ma le dichiarazioni. Se non esiste una sezione dedicata alle dichiarazioni, è quella la lacuna da colmare ora, quando apportare modifiche è ancoraico.
- Qual è esattamente la stringa del modello riportata nella dichiarazione? Richiedete la stringa e confrontatela carattere per carattere con quella che comparirà sul prodotto e nella documentazione. Richiedete una voce per ogni SKU, non per la piattaforma.
- Chi è proprietario degli stampi e cosa accade al loro costo se interrompiamo il processo a questo punto? Tre domande in una: proprietà, trattamento contabile e processo di prosecuzione. La risposta deve essere riportata in un accordo firmato, non in un'email.
- Qual è l'identificatore della build del firmware e la relativa configurazione delle funzionalità? Richiedete qualcosa che possa essere verificato rispetto ai requisiti, non soltanto un numero di versione.
- Che cosa copre realmente il verbale di verifica del campione di riferimento? Dovrebbe comprendere l'abbinamento, l'audio, la ricarica, l'eventuale funzione della fotocamera e il comportamento dei comandi, riportando risultati misurati anziché un semplice esito positivo.
- Dove è conservato il campione di riferimento e chi ne ha la custodia? Un'unità di riferimento in una scatola di spedizione, in un magazzino caldo, non è un'unità di riferimento.
- Quali sono i criteri di ispezione e sono stati redatti confrontandoli con il campione di riferimento? I criteri redatti da un disegno sono diversi da quelli basati su un'unità fisica, e soltanto questi ultimi consentono di individuare una deviazione di produzione.
- Quale versione dell'artwork è approvata e è identificata come versione e firmata? Richiedete il riferimento del file artwork principale, non una sua descrizione.
- Quali modifiche sono state apportate dopo la chiusura del gate del fornitore e i documenti a valle sono stati riemessi? Il registro delle modifiche è il documento che rivela la perdita di allineamento. Un fornitore dotato di un processo disciplinato risponde in pochi minuti.
- Quali informazioni non sono pubblicate e cosa dovremmo richiedere al loro posto? Richiedete MOQ, tempi di consegna, incoterm, garanzia, costi dei campioni e condizioni relative ai ricambi come termini commerciali in un preventivo. Richiedete prove di certificazione per ogni stringa di modello. Per gli elementi realmente non disponibili, chiedete al fornitore cosa deve ricevere da voi per produrli.
- Una nuova persona del nostro team è in grado di riprendere questo fascicolo e comprenderlo? Il modo più onesto di verificarlo è individuare qualcuno che non ha mai visto il progetto e chiedergli di rispondere a una domanda consultando il fascicolo.
Vale la pena indicare come positive due comportamenti del fornitore, perché sono meno frequenti di quanto dovrebbero essere. Il primo consiste nel fornire l'elenco delle questioni aperte anche quando è scomodo, e dimostra che il lavoro di ingegneria viene svolto in riferimento ai requisiti anziché a una narrazione commerciale. Il secondo è definire esplicitamente l'ambito di una dichiarazione riferendola a una singola stringa di modello, anziché estenderla a un'intera famiglia, anche quando tale estensione sarebbe stata comoda.
Da parte nostra, tratteremo l'insieme dei documenti come parte della deliverable anziché come documentazione interna: ogni gate produce il proprio documento prima dell'hardware corrispondente, i documenti riportano identificatori e versioni e si rinviavano tra loro tramite gli identificatori, e il gate di conformità viene chiuso rispetto alla stringa di modello esatta che sarà spedita. Se una domanda in qualsiasi fase non può essere risposta consultando il fascicolo, la risposta corretta è ammetterlo e produrre il documento mancante, anziché rispondere verbalmente e lasciare incompleto il fascicolo.
Una dichiarazione discussa durante una riunione, ma non messa per iscritto, ripresenterà i problemi durante la revisione di conformità. Una dichiarazione che copre una famiglia di prodotti anziché un singolo modello non copre il vostro SKU. Queste due frasi spiegano perché vale la pena conservare questo fascicolo. Tutto il resto dell'insieme è amministrativo; sono proprio queste due frasi a costare un ingresso nel mercato.
Per la sequenza complessiva e il rapporto tra i gate, consultate la panoramica del processo di sviluppo. Per i gate qualità e la funzione di ciascuno nel prevenire i problemi, consultate i gate qualità del processo di sviluppo. Per verificare cosa controllare prima di accettare una spedizione rispetto a questo fascicolo, consultate la checklist di certificazione e conformità.



