O gerenciamento de versões em um produto personalizado não é o mesmo problema que o gerenciamento de versões em um produto de software, e tratar os dois da mesma forma provoca as duas falhas sobre as quais trata este artigo. As equipes de software tendem a pensar em versões como um fluxo, no qual a mais recente é a melhor e as mais antigas são mantidas apenas para os clientes que ainda não atualizaram. Em um produto físico, as versões mais antigas não são história, são estoque, e estão em armazéns, com distribuidores e nas mãos dos clientes, e cada uma delas acabará por gerar uma pergunta. Um sistema de versões para um produto físico personalizado precisa responder à mesma pergunta que as versões de software respondem, mais uma: qual é a versão desta unidade que tenho em mãos e onde ela está registrada.
Essa segunda pergunta é toda a disciplina. Uma versão que existe no sistema de produção de uma fábrica, mas que não pode ser lida na unidade nem encontrada em um documento, não resolveu nada. Criou uma conveniência interna e um mistério externo, e é o mistério externo que chega à mesa de suporte.
A razão para pensar nisso desde o início é que um produto personalizado multiplica o número de elementos que podem diferir entre duas unidades que são idênticas para qualquer cliente. Duas unidades do mesmo lote de produção podem ter firmware, arte, materiais impressos, documentação e acessórios diferentes, e cada uma dessas diferenças é legítima. O trabalho do sistema de versões é tornar as diferenças identificáveis, e o trabalho do comprador é garantir que essa identificação esteja registrada no acordo.
Gerenciamento de versões de personalizações de engenharia: os sete elementos que precisam de sua própria versão
Sete elementos de um produto personalizado têm uma versão própria. Eles são listados aqui porque cada um muda de forma independente dos demais, e um sistema que versiona apenas os dois primeiros ainda será incapaz de responder a uma pergunta sobre o terceiro.
- A versão do firmware. O código como existe na unidade, identificado por um número de build que pode ser lido novamente no dispositivo. É a versão mais importante para o suporte técnico e a que mais frequentemente está ausente da documentação do comprador. Não publicamos uma política de versões de firmware, portanto, o esquema precisa ser acordado por programa.
- A revisão do hardware. A placa, as peças mecânicas e tudo o que sofreu alguma alteração física. É invisível para o cliente, portanto, só pode ser conhecido por uma marcação na unidade, um registro de build ou pela memória de um fornecedor, e frequentemente é a versão que explica uma reclamação física.
- O conjunto de configurações. A combinação específica de personalizações aplicadas a essa unidade: cor, nome, tratamento do logotipo, versão da interface e embalagem. Duas unidades do mesmo modelo com o mesmo firmware ainda podem ser produtos diferentes, e esta é a versão que o sistema de pedidos do próprio comprador precisa ser capaz de registrar.
- Os arquivos de arte e embalagem. O lado impresso. Eles mudam com mais frequência do que as pessoas esperam, porque uma correção de idioma, uma inserção regulatória para um novo mercado ou uma linha legal revisada representa uma alteração na versão da embalagem, mesmo quando o produto não foi modificado.
- O conjunto de documentação. O manual, o cartão de início rápido e as inserções, vinculados a uma configuração específica e a uma versão específica do firmware. Um manual que descreve uma versão diferente daquela presente na caixa representa um custo de suporte que cresce a cada cliente que o lê.
- O conjunto de acessórios. A mala que acompanha a unidade e sua configuração. As linhas publicadas em nosso catálogo mostram por que isso precisa de sua própria versão: a capacidade é publicada para cinco modelos — CY05 e CY03, e L1 Pro —, cada um com 1400 mAh, L2 Utral com 900 ou 1400 mAh, e MT6 como uma mala dobrável de 1200 mAh. KY06 e MT5 têm uma mala sem capacidade publicada. V03 e V06, e S7, não têm nenhuma linha para a mala, e V03 Pro é documentada como sendo enviada sem mala. Somente L2 Utral é um produto com duas configurações, e uma unidade com a mala menor não é o mesmo produto que uma unidade com a maior.
- O registro de avaliação. Qual avaliação ou avaliação regulatória se aplica a cada revisão. Este elemento é invisível para todos, exceto para as pessoas que mantêm o arquivo, e é a versão que determina se uma unidade está sendo enviada com base em uma avaliação ainda aplicável.
A relação entre os sete itens é tão importante quanto os próprios itens. O conjunto de configurações, o conjunto de documentação e o conjunto de acessórios normalmente correspondem à mesma versão da amostra aprovada, e a compilação do firmware e a revisão do hardware normalmente são aquelas a partir das quais a amostra foi construída. Portanto, um bom sistema de versões tem um rótulo visível — a amostra, a unidade de referência —, e os outros seis derivam dele. Esse é um sistema mais simples do que aquele com o qual a maioria dos compradores acaba ficando, e é muito mais fácil de auditar.

