📚 课程目录第3章原型交付物标准化定义

3、原型交付物标准化定义

本章定义原型交付物的统一标准，包括类型、格式、命名及元数据字段，确保交付物在团队间、工具链间及 Roadmap 各里程碑间可追溯、可复用、可自动校验。

适用场景

多团队（产品、设计、开发、测试）协作交付原型时，需要消除文件格式/命名差异。
从原型阶段向 Roadmap 里程碑移交时可机读化。
需满足审计、合规或版本追溯要求时。

前置条件

已定义项目交付物清单（原型文件、交互说明、标注稿等）。
团队约定统一的命名规则和元数据字段。
交付物管理工具（如 Figma、Axure Cloud、SVN/Git LFS）就绪。

操作步骤

确定交付物类型：根据项目阶段（低保真、高保真、动效原型等）列出必须交付的内容。
设定格式要求：按工具输出标准化格式（详见下表）。
制定命名规范：统一前缀、版本、日期、类型标识。
定义元数据字段：作为文件内嵌信息或附属数据表。
验收与归档：检查格式、命名和元数据完整性后移交。

常用交付物类型与格式对照
类型	原始工具格式	标准交付格式	备注
页面原型（高保真）	Figma / Sketch / Axure	PDF + 交互式 HTML 包	交互式 HTML 包含热区链接
动效原型	Principle / Protopie	MP4 录像 + 源文件	录像时长≤3min
交互说明文档	Markdown / Confluence	.md + .pdf	必须含 Flows 图
标注切图	Zeplin / Sketch Measure	.png + 标注 JSON	标注 JSON 含间距、字号、色值

命名规范细则（示例）

{项目代号}_{模块}_{版本号}_{生效日期}_{类型标识}.{扩展名}

示例：
PARK-v2_carSearch_v1.2_20250320_appGuide.pdf
PARK-v2_carSearch_v1.2_20250320_prototype.axure

命名约定：建议全部小写，日期格式 YYYYMMDD，版本号遵循语义化版本（major.minor）。类型标识为固定枚举：prototype、spec、annotation、asset、demo。

元数据字段定义

元数据可嵌入文件属性或单独生成 metadata.json：

{
  "title": "车辆搜索高保真原型",
  "version": "1.2.0",
  "author": "zhangsan",
  "created": "2025-03-20T14:00:00Z",
  "status": "正式发布",
  "relatedRequirementID": "REQ-042",
  "roadmapMilestone": "M3-交互验证",
  "dependencies": ["样式系统 v2.1", "图标库 2025Q1"]
}

输入输出物

输入	输出
原始设计稿（工具源文件）	标准化交付物包（含规定格式文件 + 元数据）
需求文档、Roadmap 里程碑列表	交付物清单（映射到 Roadmap 节点的索引表）

责任边界

设计师：按规范创建和提交交付物，元数据字段初始化。
产品经理 / Roadmap 负责人：审核交付物是否与当前 Roadmap 里程碑匹配，元数据中的 requirementID 是否存在。
开发测试：验收时校验格式和命名，拒绝不合规文件。

记录材料

交付物登记表（CSV / Excel）：记录文件路径、命名、版本、提交人、日期。
变更日志：每次修改后更新 CHANGELOG.md。

异常处理

异常情况	处理方式
命名冲突（同名不同版本）	强制增加时间戳后缀或使用 Git 版本树解决
格式不符合（如 PDF 含字体缺失）	退回设计师重新导出并嵌入字体
元数据字段缺失	拒绝接收，补充后重新提交
版本号与 Roadmap 里程碑不一致	确认版本对应关系后更新元数据

验收标准

每个交付物命名严格遵循 {项目}_{模块}_{版本}_{日期}_{类型} 格式。
文件格式完整可打开（PDF 可渲染，HTML 无死链，图片清晰）。
元数据字段全部填写，且 roadmapMilestone 存在于 Roadmap 当前列表中。
交付物登记表与实际文件一一对应，无遗漏。