智能眼镜 OEM/ODM 制造商 · 中国深圳 +86 19835872450 sales@cynrin.com
OEM 与 ODM

值得留存的产品开发流程文档

大多数智能眼镜采购问题并非工程问题。硬件造好了,产线也开动了,产品到货后却仍有问题:……

由 CYNRIN 工程与采购团队提供/ Jul 7, 2020/ 3 分钟阅读
值得留存的产品开发流程文档

智能眼镜采购中的大多数问题并不是工程问题。硬件造好了,产线跑起来了,设备也到货了,但问题依然存在:某项宣传无法证实,型号字符串与文件不一致,检验争议没有判定依据,而且没人能拿出本应据此解决争议的记录。差距几乎从来不是缺少设备,而是缺少文件。

本文介绍在 CYNRIN 开发框架中,采购方应逐个关口留存的文件资料。本文说明每份文件必须解决什么问题,如何整理归档以应对人员变动或审核,以及针对文件资料本身应提出哪些问题。本文承接开发流程概览,并对设计与样机阶段的说明加以补充,同时与开发实际如何推进的专题文章相配合。

开发流程文件:逐关口的文件资料

该框架设有六个关口,每个关口都要先形成一份文件,之后才能产出其他成果。关口的完成标准是文件已经形成并签署,而不是日期到了。这就是整理归档文件的全部原则。

完整文件资料按关口顺序如下:

  1. 需求冻结——已签署的需求文件。明确目标市场、适用型号、配置、包装、交付文件资料,以及最关键的一点:产品获准作出哪些宣传。这是整个项目的权威依据。之后所有文件都由此延伸而来。
  2. 可行性评审——书面可行性答复。说明需求能否实现,以及在工程和模具方面需要多少成本。其输出是一条边界,而不是最终结论:商业上可行的事项、需要投入工程资源的部分,以及能够给出切实答复的最早日期。“可以”和“不可以”在这里都不是有用的答复。
  3. 工程与模具——模具协议及固件构建基准。模具协议记录要开制的模具、模具所有权归属、如果项目在此阶段终止时模具成本如何处理,以及项目继续推进时所有权如何变更。固件构建基准明确构建版本,并说明其相对冻结需求的功能配置。
  4. 样品制作与验证——已签署的黄金样机及其验证记录。黄金样机是界定合格与不合格的实物基准。验证记录是书面证据,涵盖配对、音频、充电、任何摄像头功能以及控制表现。
  5. 合规文件归档完成——符合性声明及底层报告。符合性声明涵盖实际出货的准确型号字符串,并置于支持该声明的报告及适用市场要求之上。涵盖产品系列而非具体型号的声明,不能作为你这个 SKU 的声明。
  6. 量产前试产——检验标准及试产记录。检验标准以黄金样机为依据编写。试产记录证明使用量产模具、按照量产数量进行的生产已通过这些标准。

六个关口对应的开发流程文件资料

逐关口的文件资料及各关口产出的成果

除上述六份文件外,还有三项资料可补全整套档案。它们经常被遗漏,因为没有人将其归类为关口产出:

  1. 美术设计文件及包装审批文件。包括刀模图、印刷稿、纸箱结构、标签以及经批准的主文件。之所以需要签署并管理版本,是因为美术设计文件往往到后期仍会变更,理由可能只是一些微不足道的小事;如果双方都只留有未管理版本的美术设计文件,就必然会导致仓库里的包装与图纸上的包装不一致。
  2. 未结项及偏差记录。记录每一条已指定部件并关闭的需求项、每一条无法关闭的需求项,以及相对于冻结需求的每项偏差,并逐一取得批准。这份文件能够防止产线上的产品悄然偏离已签署的产品。
  3. 变更记录。记录相应关口关闭后对需求、规格、固件构建或美术设计文件作出的任何变更,并注明日期、原因、审批情况以及因此重新签发的下游文件。

请注意该清单中刻意未包含的内容及其原因。容量数据、阶段耗时、参考进度安排、价格、MOQ、交期、样品费用、保修条款、证书编号、工厂规模、员工人数和年产量均不由我们公布,也不属于本框架的文档集。这并非是在刻意隐瞒商务条款,而是因为这些内容属于报价和协议材料,而非工程记录。它们应出现在报价单、采购订单和合同中——如果您正在评估供应商,应将其作为商务条款直接向对方索取,而不要指望从技术文件中获得。供应商如果无法明确报出MOQ、交期、贸易术语和保修条款,就等于在向您说明其商务运营情况中的某些问题,而这些问题是任何工程文件都无法揭示的。

