工程软件开发之团队开发规范.docx

工程软件开发之团队开发规范.docx

《工程软件开发之团队开发规范.docx》由会员分享，可在线阅读，更多相关《工程软件开发之团队开发规范.docx（20页珍藏版）》请在冰点文库上搜索。

工程软件开发之团队开发规范

水利水电工程XXXXX辅助决策支持系统

团队开发规范

XXXXX设计有限公司

二XXX年十二月

文档信息：

文档名称

水利水电工程XXXXX辅助决策支持系统团队开发规范

描述

该文档详细定义了团队开发的角色及职责、项目开发流程、开发过程控制的约定、协作开发的约定、代码版本控制、交流机制等

负责人

XX

状态

最终版

文档变更历史：

时间

修改人

章节

描述

2008-8-29

XXX

所有章节

创建文档初稿

2008-12-10

XXX

所有章节

修改

文档名称：

团队开发规.doc

审核结果：

审核人

意见

签名档

1团队组成

我们的整个软件开发团队由4种角色组成，分别为：

产品管理（ProductManagement）

项目管理（ProgramManagement）

开发人员（Development）

测试人员（Test）

各角色在团队的地位相当，各司其职。

各个角色的具体目标、职能以及责任在以下的小节中进行详述。

1.1产品管理

（1）目标

满足客户需求。

产品管理的目标就是满足客户需求。

一个成功的项目必须要能够满足客户和用户的要求。

即使项目达到了预算和时间的目标，只要未能满足客户需求，那这就是一个失败的项目。

首先必须认清和理解客户。

有时，使用方和投资方的目标需求并不完全相同，因此就需要清晰地区别和分析所有的需求。

（2）职能

市场

推动市场和公关，以对目标客户发生效用

突出产品与其他竞争对手的区别性，以利于竞争

分发解决方案，以便用户能够容易地获得

为用户提供支持，以使其无论在购买还是使用过程中都留下正面的印象

业务价值

定义并维护项目的业务正确性

定义并衡量业务价值的实现和评价

发展客户

推动项目和解决方案的远景目标

负责客户期望值和沟通

产品计划

收集、分析客户和业务需求，并区分其优先级

执行市场调查、市场开拓和竞争对手分析

确定业务和成功的标准

识别多目标的发布计划

1.2项目管理

（3）目标

在项目的约束条件下完成解决方案。

整个团队的一个主要目标就是在项目的约束条件下完成项目。

项目的约束条件包括预算和进度等。

大部分项目会根据时间和资金的使用来衡量项目的结果。

为了实现这个目标，项目管理负责并推动进度表、功能集和预算资金。

他必须保证能够在正确的时间发布正确的项目或产品，保证正确理解了项目投资方的期望，并自始至终贯穿于项目执行过程中。

（4）职能

项目管理

跟踪和管理预算资金

管理控制进度表

推动风险管理流程

加强团队沟通和协调

跟踪进度和报告项目状态

管理资源分配

解决方案构建

推动整体项目设计

负责功能规范

负责解决方案范围和重要决定

流程控制

推动流程质量控制

定义并推荐可改进处

管理服务

实现项目的管理流程并提供支持

提供管理服务以保证高效的团队运作

1.3开发

（5）目标

按照功能规范说明、《软件开发需求分析报告》和《总体结构设计》的要求进行开发。

功能规范说明详细描述了整个团队将要提供给客户的交付物。

对整个团队来说，应该尽可能精确地按照功能规范说明来实现整个项目，因为功能规范说明可以看成是整个团队和客户之间所达成的共识。

开发人员必须按照客户需求和功能规范说明来构建整个解决方案。

同时，开发人员还需要为整个团队提供技术方面的咨询，这样在设计和技术选择时可以尽量减少开发风险。

开发人员提供较低层次的功能设计，并预估完成设计所需的时间。

（6）职能

技术咨询

为团队提供技术咨询服务

评估并验证所用技术