Personalização de engenharia e as duas maneiras pelas quais um sistema de versões falha
Os dois modos de falha são opostos e ocorrem em diferentes tipos de organização, portanto os compradores devem saber qual deles estão analisando.
Silêncio de versão. Os identificadores existem em algum lugar — em uma planilha da fábrica, em um sistema de compilação, em uma pasta —, mas nunca são registrados em um local acessível à própria equipe do comprador. O sintoma é uma solicitação de suporte que fica parada porque ninguém consegue determinar qual produto o cliente possui. O segundo sintoma é uma reivindicação que não pode ser investigada, porque a unidade não pode ser vinculada a uma compilação. O terceiro, e mais caro, é um pedido de alteração que a fábrica acredita já corresponder ao estado do produto, enquanto o comprador acredita que ele foi solicitado, mas não realizado. O silêncio de versão é mais uma falha de comunicação do que técnica, e é mais comum entre fornecedores pequenos, movimentados e bons na produção.
Explosão de versões. Cada artefato recebe um identificador, e os identificadores se multiplicam mais rápido do que os produtos. O comprador recebe um número de compilação, um número de revisão, um código de configuração, um número de documento e um código de embalagem para a mesma unidade, sem conseguir relacioná-los entre si. O sintoma é uma especificação que foi ultrapassada por um esquema de numeração, e um fornecedor que não consegue dizer qual versão é a vigente sem consultar três sistemas. O custo da explosão de versões é pago nos lugares em que a velocidade importa: uma correção de defeito demora mais para ser implantada, uma reivindicação demora mais para ser avaliada e uma nova rodada de produção demora mais para começar, pois a configuração inicial precisa ser reconstruída.
Os dois modos de falha têm a mesma causa raiz: tratar o identificador como o objetivo, em vez de como um meio de localizar coisas. Um número de versão só tem valor se alguém puder agir com base nele. O teste de um sistema de versões é simples: escolha um número de série de uma reclamação de cliente e veja quantas etapas são necessárias para chegar à compilação, à configuração, à documentação e à avaliação que a cobriram. Se a resposta for mais de alguns minutos, o sistema é apenas um exercício de arquivamento, e não um controle.
Existe um terceiro padrão, mais discreto, que vale a pena nomear: versões que existem, mas cujo significado é ambíguo. Um número de compilação reutilizado para duas compilações diferentes, ou um código de configuração que significa coisas diferentes na fábrica e no sistema de pedidos do comprador, gera exatamente o tipo errado de confiança. É pior do que não ter versão, porque as pessoas param de procurar.
Durante a diligência devida, a tabela de versões é um dos documentos mais reveladores que um comprador pode solicitar, e ela raramente é pedida. A maioria das avaliações de fornecedores examina alegações de capacidade — capacidade, prazo de entrega, certificação, sistemas de qualidade — e ignora a pergunta mundana de como o fornecedor sabe o que enviou. Um comprador que solicita uma tabela de versões com dados ocultados de um programa personalizado recente aprende algo que nenhuma alegação de poderá revelar: se o fornecedor consegue rastrear uma unidade nas mãos de um cliente até a compilação e a documentação que a acompanharam. Um fornecedor que possui essa tabela já resolveu o problema tratado neste artigo. Um fornecedor que diz que pode consultá-la em um instante normalmente não consegue.
O mesmo teste funciona durante a comparação de uma lista de candidatos, e vale a pena estabelecer os critérios antes de as cotações chegarem. Os critérios importantes são simples: cada fornecedor indica os identificadores que utilize, diz onde o registro ficará armazenado, diz quem será responsável pelo acesso e explica o que acontece com uma versão depois de sua aposentadoria. Dois fornecedores podem cotar o mesmo preço e o mesmo prazo de entrega e ainda assim estar oferecendo modelos de suporte completamente diferentes, e o esquema de versões normalmente é o primeiro lugar em que essa diferença se torna visível.

