第三章:评审输入输出物定义与规范

适用场景

本章节适用于所有需要开展 Solution Design 文档评审 的团队和项目,当评审流程启动后,评审组织者、参与者、评审组长需严格按照本章定义的输入输出物清单进行操作,确保每个评审场次的物料齐全、输出完整、可追溯。

典型场景包括:

  • 解决方案设计文档初稿完成后的首次正式评审
  • 需求变更触发的设计文档增量评审
  • 架构调整后的跨域协同评审
  • 交付前最终验收评审(含合规检查)

前置条件

  • 评审会议已排期,相关角色已确认(评审组长、记录员、评审委员、设计责任人)
  • 设计责任人已完成自检,并确认输入物版本锁定
  • 评审组织者已开放共享空间或文档库,用于存放输入输出物
  • 评审委员已收到预读通知,并预留足够的预审时间(通常 ≥ 24 小时)

操作步骤

  1. 准备输入物包:设计责任人将最新的解决方案设计文档、需求文档、架构图打包,命名格式为 SDD_v1.2_Input_20250301,上传至评审共享目录。
  2. 分发预读:评审组织者通过邮件或协作工具通知所有评审委员,附件链接指向输入物包,并注明预读截止时间。
  3. 召开评审会议:评审组长主持,记录员使用 评审意见表 实时记录问题,设计责任人现场答疑。
  4. 生成评审纪要:会议结束后 24 小时内,记录员整理 评审纪要,包含会议基本信息、出席情况、关键讨论点、待办项。
  5. 输出整改清单:评审组长根据评审意见表,合并同类项、划分优先级,形成 整改清单,指派责任人及整改期限。
  6. 归档:所有输出物(意见表、纪要、整改清单)连同原始输入物,存入项目文档库的 ./review/20250301/ 目录,保留至少 2 个版本周期。

输入输出物

类别名称来源/责任人格式要求关键字段
输入物解决方案设计文档设计责任人Word / Markdown / PDF版本号、设计决策、架构描述、接口定义
需求文档需求分析师 / POWord / Excel / Confluence 页面需求编号、优先级、验收标准、关联用户故事
架构图系统架构师DrawIO / Visio / SVG / PNG组件、连接、数据流、部署边界
输出物评审意见表记录员Excel / 在线表格问题编号、严重等级、对应文档章节、提出人、状态
评审纪要记录员Word / Markdown会议时间、参会人、决策记录、待办项清单
整改清单评审组长Excel / 项目管理工具问题摘要、责任人、整改期限、完成状态

责任边界

  • 设计责任人:负责输入物的完整性、版本正确性,并确保架构图与设计文档内容一致。
  • 评审组长:负责把控评审节奏,在会议结束时确认“输入物已充分讨论”,并签发整改清单。
  • 记录员:负责在会议中按模板填写评审意见表,会后 1 个工作日内输出评审纪要。
  • 评审委员:负责按照输入物包进行预读,并在会议中针对设计提出可执行的改进意见。
  • 文档管理员 / PM:负责监督归档动作,确保输入输出物在项目文档库中可检索。

记录材料

以下文件构成该评审活动的完整证据链,应长期保存(至少至项目验收后 6 个月):

  • 原始输入物包(含版本戳)
  • 评审意见表(含各委员签字或电子签名)
  • 评审纪要(含参会签到记录)
  • 整改清单(含每次状态变更的时间戳)
存档建议:将所有记录材料打包为 Review_20250301_Archive.zip,内部按 Input/、Output/ 两层目录整理,便于后续审计或后评估调用。

异常处理

异常场景处理措施责任人
输入物版本混乱,出现多个副本立即熔断评审,由设计责任人清理版本,重新提交锁定后再次分发设计责任人
评审意见表丢失关键字段(如章节对应关系)记录员在 30 分钟内补填,并通知全体委员确认;若无法补全,降级为次要问题,在整改清单中标记记录员
整改清单长期无人认领评审组长升级给项目 PM,由 PM 在周例会中督办,并计入项目风险登记册评审组长 → PM
输出物归档后发现原输入物被误删启用文档库回收站或版本回溯;若无备份,记录为过程缺失,在项目复盘时作为改进项文档管理员

验收标准

本章节内容的正确执行可通过以下条件判定:

  1. 每次评审在启动前,输入物包内包含且仅包含 解决方案设计文档、需求文档、架构图 三项,且三者版本一致。
  2. 评审会议结束后,评审意见表、评审纪要、整改清单 三份输出物均已完成,且内容无逻辑矛盾。
  3. 所有输出物在 48 小时内完成归档,且归档路径与命名规则匹配项目文档规范。
  4. 随机抽取 10% 已归档的评审记录,可在 5 分钟内在文档库中找到对应的输入物与输出物。

输入输出物关系流程

评审输入输出物关系图 解决方案设计文档 需求文档 架构图 输入物(设计责任人提供) 评审活动 评审意见表 评审纪要 整改清单 输出物(记录员/组长负责) 说明:输入物必须版本锁定且三件一致;输出物需在评审结束后 24 小时内完成。 所有材料归档至项目文档库,保留至少 2 个版本周期。
常见误区和避坑:部分团队将“评审意见表”和“评审纪要”混用,导致整改追溯困难。请严格遵守:意见表逐条记录问题,纪要是会议过程记录,整改清单是行动跟踪。三者缺一不可。