De flesta problemen vid inköp av smarta glasögon är inte tekniska problem. Hårdvaran tillverkas, produktionen är igång, enheterna levereras, och något är fortfarande fel: ett påstående kan inte beläggas, en modellbeteckning stämmer inte med ett dokument, en inspektionstvist saknar referenspunkt, och ingen kan ta fram den dokumentation som skulle ha avgjort ärendet. Luckan är nästan aldrig en saknad maskin. Det är ett saknat dokument.
Den här artikeln handlar om de dokument en köpare bör behålla steg för steg i CYNRINs utvecklingsramverk. Den beskriver vad varje dokument måste avgöra, hur filen bör organiseras så att den överlever en personalförändring eller en revision, och vilka frågor man bör ställa om dokumentationen i sig. Artikeln bygger vidare på översikten över utvecklingsprocessen och kompletterar beskrivningen av design- och prototypsfasen i design- och prototypfasen med det komplementerande inlägget om hur utvecklingen faktiskt bedrivs.
Utvecklingsprocessens dokumentation: steg för steg i dokumentuppsättningen
Ramverket har sex kontrollsteg, och varje steg producerar ett dokument innan det producerar något annat. Ett steg är avslutat när ett dokument finns och är underskrivet, inte när datumet är inne. Det är hela den organiserande principen för filen som ska behållas.
Den fullständiga uppsättningen, i stegordning:
- Requirements frozen — det undertecknade kravdokumentet. Anger målmarknaden, de modeller som omfattas, konfigurationen, förpackningen, leveransdokumentationen och, avgörande, vilka påståenden produkten får göra. Detta är den auktoritativa grunden för hela programmet. Alla senare dokument härställer från det.
- Feasibility reviewed — det skriftliga genomförbarhetssvaret. Om begäran kan byggas och vad det kostar i utvecklings- och verktygsinsats. Resultatet är en avgränsning, inte ett omdöme: vad som är kommersiellt möjligt, vad som kräver utvecklingsinsats och den tidigaste tidpunkt då ett verkligt svar kan lämnas. "Ja" och "nej" är inte användbara svar här.
- Engineering and tooling — verktygsavtalet och firmware-referensen. Verktygsavtalet registrerar vilka verktyg som tas fram, vem som äger dem, vad som händer med verktygskostnaden om projektet stoppas vid det här steget och hur ägandet förändras om det fortsätter. Firmware-referensen identifierar byggnaden, dess version och dess funktionskonfiguration i förhållande till de låsta kraven.
- Samples built and verified — det undertecknade referensprovet och dess verifieringsdokument. Referensprovet är den fysiska referens som definierar vad som är och inte är godtagbart. Verifieringsdokumentet är det skriftliga underlaget som omfattar parkoppling, ljud, laddning, eventuell kamerafunktion och styrbeteende.
- Compliance file closed — försäkran om överensstämmelse och de underliggande rapporterna. Försäkran omfattar den exakta modellbeteckning som ska levereras och vilar på de rapporter som stödjer den samt de marknadsspecifika kraven som gäller. En försäkran som omfattar en produktfamilj i stället för en modell är inte en försäkran för er SKU.
- Pilot run before mass production — inspektionskriterierna och dokumentationen av testproduktionen. Inspektionskriterierna är skrivna utifrån referensprovet. Dokumentationen av testproduktionen visar att en körning med produktionsverktyg, i produktionsvolym, uppfyllde dessa kriterier.
Tillsammans med de här sex stegen kompletteras filen av ytterligare tre poster, som ofta utelämnas eftersom ingen klassificerar dem som resultat från kontrollstegen:
- Godkännanden av artwork och förpackning. Dielinje, tryckoriginal, kartongstruktur, märkning och den godkända masterfilen för artwork. Dessa undertecknas och versionsförsätts eftersom artwork ofta ändras sent, ibland av triviala skäl, och en artworkfil utan versionsinformation hos båda parter garanterar att förpackningen i lagret inte matchar förpackningen på ritningen.
- Loggen över öppna poster och avvikelser. Varje kravrad som har stängts mot en namngiven komponent, varje rad som inte kunde stängas och varje avvikelse från de låsta kraven, med ett godkännande för varje post. Det här dokumentet hindrar att produkten i produktionen tyst avviker från den produkt som undertecknats.
- Ändringsregistret. Alla ändringar av kraven, specifikationen, firmware-byggnaden eller artworket efter att respektive steg har stängts, med datum, skäl, godkännande och vilka nedströmsdokument som utfärdades på nytt på grund av ändringen.
Notera vad som medvetet saknas i listan, och varför. Kapacitetssiffror, ledtider, indikativa scheman, priser, MOQ-nivåer, leveranstider, provkostnader, garantivillkor, certifikatsnummer, fabriksstorlek, personalstyrka och årlig produktion publiceras inte av oss och ingår inte i ramverket dokumentation. Det är inte ett sätt att dölja kommersiella villkor; det beror på att de är offertfarter och avtalsartefakter, inte tekniska dokument. De hör hemma i offerten, beställningen och kontraktet – och när du utvärderar en leverantör bör du begära dem direkt som kommersiella villkor i stället för att förvänta dig att de ska framgå ur en teknisk fil. En leverantör som inte kan lämna MOQ, leveranstid, incotermer och garantivillkor utan att ange reservationer säger dig något om sin kommersiella verksamhet som inget tekniskt dokument kommer att avslöja.
Vad vi producerar vid varje gate är det dokument som gateen är avsedd att skapa, i en form som kan arkiveras och hänvisas till: krav som frysts till ett undertecknat kravdokument, genomförbarhet som granskats till en skriftlig avgränsning, konstruktion och verktyg som ett verktygsavtal och en referens för firmwarebygge, prover som verifierats till en undertecknad referensmodell med verifieringsdokument, överensstämmelse som avslutats med en försäkran avgränsad till modellsträngen samt pilotproduktion som dokumenterats mot skriftliga inspektionskriterier. När en siffra är kommersiell snarare än teknisk hänvisar vi dig till offerten i stället för att placera den i den tekniska filen, så att den tekniska filen förblir läsbar som ett tekniskt dokument.

