第2章:状态命名规范 – 命名规则、缩写标准、版本后缀

1. 适用场景

本章规范适用于以下三类场景:

  • 原型状态定义:当产品经理首次为 IoT 硬件原型创建状态标识时,需要按照统一规则命名,确保跨团队(硬件、固件、测试、产品)无歧义。
  • 状态变更通知:原型从“设计验证”进入“工程验证”或“小批量试产”时,命名中的版本后缀必须同步更新,以便追溯。
  • 多源协同开发:当多个供应商或内部团队并行开发同一原型的不同模块时,缩写标准可防止状态字段混乱。

2. 前置条件

  • 已确定原型的产品代号(如 SMART-SENSOR-V2)。
  • 已明确当前所处的研发阶段(EVT/DVT/PVT/MP)。
  • 团队已约定缩写词典,确保每个缩写有唯一释义。
  • 版本管理工具(如 Git、SVN 或 PLM 系统)已就绪,可记录命名历史。

3. 操作步骤

  1. 确定产品代号:从产品路线图中提取唯一代号,例如 SMART-LOCK-G3。
  2. 选择状态前缀:根据原型当前所处的里程碑,从缩写标准表中选取对应的英文缩写(见表1)。
  3. 附加版本号:采用主版本.次版本.修订号格式,其中主版本对应重大重构,次版本对应功能增减,修订号对应缺陷修复。
  4. 拼接完整状态名:按顺序组合为 产品代号_状态前缀_版本号,例如 SMART-LOCK-G3_EVT_1.2.0。
  5. 登记与公示:将最终状态名写入《原型状态登记表》,并通过项目协同工具周知所有干系人。
关键检查点:每次状态变更必须同时更新登记表和版本后缀,禁止仅口头通知。

4. 输入输出物

类型 名称 描述 模板/示例
输入 产品代号表 由产品线维护的代号清单,包含产品全称、代号、代际 SMART-SENSOR-V2
输入 缩写词典 团队约定的状态缩写与中文释义对照表 EVT → 工程验证测试
输出 原型状态命名登记表 记录每个原型的历史状态名、变更人、时间戳 SMART-LOCK-G3_EVT_1.2.0
输出 状态命名公告 通过项目管理工具发送的通知,含新旧状态名对比 邮件/飞书/钉钉消息

5. 责任边界

  • 产品经理:负责维护产品代号表,批准缩写词典的增删改。
  • 项目经理:监督状态命名流程的执行,确保每个节点都有记录。
  • 开发/测试负责人:根据实际进展提议状态变更,并验证命名与实物状态一致。
  • 配置管理员:在版本管理系统中创建标签时,必须使用经过审批的完整状态名。

6. 记录材料

  • 《原型状态登记表》(Excel 或在线表格):包含字段:产品代号、状态前缀、版本号、变更人、变更日期、审批人。
  • 《缩写词典》(共享文档):列出所有允许使用的缩写及其全称、适用范围、启用日期。
  • 状态命名公告记录:消息截图或系统日志,留存至少一个项目迭代周期。

7. 异常处理

异常场景 处理措施 输出物
缩写冲突(同一缩写被不同团队定义为不同含义) 由产品经理召集仲裁会议,重新定义唯一缩写,并更新缩写词典 缩写词典更新记录
版本后缀遗漏或格式错误 退回命名申请,要求提交人补充正确的版本号后再走审批 状态修正通知
产品代号已废弃但仍被使用 立即停止该命名,改用最新产品代号,并在登记表中标注废弃代号的有效期 代号废弃公告
同一原型出现多个不同状态名 以版本管理系统中打 tag 的状态名为准,其他状态名一律作废并归档 状态名统一确认单

8. 验收标准

  1. 命名完整性:所有 IoT 原型的状态名必须同时包含产品代号、状态前缀、版本号,缺一不可。
  2. 缩写合规性:状态前缀必须来自当前有效版本的《缩写词典》,禁止使用自造缩写。
  3. 版本可追溯:每个状态名对应的版本号能在版本管理系统中找到匹配的 tag 或 commit。
  4. 登记及时性:状态变更发生后 2 个工作日内,登记表必须完成更新,且公告已发出。
  5. 一致性校验:随机抽查 5 个原型,其状态名与实物状态、登记表、版本 tag 三者完全一致。
常见返工原因:缩写风格不统一(大小写混用)、版本号缺少修订位、产品代号中带空格或特殊字符。验收时会对这三项做硬性检查。

状态命名规范结构图

状态命名规范结构图 完整状态名 产品代号 状态前缀 版本后缀 产品线代码 代际标识 EVT DVT PVT 主版本 次版本 修订 合成示例:SMART-LOCK-G3_EVT_1.2.0 说明: 命名规则强制三要素顺序,缩写标准取自词典,版本后缀遵循语义化版本 2.0 规范。 状态前缀仅允许使用词典中已登记的缩写,禁止自定义变体。