Zarządzanie wersjami w zcustomizowanym produkcie to nie to samo co zarządzanie wersjami w produkcie oprogramowania, a traktowanie tych dwóch przypadków tak samo prowadzi do dwóch porażek, których dotyczy ten artykuł. Zespoły programistyczne zwykle postrzegają wersje jako strumień, w którym najnowsza jest najlepsza, a starsze są przechowywane wyłącznie dla klientów, którzy jeszcze nie zaktualizowali urządzenia. W produkcie fizycznym starsze egzemplarze nie są historią — są zapasem magazynowym, który znajduje się w magazynach, u dystrybutorów i w rękach klientów, a każdy z nich ostatecznie stanie się przedmiotem pytania. System wersji zcustomizowanego produktu fizycznego musi udzielać odpowiedzi na to samo pytanie co wersje oprogramowania, a także na jedno dodatkowe: którą wersję ma egzemplarz, który trzymam w ręku, i gdzie jest ona zapisana.
To drugie pytanie stanowi całą dziedzinę. Wersja, która istnieje w systemie produkcyjnym fabryki, ale której nie można odczytać z egzemplarza ani znaleźć w dokumencie, nie rozwiązuje żadnego problemu. Stworzyła wewnętrzną wygodę i zewnętrzną zagadkę, a właśnie ta zewnętrzna zagadka trafia do działu wsparcia technicznego.
Powodem, aby zastanowić się nad tym wcześnie, jest to, że zcustomizowany produkt mnoży liczbę elementów, które mogą różnić się między dwoma egzemplarzami identycznymi z perspektywy dowolnego klienta. Dwa egzemplarze z tej samej serii produkcyjnej mogą mieć różne oprogramowanie sprzętowe, różną grafikę, różne wkładki, różną dokumentację i różne akcesoria, a każda z tych różnic jest uzasadniona. Zadaniem systemu wersji jest umożliwienie nazywania tych różnic, a zadaniem kupującego — upewnienie się, że nazwy te zapisano w umowie.
Zarządzanie wersjami customizacji inżynieryjnej: siedem elementów wymagających własnej wersji
Siedem elementów zcustomizowanego produktu ma własną wersję. Wymieniamy je tutaj, ponieważ każdy z nich zmienia się niezależnie od pozostałych, a system wersjonujący wyłącznie pierwsze dwa nadal nie będzie w stanie odpowiedzieć na pytanie dotyczące trzeciego.
- Kompilacja oprogramowania sprzętowego. Kod obecny w urządzeniu, identyfikowany numerem kompilacji, który można odczytać z urządzenia. To wersja ma największe znaczenie dla wsparcia technicznego i jednocześnie najczęściej brakuje jej w dokumentach kupującego. Nie publikujemy polityki wersjonowania oprogramowania sprzętowego, dlatego schemat wersjonowania trzeba uzgodnić dla każdego programu.
- Wersja sprzętu. Płytka, części mechaniczne i wszystko, co zmieniło się fizycznie. Jest niewidoczna dla klienta, więc można ją ustalić wyłącznie na podstawie oznaczenia na egzemplarzu, rekordu kompilacji lub pamięci dostawcy — i to ona często wyjaśnia fizyczną reklamację.
- Zestaw konfiguracji. Konkretne połączenie customizacji zastosowanych w danym egzemplarzu: kolor, nazwa, sposób wykonania logo, kompilacja interfejsu i opakowanie. Dwa egzemplarze tego samego modelu z tym samym oprogramowaniem sprzętowym nadal mogą być różnymi produktami, a tę wersję system zamówień kupującego musi być w stanie zapisać.
- Pliki grafiki i opakowań. Strona drukowana. Zmienia się częściej, niż ludzie się spodziewają, ponieważ korekta językowa, wkładka regulacyjna dla nowego rynku lub zmieniona linia prawna oznaczają zmianę wersji opakowania, nawet jeśli sam produkt pozostaje bez zmian.
- Zestaw dokumentacji. Instrukcja, karta szybkiego startu i wkładki, powiązane z określoną konfiguracją i określoną kompilacją oprogramowania sprzętowego. Instrukcja opisująca inną kompilację niż ta w pudełku to koszt wsparcia technicznego, który rośnie z każdym klientem, który ją przeczyta.
- Zestaw akcesoriów. Etui, które oraz w jakiej konfiguracji dołącza do egzemplarza. Opublikowane wiersze w naszym katalogu pokazują, dlaczego wymaga to własnej wersji: pojemność jest podana dla pięciu modeli — CY05 i CY03 oraz L1 Pro — każdy o pojemności 1400 mAh, L2 Utral o pojemności 900 lub 1400 mAh oraz MT6 jako składane etui o pojemności 1200 mAh. KY06 i MT5 mają etui o niepodanej pojemności. V03, V06 i S7 nie mają w ogóle wiersza dotyczącego etui, a V03 Pro jest udokumentowany jako urządzenie wysyłane bez etui. Sam L2 Utral jest produktem występującym w dwóch konfiguracjach, a egzemplarz z mniejszym etui nie jest tym samym produktem co egzemplarz z większym.
- Rejestr oceny. Określona ocena regulacyjna lub ewaluacja, która obejmuje daną wersję sprzętu. Jest niewidoczny dla wszystkich poza osobami przechowującymi dokumentację i to ta wersja decyduje, czy egzemplarz jest wysyłany zgodnie z obowiązującą oceną.
Relacja między siedmioma elementami jest tak samo ważna jak same elementy. Zestaw konfiguracji, zestaw dokumentacji i zestaw akcesoriów zwykle mają tę samą wersję co zatwierdzona próbka, a kompilacja oprogramowania sprzętowego i rewizja sprzętu zwykle odpowiadają elementom, z których zbudowano próbkę. Dobry system wersjonowania ma więc jedną widoczną etykietę — próbkę, złotą jednostkę — a pozostałe sześć jest z nią powiązanych. Jest to prostszy system niż ten, który ostatecznie otrzymuje większość kupujących, i znacznie łatwiejszy do audytu.