Personalização de engenharia e as regras que tornam um sistema de versões utilizável
Seis regras bastam para fazer um sistema de versões funcionar nesta categoria. Elas são simples, e vale a pena enunciá-las porque a maioria dos sistemas falha em uma delas, e não em algum aspecto sofisticado.
- Um identificador por dimensão, nunca um identificador composto. A versão do firmware, a revisão do hardware e o conjunto de configurações são três coisas distintas, e combiná-las em uma única "versão do produto" significa que qualquer alteração em uma delas invalida as outras. Identificadores compostos também são a causa direta da explosão de versões.
- Uma versão é imutável. Alterar um artefato cria uma nova versão. Editar uma versão lançada no local destrói o único registro do que foi distribuído e é a causa mais comum de uma divergência na documentação que chega ao cliente.
- Uma versão só tem sentido se o artefato puder ser recuperado. Um identificador que aponta para um arquivo em uma pasta que ninguém consegue encontrar é apenas uma etiqueta, não uma versão. Em um programa personalizado, o armazenamento deve sobreviver à pessoa que o criou.
- Toda versão lançada acompanha um registro. Quem a lançou, quando, com base em qual linha de base, o que mudou e o que ela substitui. Essa é a diferença entre um número de versão e uma nota de lançamento, além de ser o artefato que torna uma auditoria possível.
- O identificador deve ser fisicamente acessível. Um número de build que só pode ser recuperado na fábrica não é utilizável por uma equipe de suporte. As soluções práticas são um item de menu visível, uma etiqueta impressa na unidade, um código na embalagem ou uma consulta por número de série, e a escolha deve ser feita considerando o processo de suporte, não o processo de build.
- Mantenha pequeno o número de versões ativas. Cada versão em uso representa uma população que precisa de suporte. Descontinuar versões antigas é tanto uma decisão comercial quanto técnica, e deve ser uma decisão acompanhada de uma data e de uma comunicação, não a simples ausência de uma decisão.
A sexta regra é aquela em que a maioria dos programas acaba com um problema que não Previu. Se nada nunca for descontinuado, o número de versões ativas cresce a cada lançamento, e o custo de suporte de um produto aumenta mesmo que seu hardware não tenha mudado. A solução é uma política com três partes: por quanto tempo uma versão terá suporte, o que aconteça com as unidades que executam uma versão expirada e como o cliente final será informado. Não publicamos nenhum compromisso de obsolescência nem nenhuma linha de nível de serviço de suporte, portanto, para nós, isso deve ser um acordo específico por programa, redigido como tal.
Descontinuar uma versão também é uma negociação com o comprador, e deve ser negociado, não apenas anunciado. Os argumentos a favor da descontinuação são reais: cada versão ativa representa um custo de suporte, um custo de peças de reposição e um custo de treinamento. O argumento contra é que as unidades em campo não podem ser recolhidas, de modo que uma versão descontinuada significa um produto que existe no mundo e não recebe mais suporte de quem o fabricate. A maioria dos compradores aceitará uma política de descontinuação que estableça claramente o horizonte de suporte e o comunique, mas não aceitará que ela seja descoberta pelos próprios clientes. O equilíbrio entre o custo de oferecer suporte a uma versão antiga e o custo de manter um produto sem suporte em campo é uma decisão comercial e deve ser tomada enquanto a versão ainda está em uso, não quando ele já está presente em grande quantidade no campo.
Uma armadilha relacionada merece uma breve menção, porque é comum nesta categoria: a versão descontinuada que ainda está no armazém. O estoque mantido pelo comprador ou por um distribuidor de uma versão descontinuada não pode ser vendido como uma versão ativa sem uma nova verificação e, se a arte-finalização, o manual ou o encarte tiver mudado, o estoque deixa de constituir um produto completo. Decidir antecipadamente o que acontece ao estoque existente quando uma versão é descontinuada é uma pequena cláusula que evita uma discussão muito maior.

