Dokumentacja programu jest zwykle traktowana jako rezultat — papierowa praca, którą trzeba przygotować, ponieważ podpisano zamówienie. Bardziej użyteczne jest traktowanie jej jako jedynej trwałej pamięci programu. Sześć miesięcy po rozpoczęciu wdrożenia marki własnej plik dokumentacji informuje kolegę z pracy, co zostało uzgodnione, co zmierzono i co zaakceptowano. Plik, który nie odpowiada na te trzy pytania, jest archiwum, a nie narzędziem kontroli.
Standardowa dokumentacja OEM w tej kategorii ma nietypowy kształt, który wynika z katalogu. Publikowane materiały są bogate w wiersze specyfikacji, ale niemal milczą w kwestiach faktycznie potrzebnych w pliku programu: nie opublikowano wartości referencyjnych dla żadnej pozycji, tolerancji, warunków akceptacji, minimalnej wielkości zamówienia, ceny, harmonogramu ani wiersza certyfikacji dla poszczególnych modeli. Komplet dokumentów dla tej kategorii musi więc być większy niż w przypadku produktu z pełną, publiczną specyfikacją, ponieważ większa jego część musi zostać opracowana, a nie zebrana.
Poniżej przedstawiono taki komplet — co ustala każdy dokument, kto go opracowuje, kiedy jest zamykany, które istnieją wyłącznie dlatego, że dostawca odpowiedział na pytanie na piśmie, oraz jak utrzymać spójność pliku po rozpoczęciu produkcji partii.
Komplet dokumentów, na którym faktycznie opiera się program OEM
Plik dokumentacji programu nie jest jednym długim dokumentem. Jest to zestaw krótkich dokumentów, każdy z jednym właścicielem i jednym zadaniem. Dyscyplina, która zapewnia jego użyteczność, polega na tym, że dokument, który niczego nie ustala, jest rejestrem, a nie dokumentem, natomiast rejestr przechowywany w wątku czatu nie jest w ogóle dokumentem.
| Dokument | Co ustala | Właściciel | Kiedy jest zamykany |
|---|---|---|---|
| Brief wymagań | Model, rynki, warianty kolorystyczne, zestaw deklaracji | Nabywca | Po podpisaniu przez nabywcę |
| Rejestr otwartych pytań | Każde pytanie bez odpowiedzi, wraz z właścicielem i terminem | Nabywca | Gdy do każdego wiersza zostanie dołączona odpowiedź |
| Opis zakresu na piśmie | Odpowiedź dostawcy na brief | Dostawca | Po uzgodnieniu przez obie strony |
| Wydanie projektu graficznego | Zatwierdzony projekt graficzny wskazanego elementu | Obie strony | Gdy zostanie wskazany w informacji o wydaniu |
| Arkusz akceptacji | Warunki, według których oceniana jest sztuka | Obie strony | Po podpisaniu po dostawie pierwszego egzemplarza |
| Zestaw deklaracji | Stwierdzenia, które można przedstawiać w odniesieniu do egzemplarza | Nabywca | Po przeglądzie wraz z dowodami |
| Oferta pisemna | Cena, minimalna wielkość zamówienia i harmonogram dla wskazanego zakresu | Dostawca | Po wystawieniu dla ustalonego zakresu |
| Rejestr partii | Jakie egzemplarze, dokumenty i wersje | Dostawca | Po wydaniu razem z partią |
| Lista pakowania | Co fizycznie znajduje się w opakowaniu | Dostawca | Po uzgodnieniu z opakowaniem zbiorczym |
| Plik wysyłki | Dokumenty towarzyszące towarom | Dostawca | Po zarchiwizowaniu przy wysyłce |
Po przeczytaniu kolumny właścicieli w dół układa się drugi wzorzec. Nabywca jest właścicielem czterech dokumentów, dostawca również czterech, a dwa mają wspólnych właścicieli. Ta równowaga ma większe znaczenie, niż się wydaje: dokumenty będące własnością nabywcy wyrażają intencje i oceny, natomiast dokumenty będące własnością dostawcy rejestrują faktycznie wykonane prace. Program, w którym nabywca nie jest właścicielem żadnego ze wspólnych dokumentów, zwykle kończy się zamówieniem bez rejestru akceptacji, czyli strukturą, która zwiastuje spór.

