1、软件开发流程管理规范软件开发流程管理规范软件开发流程管理规范.1一、概述.2二、流程.2三、附件.3附件一、编码规范.31、命名空间.32、命名规则.32.1文件夹及相关文件命名规则.32.2数据库表命名规则.43、代码规范.43.1代码分层结构.43.2编码规范.54、注释.64.1注释模板设置.64.2手工添加注释.74.3注释要求.8附件二、软件需求申请表.9附件三、软件开发申请表.10附件四、项目组成成员表.11附件五、项目策划/任务书 .12附件六、WBS表 .13附件七、项目进度计划表.14附件八、项目风险管理表.15附件九、项目沟通计划表.16附件十、项目会议纪要.17附件十一、
2、项目状态报告表.18附件十二、项目变更管理表.19附件十三、项目总结表.20一、概述随着公司规模的扩大、各部门对软件需求的激增、提高效率的工作要求,IT部门承接的软件开发项目越来越多,而与之相对应的就是软件开发流程不明确,软件项目的随意性较大、可追溯性较差、可统计性模糊、可预测性不足是摆在我们面前最直接的问题。为了适应公司的发展,IT部软件开发项目特制订本流程。二、流程由上图可以得出以下几个关键步骤:一、需求部门:I、需求部门首先需要填写软件需求申请表,说明需要开发的软件具体用途径、目前工作模式、工作不方便之处、基本功能等信息;II、待 IT部门评审通过后,通知需求部门,填写软件开发申请表,具
3、体列明需要实现的功能、目前工作流程、使用系统后需要达到的状态,可节省的人力、物力,调高的效率等信息;III、软件开发测试完成之后,接受 IT部门的软件使用培训,并填写参与培训确认单;IV、软件试用结束后,填写软件验收表,完成软件项目的开发流程;V、在开发测试过程中,遇到开发风险增加、需求变更等,都需要配合 IT软件开发人员填写相关的项目风险管理表和项目变更管理表。二、IT部门:I、积极对需求部门提出的软件需求申请表进行评审、审批,限 3个工作日完成,及时反馈结果给需求部门;II、指导需求部门填写各类表格;III、积极评审需求部门填写的表格、积极沟通,有效获得相对准确的需求,并填写完善,让需求部
4、门签字确认;IV、进入开发流程后,积极填写项目成员组成表、项目策划任务书、WBS表、项目进度计划表等(具体见附件);V、积极开展人员培训和软件试用工作,编写完善的XXX软件试用说明书,并要求相关人员签字确认,并存档处理。三、附件附件一、编码规范1、命名空间1.公共类库(公司功能业务):(1 )全局公共类库:例:ECO.Common.DBhelper/Excel/email,生成 dll文件,添加至最小应用库可全程序引用(2)局部公共类库(主要区分公司),命名方式为专有业务场景+专有业务名+具体类名:例:ECO.Gp(总部)/In(国内市场)/Rb(生产)注:(公共类库)信息登记、评审、信息共享
5、,命名空间最多三层2.项目程序文件:项目文件名,以核心功能的英文名称为准,格式:ECO_英文名词首字母大写2、命名规则2.1文件夹及相关文件命名规则a)文件夹:功能文件夹,采用驼峰形式,首字母大写全称窗体文件:采用驼峰形式,首字母大写全称接口:I+采用驼峰形式,首字母大写全称方法名:采用驼峰形式,首字母大写全称窗体控件:同上b)c)d)e)f)局部变量:变量类型缩写(int,fl,str)+驼峰形式全局变量:不建议使用g)h)常量:全英文大写,不建议出现在页面数组:功能名称首字母小写+驼峰+ArrList集合:功能名称首字母小写+驼峰+List字典:功能名称首字母小写+驼峰+DicDatese
6、t:功能名称首字母小写+驼峰+DsDateTable:功能名称首字母小写+驼峰+Dti)j)k)l)m)附表 1:类型前缀(小写)+驼峰样式名词或名词短语对于基本类型变量,前缀如下表:类型int前缀intdoufldoublefloatstringboolstrbooldatetimebyte.datbyt.对于对象类型变量,也可以采用类似基本类型方式,如 StringBuilder类型,可使用 sb作为前缀开头,后跟变量名驼峰样式。对于集合类型变量,如数组、List、Dictionary,可以在变量命名的基础上结尾加入集合类型简写。如,sqlList,dataDic等。2.2数据库表命名规则
7、命名方法:项目大写首字母+_+功能(全英文大写)【多单词组成的,取单词首字母大写组合】表字段:类似变量命名索引:表名(或缩写)+_+列名+idx注:ID、创建人(creator)、创建时间(createTime)、状态(state)、创建人工号(createID)等字段为必须创建的字段;3、代码规范3.1代码分层结构建议每个模块中代码至少分三层结构,根据项目大小决定是否采用这种方式,可以先以一两个项目测试一下这种结构;表现层逻辑层数据层例如一个项目的一个模块,可以创建文件夹结构如下所示:表现层页面 *.aspx数据层 *.cs逻辑层 *.cs表现层直接面向用户,逻辑层负责后端逻辑处理,数据层负
8、责和底层数据库交互。表现层调用逻辑层代码,只有查询数据时,表现层可以直接调用数据层;逻辑层负责处理逻辑,为表现层提供调用接口,其数据操作需要调用数据层提供接口;数据层负责提供和处理数据,需要为逻辑层提供调用接口,所有与数据库的操作都只能在该层实现。3.2编码规范3.2.1通用a)b)c)d)e)f)g)h)i)j)k)l)类功能必须唯一:每个文件中只有一个类(不包括内部类)行宽限制在 80个字符内,必须按最低优先级换行方法代码限制在 200行内类代码建议限制在 1500行内方法参数过长,应分行显示,逗号至于末尾每行声明一个变量,且尽量赋初值,同类型必须连续写复合语句都需加大括号 ,不要写在一行
9、,if、else尽量配对出现,try、catch、finally高扇入、合理扇出(尽量不超过三层)缩进不允许空行递归要慎用,goto不允许使用方法内禁止更改传递过来的参数实体类中变量应私有化,应包含每个变量的 set及 get方法m)避免三层以上嵌套循环n)o)p)q)r)s)t)u)代码应包含正确性和容错性处理(try、catch、finally)编程时应考虑代码的效率(时间、空间),多循环内侧,变量声明放在循环外对象比较用对应方法不用“=”,例如:equals,compare to计算尽量避免除法设计方法可重用性else、finally、catch、日志必须有出口堆常量统一定义,避免用常量
10、字符串变量必须初始化3.2.2表现层页面端1、JS代码和 CSS代码统一放置在 html的 head子元素中;2、JS代码需要有注释;3、页面控件有嵌套情况的,各级需要缩进,并且各级的头尾对齐;页面处理类1、页面加载时谨慎处理 Session置空;2、类中多处用到的变量建议创建成员变量,成员变量应私有化(private),位于类代码上方;3、除用于 E前台调用的如 App.direct方法需为 public外,其他方法建议均为 private;4、Page_Load方法:建议将页面加载方法中内容加入if (!X.IsAjaxRequest)代码块中,避免页面每次操作后都调用 Page_Load
11、方法;5、获取页面的服务端控件的值前需对控件值的 null和空进行判断,避免空指针异常;6、避免过多或复杂的逻辑处理代码,统一调用逻辑层代码,将展现和逻辑分离;7、对数据的增删改操作不要直接调用数据层,查询可直接调用数据层代码;3.2.3逻辑层1、除对表现层提供的接口方法外,其他方法均保持私有 private2、对数据库数据处理调用数据处理层代码3、对串行的数据处理时事务保证4、逻辑代码容错性保证3.2.4数据处理层1、除对外提供的接口方法外,其他方法均保持私有 private2、对数据库的底层访问(获取数据库连接、执行 sql语句、数据库连接关闭)均调用数据库操作帮助类3、数据处理层类中只处
12、理数据,避免业务逻辑代码4、sql语句编写时避免使用“+”5、数据库操作帮助类中数据库操作的容错性和事务处理(插入、更新、删除操作需要事务保证)4、注释编写任何代码都需要有代码注释,并且代码修改后也要修改注释,保证代码注释同步。4.1注释模板设置在 vs安装目录,以下目录中,找到 class.cs文件,修改保存后,重启 vs,之后创建新类时即会自动产生注释。D:ProgramFiles(x86)MicrosoftVisualStudio10.0Common7IDEItemTemplatesCacheCSharpCode2052Class.zip但是修改后没有效果。4.2手工添加注释创建新对象可
13、以手工添加注释:注释写法:块注释注释包含在/*和*/中,可以有多行。行注释以/开头,可以有多行,每行前面都以/开头。文件头注释/* =* Copyright 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%,项目完成周
14、期延长 20%注释地方:段前以及当行之后上线之前无需版本号,上线之后需版本号,上线前统一为 1.0注释与自身方法之间不为空,其他方法必须为空注释代码在上线后全删除,上线后不允许无效代码存在注:注释中的内容含创建人、创建时间、功能描述、参数说明、修改人、修改时间、修改描述、返回值;上线后每个源码备份空间附件二、软件需求申请表需求部门:用途描述申请人:目前工作状态基本功能描述部门主管建议签字确认(时间)附件三、软件开发申请表需求部门:申请人:具体功能模块说明目前工作流程项目完成所能带来的预期效益(可节省的人力、物力等)部门主管建议签字确认(时间)附件四、项目组成成员表一、项目基本情况项目名称(Pr
15、oject Name):制作人(Prepared by):项目经理(Project Manager):二、项目组成员项目编号(Project Code):审核人(Reviewed by):制作日期(Data):成员姓名项目角色所在部门职责项目起止日 投入频度及联系电话主管经理NameProject RoleDept NameResponsibility期 Data工作量 TimeTel No.Supervisor签字 Signature:项目赞助人 Sponsor项目经理 Project Manager日期 Date:项目角色包括项目赞助人(Sponsor)、项目经理(Manager)、项目核
16、心成员(Core team)和项目非核心成员(Extended team)。附件五、项目策划/任务书一、项目基本情况项目名称(Project Name):制作人(Prepared by):项目经理(Project Manager):二、项目描述项目编号(Project Code):审核人(Reviewed by):制作日期(Data):1、项目背景与目的(所有的项目均起始于某个商业问题,该部分简要描述这些问题)2、项目目标(包括质量目标,工期目标、费用目标和交付产品特征与特征的主要描述)3、项目里程碑计划(包含里程碑的时间和成果)4、评价标准(说明项目成果在何种情况下将被接受)5、项目假定与约
17、束条件(说明项目的主要假设条件和限制性条件)6、项目主要利益干系人(包括高管、客户、职能部门主管、供应商、项目赞助人、项目经理、项目组成成员等干系人)姓名类别部门职务附件六、WBS表一、项目基本情况项目名称(Project Name):制作人(Prepared by):项目编号(Project Code):审核人(Reviewed by):项目经理(Project Manager):制作日期(Data):二、工作分解结构分解代码任务名称包含活动ActivitiesIncluded工时估算EstimatedTime人力资源其他资源费用估计EstimatedCost工期ExpectedDaysWB
18、S CodeTaskEstimated HREstimatedResources注:以上工期及费用估算均用最可能值附件七、项目进度计划表一、项目基本情况项目名称(Project Name):制作人(Prepared by):项目编号(Project Code):审核人(Reviewed by):制作日期(Data):项目经理(Manager):二、项目进度表周(Week)Project012责任人关键里程碑Team MemmberMilestone开始293031123456789101112Start开工会 Kick-off meeting附件八、项目风险管理表一、项目基本情况项目名称(Pr
19、oject Name):制作人(Prepared by):项目经理(Project Manager):二、项目风险管理项目编号(Project Code):审核人(Reviewed by):制作日期(Data):风险发生概率的判断准则高风险:60%发生风险的可能性中风险:30-60%发生风险的可能性低风险:30%发生风险的可能性序号Sequence NO.风险描述发生概率HappeningProbability影响程度Influencedegree风险等级风险响应计划责任人Risk开放/关闭Open/ClosedRisk DescriptionRisk LevelRiskPlanResponseowner附件九、项目沟通计划表一、项目基本情况项目名称(Project Name):制作人(Prepared by):项目经理(Project Manager):二、项目沟通计划项目编号(Project Code):审核人(Reviewed by):制作日期(Data):利益干系人所需信息频率方法责任人StakeholdersInfo NeededFrequencyMeansRisk owner附件十、项目会议纪要一、基本情况会议名称(Meeting Name):会议日期(Meeting Date):会议地
copyright@ 2008-2022 冰豆网网站版权所有
经营许可证编号:鄂ICP备2022015515号-1