Versionshantering för en anpassad produkt är inte samma problem som versionshantering för en programvaruprodukt, och att behandla det på det sättet leder till de två fel som den här artikeln handlar om. Programvaruteam tenderar att se versioner som en ström, där den senaste är den bästa och de äldre bara finns kvar för kunder som inte har uppdaterat än. I en fysisk produkt är de äldre versionerna inte historia, utan inventarier. De finns i lager, hos distributörer och i kundernas händer, och var och en av dem kommer förr eller senare att bli föremål för en fråga. ett versionssystem för en anpassad fysisk produkt måste besvara samma fråga som programvaruversionerna gör, plus en till: vilken version har enheten jag håller i handen, och var står det nedskrivet?
Den andra frågan utgör hela disciplinen. En version som finns i en fabriks versionshanteringssystem men inte kan läsas av från en enhet eller hittas i ett dokument har inte löst någonting. Den har skapat en intern bekvämlighet och en extern gåta, och det är den externa gåtan som kommer till supportavdelningen.
Skälet till att fundera på det här tidigt är att en anpassad produkt multiplicerar antalet saker som kan skilja sig åt mellan två enheter som är identiska för varje kund. Två enheter från samma produktionsomgång kan ha olika firmware, olika grafik, olika tillbehör, olika dokumentation och olika tillbehör, och varje sådan skillnad är berättigad. Versionssystemets uppgift är att göra skillnaderna namngivbara, och köparens uppgift är att se till att benämningen skrivs in i avtalet.
Versionshantering av teknisk anpassning: de sju sakerna som behöver en egen version
Sju element i en anpassad produkt har en egen version. De listas här eftersom var och en ändras oberoende av de andra, och ett system som bara versionshanterar de två första kommer fortfarande att vara oförmåga att besvara en fråga om den tredje.
- Firmwarebygget. Koden som den ser ut i enheten, identifierad av ett byggnummer som kan läsas tillbaka från enheten. Det är den version som betyder mest för teknisk support och den som oftast saknas i köparens dokumentation. Vi publicerar ingen policy för firmwareversioner, så systemet måste avtalas för varje program.
- Maskinvarurevisionen. Kortet, de mekaniska delarna och allt som har ändrats fysiskt. Den är osynlig för kunden och kan därför bara fastställas utifrån en märkning på enheten, en byggregistrering eller en leverantörs minne, och det är ofta versionen som förklarar ett fysiskt klagomål.
- Konfigurationsuppsättningen. Den specifika kombinationen av anpassningar som har tillämpats på enheten: vilken färg, vilket namn, vilken logobehandling, vilket gränssnittsbygge och vilken förpackning. Två enheter av samma modell med samma firmware kan fortfarande vara olika produkter, och det är denna version som köparens eget ordersystem måste kunna registrera.
- Grafik- och förpackningsfilerna. Den tryckta sidan. De ändras oftare än folk tror, eftersom en språkkorrigering, ett regulatoriskt tillägg för en ny marknad eller en reviderad juridisk formulering innebär en ändring av förpackningsversionen även när produkten inte har ändrats.
- Dokumentationsuppsättningen. Manualen, snabbstartskortet och tilläggen, kopplade till en specifik konfiguration och ett specifikt firmwarebygge. En manual som beskriver ett annat bygge än det som finns i lådan är en supportkostnad som växer med varje kund som läser den.
- Tillbehörsuppsättningen. Vilket fodral, och vilken konfiguration av det, som levereras med enheten. De publicerade raderna i vår katalog visar varför det här behöver en egen version: kapaciteten anges för fem modeller — CY05 och CY03 samt L1 Pro — som alla har 1400 mAh, L2 Utral med antingen 900 eller 1400 mAh och MT6 som ett vikbart fodral med 1200 mAh. KY06 och MT5 har ett fodral utan angiven kapacitet. V03 och V06 samt S7 har ingen rad alls för fodral, och V03 Pro dokumenteras som levererad utan fodral. Endast L2 Utral är en produkt med två konfigurationer, och en enhet med det mindre fodralet är inte samma produkt som en enhet med det större.
- Bedömningsregistret. Vilken regulatorisk bedömning eller utvärdering som omfattar vilken revision. Den här är osynlig för alla utom personerna som förvaltar filen, och det är versionen som avgör om en enhet skickas baserat på en bedömning som fortfarande gäller.
Relationen mellan de sju är lika viktig som själva sakerna. Konfigurationen, dokumentationen och tillbehören har normalt samma version som det godkända provet, och firmware-versionen och hårdvarurevisionen är normalt de som provet byggdes från. Ett bra versionssystem har därför en synlig etikett – provet, referensenheten – och de andra sex knutna till den. Det är ett enklare system än det de flesta köpare slutar med, och det är mycket lättare att granska.