积极参与功能规范说明的创建和审核

定义开发标准

实现架构和设计

提供针对解决方案的应用程序、数据和技术细节，以便将企业架构映射到解决方案架构的实现上

负责并实现解决方案的逻辑和物理设计

应用程序开发

根据设计规范编写代码以实现功能

在开发过程中进行代码审核，并共享知识和经验

在测试人员的帮助下，根据测试计划执行单元测试

架构开发

为自动安装开发脚本

开发安装文档

1.4测试

（7）目标

在确认所有的产品质量问题都得到妥善处理后，批准产品发布。

所有的软件产品在发布时都存在着缺陷。

最重要的是，在发布前，必须清楚地认识和鉴别出这些问题，可以以问题的形式给出解决方法，或者是给出如何绕开该问题的文档记录。

宁愿对于已知的问题，提供了文档或解决方法，也不要存在一些未知的问题。

因为这些未知的问题，可能会带来不可预知的后果。

（8）职能

计划测试

开发测试方法和计划

参与设置质量标准

开发测试说明

测试

开发并维护自动测试案例、工具和脚本

执行测试，以确定产品开发过程的状态

负责定义构造流程

测试报告

为团队提供与产品质量相关的数据

跟踪所有缺陷，并保证在发布前得到妥善处理

1.5角色共享

尽管团队组成包含了4种角色，但并不意味着一个团队至少需要4个成员，也不意味着一个人只能承担一种角色，重要的是这4种角色必须在一个团队中体现。

一般情况下，团队成员常常共享角色。

在一些较小的团队中，不同的角色只能进行兼任。

角色共享有两条重要原则：

一是开发组成员不能共享角色。

开发人员是项目的构建者，他们不应该从他们的主任务中分身。

如果对开发组成员要求额外的角色，往往会使得他们无法按时完成进度要求。

二是不要试图组合具有一定利益冲突的角色。

比如，产品管理和项目管理的利益具有冲突点，所以他们的角色不能组合。

产品管理注重满足客户需求，而项目管理主要关心在时间和预算的限度内完成项目。

如果这两个角色组合在一起，那么在需求发生变更时，可能会发生一些情况，诸如没有足够地考虑客户满意度而忽略该变更，或者是没考虑对项目的冲击盲目地接受变更。

让不同的团队成员担任这样的角色有助于确保每个方面得到相当的考虑和重视程度。

同样，这也适用于组合开发人员和测试人员。

1.6开发小组

开发小组成员组成

姓名

性别

年龄

职务/职称

业务专业

本项目分工

所在单位

1.7专家小组

姓名

性别

年龄

职务/职称

业务专业

本项目分工

所在单位

专家小组负责系统开发过程中重要阶段的评审、导截流技术问题的解答和指导等。

主要目标是保证系统的理论先进性、更好的满足客户需求和保障开发质量。

2开发流程

在开发过程中，采用多里程碑式的过程模型，如图1所示。

而其中每一个循环均包含四个里程碑。

图1多里程碑模型

这四个里程碑组成的循环放大后如图2所示，称为“过程模型”。

图2过程模型

2.1达成共识

基本完成需求调研和分析（产品管理负责）

确定大方向和长中短期目标

所有角色都参与讨论并真正认同结论

产生的文档

常见用户情景：

覆盖80%以上功能

前景：

言简意赅地说明大方向，并有激励团队的作用

2.2完成项目计划

编写详细的功能规范（项目管理）

在编程前想清楚所有功能流程，并引导用户明确需求

所有角色都参与审阅功能规范

制订开发计划和进度表（开发团队）

制订测试计划和进度表（测试团队）

分配资源（人力和预算）

形成项目综合计划和综合进度表

2.3完成功能

开发人员分别完成自己的功能

进行版本合理的控制

对每一项可测试的功能进行测试，无需等待

通过测试用例，对功能进行完整和重复的检验

记录所有程序问题

实现解决缺陷的自动流程

