一、目的
在软件开发的每个阶段,对该阶段所形成的文档进行评审,尽早发现问题,并及时采取措施予以解决,确保文档的内容准确,为软件产品的质量提供保障。文档的签署是为了体现文档的合法性、有效性、法规性。
二、规定
1.文档评审的重点是需求说明和设计说明的评审,见附录一。
2.需求评审需要进一步确认用户要求什么,及用户从开发者一方了解某些和约束。用户代表必须参与此项评审活动,以得到双方认可的需求文档。
3.设计评审主要进行概要设计评审和详细设计评审。概要设计评审主要详细评审每个系统组成部分的基本设计方法和测试计划;详细设计评审主要评审程序和程序单元测试计划。
4.所有评审会议必须形成会议记录(备忘录)和评审报告。
5.涉及到文档的更改按文档的更改要求执行。
6.评审的内容还可以包括:编排方式、技术准确度、完整性、对读者的适合性、表达上的正确性、格式的规范性等。
7.评审一般采用评审会的方式进行。
8.软件文档都应进行签署,签署的一般顺序为编制→审核→会签→标准化→批准的顺序进行。其中会签仅在必要时进行。
9.签署不允许代签,且修改单的签署与被修改的文档签署要一致。
10.编制、审核、会签、标准化、批准等人员见附录二。
三、程序
评审
1.由主管领导、用户代表(必要时)、开发小组成员、项目管理人员、标准化人员等组成评审小组,必要时邀请外单位专家参加。
2.开会前,由主管领导确定评审的具体内容,并将材料发给评审小组成员。
3.评审小组成员准备。
4.主管领导主持会议,根据评审条目由评审小组成员评议、评审。
5.评审小组得出评审结论,形成评审报告,评审小组成员应在评审报告上签字。
签署
(无)
四、相关记录
评审报告
会议纪要(记录)
五、相关文档
(无)
附录一 各评审点评审内容
附录二 软件文档签署者一览表
编制: 审核: 批准:
附录一 各评审点评审内容
评审点 | 评审人员 | 评审文档 | 评审内容 |
软件需求评审 | ●软件开发人员 ●用户 ●管理人员 ●标准化人员 ●特邀专家 | ●软件需求说明书 ●数据要求说明书 ●项目开发计划 | 软件需求说明书是否覆盖用户的所有要求 软件需求说明书和数据要求说明书的明确性、完整性、一致性、可测可跟踪性 项目开发计划的合理性 文档是否符合有关规范 |
概要设计评审 | ●软件开发人员 ●管理人员 ●标准化人员 | ●概要设计说明书 | 概要设计说明书是否与软件需求说明书一致 概要设计说明书是否正确、完整 系统的模块划分是否合理 接口定义是否明确 文档是否符合有关规范 |
详细设计评审 | ●软件开发人员 ●管理人员 ●标准化人员 | ●详细设计说明书 ●测试计划 ●数据库设计说明书 | 详细设计说明书是否与概要设计说明书一致 模块内部逻辑结构是否合理,接口是否清晰 数据库设计说明书是否完全,是否反映详细设计说明书的要求 测试是否全面、合理 文档是否符合有关规范 |
鉴定(验收) | ●软件开发人员 ●用户 ●管理人员 ●标准化人员 ●特邀专家 ●上级领导 | ●成套文档 | 开发软件系统是否达到软件需求说明规定的各项技术指标 使用手册内容是否完整、正确 文档是否齐套,是否符合有关规范 |
序号 | 文档名称 | 编制 | 审核 | 会签 | 标准化 | 批准 |
1 | 任务委托书 | 课题组成员 | 技术管理部门 | 委托单位领导 | ||
2 * | 可行性研究报告 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
3 * | 可行性评审报告 | 评审组 | 评审组组长 | |||
4 * | 软件需求说明书 | 主管设计师 | 主任设计师 | 质管部门 | 标准化主管师 | 总设计师 |
5 * | 数据要求说明书 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
6 * | 软件需求评审报告 | 评审组 | 评审组组长 | |||
7 | 项目任务书 | 主管设计师 | 主任设计师 | 项目管理部门 | 标准化主管师 | 总设计师 |
8 * | 项目开发计划 | 主管设计师 | 主任设计师 | 项目管理部门 | 标准化主管师 | 总设计师 |
9 | 质量保证计划 | 主管设计师 | 主任设计师 | 质管部门 | 标准化主管师 | 总设计师 |
10 | 配置管理计划 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
11 * | 概要设计说明书 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
12 | 程序流程图 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
13 | 软件分析报告 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
14 * | 数据库设计说明书 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
15 * | 概要设计评审报告 | 评审组 | 评审组组长 | |||
16 * | 详细设计说明书 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
17 * | 测试计划 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
18 * | 模块开发卷宗 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
19 * | 详细设计评审报告 | 评审组 | 评审组组长 | |||
20 * | 程序 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
21 * | 测试分析报告 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
22 * | 用户手册 | 主管设计师 | 主任设计师 | 质管部门 | 标准化主管师 | 总设计师 |
23 * | 操作手册 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
24 | 程序维护手册 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
25 | 安装实施手册 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
26 | 开发进度月报 | 主管设计师 | 主任设计师 | 项目管理部门 | 标准化主管师 | 总设计师 |
27 * | 项目开发总结报告 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
28 | 用户使用报告 | 用户单位 | 用户单位负责人 | |||
29 | 产品标准 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
30 | 媒体内容分布图 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
31 | 成套软件明细表 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
32 | 成套运用文件清单 | 设计师 | 主管设计师 | 标准化主管师 | 主任设计师 | |
33 | 经济分析报告 | 财务人员 | 总设计师 | 财务部门负责人 | ||
34 | 标准化审查报告 | 标准化主管师 | 标准化室主任 | |||
35 | 性能测试报告 | 测试组组长 | ||||
36 | 资料审查报告 | 评审组组长 | ||||
37 | 鉴定会纪要 | 鉴定会主任 | ||||
38 | 软件验收报告 | 验收委员会主任 | ||||
39 * | 软件问题报告 | 维护人员 | 总设计师 | |||
40 * | 软件维护报告 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 | |
41 | 软件维护通报 | 主管设计师 | 主任设计师 | 标准化主管师 | 总设计师 |