软件技术评审规程

1、软件技术评审规程1 引言1.1 目的明确技术评审的类型,以及如何组织同行评审会议.1.2 适用范围本标准适用于对公司所有工程各阶段产生的产品的技术评审.1.3 技术评审软件技术评审,是指在软件开发过程中,由参与评审的人员对软件开发文档或代码进行 评审或检查,帮助查找缺陷和改良.软件评审的工作包括：1检验产品是否满足以前的标准,如需求或设计文档；2识别产品相对于标准的偏差；3向作者提出改良建议；4促进技术交流和学习.软件技术评审涉及评审的组织机构、治理、准那么、类别、内容、文件和要求等.一般要求在软件研制阶段的里程碑点进行软件评审.评审的主要类别有： 软件定义评审、软件需求评审、概要设计评审、详

2、细设计评审、软件实现评审和软件验收评审等.软件技术评审主要分为 3类：审查、走查、四眼评审.其中审查是最系统化、 最严密的评审技术, 严格规定了每个阶段的角色及各自责任,在质量要求非常高的软件开发工程中得到了较广泛的应用.在判断采用哪种评审方法时,需考虑以下风险因素：1） 使用了新技术,方法,工具的组件2） 关键的架构性的组件3） 难以理解,却又必须准确和优化的复杂逻辑或算法4） 具有危险失败模式的组件,而且是任务、可靠性、平安性关键的5） 具有多个异常条件或失败模式的组件6） 不易测试的异常处理代码7） 打算复用的组件8） 将作为其他组件的模型或模板的组件9） 影响产品多个局部的组件10）

3、复杂的用户界面11） 由缺乏经验的开发者创立的组件12） 具有高度圈复杂性的代码模块13） 以往具有很多缺陷或变更的模块3 技术评审类型技术评审分为：审查即同行评审、走查、四眼评审 3种方式.3.1 审查即同行评审同行评审步骤一般是：评审方案、总体会议,评审准备,评审会议,修改、验证.同行 评审的目的主要是及早高效的发现并消除开发过程中出现的缺陷.整个过程关键是组织评审会议,只有评审会议进行完满,其他修改 Bug、消除缺陷都比拟容易完成.评审会议流程一 般采取以下几个步骤：评审会议的准备、评审会议的召开、评审会议的跟踪三大环节.组建评审小组是首先要做的工作.评审小组通常由5人及5人以下组成,其

4、中一人担任评审组组长.评审组组长应全面负起组织评审会的责任,他工作的好坏直接影响评审会成功与否.评审组成员应该由与被评审的工作产品无直接关系的同行专家,以保证评审工作开展的公正性、客观性.还可以包括被评审工程的开发人员,他们主要是介绍被评审产品的情况,提供所需信息.还可以有配置治理人员和质量保证人员参加.3.1.1 评审会议准备会议的发起人召集会议,发出评审通知评审内容、会议时间、会议地点、参加人员等, 并且将相关待评审的相关资料也发送给参加会议的评委；主要的目的有两个： 第一、让参加会议的人员对会议的内容有一定的了解,在会议前做好准备, 防止盲目的参加会议而浪费自己和其他人的时间； 第二、如

5、果该评委在会议时间有其他紧急的事情,可以及早反应给会议召集人,必便召集人重新确定评委或者评审会议改期召开.3.1.2 评审会议的召开一般情况下,确定一个会议主持人；其主要的责任是限制会议的进度、时间、协调会议中出现的偏差.对于待评审的工作产品由其生产者采用“走读的形式进行讲解,在讲解的过程中答复评委提出的问题.会议记录人主要是记录会议中发现的所有问题,方便会后的修改完善.QA人员参加会议主要的关注点在于对照QA的检查表Checklist检查评审的流程是否符合标准.3.1.3 评审会议的跟踪将记录的问题汇总到?评审会议纪要?,由工程组进行修改、完善； QA监督所有问题是否封闭.3.2 采用同行评

6、审的过程采用最严格最系统的同行评审方法的软件过程有:1?软件需求规格说明书?的评审2） ?概要设计说明书?的评审3） ?详细设计说明书?的评审4） 代码评审5?集成测试方案?的评审对于文档评审以文档页数为基数,要求每页发现的缺陷数有一个目标值,并规定了上下限的范围.对于代码评审以代码行数为基数,要求每千行代码发现的缺陷数有一个目标值, 并规定了上下限的范围.3.3 同行评审软件过程的准那么3.3.1 软件需求规格3.3.1.1 输入需提交的材料包括：?产品需求规格说明书?、?系统测试方案初稿、合同工程提交 合同或投标书或工程方案书,研发工程提交?工程立项申请书?和?可行性分析报告?.3.3.1

7、.2 评审准那么?-SP-RDM-C01产品需求规格说明书检查单?3.3.1.3 评审重点主要关注需求来源、 需求的准确性、需求的完整性,需求的影响等方面；最好让测试人 员和客户参加,以便让各角色达成共识.3.3.1.4 批准?产品需求规格说明书?由高层经理批准3.3.2 工程方案3.3.2.1 输入工程开发方案评审需提交的材料包括：?工程方案?和?产品需求规格说明书?.3.3.2.2 评审准那么?-SP-PP-C01工程方案检查单?3.3.2.3 评审重点主要是关注的核心在于估计是否准确；人员安排是否合理；以上两个方面如果合理,项目的进度就不会出很大的问题.3.3.2.4 批准3.3.3 概