Vad varje gatedokument måste avgöra
Ett dokuments värde ligger inte i dess längd. Det ligger i om det avgör en fråga som annars skulle avgöras av minnet, av antaganden eller av den person som råkar vara i rummet.
Kravdokumentet avgör vad produkten är. Om det är välskrivet kan det kontrolleras mot en levererad enhet utan att behöva fråga någon. Dess svagaste punkt är vanligtvis avsnittet med påståenden. Köpare skriver rutinmässigt krav kring funktioner och glömmer att skriva ned marknadsföringspåståenden. Sedan upptäcker de under granskningen av överensstämmelse att ett påstående som diskuterats på ett möte aldrig skrivits ned och nu finns på produktsidan. Påståenden måste finnas i kravdokumentet, med ett uttryckligt angivande av vilka påståenden produkten får göra. Ett påstående som diskuterats muntligen men inte skrivits in i de frysta kraven återkommer under granskningen av överensstämmelse, och det återkommer vid den värsta möjliga tidpunkt, eftersom grafisk material, förpackning och levererade enheter då redan är beroende av det.
En relaterad typ av fel är lätt att missa eftersom den ligger inom köparens egen organisation. Kravdokumentet undertecknas ofta av produktägaren, medan ansvaret för överensstämmelse hamnar på någon annan. En produktägare kan specificera en funktion. Endast den person som ansvarar för överensstämmelsefilen kan specificera vad som får sägas om den. När det är två olika personer behöver kravdokumentet ett namngivet avsnitt med påståenden och en signering som omfattar ansvarig för överensstämmelse, inte bara ägaren till funktionslistan. Om den personen aldrig ser dokumentet skrivs listan med påståenden i stället vid gateen för överensstämmelse, när grafisk material godkänns och marknadsföringstexten utarbetas. Resultatet blir antingen en försening eller ett påstående som går ut utan att ha godkänts. Detta är ett av de billigaste problemen i hela processen att åtgärda och ett av de dyraste att åtgärda sent.
Svaret om genomförbarhet avgör vad som är möjligt och vilket det tidigaste svaret skulle vara. Dess användbarhet för en köpare ligger helt i avgränsningarna. Ett svar om genomförbarhet som bara anger ”möjligt” har inte berättat någonting. Det du behöver är uppdelningen: vad som är kommersiella villkor i befintligt skick, vad som kräver teknisk utveckling och vad som inte kan besvaras förrän en specifik undersökning har genomförts. Den tredje kategorin är den som köpare förlorar, eftersom den formuleras som ett datum i stället för ett villkor. Det korrekta sättet att tolka ett svar om genomförbarhet är som en lista med beroenden.
Verktygsavtalet avgör vem som äger verktygen och vad som händer med verktygskostnaden om projektet stoppas. Det är det enskilt mest betydelsefulla dokumentet i filen och det som oftast lämnas outtryckligt. Verktygen är där pengarna går och det är det steg i programmet som är svårast att ångra: när stålet är skuret är geometrin fastställd, och varje enhet som följer byggs efter den geometrin. Tre saker måste finnas i avtalet: vem som har äganderätten till verktygen, vad som händer med verktygskostnaden om projektet avslutas i detta skede och vilken process som gäller om projektet fortsätter. Om svaret på någon av dem är ”det diskuterar vi senare”, blir det då det dyrt.
Referensen för firmwarebygget avgör vilken programvara som produkten kör. En byggidentifierare, dess version och dess funktionskonfiguration, uttryckta mot den låsta kravspecifikationen så att alla kan se vad som är aktiverat, vad som är inaktiverat och vilka standardinställningarna är. Utan den är firmwaren inte ett objekt som kan hållas — det är ett tillstånd som fanns på en arbetsbänk, och nästa samtal om en defekt blir en diskussion om vilken version som kördes.
Referensprovet och dess verifieringsdokument avgör vad som anses vara godtagbart. Referensprovet är den fysiska referensen; dokumentet gör den användbar eftersom det registrerar utgångsläget i skriven form: parkopplingsbeteende, ljudutgång och kanalbeteende, laddningsbeteende och indikering, eventuell kamerafunktion och dess styrbeteende samt den observerbara kosmetiska utgångspunkten. Dokumentet ska också ange förvaringsarrangemanget — var enheten lagras, vem som har åtkomst och i vilket skick den måste vara för att fortsätta vara en giltig referens. Ett referensprov som har legat i en varm bil är inte längre en referens, och ingen kommer att berätta det för dig.
Försäkran om överensstämmelse och rapporterna bakom den avgör vad du får påstå och på vilken marknad. Försäkran måste omfatta exakt den modellbeteckning som ska levereras. En försäkran som täcker en produktfamilj i stället för en modell är inte en försäkran för din SKU, och detta är den mest avgörande skillnaden i hela underlaget, eftersom modellbeteckningen förekommer på produkten, i dokumentationen, i transporten och i din produktsida. Om din katalog innehåller fler än en modell som härletts från samma plattform behöver varje levererad modellbeteckning ha en egen täckning. Om leverantören erbjuder en familjförsäkran och du avser att leverera tre SKU:er, fråga vilken av de tre beteckningarna som omfattas.
Vi tillhandahåller försäkran med exakt avgränsning för modellbeteckningen, tillsammans med de rapporter den vilar på och de marknadsspecifika krav den behandlar, och vi anger tydligt vilka marknader en viss försäkran inte täcker. Den sista delen är viktig: ett dokument som anger vad det inte täcker är mycket mer användbart för en köpare än ett som anger vad det täcker, eftersom en köpare som ställer den andra frågan ändå får svaret på den första.
Inspektionskriterierna och dokumentationen av pilotkörningen avgör vad ett parti får innehålla och om partiet godkändes. Inspektionskriterierna är skrivna punkt för punkt mot referensprovet, så att två olika inspektörer på två olika produktionslinjer kan fatta samma bedömning. Dokumentationen av pilotkörningen är beläget för att en körning med produktionsverktyg och i produktionsvolym har inspekterats mot dessa kriterier och godkänts. Här upptäcks utbyten: ingenjörsprov avslöjar aldrig en ändrad komponentleverans eller en processavvikelse, eftersom de byggs för hand med rätt komponent på rätt plats. En pilotkörning gör det.
Godkännandena av artwork och förpackning avgör hur förpackningen ser ut. Ritlinje, artwork, kartong, märkning och den versionsstyrda huvudfilen. Förpackningsgodkännanden är en vanlig orsak till sena och dyra ändringar, just därför att de betraktas som triviala och därför lämnas utan versionshantering.