Teknisk anpassning och de två sätt på vilka ett versionssystem misslyckas
De två felmoderna är motstridiga och förekommer i olika typer av organisationer, så köpare bör känna till vilken de står inför.
Versionsstilhet. Identifierarna finns någonstans – i en kalkylbladstabell i fabriken, i ett byggsystem, i en mapp – men registreras aldrig någonstans som köparens eget team kan nå. Symptomet är en supportfråga som står still eftersom ingen kan fastställa vad kunden har. Det andra symptomet är ett krav som inte går att utreda, eftersom enheten inte kan knytas till någon byggning. Det tredje, och dyraste, är en begäran om en ändring som fabriken tror redan är produktens aktuella status, samtidigt som köparen tror att den har begärts men inte genomförts. Versionsstilhet är i första hand ett kommunikationsfel snarare än ett tekniskt, och det är vanligare bland leverantörer som är små, upptagna och bra på att bygga.
Versions-explosion. Varje artefakt får en identifierare, och identifierarna ökar snabbare än produkterna. En köpare får ett byggnummer, ett revisionsnummer, en konfigurationskod, ett dokumentnummer och en förpackningskod för samma enhet, utan möjlighet att koppla dem till varandra. Symptomet är en specifikation som blivit överkänd av ett numreringssystem och en leverantör som inte kan säga vilken version som är aktuell utan att kontrollera tre system. Kostnaden för versions-explosionen betalas på de ställen där hastighet spelar roll: en felkorrigering tar längre tid att sprida, ett krav tar längre tid att bedöma och en ny produktionsomgång tar längre tid att starta eftersom startkonfigurationen måste rekonstrueras.
Båda felmoderna har samma grundorsak: att identifieraren behandlas som målet i stället för som ett medel för att hitta rätt saker. Ett versionsnummer är bara värdefullt om någon kan agera på det. Prövningen av ett versionssystem är enkel: välj ett serienummer från en kundreklamation och se hur många steg det krävs för att nå byggningen, konfigurationen, dokumentationen och den bedömning som omfattade den. Om svaret är mer än några minuter är systemet ett arkiveringsmoment snarare än en kontroll.
Det finns ett tredje, tystare mönster som är värt att benämna: versioner som finns men vars innebörd är tvetydig. Ett byggnummer som har återanvänts för två olika byggningar, eller en konfigurationskod som betyder olika saker i fabriken och i köparens ordersystem, skapar precis fel sorts säkerhet. Det är sämre än att inte ha någon version alls, eftersom då slutar människor leta.
Vid due diligence är versionstabellen ett av de mest diskriminerande dokumenten en köpare kan begära, ändå begärs den sällan. De flesta leverantörsbedömningar tittar på kapacitetspåståenden – kapacitet, ledtid, certifiering, kvalitetssystem – och hoppar över den vardagliga frågan om hur leverantören vet vad den har levererat. En köpare som begär en maskerad versionstabell från ett nyligen anpassat program får veta något som inget kapacitetspåstående kan berätta: om leverantören kan spåra en enhet i kundens hand tillbaka till byggningen och dokumentationen som följde med den. En leverantör som har tabellen har redan löst problemet som den här artikeln handlar om. En leverantör som säger att den kan slå upp det på en minut kan normalt inte det.
Samma prövning fungerar vid jämförelse av en slutlista, och det är värt att fastställa kriterierna innan anbuden kommer in. De viktiga kriterierna är enkla: anger varje leverantör vilka identifierare den kommer att använda, var registreringen kommer att finnas, vem som kommer att ha behörighet och vad som händer med en version när den ersätts. Två leverantörer kan lämna samma pris och samma ledtid och ändå erbjuda helt olika supportmodeller, och versionssystemet är normalt den första platsen där skillnaden blir synlig.