我们在每个关卡产出的,都是该关卡本应形成的文件,并确保其形式适合归档和引用:需求以签署的需求文档形式冻结,可行性以书面边界形式评审,工程与模具以模具协议和固件构建参考形式确认,样品以签署的黄金样机及其验证记录形式确认,合规性以针对具体型号字符串的声明形式完成闭环,试产则依据书面检验标准形成记录。凡属于商务而非技术范畴的数据,我们都会指向报价单,而不会将其放入工程文件,从而让工程文件始终作为清晰的工程记录保存。

用于说明开发流程文档留存要点的AI生成照片——图1,共3张

各关卡文件必须明确解决的问题

文件的价值不在于篇幅,而在于它是否明确了原本会凭记忆、凭假设,或由当时恰好在场的人随口决定的问题。

需求文档明确产品是什么。如果编写得当,无须询问任何人即可将其与交付实物进行核对。其中通常最薄弱的是宣传声明部分。采购人员经常围绕功能编写需求,却忘记记录营销声明,随后在合规评审时才发现,会上讨论过的某项声明从未被书面记录,如今却已出现在产品页面上。所有声明都必须写入需求文档,并明确说明产品获准使用哪些声明。凡仅口头讨论、却未写入冻结版需求的声明,都会在合规评审阶段重新浮现,而且往往在最糟糕的时机出现,因为此时设计稿、包装和已发货产品都已依赖这些声明。

还有一种相关问题很容易被忽略,因为它就藏在采购方自己的组织内部。需求文档通常由产品负责人签署,而合规义务却落在另一个人身上。产品负责人可以规定某项功能,但只有合规文件负责人才能规定可以对该功能作出哪些声明。如果由两个人分别承担这两项职责,需求文档就必须设有明确署名的声明章节,并且签署环节不仅要包括功能清单负责人,还必须包括合规负责人。如果负责合规的人从未看过该文档,声明清单就会拖到合规关卡才编写,届时设计稿已获批准、营销文案也已起草,最终结果不是延期,就是未经审核便发布声明。这是整个流程中成本最低就能解决的问题之一,也是发现问题过晚后修复代价最高的问题之一。

可行性答复明确哪些内容可行,以及最早何时能得到答复。它对采购方有多大价值,完全取决于其边界是否清楚。一份只说“可行”却再无其他内容的可行性答复,等于没有提供任何信息。您真正需要的是明确区分:哪些内容可以按现有条件直接实现,哪些需要工程开发,哪些必须完成某项具体调查后才能答复。采购方最容易忽略的正是第三类,因为这类内容往往被表述为一个日期,而不是一个前置条件。阅读可行性答复的正确方式,是将其视为一份依赖事项清单。

模具协议明确模具归谁所有,以及项目中止时模具成本如何处理。这是整个文件中后果最重大的文件,也是最常被默认忽略的文件。模具是资金投入所在,也是项目中最难逆转的环节:钢材一旦开模,几何结构便已固定,此后生产的每一件产品都会按照该几何结构制造。协议中必须明确三点:模具所有权归谁,如果项目在此阶段终止如何处理模具成本,以及如果项目继续推进应遵循什么流程。如果其中任何一项的答复是“我们以后再讨论”,那么真正付出高昂代价的时候,就是“以后”。

固件构建参考记录确定了产品运行的是哪套软件。它记录构建标识、版本及功能配置,并针对已冻结的需求进行表述,让任何人都能看清哪些功能已启用、哪些已禁用,以及默认设置是什么。没有它,固件就不是一个可以保存的对象——它只是曾经存在于测试台上的一种状态;下次讨论缺陷时,就会变成对当时运行的是哪个版本的争论。

黄金样本及其验证记录确定了何为可接受。黄金样本是实物基准;记录则让基准得以使用,因为记录以书面形式固化了基线:配对行为、音频输出及声道表现、充电行为与充电指示、任何摄像头功能及其控制行为,以及可观察的外观基线。记录还应说明样品保管安排——存放位置、接触权限,以及样品必须保持何种状态才能继续作为有效基准。曾被放在高温车辆中的黄金样本已不再是基准,而且不会有人提醒你这一点。

符合性声明及其所依据的报告确定了你可以提出哪些声明,以及可以在哪些市场提出。声明必须涵盖实际发货时使用的准确型号字符串。涵盖产品系列而非某一具体型号的声明,不能作为你这款 SKU 的声明。这是整个文件体系中影响最重大的区别,因为型号字符串会出现在产品上、文件中、货运单以及商品listing中。如果你的目录中有多个型号源自同一平台,每个出货型号字符串都需要单独的覆盖证明。如果供应商提供的是系列声明,而你计划出货三个 SKU,请询问声明上写的是这三个型号字符串中的哪一个。