Hur underlaget är organiserat
Ett komplett men oanvändbart dokumentpaket är mindre värt än ett mindre paket som någon faktiskt kan navigera i. Tre regler gör skillnaden mellan ett underlag och en trave papper.
Organisera efter gate, inte efter datum eller dokumenttyp. Varje gate får en mapp. Inuti den samlas gateens dokument tillsammans med gateens stödbevis. En datumbaserad struktur tvingar läsaren att rekonstruera vilken gate ett dokument hörde till, och den rekonstruktionen är precis det arbete du försöker eliminera. En typbaserad struktur — alla specifikationer här, alla rapporter där — sprider en gates bevis över fyra mappar och gör gateens gränser osynliga.
Varje dokument har en identifierare, en version och ett datum, och varje korshänvisning anger identifieraren. Inte filnamnet, inte datumet, identifieraren. Ett kravdokument som anger ”per firmware build 2.3.1” och en firmwarereferens som anger ”per requirement CY-RQ-001” kan stämmas av på några sekunder. Två dokument som båda anger ”den senaste versionen” kan inte stämmas av alls.
Varje dokument har ett godkännande. Namn, roll, datum och vad som godkändes. Ett dokument utan godkännande är ett utkast som råkar ha skickats, och efter några månader när folk har flyttat vidare går det inte längre att rekonstruera den skillnaden.
Det finns ytterligare en konvention som snabbt betalar sig, och det är den vi följer i varje projektfil som vi levererar: en kort indexering i filens rot, en rad per dokument, som visar identifierare, titel, version, datum och vilket steg den tillhör. Det tar en timme att underhålla och förvandlar filen från något som en person måste navigera i till något som en person kan söka i. Revisorer, mottagande chefer och kunder läser alltid indexeringen först.
En fungerande struktur ser ut så här:
- Steg 1 — Krav. Det undertecknade kravdokumentet, kravlistan, godkännandena och briefen för grafisk design om sådan beställdes i detta steg.
- Steg 2 — Genomförbarhet. Bedömningen av genomförbarhet med sina tre gränsdragningskategorier, listan över beroenden och de beslut som fattats.
- Steg 3 — Konstruktion och verktyg. Verktygsavtalet, den konstruktionsbara specifikationen, firmware-referensen, loggen över öppna punkter med deras avslut och avvikelseloggen.
- Steg 4 — Prover. Den undertecknade dokumentationen av godkänt referensprov, verifieringsdokumentet, custody-arrangemanget samt prototypernas godkänningsvillkor och underlag.
- Steg 5 — Överensstämmelse. Försäkran om överensstämmelse för varje modellsträng som ska skickas, de underliggande rapporterna och bedömningen av marknadens tillämplighet.
- Steg 6 — Pilotkörning. Inspektionskriterierna, pilotkörningsdokumentationen, iakttagelserna och åtgärderna samt beslutet om release.
- Övergripande. Ändringsdokumentationen, korrespondensloggen och den kommersiella filen — offert, beställning och de överenskomna kommersiella villkoren, såsom MOQ, ledtid, incoterms, garanti och reservdelar.
Det finns två ytterligare praktiska synpunkter på hur detta ska hållas användbart. För det första ska filen förvaras på en plats som inte är en enskild persons postkast eller bärbara dator, eftersom filens värde ligger just i att den överlever den person som sammanställde den. För det andra ska underlaget finnas på samma plats som det krav det belägger. En försäkran som är separerad från de rapporter som ligger bakom den är en försäkran som inte går att försvara när någon frågar varför.
En tredje punkt gäller de fysiska föremålen i filen, vilka lätt glöms bort när allt annat är digitalt. Referensprovet är ett fysiskt föremål med juridisk funktion och kräver en namngiven förvaringsansvarig, en förvaringsplats och en konditionskontroll med den regelbundenhet som ert kvalitetssystem redan använder för kalibrering eller referenstillgångar. Detsamma gäller den kvarvarande andra enheten från pilotkörningen, som ofta är den mest användbara jämförelseenhet ni någonsin kommer att ha, eftersom den kommer från en verklig produktionslinje och inte från en testbänk. När ni behåller en produktionsenhet som referens ska ni dokumentera vilken modellsträng och vilken firmware-build den hade, eftersom en referensenhet utan dessa identifierare inte kan matchas mot något.
Det finns också leverantörer som inte arbetar på detta sätt. Vissa verkstäder producerar verkligen inga dokument, och deras resultat är bra. Det är en legitim arbetsmetod, men det är en risk som bör prissas som en risk och inte upptäckas i efterhand. Det praktiska testet är inte om leverantören har en dokumentationsavdelning, utan om ni kan få fram de underlag som behövs för att försvara en leverans till en kund eller en inspektör. Om svaret är att underlaget finns men ingen har skrivit ner det, ska ni begära att det sammanställs som ett villkor för fortsatt samarbete, och förstå att detta är konstruktionsarbete med en kostnad. Om svaret är att underlaget inte finns kan projektet inte avsluta sitt steg för överensstämmelse på det sätt ni avser, och ni bör veta det innan investeringar i verktyg görs, inte efteråt.
Och testet av organisationen är enkelt nog att tillämpa när som helst: välj godtyckligt ett dokument och fråga vad det reglerar och vad annat som är beroende av det. Om svaret tar mer än en minut har strukturen misslyckats.