Kto opracowuje każdy dokument i kiedy jest on zamykany
Najczęstszą przyczyną problemów z dokumentacją nie jest brak dokumentu. Jest nim dokument, który nigdy nie zostaje zamknięty — istnieje w wersji roboczej, jest omawiany na spotkaniu, ale nigdy nie otrzymuje elementu nadającego mu wiążący charakter. Każdy z powyższych dokumentów zamyka się w inny sposób, a wskazanie warunku zamknięcia zapobiega temu, by plik zapełniał się wersjami roboczymi, które wszyscy uznają za ukończone.
Brief wymagań zamyka się po podpisaniu
Brief wymagań jest gotowy, gdy nabywca go podpisze, a podpis nie jest jedynie formalitycznością. Oznacza to moment, w którym nabywca zobowiązuje się do określonego zakresu, a każde pytanie, którego nabywca postanowił nie zapisać, staje się pytaniem, na które dostawca odpowie na własnych warunkach. Brief powinien zatem zawierać zarówno to, co nabywca wie, jak i to, czego nie wie, przy czym drugą grupę należy wymienić w postaci pytań, a nie pominąć.
Rejestr otwartych pytań zamyka się wiersz po wierszu
Rejestr jest najtańszym i najbardziej użytecznym dokumentem w zestawie. Jeden wiersz na pytanie wraz z datą zadania pytania, osobą odpowiedzialną za odpowiedź, treścią odpowiedzi oraz informacją, co ona zmieniła. Zamyka się wiersz po wierszu, a nie w całości. Widoczna końcówka z otwartymi wierszami oznacza, że program działa, ponieważ taka końcówka pełni funkcję harmonogramu.
Opis zakresu na piśmie zamyka się po uzgodnieniu, a nie po otrzymaniu
Dokument określający zakres, który został przesłany, nie jest dokumentem uzgodnionym. Warunkiem zamknięcia jest to, że obie strony zapoznały się z nim, a kupujący oznaczył w nim otwarte kwestie. To rozróżnienie zapobiega sytuacji, w której program odkrywa już w pierwszej próbie, że dostawca i kupujący pracowali na podstawie różnych dokumentów.Zamknięcie projektu graficznego przez odesłanie
Plik projektu graficznego zostaje zamknięty notatką o wydaniu wskazującą nazwę pliku, wersję, część, której dotyczy, oraz konfigurację, na podstawie której został wykonany. Zamykanie projektu graficznego przez odesłanie, a nie przez załączenie pliku, umożliwia audytowanie partii, ponieważ właśnie notatka o wydaniu pozwala fabryce po sześciu miesiącach porównać ją z egzemplarzem w opakowaniu.
Arkusz akceptacji zostaje zamknięty podpisem, ale dopiero po powstaniu egzemplarza
Arkusz akceptacji sporządzony przed pierwszą próbą jest jedynie listą zamierzeń. Sporządzony po jej wykonaniu i na podstawie określonych kryteriów jest jedynym dokumentem, na której można oprzeć odrzucenie lub akceptację partii produkcyjnej. To najczęściej pomijany dokument w programach marek własnych, a przyczyną jego pomijania jest to, że próbka zwykle przechodzi inspekcję. Kupujący, który nie dysponuje podpisanym arkuszem akceptacji, nie ma również egzemplarza referencyjnego, a partia produkcyjna bez egzemplarza referencyjnego jest oceniana na podstawie pamięci kupującego.
Rejestr partii jest dokumentem, którego nikt nie planuje
Rejestr partii — wskazujący egzemplarze, dokumenty, wersje oraz próbkę, względem której zatwierdzono partię — jest generowany przez fabrykę i stanowi dokument umożliwiający zbadanie reklamacji. Jest zarazem najczęściej nieobecny, ponieważ w relacji zakupowej nie jest niczyim zobowiązaniem do dostarczenia. Pytanie jest proste: jakie dokumenty fabryka wydaje wraz z partią i czy identyfikują one egzemplarze względem zaakceptowanej pierwszej próby.
Dokumenty istniejące wyłącznie po uzyskaniu odpowiedzi od dostawcy
Wiele dokumentów w folderze programu istnieje z jednego powodu: katalog nie publikuje informacji, której dotyczą. Nie jest to zarzut wobec katalogu. Jest to specyfikacja, tyle że specyfikacja produktu, a nie programu. Kupujący musi rozpoznać tę różnicę i celowo utworzyć brakujące dokumenty.
Dokument referencyjny i tolerancji. Dla żadnej pozycji nie podano wartości referencyjnej koloru, wykończenia powierzchni ani przedziału tolerancji, w tym dla dwóch pozycji dotyczących kamer, dla których opublikowano nazwy kolorów. Nazwa koloru jest etykietą, natomiast wartość referencyjna jest punktem docelowym, względem którego można dokonać oceny. Dokument ten musi istnieć przed oceną pierwszej próby oraz określać warunki oglądania i metodę porównania, ponieważ bez tych dwóch elementów ocena jest jedynie opinią.
Dokument akceptacji. Dla żadnej pozycji nie opublikowano warunków akceptacji. Warunki te muszą zostać sporządzone przez strony, a ich cztery elementy umożliwiające praktyczne stosowanie to warunki oglądania, metoda porównania, wielkość próbki oraz określona konsekwencja niezgodności.
Decyzja dotycząca listy pakunkowej. Dla pięciu pozycji dotyczących kamer opublikowano pojemność opakowania zbiorczego; kolejne dwie wskazują opakowanie zbiorcze bez podanej pojemności, a cztery nie zawierają żadnego wpisu dotyczącego opakowania zbiorczego. W przypadku tych czterech pozycji kwestia, czy akcesorium stanowi część dostawy, pozostaje otwarta i musi zostać odnotowana na liście pakunkowej, a nie wywnioskowana z nazwy modelu. Ten sam dokument rozstrzyga kwestie etykiety, wkładki i instrukcji, ponieważ wszystkie muszą być zgodne z opakowaniem.
Notatka o wersji radiowej. Dla ośmiu pozycji audio opublikowano wersję radiową, natomiast dla jedenastu pozycji dotyczących kamer nie opublikowano jej. W rezultacie arkusz specyfikacji produktu kamerowego zawiera puste miejsce, które należy zamknąć pisemnie przed przekazaniem arkusza klientowi.
Notatka o dowodach odporności na przenikanie. Dwie pozycje zawierają na swoich stronach oznaczenie IP54, a w rejestrze wewnętrznym wskazano, że jest to oznaczenie wydrukowane na stronie, bez numeru raportu z testu przeprowadzonego przez stronę trzecią. Notatka rejestrująca takie stanowisko zapobiega napisaniu przez zespół marketingowy gwarancji. Zestaw deklarowanych cech i dowody należy oceniać łącznie, ponieważ w przeciwnym razie deklaracja zostanie sporządzona najpierw, a dowody nigdy nie zostaną odnalezione.
Oświadczenie o kompletności dokumentacji technicznej. W katalogu nigdzie nie pojawia się pozycja dotycząca certyfikacji poszczególnych modeli, a CE, FCC i RoHS są w całości nieobecne w tekście katalogu. Oświadczenie potwierdzające, które dokumenty obejmują zamawianą konfigurację oraz jakie zmiany spowodowałyby wyjście egzemplarza poza zakres ich obowiązywania, jest dokumentem, który musi istnieć w ramach programu, ale nie znajduje się w opublikowanym materiale.
Dokument warunków zamówienia. W katalogu nie pojawia się nic ze strony handlowej — nie ma opublikowanego minimum, opublikowanej ceny jednostkowej ani harmonogramu dla żadnego produktu, konfiguracji ani wielkości zamówienia. Oferta jest więc nie odtworzeniem, lecz konstrukcją, którą trzeba powiązać z ustalonym zakresem, ponieważ cena podana dla otwartego zakresu to liczba bez znaczenia.
Jak ocenić zestaw dokumentów przed jego zaakceptowaniem
Kupiec, który otrzymał zestaw dokumentów, może ocenić go w około piętnastu minut. Kryteria warte są przedstawienia, ponieważ przy pierwszym sprawdzeniu zestaw prawie zawsze wygląda na kompletny.
- Czy każdy dokument wskazuje konfigurację? Dokument niewskazujący modelu ani konfiguracji, do której należy, nie można zweryfikować w odniesieniu do egzemplarza, a pierwszym sprawdzeniem, które nie przejdzie, będzie protokół akceptacji.
- Czy każdy dokument ma właściciela i wersję? Dokumentu pozbawionego obu tych elementów nie można aktualizować, więc każda jego zmiana prowadzi do powstania drugiej wersji, a nie nowego wydania.
- Czy każdy z nich ma spisany warunek zamknięcia? Jeżeli jedynym kryterium zamknięcia jest data, dokument zostanie uznany za zakończony niezależnie od tego, czy faktycznie taki jest.
- Czy zestaw zawiera dokumenty, których katalog nie może dostarczyć? Brak opublikowanego wiersza oznacza dokument do napisania, a zestaw, który po cichu go pomija, ma lukę.
- Czy policzono zestawy dla wariantów kolorystycznych i rynków? Jeśli liczby nie zapisano, nie zaplanowano jej.
- Czy uzgodniono zasady wprowadzania zmian w trwającej partii? Jeśli nie, zostaną one wymyślone pod presją, a zasady wymyślane pod presją kosztują najwięcej.
Czerwone flagi są takie same u wszystkich dostawców: plik bez spisu treści, zestaw dokumentów z tym samym właścicielem, oferta przesłana przed zamknięciem zakresu oraz protokół akceptacji, który jest w istocie podsumowaniem marketingowym. Porównanie dwóch zestawów dokumentów nie polega więc na ocenie, który wygląda bardziej profesjonalnie, lecz na ustaleniu, na który kupiec mógłby polegać w razie roszczenia.
O tym, o co i kiedy pytać, decyduje ta sama lista. Poproście jednocześnie o spis treści i protokół akceptacji, ponieważ dostawca, który posiada jeden, prawie zawsze posiada również drugi. Dostawca przeprowadzający należytą due diligence własnej dokumentacji zwróci zestaw z historią wersji; dostawca, który kompletuje dokumenty na żądanie, nie zwróci.