按照综合进度表不断检查进度

2.4稳定与发布

测试组全面地测试功能，包括性能和稳定性

开发组全力配合解决缺陷

监测质量情况

预测发布日期

专家会诊机制

决定缺陷的优先度

决定哪些缺陷可以在下个里程碑或版本中解决

决定由谁解决某个缺陷

3代码管理

3.1编码规范

请参看附录，系统开发编码规范。

3.2版本管理

3.2.1概述

版本控制有如下好处：

可以获得连续的受版本控制的项目，并保存不同版本的区别以作比较

能获得版本控制工具中保存的任何版本

能够把出错或误操作的最新版的项目恢复到正确的历史版本

获得历史版本的详细信息

在开发过程中，核心程序员对版本进行控制、对系统源代码进行集中管理，并做好程序的备份和保密工作。

3.2.2代码管理

核心程序员根据系统结构设计和详细设计，对系统实现的功能进行分解，将实现各功能的小模块分配给项目组的开发人员，并事先设计好各模块的接口。

开发人员根据接口要求进行编码。

编码完成后进行单元测试。

单元测试由开发人员完成。

单元测试后开发人员将本部分模块代码上交给核心程序员，核心程序员负责加入模块后的系统测试。

系统的全部代码由核心程序员管理，其它开发人员负责配合进行各模块的开发。

4附录：

系统开发编码规范

在开发中保持良好的编码规范是十分重要的。

程序开发人员应该严格遵循系统开发编码规范进行编码。

4.1类型级单位的命名

4.1.1类

在为类（class）命名前首先要知道它是什么，如果通过类名的提供的线索，你还是想不起这个类是什么的话，那么你的设计就还做的不够好。

超过三个词组成的混合名是容易造成系统各个实体间的混淆。

对于派生类的命名应该避免带其父类名，一个类的名字只与它自身有关，和它的父类叫什么无关。

1类命名

以Class声明的类，都必须以名词或名词短语命名，使用大写字母作为词的分隔，其他的字母均使用小写，名字的首字母使用大写不要使用下划线（_）。

如：

ClassIndicator

当类是一个特性（Attribute）时，以Attribute结尾，当类是一个异常（Exception）时，以Exception结尾，如：

Class ColorSetException

Class CauseExceptionAttribute

当类只需有一个对象实例（全局对象，比如Application等），必须以Class结尾，如：

Class ScreenClass

Class SystemClass

当类只用于作为其他类的基类，根据情况，以Base结尾：

MustInheritClassIndicatorBase

如果定义的类是一个窗体，那么名字的前面或后面必须加Frm。

在本系统编码中，对于前处理和处理器模块使用的窗体，在名字的后面加后缀Frm，在后处理模块中使用的窗体在名字的前面加前缀Frm。

如果是Web窗体，必须加后缀Page：

ClassPrintFrm:

InheritsForm ‘*Windows窗体

ClassStartPage:

InheritsPage ‘*Web窗体

2类库命名

目前命名空间正在越来越广泛的被采用，以避免不同厂商和团体类库间的类名冲突。

当未采用命名空间的时候，为了避免类名冲突，一般的做法是在类名前加上独特的前缀，两个字符就可以了，当然多用一些会更好。

例如：

John Johnson的数据结构类库可以用Jj做为前缀，如下：

class JjLinkList

4.1.2枚举和结构

同样必须以名词或名词短语命名。

最好体现枚举或结构的特点，如：

EnumColorButtons ''以复数结尾，表明这是一个枚举

StructureCustomerInfoRecord ''以Record结尾，表明这是一个结构体

4.1.3委派类型

普通的委派类型以描述动作的名词命名，以体现委派类型实例的功能：

DelegateSubDataSeeker（ByValSeekStringAsString）

用于事件处理的委派类型，必须以EventHandler结尾，如：

Delegate SubDataChangedEventHandler （ByValSenderAsObject,ByValeAsDataChangedEventArgs）