Frågor att ställa om dokumentpaketet
Dokumentation är vanligtvis inte kontroversiell i början av ett projekt. Den blir kontroversiell när det kommersiella trycket är som störst, vanligtvis nära pilotkörningen, och den blir dyrare när den saknas vid en tull- eller marknadskontroll. Detta är de frågor som är värda att ställa, och ordningen spelar mindre roll än att frågorna ställs innan trycket kommer.
- Kan vi få hela dokumentpaketet, gate för gate, i dess nuvarande form? En leverantör med en fungerande process producerar detta utan ansträngning. En leverantör utan process kommer att hitta på att det tar tid, och skälet till det är svaret.
- Finns det ett undertecknat kravdokument, och anger det vilka påståenden produkten får göra? Inte funktionerna – påståendena. Om det saknas ett avsnitt om påståenden är det den luckan som behöver åtgärdas nu, när det fortfarande är enkelt att ändra.
- Vilken modellsträng står exakt på deklarationen? Be om strängen och jämför den tecken för tecken med modellsträngen som kommer att finnas på produkten och i dokumentationen. Be om varje SKU separat, inte plattformen.
- Vem äger verktygen, och vad händer med verktygskostnaden om vi avbryter här? Tre frågor i en: ägande, kostnadsbehandling och fortsättningsprocess. Svaret ska finnas i ett undertecknat avtal, inte i ett mejl.
- Vilken identifierare har firmware-versionen, och hur är dess funktionskonfiguration? Be om något som kan kontrolleras mot kraven, inte bara ett versionsnummer.
- Vad täcker dokumentationen för verifieringen av referensexemplaret egentligen? Den bör täcka parkoppling, ljud, laddning, eventuella kamerafunktioner och styrbeteende, med uppmätta resultat i stället för ett godkänt resultat.
- Var förvaras referensexemplaret, och vem har ansvar för det? En referensenhet i en transportkartong i ett varmt lager är inte en referensenhet.
- Vilka är inspektionskriterierna, och skrevs de utifrån referensexemplaret? Kriterier som skrivs utifrån en ritning skiljer sig från kriterier som skrivs utifrån en enhet, och endast det sistnämnda upptäcker avvikelser i tillverkningen.
- Vilken version av grafiken är godkänd, och är den versionsstyrd och undertecknad? Be om referensen till originalfilen för grafiken, inte en beskrivning av den.
- Vilka ändringar gjordes efter att deras gate stängdes, och utfärdades dokumenten nedströms på nytt? Ändringsdokumentationen avslöjar avdrift. En leverantör med en disciplinerad process kan besvara frågan på några minuter.
- Vad är inte publicerat, och vad ska vi i stället begära? Be om MOQ, ledtid, incoterms, garanti, provkostnader och villkor för reservdelar som kommersiella villkor i en offert. Be om certifieringsbevis för varje modellsträng. När något verkligen inte är tillgängligt, fråga vad leverantören behöver från oss för att kunna ta fram det.
- Kan en ny person på vår sida ta över den här filen och förstå den? Det ärliga sättet att pröva detta är att utse någon som aldrig har sett projektet och be dem att besvara en fråga utifrån filen.
Det finns två beteenden hos leverantören som är värda att lyfta fram som goda, eftersom de är mer sällsynta än de borde vara. Det första är att tillhandahålla listan med öppna frågor även när det är obehagligt, vilket visar att ingenjörsarbetet görs mot kraven och inte mot en berättelse om försäljning. Det andra är att uttryckligen avgränsa en deklaration till en enda modellsträng i stället för att låta den omfatta en produktfamilj, även när det skulle ha varit bekvämt.
Vad vi kommer att göra på vår sida är att behandla dokumentpaketet som en del av leveransen och inte som intern administration: varje gate producerar sitt dokument innan den producerar sin hårdvara, dokumenten har identifierare och versioner och hänvisar till varandra via identifierare, och compliance-gaten stängs mot exakt den modellsträng som levereras. Om en fråga i något skede inte kan besvaras utifrån filen är det korrekta svaret att säga det och ta fram det saknade dokumentet, inte att svara muntligt och lämna filen ofullständig.
Et påstående som diskuteras på ett möte men inte skrivs ner återkommer vid compliance-granskningen. En deklaration som täcker en familj i stället för en modell täcker inte din SKU. De här två meningarna är skälet till att den här filen är värd att behålla. Allt annat i paketet är administrativt; de två påståendena är de som kan kosta dig en marknadsintroduktion.
Se översikten över utvecklingsprocessen för det vidare förloppet och hur gateerna förhåller sig till varandra. Se kvalitetsgates i utvecklingsprocessen för kvalitetsgates och vad var och en är avsedd att förhindra. Se checklistan för certifiering och compliance för vad som ska verifieras innan en leverans godkänns utifrån den här filen.