我们将提供针对准确型号字符串的声明、其所依据的报告、所对应的市场特定要求,并明确说明某份声明未涵盖哪些市场。最后这一点很重要:一份清楚说明自己不涵盖什么的文件,对买家而言远比一份只说明自己涵盖什么的文件有用,因为当买家提出后一个问题时,得到的本来就是前一个问题的答案。

检验标准及试产记录确定了一批货允许包含哪些产品,以及该批次是否通过检验。检验标准参照黄金样本逐项编写,确保不同产线上的两名不同检验员也能得出相同结论。试产记录证明使用生产工装、按生产数量完成的一次试产已依据这些标准接受检验并通过。物料替换正是在这一环节被发现:工程样机永远无法揭示供应来源变更或工艺波动,因为工程样机是手工打造的,每个零件都放在正确位置。试产则不然。

图稿及包装审批记录确定了包装的形式。刀模线图、图稿、纸箱、标签以及带版本的主文件。包装审批之所以经常导致后期出现代价高昂的变更,正是因为它们被视为小事,因而没有进行版本管理。

留存文件体系的各层级及其相互引用关系

各关卡的文件完整性检查清单

用于展示开发流程文件留存工作的 AI 生成照片 — 第 2 张,共 3 张

文件体系的组织方式

一套完整但无法使用的文件,其价值远低于一套规模更小、但有人真正能够浏览的文件。遵循以下三条规则,即可让文件体系与一堆杂乱文件拉开差距。

按关卡组织,而不是按日期或文件类型组织。每个关卡对应一个文件夹。文件夹内,该关卡的文件与其支持证据放在一起。基于日期的结构会迫使读者推断某份文件属于哪个关卡,而这种推断恰恰是你想消除的工作。基于类型的结构——规格文件全部放这里,报告全部放那里——会把同一关卡的证据分散到四个文件夹中,使关卡边界变得模糊不清。

每份文件都有标识、版本和日期,每处交叉引用都注明标识。是标识,不是文件名,也不是日期。一份写着“参见固件构建 2.3.1”的需求文件,与一份写着“参见需求 CY-RQ-001”的固件参考记录,可以在几秒内核对一致。两份都写着“最新版本”的文件则根本无法核对。

每份文件都有审批记录。注明审批人姓名、职务、日期及审批内容。没有审批记录的文件只是碰巧被发出去的草稿。几个月后人员发生变动,就再也无法还原这一区别了。

还有一种惯例能迅速收回成本,而且我们将把它应用于我们提供的每个项目文件:在文件根目录设置一份简短索引,每份文档占一行,注明标识符、标题、版本、日期及其所属关口。维护这份索引只需一小时,却能让文件从需要人工查找,变为可以随时搜索。审核人员、接手管理人员和客户都会先查看索引。

一套实用的结构如下:

  1. 关口1——需求。 已签署的需求文件、声明清单、审批记录;如果此阶段要求提供 artwork,还应包括 artwork 需求说明。
  2. 关口2——可行性。 包含三类边界条件的可行性答复、依赖项清单以及已作出的决策。
  3. 关口3——工程设计与工装。 工装协议、可制造规格、固件构建参考、待办事项日志及其关闭记录,以及偏差日志。
  4. 关口4——样品。 已签署的黄金样记录、验证记录、保管安排,以及样机验收条件与证据。
  5. 关口5——合规性。 每个发货型号字符串对应的符合性声明、支撑该声明的报告,以及市场适用性说明。
  6. 关口6——试产。 检验标准、试产记录、发现的问题及处置措施,以及放行决定。
  7. 跨关口。 变更记录、往来函件日志,以及商务文件——报价、采购订单,以及约定的商务条款,如 MOQ、交期、贸易术语、质保和备件。

要确保文件切实可用,还需注意两个实用要点。第一,不要把文件放在某个人的邮箱或笔记本电脑里,因为这份文件的价值恰恰在于,整理它的人离职后,文件仍能保留下来。第二,应将证据与相应声明放在同一位置。声明如果与其支撑报告分离,当有人追问原因时,你就无法为其辩护。

第三点涉及文件中的实物实体;在其他一切都已经数字化的情况下,这些实物很容易被遗忘。黄金样是具有法律效力的实物,需要指定保管人、存放位置,并按照质量体系中用于校准或参考资产的规定频率进行状态检查。试产时留存的第二台设备也同样如此。它通常会成为你拥有过的最有用的比对设备,因为它来自真实产线,而不是实验台。如果为参考用途留存生产设备,请记录其型号字符串和固件版本,因为缺少这些标识符的参考设备将无法与任何其他对象匹配。