4.1.4接口

与其他类型不同，接口必须要由I作为前缀，并用形容词命名，突出表现实现接口的类将具有什么能力：

InterfaceISortable

4.1.5模块

模块不是类型，他的名称除了必须以名词命名外，必须加以后缀Module:

ModuleSharedFunctionsModule

上述所有规则的共同特点是，每个组成名称的词语都必须是大写开头，禁止完全大写或小写的名称。

4.2方法和属性的命名

4.2.1方法

最好采用与类命名一致的规则，无论是函数还是子程序，方法都必须以动词或动词短语命名。

无需区分函数和子程序，也无需指明返回类型。

SubOpen（ByValCommandStringAsString）

FunctionSetCopyNumber（ByValCopyNumberAsInteger）

参数需要指明ByVal还是ByRef，这一点写起来会让程序变长，但非常必要。

如果没有特别情况，都使用ByVal。

参数的命名方法，参考后面“变量的命名方法”。

需要重载的方法，一般不写Overloads，根据需要编写重载方法。

4.2.2属性

原则上字段（Field）是不能公开的，要访问字段的值，一般使用属性。

属性以简洁清晰的名词命名：

PropertyConcentrationAsSingle

PropertyCustomerAsCustomerTypes

4.2.3事件

事件是特殊的属性，只能在事件处理上下文中使用。

命名的原则一般是动词或动词的分词，通过时态表明事件发生的时间：

EventClickAsClickEventHandler

EventColorChangedAsColorChangedEventHangler

4.3变量和常数

常数以表明常数意义的名词命名，一般不区分常数的类型：

ConstDefaultConcentrationAsSingle=

在严格要求的代码中，常数以c_开头，如c_DefaultConcentration，但最好不要用它，它会带来输入困难。

普通类型的变量，只要用有意义的名字命名即可，不可使用简称和无意义的名称诸如A，x1等，下面给出了良好的例子：

DimIndexAsInteger

DimNextMonthExpenditureAsDecimal

DimCustomerNameAsString

不能起太长的名字，应该尽量简洁，如下面的例子：

DimVariableUsedToStoreSystemInformationAsString ''*太复杂了

DimSystemInformationAsString ''* 正确，简单明了

DimsysInfoAsString ''* 错误，过于简单

特殊情况可以考虑一个字母的变量：

DimgAsGraphic

对于控件，应该指明控件的类型，方法是直接在变量后面加以类名：

FriendWithEventsNextPageButtonAsButton ''* 按钮

FriendWithEventsColorChoicerPanelAsPanel ''* 面版

FriendWithEventsCardFileOpenDialogAsFileOpenDialog''*文件打开对话框等等，无需规定某种类型的变量的前缀，只需把类型写在后面就行了，试对比下列代码：

=&Cancel

=&Cancel

显然后者更能使阅读者明白变量的类型是一个按钮。

4.4前缀

4.4.1对象

1标准对象

名称前缀例子说明

arrarrUsers用户集合

blnblnDoesUserExist用户是否存在

bytbytStreamContent字节流内容

chrchrKeyPress按键

dtedteCreatedDateTime创建日期

decdecYearlySaleQuota年度销售额

dbldblTotalPrice总金额

intintMessages消息数

objobjExternalFunction外部功能

sngsngFinishRate完成率

strstrLoginName登陆名称

excexcRet错误

enmenmUserStates用户状态

StructurestustuEmployees员工类型

cnncnnDatabase数据库连接

sdrsdrUserData用户数据读取器

2自定义对象

我们规定应该根据自定义对象的名称来确定该对象类型的前缀，例子如下:

对象：

SysSet

前缀：

ss

例子：

ssSafety

4.4.2变量/常量的范围

根据变量与常量的生存周期，我们应该定义不同的生存周期前缀以示区别，以便我们清楚该变量/常量的范围。

1类、模块、组件、控件