Dostosowanie inżynieryjne i dwa sposoby, w jakie system wersjonowania zawodzi
Te dwa tryby awarii są przeciwstawne i występują w różnych rodzajach organizacji, dlatego kupujący powinni wiedzieć, z którym mają do czynienia.
Cisza wersji. Identyfikatory istnieją gdzieś — w arkuszu kalkulacyjnym fabryki, w systemie kompilacji, w folderze — ale nigdy nie są zapisywane w miejscu dostępnym dla własnego zespołu kupującego. Objawem jest pytanie do wsparcia, które utyka, ponieważ nikt nie może ustalić, co posiada klient. Drugim objawem jest reklamacja, której nie można zbadać, ponieważ nie można powiązać egzemplarza z kompilacją. Trzecim i najdroższym jest żądanie zmiany, którą fabryka uważa już za stan produktu, podczas gdy kupujący jest przekonany, że została zgłoszona, ale nie wykonana. Cisza wersji to bardziej problem komunikacji niż techniczny i częściej występuje wśród dostawców, którzy są mali, zajęci i dobrze radzą sobie z produkcją.
Eksplozja wersji. Każdy artefakt otrzymuje identyfikator, a liczba identyfikatorów mnoży się szybciej niż liczba produktów. Kupujący otrzymuje numer kompilacji, numer rewizji, kod konfiguracji, numer dokumentu i kod opakowania dla tego samego egzemplarza, ale nie może ich ze sobą powiązać. Objawem jest specyfikacja, którą przytłoczył schemat numeracji, oraz dostawca, który nie potrafi wskazać aktualnej wersji bez sprawdzenia trzech systemów. Koszt eksplozji wersji ponoszą miejsca, w których ważna jest szybkość: korekta usterki wymaga dłuższego wdrożenia, ocena reklamacji trwa dłużej, a rozpoczęcie nowej serii produkcyjnej jest opóźnione, ponieważ konfigurację wyjściową trzeba odtworzyć.
Oba tryby awarii mają tę samą przyczynę: traktowanie identyfikatora jako celu, a nie jako narzędzia do znajdowania elementów. Numer wersji ma wartość tylko wtedy, gdy można na jego podstawie podjąć działanie. Test systemu wersjonowania jest prosty: wybierz numer seryjny z reklamacji klienta i sprawdź, ile kroków trzeba wykonać, aby dotrzeć do kompilacji, konfiguracji, dokumentacji i oceny, które ją obejmowały. Jeśli odpowiedź brzmi: dłużej niż kilka minut, system jest jedynie procedurą archiwizowania, a nie mechanizmem kontroli.
Istnieje jeszcze trzeci, cichszy wzorzec wart odnotowania: wersje, które istnieją, ale ich znaczenie jest niejednoznaczne. Numer kompilacji wykorzystany ponownie dla dwóch różnych kompilacji lub kod konfiguracji oznaczający różne rzeczy w fabryce i w systemie zamówień kupującego wywołują dokładnie niewłaściwy rodzaj pewności siebie. Jest to gorsze niż brak wersji, ponieważ ludzie przestają sprawdzać.
Podczas due diligence tabela wersji jest jednym z najbardziej rozróżniających dokumentów, o który kupujący może poprosić, a rzadko się o to pyta. Większość ocen dostawców koncentruje się na deklarowanych możliwościach — wydajności, terminie realizacji, certyfikacji, systemach jakości — i pomija proste pytanie, w jaki sposób dostawca wie, co wysłał. Kupujący, który poprosi o zanonimizowaną tabelę wersji z ostatniego niestandardowego programu, dowie się czegoś, czego nie ujawni żadna deklaracja możliwości: czy dostawca potrafi powiązać egzemplarz posiadany przez klienta z kompilacją i towarzyszącą mu dokumentacją. Dostawca, który dysponuje taką tabelą, rozwiązał już problem, którego dotyczy ten artykuł. Dostawca, który twierdzi, że może go w mgnieniu oka sprawdzić, zwykle nie jest w stanie tego zrobić.
Ten sam test działa podczas porównania krótkiej listy, a kryteria warto ustalić przed otrzymaniem ofert. Istotne kryteria są proste: czy każdy dostawca wskazuje identyfikatory, których będzie używał, czy określa, gdzie będzie przechowywany zapis, kto będzie miał do niego dostęp i co stanie się z wersją po jej wycofaniu. Dwa firmy mogą zaoferować tę samą cenę i ten sam termin realizacji, a mimo to oferować zupełnie różne modele wsparcia, przy czym schemat wersjonowania jest zwykle pierwszym miejscem, w którym ta różnica staje się widoczna.