Utrzymanie spójności pliku w trakcie partii produkcyjnej
Spójność to nie porządek. Plik może być kompletny, a mimo to niespójny, a niespójność ujawnia się jako spór, a nie błąd. Po rozpoczęciu produkcji spójność pliku programu utrzymują trzy mechanizmy.
Jeden właściciel na dokument i jeden spis treści
Każdy dokument potrzebuje jednego właściciela, przy czym właścicielem jest osoba, a nie zespół. Spis treści łączący dokumenty powinien zawierać po jednym wpisie dla każdego dokumentu jego wersję, datę i lokalizację oraz powinien być jedynym miejscem, w którym czytelnik szuka informacji. Plik z trzema spisami treści to plik, w którym dwa z nich są błędne.
Spis treści powinien również zawierać informację, do której konfiguracji należy każdy dokument, ponieważ to właśnie to pole najczęściej zawodzi. Plik graficzny w kolorze opracowany dla jednego wariantu kolorystycznego i zastosowany do drugiego to najczęstsza wersja tego błędu, niewidoczna do chwili otwarcia opakowania przed klientem.
Zestawy dla każdego wariantu kolorystycznego i rynku, z wyraźnie podanymi liczbami
Zestaw dokumentacji rozrasta się wraz z liczbą wariantów kolorystycznych i rynków, ale nie wraz z liczbą egzemplarzy. Dwa warianty kolorystyczne na dwóch rynkach oznaczają cztery zestawy etykiet, opakowań, kodów kreskowych, ulotek i dokumentów wysyłkowych. Kupiec, który zaplanował jeden zestaw, zaplanował zaledwie jedną czwartą potrzebnego zakresu. Wyraźne policzenie zestawów na początku to pięciominutowe ćwiczenie zapobiegające opóźnieniu opakowań w ostatnim tygodniu programu.
Zestawy prowadzi się osobno również z drugiego powodu. Zmiana materiału graficznego dla jednego wariantu kolorystycznego nie zmienia drugiego, a jeśli oba warianty zostaną połączone w jednym pliku, zmianę trzeba zastosować do obu albo formalnie wyłączyć z jednego. Rozdzielenie ich sprawia, że decyzja jest jawna, i jest najtańszym sposobem uniknięcia opóźnienia opakowań w ostatnim tygodniu programu.
Zasady wprowadzania zmian w partii, uzgodnione przed jej rozpoczęciem
Reguła uzgodnienia z wyprzedzeniem określa, co się dzieje, gdy dokument ulegnie zmianie po rozpoczęciu produkcji. Decyzja o wstrzymaniu partii, decyzja o kontynuacji produkcji i oznakowaniu affected units oraz decyzja o utylizacji to trzy różne odpowiedzi, o trzech różnych kosztach. Nie powinny być podejmowane w trakcie tygodnia produkcji przez dwie osoby, z których każda zakłada, że drugą sprawą zajmuje się ta druga.
Reguła musi również obejmować punkt graniczny. Zmiana uzgodniona przed rozpoczęciem partii oznacza zmianę zakresu; zmiana uzgodniona po jej rozpoczęciu to odstępstwo wymagające uwzględnienia kosztów i terminu. Traktowanie drugiej zmiany jak pierwszej to sposób, w jaki program traci kontrolę nad własną dokumentacją.