8、要设计3.3.3.1 输入需提交的材料包括：?概要设计说明书?、?数据库设计说明书?、?集成测试方案?初稿、 ?产品需求规格说明书?.3.3.3.2 评审准那么?-SP-SD-C01概要设计检查单?3.3.3.3 评审重点在总体设计评审中, 最好将已经评审通过的需求文档从配置治理库中提出,对照总体设计是否和需求一致；另外,技术领域专家参加评审还要关注于设计的合理性、可实现性以及完整性.3.3.3.4 批准?概要设计说明书?由高层经理批准3.3.4 详细设计3.3.4.1 输入需提交的材料包括：?详细设计说明书?、?概要设计说明书?、?接口标准?.3.3.4.2 评审准那么?-SP-SD-C02

9、详细设计检查单?3.3.4.3 批准?详细设计说明书?由高层经理批准3.3.5 软件测试3.3.5.1 输入需提交的材料包括：?测试方案?、?测试用例?,系统测试和验收测试需提交?产品需求 规格说明书?,集成测试需提交?概要设计说明书?,单元测试需提交?详细设计说明书? .3.3.5.2 评审准那么?-SP-PT-C01集成测试的检查单?-SP-PT-C02验收测试方案检查单?-SP-PT-C03验收测试报告检查单?3.3.5.3 批准?集成测试方案?系统测试方案?验收测试报告?由高层经理批准.3.4 同行评审应当把握的原那么3.4.1 评审工作产品,而不是评审生产者评审涉及到别人和自我.如果

10、进行的恰当,可以使所有参与者体会到温暖的成就感.如果不恰当,那么可能陷入审问的气氛之中.应当温和的指出错误,会议的气氛应当是轻松和建设性的；不要试图贬低或者羞愧别人.主持人应当加以引导,以保证会议始终处于恰当的气氛和态度中,如果失去限制应立即休会.3.4.2 制定日程,并且遵守日程各种会议经常有一个主要的缺点：放任自流.评审会议必须保证不要离题和根据方案进行.主持人要有维持会议的程序的责任,有人在转移话题的时候应当提醒.3.4.3 限制争论和辩驳评委提出问题时,未必所有人都能认同该问题的严重性或者能马上打成一直的意见.不要花费时间争论这一问题,应当记录在案,留会后讨论.3.4.4 对各个问题发

11、表见解,但是不要试图解决所有记录的问题评审会议不是解决问题的会议.问题的解决由生产者自己或者其他人的帮助下完成.问题的解决方案应当在会后进行.3.4.5 作书面笔记有时候让记录员在黑板上作笔记是个好主意,在记录的时候,评委可以推敲措词, 确定问题的优先次序.3.4.6 限制参与人数,并且坚持事先做准备个人的脑袋好过一个, 但是14个脑袋未必就好过 4个.将评审涉及的人员数量保证保 持在最小的值上.所有参与会议的人员要事先作好准备.3.4.7 为每个可能要评审的工作产品建立一个检查表检查表能帮助评审主持人组织会议,并帮助每个与会人员将注意力集中在重要问题上.3.4.8 为评审分配资源和时间评审要

12、占工程组的资源和时间.所以,评审会议一定要作为软件工作活动的任务加以调度.可以在综合方案中考虑进去.3.4.9 对所有的评审者进行有意义的培训为了提升效率,所有参与评审会议的人都应当接受正式的培训.2个小时.3.4.10 会议时间的限制为了提升效率,每次评审会议只评审一个工作产品,并且时间最长不能超过 所以要求,在评审准备时候各位评委事先作好准备.4 其它评审类型介绍4.1 走查走查是一种常用的非正式的评审方式,它可以对代码、设计、需求进行检查. 通常用于开发小组成员间的评审方法,主要是到达纠正明显的错误的目的.而四眼评审那么是开发小组成员与工程经理之间评审,在工程组内部的评审方法, 主要是能

13、发现一些潜在的非功能、非设计性的错误,催促纠正.同行评审是最为正式的技术评审,它独立于工程组外,由非此项目组的同行专家、测试部门、QA人员、客户等角色组成,主要是考察工程系统的正确性,发现工程决定性的错误.4.1.1 代码走查的概念代码走查是一种非正式的评审,它以小组为单元进行代码阅读,是一系列规程和错误检查技术的集合.且代码走查可以采用持续一至两个小时的不间断会议的形式和开发现场演示 这两种方式.在现场进行代码走查,必须成立代码走查小组,小组成员的构成而言,一般由三至五人组成,其中一人扮演“协调人,一人担任秘书角色,负责记录所有查处的错误,还有一人担任测试人员.采用走查的过程：需求分析过程中

14、,系统分析员、系统架构师相互之间的走查； 设计过程中,系统分析员、系统架构师相互之间的走查； 在进入维护阶段时,作者需和维护人员进行走查,让维护人员能够维护作者的工作 产品.4.1.2 实施代码走查会议步骤输入：待检查的工作产品(代码、测试数据等)入口条件：代码编写完毕 步骤：(1) 选择评审参与者,确认他们同意参与评审,安排走查会议时间；(2) 在会议之前分发工作产品给评审者；(3) 在会议期间,以适当的方式向评审者描述工作产品；(4) 向创立者表示评论,可能的缺陷和改良建议；(5) 基于评审者的评论,对工作产品执行必要的返工.交付产品：经过修改的工作产品出口条件：已经对工作产品做了恰当的修改4.2 四眼评审四眼评审,顾名思义,四眼即为 2个人面对面(评审者与工作产品创立者)就对所创建的工作产品进行非正式的评审,