有些供应商并不采用这种工作方式。有些工厂确实不编制文件,而且其产出质量良好。这是一种合理的运营模式,但你应当将其作为风险计入成本,而不是等到日后才发现。实用的判断标准不是供应商是否设有文档部门,而是你能否取得必要的证据,以便为向客户或检查员交付的货物进行辩护。如果答案是证据存在但无人记录,就把补齐文件作为继续合作的条件,并且要理解,编制这些文件是一项有成本的工作。如果答案是证据根本不存在,那么该项目就无法按照你的预期通过合规性关口;你应当在投入工装之前,而不是之后,了解到这一点。

判断组织是否合理的方法也很简单,任何时候都能适用:随机选取一份文件,问问它解决了什么问题,还有哪些事项依赖它。如果回答这个问题需要超过一分钟,说明文件结构已经失效。

AI-generated photograph illustrating development process documentation you should hold onto — image 3 of 3

关于文件资料集需要提出的问题

项目初期的文件工作通常不会引发争议。到了商业压力最大的时候,通常是在试产阶段附近,文件问题才会成为争议焦点;而在海关检查或市场准入检查时,文件一旦缺失,代价就会非常高。以下这些问题值得提出。相比于提出问题的顺序,更重要的是在压力到来之前就把这些问题问清楚。

  1. 我们能否按当前状态逐关卡获取整套文件?已有成熟流程的供应商无需费力即可做到。没有流程的供应商则会找出各种理由来解释为何需要时间,而这个理由本身就是答案。
  2. 是否有已签署的需求文件,其中是否列明产品允许使用的产品声明?不是功能——而是产品声明。如果没有产品声明章节,这就是现在需要补齐的缺口,而且此时修改的成本最低。
  3. 声明文件上的型号字符串究竟是什么?索取具体字符串,并逐字符与将出现在产品和文件上的型号字符串进行比对。每个SKU都要单独询问,不能只问平台型号。
  4. 模具归谁所有?如果我们在此阶段停止,模具费用如何处理?一个问题涵盖三个方面:所有权、费用处理以及后续流程。答案应写入已签署的协议,而不是通过邮件确认。
  5. 固件构建标识及其功能配置是什么?索取可用于对照需求进行核验的信息,而不只是版本号。
  6. 黄金样机验证记录实际涵盖哪些内容?应涵盖配对、音频、充电、所有摄像头功能以及控制行为,并记录实测结果,而不只是给出合格判定。
  7. 黄金样机存放在哪里,由谁保管?放在炎热仓库运输纸箱里的参考机,不能算真正的参考机。
  8. 检验标准是什么,是否依据黄金样机制定?依据图纸制定的标准与依据实物制定的标准不同,只有后者能够发现生产偏差。
  9. 哪个图稿版本已获批准,是否有版本标识并经过签署?索取最终图稿文件引用,而不是对文件的描述。
  10. 其关卡关闭后做了哪些更改,下游文件是否重新签发?变更记录是揭示文件偏离情况的关键文件。流程严谨的供应商几分钟内就能回答这个问题。
  11. 哪些内容尚未公开,我们应该改为索取什么?要求以报价形式提供MOQ、交期、贸易术语、保修、样品费用和备件条款等商务条款。按型号字符串索取认证证明。对于确实无法提供的内容,应询问供应商需要我们提供什么才能出具相关文件。
  12. 我们这边新加入的人能否接手这套文件并理解其中内容?最真实的测试方式是指定一位从未接触过该项目的人,让他根据文件回答一个问题。

供应商方面的两种做法值得明确称为优秀,因为它们远比现实中常见。第一,即使未结事项清单令人难以接受,仍愿意提供,这表明工程工作是基于需求推进,而不是围绕销售话术展开。第二,明确将声明限定至一个型号字符串,而不是将其套用于整个产品系列,即便后者会方便很多。

我们这边会把整套文件视为交付物的一部分,而非内部资料:每个关卡都要先产出相应文件,再生产硬件;文件应带有唯一标识和版本,并通过标识相互引用;合规关卡必须依据实际出货的准确型号字符串关闭。如果任何阶段的问题都无法通过文件回答,正确做法是如实说明并补齐缺失文件,而不是只在口头答复,却让文件保持不完整。

会议中讨论过却未记录在案的产品声明,到了合规审查时还会重新出现。覆盖整个产品系列而非具体型号的声明,也无法覆盖你的SKU。正是这两句话说明这套文件值得保留。文件中其他内容都只是行政事务,而这两点却可能让你失去市场准入资格。

有关更完整的流程顺序及关卡之间的关系,请参阅开发流程概览。有关质量关卡及各自旨在防范的问题,请参阅开发流程质量关卡。有关依据这套文件接受货物前需要核验的事项,请参阅认证与合规检查清单。

在 WhatsApp 上聊天
您在此网站上的体验将通过允许 cookies 得到改善。