Nasze stanowisko dotyczące dokumentacji programu
W kwestii dokumentacji programu nasze stanowisko jest następujące: dostarczymy dokumenty opisujące to, co robimy, i nie będziemy tworzyć dokumentów opisujących działania, o których nie zostaliśmy poproszeni. Oznacza to pisemny zakres zgodny z Państwa wymaganiami, ofertę sporządzoną na podstawie tego zakresu, arkusz akceptacji dla pierwszej próbnej partii, dokument partii identyfikujący egzemplarze względem zatwierdzonej próbki oraz list pakunkowy uzgodniony z opakowaniem. Oznacza to również, że nie wystawimy certyfikatu, raportu z badań ani deklaracji zgodności, której nie możemy udokumentować, a jasno wskażemy, które z tych dokumentów istnieją, a które nie.
Druga część tego stanowiska dotyczy dokumentacji nabywcy. Jeśli jakieś pytanie nie ma opublikowanej odpowiedzi, odpowiemy na nie pisemnie dla jednego wskazanego modelu i jednej wskazanej konfiguracji oraz powiemy, jaki dokument byłby potrzebny do udzielenia odpowiedzi. Jest to ta sama trójczęściowa struktura stosowana wszędzie w tej branży: co jest opublikowane, co nie jest opublikowane i co pozwoliłoby to rozstrzygnąć. Program, który utrzymuje te trzy elementy oddzielnie w swoim rejestrze, nie będzie spędzał tygodnia poświęconego pierwszej próbnej partii na ustalaniu, która wersja specyfikacji obowiązywała.
Nabywca przeprowadzający due diligence w zakresie praktyk dokumentacyjnych dostawcy powinien poprosić o jeden zwolniony dokument partii z wcześniejszego programu lub o notatkę o zatwierdzeniu projektu graficznego modelu już objętego produkcją. Oba dokumenty są krótkie, konkretne i jaśniej pokazują mechanizm niż jakikolwiek opis procesu.
Standardowa dokumentacja OEM jako dokumentacja robocza
Przedstawiona w formie, którą można przesłać współpracownikowi bez żadnych zastrzeżeń: standardowy program OEM opiera się na dziesięciu dokumentach — briefie wymagań, rejestrze otwartych pytań, pisemnym zakresie, zatwierdzeniu projektu graficznego, arkuszu akceptacji, zestawie roszczeń, pisemnej ofercie, dokument partii, liście pakunkowym i dokumentacji wysyłkowej — a każdy z nich ma jednego właściciela i jeden warunek zamknięcia.
Six z tych dokumentów istnieje wyłącznie dlatego, że katalog nie publikuje danych, które rejestrują: wartości referencyjne i tolerancje, warunki akceptacji, decyzję dotyczącą listy pakunkowej w przypadku pozycji bez opublikowanego wiersza opisu obudowy, wersji radiowej dla produktów z kamerą, dowodów potwierdzających opublikowane oznaczenie odporności na przenikanie oraz warunków handlowych. Katalog jest bogaty w wiersze specyfikacji, lecz milczy na temat danych programu, dlatego zestaw dokumentacji zbudowany w oparciu o ten fakt jest większy, a nie mniejszy niż zestaw przygotowany dla produktu w pełni opublikowanego.
Kryteria zdrowej dokumentacji są na tyle proste, by można je było sprawdzić w dziesięć minut. Każdy dokument ma właściciela i numer wersji. Każdy dokument zamyka się po spełnieniu warunku, a nie w określonym dniu. Indeks zawiera po jednym wpisie dla każdego dokumentu oraz jego konfiguracji. Zestawy wariantów kolorystycznych i rynków są zliczane, a nie zakładane. Regułę dotyczącą zmian w trwającej partii uzgodniono przed rozpoczęciem partii, a nie w jej trakcie.
Aby dowiedzieć się, co powinien rozstrzygnąć dokument znajdujący się na początku dokumentacji i określający jej zakres, zobacz co powinna rozstrzygać wytyczna marki. Aby poznać kolejność dokumentów, zobacz program realizowany od briefu po wysyłkę.
Prześlijcie etap, na którym znajduje się Państwa program, oraz posiadaną dokumentację, a wskażemy, jakie dokumenty nadal brakuje i które z nich musielibyśmy opracować.