Teknisk anpassning och de regler som gör ett versionssystem användbart
Sex regler räcker för att få ett versionssystem att fungera i den här kategorin. De är enkla, och det skall till att de är värda att ange är att de flesta system misslyckas på någon av dem snarare än på något avancerat.
- En identifierare per dimension, aldrig en sammansatt. Firmware-versionen, hårdvarurevisionen och konfigurationsuppsättningen är tre separata saker, och att kombinera dem till en enda ”produktversion” innebär att en ändring av någon av dem ogiltigförklarar de andra. Sammansatta identifierare är också den direkta orsaken till versionsinflation.
- En version är oföränderlig. Att ändra en artefakt skapar en ny version. Att redigera en släppt version på plats förstör den enda registreringen av vad som levererades, och det är den vanligaste enskilda orsaken till att dokumentationsavvikelser når en kund.
- En version är endast meningsfull om artefakten kan hämtas. En identifierare som pekar på en fil i en mapp som ingen kan hitta är en etikett, inte en version. För ett anpassat program måste lagringen överleva personen som skapade det.
- Varje släpp innefattar en registerant. Vem som släppte det, när, mot vilken baslinje, vad som ändrades och vad det ersätter. Det är skillnaden mellan ett versionsnummer och en släppnot, och det är artefakten som gör en revision möjlig.
- Identifieraren måste vara fysiskt åtkomlig. Ett byggnummer som endast kan hämtas från fabriken går inte att använda av supportteamet. Praktiska lösningar är en synlig menypost, en tryckt etikett på enheten, en kod på förpackningen eller en uppslagning av serienummer, och valet bör göras utifrån supportprocessen snarare än byggprocessen.
- Håll antalet aktiva versioner litet. Varje version som används i drift är en population som behöver support. Att ta äldre versioner ur drift är lika mycket en kommersiell åtgärd som en teknisk, och det bör vara ett beslut med ett datum och en kommunikation, inte ett frånvaro.
Den sjätte regeln är där de flesta program hamnar i ett problem de inte förutsåg. Om ingenting någonsin tas ur drift växer antalet aktiva versioner med varje släpp, och supportkostnaden för en produkt växer trots att dess hårdvara inte har ändrats. Lösningen är en policy med tre delar: hur länge en version stöds, vad som händer med enheter som kör en utgången version och hur slutkunden informeras. Vi publicerar varken något åtagande om att ersätta utgångna produkter eller någon supportnivårad, så för oss är detta ett avtal per program, och det bör skrivas som ett.
Att ta en version ur drift är också en förhandling med köparen, och det bör förhandlas snarare än tillkännagöras. Argumenten för att ta den ur drift är reella: varje aktiv version innebär en supportkostnad, en kostnad för reservdelar och en utbildningskostnad. Argumentet emot är att enheter i fält inte kan återkallas, så en version som tagits ur drift innebär en produkt som finns i världen och inte längre stöds av tillverkarna. De flesta köpare accepterar en policy för utgångna produkter som tydligt anger supporthorisonten och kommunicerar den, men inte en policy som deras egna kunder upptäcker. Avvägningen mellan kostnaden för att stödja en gammal version och kostnaden för en produkt utan support i fält är ett kommersiellt beslut, och det bör fattas medan versionen fortfarande är aktuell, inte när fältet är fullt av den.
En relaterad fälla förtjänar en mening, eftersom den är vanlig i denna kategori: versionen som tagits ur drift men fortfarande finns i lagret. Lager hos köparen eller en distributör av en version som tagits ur drift får inte säljas som en aktiv version utan en ny verifiering, och om grafiken, bruksanvisningen eller en insats har ändrats är lagret inte längre en komplett produkt. Att i förväg bestämma vad som ska hända med befintligt lager när en version tas ur drift är en liten bestämmelse som undviker en mycket stor diskussion.