我们规定在类、模块、组件、控件范围内，变量的生存周期前缀应该添加“m_”（Module－模块）。

例子如下：

名称前缀例子说明

m_arrm_arrUsers用户集合

m_blnm_blnDoesUserExist用户是否存在

m_bytm_bytStreamContent字节流内容

m_chrm_chrKeyPress按键

m_dtem_dteCreatedDateTime创建日期

m_decm_decYearlySaleQuota年度销售额

m_dblm_dblTotalPrice总金额

m_intm_intMessages消息数

m_objm_objExternalFunction外部功能

m_sngm_sngFinishRate完成率

m_strm_strLoginName登陆名称

2过程、函数、属性、事件

我们规定在过程、函数、属性、事件范围内，变量的生存周期前缀应该添加“o_”（Owner－私有）。

例子如下：

名称前缀例子说明

o_arro_arrUsers用户集合

o_blno_blnDoesUserExist用户是否存在

o_byto_bytStreamContent字节流内容

o_chro_chrKeyPress按键

o_dteo_dteCreatedDateTime创建日期

o_deco_decYearlySaleQuota年度销售额

o_dblo_dblTotalPrice总金额

4.5标签

标签就是用于Goto跳转的代码标识，由于Goto并不推荐使用，所以标签的使用也比较苛刻。

标签必须全部大写，中间的空格用下划线_代替，而且应该以_开头，比如：

_A_LABEL_EXAMPLE：

如此定义标签是为了与其他代码元素充分区别。

4.6名字空间

通常，一个工程使用一个名字空间，通常不需要用Namespace语句，而是在工程选项的“RootNamespace”中指定，使用根名字空间可以使代码更加整齐，容易修改，这一点是VB十足的优点。

名字空间的语法是：

公司名.产品名[.组件名的复数]

如：

Namespace

Namespace随便起一个名字空间的名字绝对不是一个好主意，一定要遵守上述规定。

4.7格式化

良好的格式化代码对我们的浏览与维护有相当的好处。

4.7.1块

.NET提供了#Region...#EndRegion块控制。

我们应该根据代码所实现的功能分类并以块组织起来。

4.7.2缩进

每个层次直接都应该以Tab进行缩进，而不是Space（空格键）。

4.7.3流

每个方法、函数、属性、事件应该有且只有一个入口和一个出口。

如果遇见多层嵌套而需要直接跳出的时候，请使用局部Boolean或者Integer变量来标示用以多层跳出。

如：

PrivateFunctionTestForReturn（） As Boolean

Dimo_blnRet AsBoolean=False

DimiAsInteger,jAsInteger

Fori=1To100

Forj=1To10

If（x）Then

o_blnRet=True

Exit For

Else

End If

Next

If o_blnRet Then

Exit For

Else

End If

Next

Return o_blnRet ''这里是唯一出口

End Function

4.8注释

4.8.1注释规范

1） 注释中，应标明对象的完整的名称及其用途，但避免对代码过于详细描述

2） 每行注释的最大长度为100个字符

3）将注释与注释分隔符用一个空格分开

4）不允许给注释加外框

5）编码的同时书写注释

6）重要变量必须有注释

7）变量注释和变量在同一行，与变量分开至少一个“Tab”键

8）典型算法必须有注释

9）在循环和逻辑分支地方的上行必须就近书写注释

10）程序段或语句的注释在程序段或语句的上一行

11）在代码交付之前，必须删掉临时的或无关的注释

12）为便于阅读代码，每行代码的长度应少于100个字符

4.8.2类（包括Form等）、模块、组件、控件

每个类、模块、组件、控件最开始的地方必须输入该对象的信息，样例内容与格式如下：

‘*****************************************************************

‘*  对象名称：

OnlineUpdateService

‘*  功能说明：

在线更新WebServices

‘*  创建日期：

2008/08/27

‘*****************************************************************

一般地，我们要求内容有：

对象名称、命名空间、作者、功能说明、创建日