第三章:评审输入输出物定义与规范
适用场景
本章节适用于所有需要开展 Solution Design 文档评审 的团队和项目,当评审流程启动后,评审组织者、参与者、评审组长需严格按照本章定义的输入输出物清单进行操作,确保每个评审场次的物料齐全、输出完整、可追溯。
典型场景包括:
- 解决方案设计文档初稿完成后的首次正式评审
- 需求变更触发的设计文档增量评审
- 架构调整后的跨域协同评审
- 交付前最终验收评审(含合规检查)
前置条件
- 评审会议已排期,相关角色已确认(评审组长、记录员、评审委员、设计责任人)
- 设计责任人已完成自检,并确认输入物版本锁定
- 评审组织者已开放共享空间或文档库,用于存放输入输出物
- 评审委员已收到预读通知,并预留足够的预审时间(通常 ≥ 24 小时)
操作步骤
- 准备输入物包:设计责任人将最新的解决方案设计文档、需求文档、架构图打包,命名格式为
SDD_v1.2_Input_20250301,上传至评审共享目录。 - 分发预读:评审组织者通过邮件或协作工具通知所有评审委员,附件链接指向输入物包,并注明预读截止时间。
- 召开评审会议:评审组长主持,记录员使用 评审意见表 实时记录问题,设计责任人现场答疑。
- 生成评审纪要:会议结束后 24 小时内,记录员整理 评审纪要,包含会议基本信息、出席情况、关键讨论点、待办项。
- 输出整改清单:评审组长根据评审意见表,合并同类项、划分优先级,形成 整改清单,指派责任人及整改期限。
- 归档:所有输出物(意见表、纪要、整改清单)连同原始输入物,存入项目文档库的
./review/20250301/目录,保留至少 2 个版本周期。
输入输出物
| 类别 | 名称 | 来源/责任人 | 格式要求 | 关键字段 |
|---|---|---|---|---|
| 输入物 | 解决方案设计文档 | 设计责任人 | Word / Markdown / PDF | 版本号、设计决策、架构描述、接口定义 |
| 需求文档 | 需求分析师 / PO | Word / Excel / Confluence 页面 | 需求编号、优先级、验收标准、关联用户故事 | |
| 架构图 | 系统架构师 | DrawIO / Visio / SVG / PNG | 组件、连接、数据流、部署边界 | |
| 输出物 | 评审意见表 | 记录员 | Excel / 在线表格 | 问题编号、严重等级、对应文档章节、提出人、状态 |
| 评审纪要 | 记录员 | Word / Markdown | 会议时间、参会人、决策记录、待办项清单 | |
| 整改清单 | 评审组长 | Excel / 项目管理工具 | 问题摘要、责任人、整改期限、完成状态 |
责任边界
- 设计责任人:负责输入物的完整性、版本正确性,并确保架构图与设计文档内容一致。
- 评审组长:负责把控评审节奏,在会议结束时确认“输入物已充分讨论”,并签发整改清单。
- 记录员:负责在会议中按模板填写评审意见表,会后 1 个工作日内输出评审纪要。
- 评审委员:负责按照输入物包进行预读,并在会议中针对设计提出可执行的改进意见。
- 文档管理员 / PM:负责监督归档动作,确保输入输出物在项目文档库中可检索。
记录材料
以下文件构成该评审活动的完整证据链,应长期保存(至少至项目验收后 6 个月):
- 原始输入物包(含版本戳)
- 评审意见表(含各委员签字或电子签名)
- 评审纪要(含参会签到记录)
- 整改清单(含每次状态变更的时间戳)
存档建议:将所有记录材料打包为
Review_20250301_Archive.zip,内部按 Input/、Output/ 两层目录整理,便于后续审计或后评估调用。异常处理
| 异常场景 | 处理措施 | 责任人 |
|---|---|---|
| 输入物版本混乱,出现多个副本 | 立即熔断评审,由设计责任人清理版本,重新提交锁定后再次分发 | 设计责任人 |
| 评审意见表丢失关键字段(如章节对应关系) | 记录员在 30 分钟内补填,并通知全体委员确认;若无法补全,降级为次要问题,在整改清单中标记 | 记录员 |
| 整改清单长期无人认领 | 评审组长升级给项目 PM,由 PM 在周例会中督办,并计入项目风险登记册 | 评审组长 → PM |
| 输出物归档后发现原输入物被误删 | 启用文档库回收站或版本回溯;若无备份,记录为过程缺失,在项目复盘时作为改进项 | 文档管理员 |
验收标准
本章节内容的正确执行可通过以下条件判定:
- 每次评审在启动前,输入物包内包含且仅包含 解决方案设计文档、需求文档、架构图 三项,且三者版本一致。
- 评审会议结束后,评审意见表、评审纪要、整改清单 三份输出物均已完成,且内容无逻辑矛盾。
- 所有输出物在 48 小时内完成归档,且归档路径与命名规则匹配项目文档规范。
- 随机抽取 10% 已归档的评审记录,可在 5 分钟内在文档库中找到对应的输入物与输出物。
输入输出物关系流程
常见误区和避坑:部分团队将“评审意见表”和“评审纪要”混用,导致整改追溯困难。请严格遵守:意见表逐条记录问题,纪要是会议过程记录,整改清单是行动跟踪。三者缺一不可。