Teknisk anpassning och efterlevnadsfrågan bakom en version
Den sjunde versionen – bedömningsrapporten – är den som knyter an till överensstämmelse, och det är den som oftast saknas. Den saknas delvis eftersom regelbilden i denna kategori verkligen är fragmenterad, och delvis eftersom ingen har bett om den.
Den ärliga positionen om vårt eget publicerade material är följande: katalogen innehåller ingen certifieringsrad per modell, och katalogens huvudinnehåll anger inte CE-, FCC-, RoHS- eller RED-poster för enskilda modeller. Exportcertifieringssidan är en bildsida som visar tio patentcertifikat, åtta designpatent och två bruksmodeller. Det är patent, som visar vad en sökande har valt att skydda, och de är inte samma sak som en regulatorisk testrapport. En köpare som antar att certifieringssidan avgör efterlevnadsfrågan för en modell kommer att bli besviken, och en köpare som antar att avsaknaden av en certifieringsrad betyder att inget efterlevnadsarbete har utförts kommer att vara orättvist negativ. Ingetdera är rätt, och lösningen är att begära bedömningsomfattningen skriftligen, för den specifika konfiguration som beställs.
Den versionsspecifika delen av frågan är följande: en bedömning omfattar en definierad konfiguration och en definierad revision. Om hårdvarurevisionen ändras, om firmware ändras på ett sätt som påverkar radiobeteendet eller hanteringen av personuppgifter, eller om antennmiljön ändras på grund av att ramen har bytts, måste omfattningen av det som omfattas fastställas på nytt. Det är här ett versionssystem för firmware blir en fråga om överensstämmelse snarare än en supportfråga, eftersom kraven på cybersäkerhet för radioutrustning bakom CE-märkning, som beskrivs genom EN 18031 harmoniserade standarder för säker kommunikation, kryptering, säker lagring, användarsamtycke och hantering av identifierade sårbarheter, gäller produkten så som den placeras på marknaden, inte produkten så som den bedömdes första gången.
Den praktiska tillämpningen av denna regel är enkel och värd att skriva in i ändringsprocessen: varje bedömningsdokument anger de revisioner som omfattas, och varje ändring av en omfattad revision utlöser en granskning av dokumentet. Utan denna bestämmelse kan en produkt i tysthet glida utanför omfattningen av sin egen bedömning, och ingen märker det förrän en marknadsauktoritet, en distributörs överensstämmelseteam eller en kunds egen juridiska rådgivare frågar.
Teknisk anpassning och den versionsdokumentation som supportteamet behöver
Den sista delen är dokumentationen i sig, eftersom ett versionssystem är bara så bra som det dokument som ett supportteam kan öppna klockan tre på eftermiddagen när en kund är på linjen.
För en anpassad produkt bör dokumentationen svara på sex frågor utan ytterligare utredning: vilken firmware-build som finns i enheten, vilken hårdvarurevision den har, vilken konfigurationsuppsättning som tillämpats, vilken dokumentationsversion som packats med den, vilken tillbehörsuppsättning som levererats och vilket bedömningsdokument som omfattar den kombinationen. I praktiken är detta en enda tabell med serienumret eller partiet som nyckel, där identifierarna är länkade i stället för upprepade, och den förvaras på en plats som köparens eget team kan nå.
Vid due diligence kan en köpare begära att få se denna tabell för ett nyligen genomfört program, i en maskerad version. Om den finns kan leverantören ge support för en anpassad produkt. Om den inte finns kan leverantören tillverka produkter, och supportmodellen för en anpassad produkt får parterna skapa från grunden. Det är en legitim ordning, förutsatt att den är ett medvetet val och inte en överraskning under det första garantikvartalet.
Positionen är entydig. Vi publicerar ingen policy för firmwareversioner, inget åtagande om att ersätta utgångna produkter och ingen supportnivå i fråga om service, eftersom det är beslut om en relation snarare än egenskaper hos en produkt. Det vi kan göra är att komma överens om detta skriftligen med er för varje program: vilka identifierare som ska användas, vad varje identifierare betyder, var dokumentationen ska lagras, hur den når supportteamet och vad som händer med versioner som tas ur bruk. Skicka oss den konfiguration ni planerar, så visar vi er den versionsstruktur vi föreslår och den dokumentation vi förväntar oss att kunna öppna när er första kund ringer.
En anmärkning om vilken modell man bör utgå från, eftersom det påverkar versionssystemet mer än köpare kanske tror. Sortimentet är brett — åtta ljudmodeller, tre sportmodeller, elva kameramodeller, tre barnmodeller samt AR-glasögon och elektrokromiska och benledningsprodukter indelade efter funktion — och versionsfrågorna skiljer sig avsevärt mellan dem. Ett kameraprogram måste versionsbestämma tillbehörssatsen, eftersom de publicerade fodralsraderna sträcker sig från ett fodral med 1400 mAh för L1 Pro och CY03 samt CY05 till en dokumenterad konfiguration utan fodral för V03 Pro. Ett sportprogram måste versionsbestämma montering och profil. Ett ljudprogram för ett varumärke som lanserar på flera språk måste versionsbestämma inläggen. Vilken modell ett varumärke väljer avgör vilka av de sju versionsbestämda elementen som faktiskt behöver hanteras, och det är en legitim del av urvalskriterierna, inte en detalj att reda ut i efterhand.
Relaterad läsning
- Vad en anpassningsförfrågan omfattar — teknisk anpassning
- Var baslinjen fastställs före produktion — utvecklingsprocessen
- Hur en kundfråga faktiskt hanteras efter lansering — kundsupport efter försäljning



