机房合作验收总结

      这几天都在忙碌机房合作验收的事情，有自己的机房合作，作为学术部的一员，当然也在不断的验收同学的文档。期间还帮徒弟的验收 了机房。这次机房的严格验收，还得从1月26日，米老师验收机房开始说起。那天去学校验收机房，12期旁听，米老师也在，验收的过程中，米老师教导了我们机房合作哪些点必须包括哪些内容，哪些部分必须严格把控，比如UML图中9种图、四种关系，程序必须打包。验收完成之后，米老师专门叫我们反映验收效果和验收感受。所以第三批机房验收就轰轰烈烈开始了。这个过程中，对于EA的使用、类图、时序图等，以及文档中应该包括哪些都有了比较明确的认识。

 

一、重点文档总结

1.项目计划书

       项目计划书是对整个项目时间进度的把控，所以要用到甘特图来明确的表示。甘特图是通过活动列表和时间刻度形象地表示出任何特定项目的活动顺序和持续时间。基本是一条线条图，横轴表示时间 ，纵轴表示活动项目，线条表示在整个期间上计划和实际的活动完成情况。它直观表明任务计划在什么时间进行，以及实际进展和计划要求的对比。管理者由此可以便利的弄清楚一项任务还剩下那些工作要做，并可以评估工作进度。

 因为开发项目进度是不断变化的，所以项目计划上会有变动，所以在项目计划书中，也有保留历史版本。这样能够对整个项目开发有个明显的对比。

2.需求规格说明书

       需求规格说明书是对软件需求的宏观把控，是项目开发的指导。以前重构的时候，都是自己的想法，所以体会不深刻，但是合作的时候，每个人想法都不一样，所以统一的项目需求说明就变得尤为重要。里面主要包括：第一，用例图，主要来说明系统的功能，每个用例要详细的说明。第二，原型图，是对整个系统的一个大致轮廓的体现，所以需要放在需求说明书中，让用户来看。第三，Er图，简单说明系统的数据库设计。

3.数据库设计说明书。

         需要有数据库各个表结构说明，数据库每张表字段详细说明，建立数据库的SQL脚本。如果用到了视图、存储过程、触发器等，都要在数据库说明书中详细的体现。也就是用户看到了你的设计说明书，也就知道了你的数据库是如何设计的。

4.概要设计说明书

         概要设计说明书就是设计软件的结构，包括组成模块，模块的层次结构，模块的调用关系，每个模块的功能等等。同时，还要设计该项目的应用系统的总体数据结构和数据库结构。即应用系统要存储什么数据，这些数据是什么样的结构，他们之间有什么关系。概要设计中应该包括，系统架构图、简单类图、接口设计、数据库表说明，这些都是比较宏观概括的，详细设计说明书中会详细说明。

5.详细设计说明书

         详细设计是为每个模块完成的功能进行具体的描述，要把功能转化为精确的、结构化的过程。详细设计中应该包括：详细架构图说明，类图，包括对类、方法、参数、返回值的详细说明，系统的每个时序图的业务逻辑，参数返回值等。定义代码规范，包括数据库设计、代码、注释等等。测试用例，在测试计划说明书中有，在这里也要有说明。测试用例可以参照提高班ITOO的测试用例，很规范。

二、重要UML图总结

1.包图

       包图是整个系统的架构图，一个包图可以清晰展现系统的大体分层架构。包图中需要注意，依赖和实现的关系如何体现？箭头是否正确？七层是如何解耦的，如何理解抽象工厂加反射？

2.类图

       注释是一个大方面，其他就是类的划分要明确。设计模式要正确。

3.时序图

          时序图清晰展现了系统每个功能的每一条线，参数、返回值等都要特别的注意。时序图验收最重要的就是代码和时序图的对应，真正做到图和文档的驱动。

画图，整体要注意，命名要规范，每个类、方法、属性等都要有注释，每一层都要详细的说明。让别人看你的类图的时候，才可以很快的了解。返回值不能够是dataTable。在画图的过程中，也真正体会到工具的强大性，也真正体会到图就是代码这句话的内容。因为通过UML可以生成很多代码，通过UML图也可以清晰看到系统的每个功能每条线是如何走的。这个过程中，对EA也越来越熟悉了，发现了原来都不知道的功能。

小结：

每次经历，都会成长，这几天在验收机房的过程中，自己也学习到很多，同时伴着自己的机房，共鸣更加的深刻。正好给徒弟验收机房重构，再次看时，觉得眼光就不一样了。

以后我觉得机房合作验收要严格，这样大家才真正学习到东西，认真对待，相信每次的收获都是大大的。