Dostosowanie inżynieryjne i zasady, dzięki którym system wersjonowania jest użyteczny
Sześć zasad wystarczy, aby system wersjonowania działał w tej kategorii. Są proste, a warto je przedstawić, ponieważ większość systemów zawodzi wskutek naruszenia jednej z nich, a nie z powodu jakiegoś wyrafinowanego mechanizmu.
- Jeden identyfikator na wymiar, nigdy złożony. Kompilacja oprogramowania sprzętowego, wersja sprzętu i zestaw konfiguracji to trzy odrębne elementy, a połączenie ich w jedną „wersję produktu” oznacza, że każda zmiana któregokolwiek z nich unieważnia pozostałe. Identyfikatory złożone są również bezpośrednią przyczyną eksplozji liczby wersji.
- Wersja jest niezmienna. Zmiana artefaktu tworzy nową wersję. Edycja wydanej wersji w miejscu niszczy jedyne źródło informacji o tym, co zostało dostarczone, i jest najczęstszą przyczyną niespójności dokumentacji docierającej do klienta.
- Wersja ma znaczenie tylko wtedy, gdy można pobrać artefakt. Identyfikator wskazujący na plik w folderze, którego nikt nie może znaleźć, jest etykietą, a nie wersją. W przypadku programu indywidualizowanego pamięć musi przetrwać osobę, która go utworzyła.
- Każde wydanie zawiera rejestr. Kto je wydał, kiedy, na podstawie jakiej wersji bazowej, co się zmieniło i jakie wydanie zastępuje. To właśnie odróżnia numer wersji od informacji o wydaniu i tworzy artefakt umożliwiający przeprowadzenie audytu.
- Identyfikator musi być fizycznie dostępny. Numer kompilacji, który można pobrać wyłącznie w zakładzie, jest bezużyteczny dla zespołu wsparcia. Praktyczne rozwiązania to widoczna pozycja menu, nadruk na etykiecie urządzenia, kod na opakowaniu lub wyszukiwanie według numeru seryjnego. Wybór należy uwzględniać proces wsparcia, a nie proces kompilacji.
- Należy ograniczyć liczbę aktywnych wersji. Każda wersja pozostająca w użytkowaniu wymaga wsparcia. Wycofywanie starych wersji jest decyzją handlową nie mniej niż techniczną i powinno być formalną decyzją z datą oraz komunikatem, a nie po prostu brakiem działań.
Szósta zasada to miejsce, w którym większość programów trafia w problem, którego nie przewidziała. Jeśli żadna wersja nie jest nigdy wycofywana, liczba aktywnych wersji rośnie z każdym wydaniem, a koszt wsparcia produktu wzrasta mimo niezmienionego sprzętu. Rozwiązaniem jest polityka obejmująca trzy elementy: jak długo wersja jest wspierana, co dzieje się z urządzeniami działającymi na wygasłej wersji oraz jak informuje się klienta końcowego. Nie publikujemy zobowiązań dotyczących wycofania ani wierszy w tabeli poziomów usług wsparcia, dlatego w naszym przypadku jest to indywidualna umowa dla każdego programu i powinna zostać sporządzona w takiej formie.
Wycofanie wersji jest również negocjacjami z nabywcą i powinno być przedmiotem negocjacji, a nie ogłoszenia. Argumenty za wycofaniem są uzasadnione: każda aktywna wersja wiąże się z kosztem wsparcia, części zamiennych i szkolenia. Argumentem przeciwko jest natomiast fakt, że urządzeń będących w użytkowaniu nie można ściągnąć z rynku, dlatego wycofanie wersji oznacza, że istnieje produkt, którego nie wspierają już osoby go wytwarzające. Większość nabywców zaakceptuje politykę wycofywania, która jasno określa horyzont wsparcia i informuje o nim, ale nie zaakceptuje polityki, którą odkryją ich własni klienci. Kompromis między kosztem wspierania starej wersji a kosztem nieobsługiwanego produktu u użytkowników końcowych jest decyzją handlową, którą należy podjąć, gdy wersja jest jeszcze aktualna, a nie wtedy, gdy urządzenia użytkowników końcowych są nią w pełni wyposażone.
Powiązana pułapka zasługuje na jedno zdanie, ponieważ jest częsta w tej kategorii: wersja wycofana, która nadal znajduje się w magazynie. Zapas należący do nabywcy lub dystrybutora, przypisany do wycofanej wersji, nie może zostać sprzedany jako wersja aktywna bez ponownej weryfikacji, a jeśli zmieniła się grafika, instrukcja obsługi lub wkładka, zapas nie stanowi już kompletnego produktu. Zdecydowanie z góry, co stanie się z istniejącym zapasem po wycofaniu wersji, to niewielki zapis, który pozwala uniknąć bardzo długiej kłótni.