Personalização de engenharia e a questão de conformidade por trás de uma versão
A sétima versão — o registro de avaliação — é a que se conecta à conformidade, e também a que mais frequentemente está ausente. Ela está ausente em parte porque o cenário regulatório nesta categoria é realmente fragmentado e em parte porque ninguém a solicitou.
A posição honesta sobre o nosso próprio material publicado é esta: o catálogo não inclui uma linha de certificação por modelo e o corpo do catálogo não enumera entradas CE, FCC, RoHS ou RED para modelos individuais. A página de certificações de exportação é uma página ilustrada que apresenta dez certificados de patente, oito desenhos registados como patentes e dois modelos de utilidade. Trata-se de patentes, que registam aquilo que o requerente decidiu proteger, e não são equivalentes a um registo de ensaios regulamentares. Um comprador que presuma que a página de certificações resolve a questão da conformidade de um modelo vai ficar decepcionado, e um comprador que presuma que a ausência de uma linha de certificação significa que não foi realizado qualquer trabalho de conformidade vai ser injustamente negativo. Nenhuma das presunções está correta, e a forma de resolver esta questão é solicitar por escrito o âmbito da avaliação, tendo em conta a configuração específica que está a ser encomendada.
A parte da questão relativa à versão específica é esta: uma avaliação abrange uma configuração definida e uma revisão definida. Se a revisão do hardware mudar, se o firmware mudar de forma a afetar o comportamento da rádio ou o tratamento de dados pessoais, ou se o ambiente da antena mudar devido à alteração da armação, o âmbito do que está coberto tem de ser novamenteestablished. É aqui que um esquema de versões de firmware se torna uma questão de conformidade, e não uma questão de suporte, porque os requisitos de cibersegurança de equipamentos de rádio associados à marcação CE, descritos através das normas harmonizadas EN 18031 para comunicação segura, encriptação, armazenamento seguro, consentimento do utilizador e tratamento de vulnerabilidades identificadas, se aplicam ao produto tal como é colocado no mercado, e não ao produto tal como foi avaliado inicialmente.
A versão prática desta regra é simples e vale a pena incluir no processo de alteração: cada registo de avaliação identifica as revisões que abrange, e qualquer alteração a uma revisão coberta desencadeia uma revisão do registo. Sem essa cláusula, um produto pode sair silenciosamente do âmbito da sua própria avaliação, e ninguém dá por isso até uma autoridade de mercado, a equipa de conformidade de um distribuidor ou o próprio consultor jurídico de um cliente perguntar.
Personalização de engenharia e o registo de versões de que uma equipa de suporte precisa
O último elemento é o próprio registo, porque um sistema de versões só é tão bom quanto o documento que uma equipa de suporte consegue abrir às três da tarde, quando um cliente está ao telefone.
Para um produto personalizado, esse registo deve responder a seis perguntas sem necessidade de investigação adicional: qual compilação de firmware está instalada na unidade, qual é a revisão do hardware, qual conjunto de configurações foi aplicado, qual versão da documentação foi incluída com a unidade, qual conjunto de acessórios foi fornecido e qual registo de avaliação abrange essa combinação. Na prática, trata-se de uma única tabela indexada pelo número de série ou pelo lote, com os identificadores ligados e não repetidos, mantida num local ao qual a equipa do comprador possa aceder.
Durante a devida diligência, um comprador pode pedir para ver esta tabela de um programa recente, em versão censurada. Se existir, o fornecedor pode apoiar um produto personalizado. Se não existir, o fornecedor pode fabricar produtos, mas o modelo de suporte para um produto personalizado terá de ser inventado do zero pelas duas partes. Essa é umamodalidade legítima, desde que seja uma decisão consciente e não uma surpresa no primeiro trimestre da garantia.
A posição é direta. Não publicamos uma política de versões de firmware, um compromisso de obsolescência nem uma linha de níveis de serviço de suporte, porque essas são decisões sobre uma relação, e não propriedades de um produto. O que podemos fazer é acordá-las consigo por escrito, para cada programa: os identificadores que serão utilizados, o que cada um significa, onde o registo será mantido, como chegará à equipa de suporte e o que acontecerá às versões retiradas. Envie-nos a configuração que pretende implementar e mostraremos-lhe o esquema de versões que proporíamos para ela, bem como o registo que esperamos poder abrir quando o seu primeiro cliente entrar em contacto.
Uma observação sobre qual modelo escolher primeiro, pois isso afeta o esquema de versões mais do que os compradores esperam. A gama é ampla — oito modelos de áudio, três modelos esportivos, onze modelos com câmera, três modelos infantis, além de óculos de AR e linhas de eletrocromia e condução óssea, listados por capacidade — e as questões de versionamento diferem muito entre eles. Um programa de câmeras precisa versionar o conjunto de acessórios, pois as linhas de estojo publicadas vão de um estojo de 1400 mAh no L1 Pro e CY03 e CY05 até uma configuração documentada sem estojo no V03 Pro. Um programa esportivo precisa versionar a fixação e o perfil de uso. Um programa de áudio para uma marca que lança em vários idiomas precisa versionar as insertos. O modelo que uma marca escolher determina quais dos sete elementos versionados ela realmente terá que gerenciar, e isso é uma parte legítima dos critérios de seleção, não um detalhe a ser resolvido depois.
Leituras relacionadas
- O que um pedido de personalização abrange — personalização de engenharia
- Onde a linha de base é definida antes da produção — o processo de desenvolvimento
- Como uma pergunta do cliente é realmente tratada após o lançamento — suporte pós-venda



