1、软件开发流程管理规范软件开发流程管理规范 .1 一、概述 .2 二、流程 .2 三、附件 .3 附件一、编码规范 .3 1、命名空间 .3 2、命名规则 .3 2.1文件夹及相关文件命名规则 .3 2.2数据库表命名规则 .4 3、代码规范 .4 3.1代码分层结构 .4 3.2编码规范 .5 4、注释 .6 4.1注释模板设置 .6 4.2手工添加注释 .7 4.3注释要求 .8 附件二、软件需求申请表 .9 附件三、软件开发申请表 .10 附件四、项目组成成员表 .11 附件五、项目策划 / 任务书 .12 附件六、 WBS表 .13 附件七、项目进度计划表 .14 附件八、项目风险管理表
2、 .15 附件九、项目沟通计划表 .16 附件十、项目会议纪要 .17 附件十一、项目状态报告表 .18 附件十二、项目变更管理表 .19 附件十三、项目总结表 .20 一、概述随着公司规模的扩大、各部门对软件需求的激增、提高效率的工作要求， IT部门承接的软件开发项目越来越多，而与之相对应的就是软件开发流程不明确，软件项目的随意性较大、可追溯性较差、可统计性模糊、可预测性不足是摆在我们面前最直接的问题。为了适应公司的发展， IT部软件开发项目特制订本流程。二、流程由上图可以得出以下几个关键步骤：一、需求部门：I、需求部门首先需要填写软件需求申请表，说明需要开发的软件具体用途径、目前工作模式、
3、工作不方便之处、基本功能等信息；II、待 IT部门评审通过后，通知需求部门，填写软件开发申请表，具体列明需要实现的功能、目前工作流程、使用系统后需要达到的状态，可节省的人力、物力，调高的效率等信息；III、软件开发测试完成之后，接受 IT部门的软件使用培训，并填写参与培训确认单；IV、软件试用结束后，填写软件验收表，完成软件项目的开发流程；V、在开发测试过程中，遇到开发风险增加、需求变更等，都需要配合 IT软件开发人员填写相关的项目风险管理表和项目变更管理表。二、 IT部门：I、积极对需求部门提出的软件需求申请表进行评审、审批，限 3个工作日完成，及时反馈结果给需求部门；II、指导需求部门填写
4、各类表格；III、积极评审需求部门填写的表格、积极沟通，有效获得相对准确的需求，并填写完善，让需求部门签字确认；IV、进入开发流程后，积极填写项目成员组成表、项目策划任务书、 WBS表、项目进度计划表等（具体见附件）；V、积极开展人员培训和软件试用工作，编写完善的 XXX软件试用说明书，并要求相关人员签字确认，并存档处理。三、附件附件一、编码规范1、命名空间1. 公共类库（公司功能业务）：（ 1 ）全局公共类库：例： ECO.Common.DBhelper/Excel/email, 生成 dll 文件，添加至最小应用库可全程序引用（ 2）局部公共类库（主要区分公司），命名方式为专有业务场景 +
5、专有业务名 +具体类名：例： ECO.Gp（总部） /In （国内市场） /Rb（生产）注：（公共类库）信息登记、评审、信息共享，命名空间最多三层2. 项目程序文件：项目文件名 ,以核心功能的英文名称为准 ,格式 :ECO_英文名词首字母大写2、命名规则2.1文件夹及相关文件命名规则a) 文件夹：功能文件夹，采用驼峰形式，首字母大写全称窗体文件：采用驼峰形式，首字母大写全称接口： I+采用驼峰形式，首字母大写全称方法名：采用驼峰形式，首字母大写全称窗体控件：同上b) c) d) e) f) 局部变量：变量类型缩写（ int， fl， str） +驼峰形式全局变量：不建议使用g) h) 常量：全
6、英文大写，不建议出现在页面数组：功能名称首字母小写 +驼峰 +Arr List集合：功能名称首字母小写 +驼峰 +List 字典：功能名称首字母小写 +驼峰 +Dic Dateset：功能名称首字母小写 +驼峰 +Ds DateTable：功能名称首字母小写 +驼峰 +Dt i) j) k) l) m) 附表 1：类型前缀（小写） +驼峰样式名词或名词短语对于基本类型变量，前缀如下表：类型int 前缀int dou fl double float string bool str bool datetime byte . dat byt . 对于对象类型变量，也可以采用类似基本类型方式，如 St
7、ringBuilder 类型，可使用 sb作为前缀开头，后跟变量名驼峰样式。对于集合类型变量，如数组、 List、 Dictionary ，可以在变量命名的基础上结尾加入集合类型简写。如， sqlList， dataDic等。2.2数据库表命名规则命名方法：项目大写首字母 +_+功能（全英文大写）【多单词组成的，取单词首字母大写组合】表字段：类似变量命名索引 :表名（或缩写） +_+列名 +idx 注： ID、创建人（ creator ）、创建时间（ createTime）、状态（ state）、创建人工号（ createID）等字段为必须创建的字段 ; 3、代码规范3.1代码分层结构建议每个
8、模块中代码至少分三层结构 ,根据项目大小决定是否采用这种方式 ,可以先以一两个项目测试一下这种结构 ; 表现层逻辑层数据层例如一个项目的一个模块，可以创建文件夹结构如下所示：表现层页面*.aspx 数据层 *.cs 逻辑层 *.cs 表现层直接面向用户，逻辑层负责后端逻辑处理，数据层负责和底层数据库交互。表现层调用逻辑层代码，只有查询数据时，表现层可以直接调用数据层；逻辑层负责处理逻辑，为表现层提供调用接口，其数据操作需要调用数据层提供接口；数据层负责提供和处理数据，需要为逻辑层提供调用接口，所有与数据库的操作都只能在该层实现。3.2编码规范3.2.1 通用a) b) c) d) e) f)
9、g) h) i) j) k) l) 类功能必须唯一：每个文件中只有一个类（不包括内部类）行宽限制在 80个字符内，必须按最低优先级换行方法代码限制在 200 行内类代码建议限制在 1500 行内方法参数过长，应分行显示，逗号至于末尾每行声明一个变量，且尽量赋初值，同类型必须连续写复合语句都需加大括号 ，不要写在一行， if 、 else尽量配对出现， try 、 catch、 finally 高扇入、合理扇出（尽量不超过三层）缩进不允许空行递归要慎用， goto不允许使用方法内禁止更改传递过来的参数实体类中变量应私有化，应包含每个变量的 set 及 get 方法m)避免三层以上嵌套循环n) o
10、) p) q) r) s) t) u) 代码应包含正确性和容错性处理（ try、 catch、 finally ）编程时应考虑代码的效率（时间、空间），多循环内侧，变量声明放在循环外对象比较用对应方法不用“ =”，例如： equals， compare to 计算尽量避免除法设计方法可重用性else、 finally 、 catch、日志必须有出口堆常量统一定义，避免用常量字符串变量必须初始化3.2.2 表现层页面端1、 JS代码和 CSS代码统一放置在 html 的 h ead子元素中；2、 JS代码需要有注释；3、页面控件有嵌套情况的，各级需要缩进，并且各级的头尾对齐；页面处理类1、页面加
11、载时谨慎处理 Session置空；2、类中多处用到的变量建议创建成员变量，成员变量应私有化（ private ），位于类代码上方；3、除用于 E 前台调用的如 App.direct 方法需为 public 外，其他方法建议均为private ；4、 Page_Load方法：建议将页面加载方法中内容加入if (!X.IsAjaxRequest) 代码块中，避免页面每次操作后都调用 Page_Load方法；5、获取页面的服务端控件的值前需对控件值的 null 和空进行判断，避免空指针异常；6、避免过多或复杂的逻辑处理代码，统一调用逻辑层代码，将展现和逻辑分离；7、对数据的增删改操作不要直接调用数据
12、层，查询可直接调用数据层代码；3.2.3 逻辑层1、除对表现层提供的接口方法外，其他方法均保持私有 private 2、对数据库数据处理调用数据处理层代码3、对串行的数据处理时事务保证4、逻辑代码容错性保证3.2.4 数据处理层1、除对外提供的接口方法外，其他方法均保持私有 private 2、对数据库的底层访问（获取数据库连接、执行 sql 语句、数据库连接关闭）均调用数据库操作帮助类3、数据处理层类中只处理数据，避免业务逻辑代码4、 sql语句编写时避免使用“ +”5、数据库操作帮助类中数据库操作的容错性和事务处理（插入、更新、删除操作需要事务保证）4、注释编写任何代码都需要有代码注释，并
13、且代码修改后也要修改注释，保证代码注释同步。4.1注释模板设置在 vs安装目录，以下目录中，找到 class.cs文件，修改保存后，重启 v s，之后创建新类时即会自动产生注释。D:Program Files (x86)Microsoft Visual Studio 10.0Common7IDEItemTemplatesCacheCSharpCode2052Class.zip 但是修改后没有效果。4.2手工添加注释创建新对象可以手工添加注释：注释写法：块注释注释包含在 /* 和 */ 中，可以有多行。行注释以 / 开头，可以有多行，每行前面都以 / 开头。文件头注释/* = * Copyrig
14、ht ? 2013 ECOVACS Inc. All rights reserved! *科沃斯机器人科技 (苏州 )有限公司* =*/ 类文件注释/* *DESC :类功能描述* SINCE : .net版本* CREATOR:创建人* DATE: */ 创建日期方法注释/* *DESC :方法功能描述* PARAMS:参数说明* RETURN:返回值说明* CREATOR:创建人* DATE: */ 创建日期4.3注释要求a) b) c) d) e) 注释量： 20%30%，项目完成周期延长 20% 注释地方：段前以及当行之后上线之前无需版本号，上线之后需版本号，上线前统一为 1.0 注释与自身方法之间不为空，其他方法必须为空注释代码在上线后全删除，上线后不允许无效代码存在注：注释中的内容含创建人、创建时间、功能描述、参数说明、修改人、修改时间、修改描述、返回值；上线后每个源码备份空间附件二、软件需求申请表需求部门：用途描述申请人：目前工作状态基本功能描述部门主管建议签字确认（时间）附件三、软件开发申请表需求部门： 申请人：具体功能模块说明目前工作流程项目完成所能带来的预期效益（可节省的人力、物力等）部门主管建议签字确认（时间）