Inżynieryjne dostosowanie i kwestia zgodności z przepisami związana z wersją
Siódma wersja — rejestr oceny — jest powiązana ze zgodnością z przepisami i najczęściej brakuje jej. Brakuje jej częściowo dlatego, że sytuacja regulacyjna w tej kategorii jest rzeczywiście rozproszona, a częściowo dlatego, że nikt o nią nie poprosił.
Uczciwe stanowisko wobec naszych własnych, opublikowanych materiałów jest następujące: katalog nie zawiera wiersza certyfikacji dla każdego modelu, a w treści katalogu nie wymieniono certyfikatów CE, FCC, RoHS ani RED przy poszczególnych modelach. Strona poświęcona certyfikacji eksportowej to strona z grafikami przedstawiającymi dziesięć patentów, osiem patentów na wzór przemysłowy i dwa wzory użytkowe. Są to patenty, które dokumentują to, co wnioskodawca zdecydował się chronić, i nie są tym samym co protokół badań regulacyjnych. Kupujący, który zakłada, że strona certyfikacji rozstrzyga kwestię zgodności z przepisami dla danego modelu, będzie rozczarowany, a kupujący, który zakłada, że brak wiersza certyfikacji oznacza, że nie przeprowadzono żadnych prac nad zgodnością z przepisami, będzie niesprawiedliwie negatywny. Żadne z tych założeń nie jest prawdziwe, a rozwiązaniem jest poproszenie o pisemne określenie zakresu oceny dla konkretnej konfiguracji, którą się zamawia.
Wersjoną częściowość pytania jest następująca: ocena obejmuje określoną konfigurację i określoną rewizję. Jeśli zmieni się rewizja sprzętu, oprogramowanie sprzętowe zmieni się w sposób wpływający na działanie modułu radiowego lub przetwarzanie danych osobowych albo zmieni się środowisko antenowe w wyniku zmiany oprawki, zakres objęty oceną trzeba ustalić ponownie. W tym miejscu schemat wersji oprogramowania sprzętowego staje się kwestią zgodności z przepisami, a nie kwestią wsparcia, ponieważ wymagania dotyczące cyberbezpieczeństwa urządzeń radiowych, na których opiera się oznaczenie CE, opisane za pomocą zharmonizowanych norm EN 18031 dotyczących bezpiecznej komunikacji, szyfrowania, bezpiecznego przechowywania danych, zgody użytkownika i obsługi zidentyfikowanych podatności, mają zastosowanie do produktu wprowadzanego na rynek, a nie do produktu ocenionego po raz pierwszy.
Praktyczna wersja tej zasady jest prosta i warto ją wpisać do procesu zarządzania zmianami: każdy protokół oceny wskazuje obejmowane przez siebie rewizje, a każda zmiana objętej rewizji uruchamia przegląd protokołu. Bez tego postanowienia produkt może po cichu wyjść poza zakres własnej oceny, a nikt tego nie zauważy, dopóki o to nie zapyta organ nadzorujący rynek, zespół ds. zgodności z przepisami dystrybutora ani własny doradca prawny klienta.
Dostosowanie inżynieryjne i rejestr wersji, którego potrzebuje zespół wsparcia
Ostatnim elementem jest sam rejestr, ponieważ system wersji jest tak dobry, jak dokument, który zespół wsparcia może otworzyć o trzeciej po południu, gdy klient jest już na linii.
W przypadku produktu dostosowanego rejestr powinien odpowiedzieć bez dalszego dochodzenia na sześć pytań: którą kompilację oprogramowania sprzętowego ma urządzenie, jaką jest rewizja sprzętu, który zestaw konfiguracji zastosowano, którą wersję dokumentacji dołączono, jaki zestaw akcesoriów dostarczono i który protokół oceny obejmuje tę kombinację. W praktyce jest to jedna tabela oparta na numerze seryjnym lub partii, z identyfikatorami powiązanymi, a nie powtarzanymi, przechowywana w miejscu dostępnym dla własnego zespołu kupującego.
Podczas due diligence kupujący może poprosić o udostępnienie tej tabeli dla niedawnego programu w formie zanonimizowanej. Jeśli istnieje, dostawca może wspierać produkt dostosowany. Jeśli nie istnieje, dostawca może wytwarzać produkty, ale model wsparcia dla produktu dostosowanego trzeba będzie wymyślić obu stronom od podstaw. Jest to prawidłowe rozwiązanie, pod warunkiem że jest świadomą decyzją, a nie niespodzianką w pierwszym kwartale okresu gwarancyjnego.
Stanowisko jest jednoznaczne. Nie publikujemy polityki wersji oprogramowania sprzętowego, zobowiązania dotyczącego wycofania produktu ani poziomu usług wsparcia, ponieważ są to decyzje dotyczące relacji, a nie właściwości produktu. To, co możemy zrobić, to uzgodnić je z Państwem na piśmie dla każdego programu: identyfikatory, które będą używane, co każdy z nich oznacza, gdzie będzie przechowywany rejestr, jak trafi do zespołu wsparcia i co stanie się z wycofanymi wersjami. Prześlijcie nam planowaną konfigurację, a pokażemy proponowany dla niej schemat wersji oraz rejestr, który będziemy oczekiwać, że będziemy w stanie otworzyć, gdy zadzwoni pierwszy klient.
Uwaga o tym, od którego modelu warto zacząć, ponieważ ma to większy wpływ na schemat wersji, niż można by sądzić. Oferta jest szeroka — osiem modeli audio, trzy sportowe, jedenaście z kamerą, trzy dla dzieci, a także okulary AR, modele elektrochromowe i z przewodnictwem kostnym, uporządkowane według możliwości — a pytania dotyczące wersji różnią się w zależności od niej. W programie kamer trzeba wersjonować zestaw akcesoriów, ponieważ opublikowane wiersze dotyczące etui obejmują etui o pojemności 1400 mAh w modelach L1 Pro i CY03 oraz CY05, aż po udokumentowaną konfigurację bez etui w modelu V03 Pro. W programie sportowym trzeba wersjonować sposób montażu i profil noszenia. W programie audio dla marki uruchamiającej się na wielu rynkach trzeba wersjonować wkładki. To, jaką kategorię modeli wybierze marka, decyduje, które z siedmiu elementów objętych wersjonowaniem faktycznie będzie musiała obsługiwać. Jest to istotna część kryteriów wyboru, a nie kwestia do rozstrzygnięcia na później.
Powiązane lektury
- Zakres indywidualizacji produktu — dostosowanie inżynieryjne
- Określenie wartości bazowej przed produkcją — proces rozwoju produktu
- Sposób obsługi zapytań klientów po premierze — wsparcie posprzedażowe



