信息系统软件开发流程管理规范初稿

软件开发流程管理规范软件开发流程管理规范一、概述二、流程2三、附件3附件一、编码规范31、命名空间32、命名规则32.1文件夹及相关文件命名规则32.2数据库表命名规则、代码规范43。1 代码分层结构42 编码规范54、注释64.1 注释模板设置64.2 手工添加注释74.3 注释要求8附件二、软件需求申请表9附件三、软件开发申请表10附件四、项目组成成员表11附件五、项目策划/任务书12附件六、W 表13附件七、项目进度计划表14附件八、项目风险管理表5附件九、项目沟通计划表1附件十、项目会议纪要17附件十一、项目状态报告表18附件十二、项目变更管理表1附件十三、项目总结表20一、概述随着公司规模的扩大、各部门对软件需求的激增、提高效率的工作要求,IT部门承接的软件开发项目越来越多,而与之相对应的就是软件开发流程不明确,软件项目的随意性较大、可追溯性较差、可统计性模糊、可预测性不足是摆在我们面前最直接的问题.为了适应公司的发展,T部软件开发项目特制订本流程。二、流程由上图可以得出以下几个关键步骤：一、需求部门:I、需求部门首先需要填写软件需求申请表,说明需要开发的软件具体用途径、目前工作模式、工作不方便之处、基本功能等信息；II、待 T部门评审通过后,通知需求部门,填写软件开发申请表，具体列明需要实现的功能、目前工作流程、使用系统后需要达到的状态，可节省的人力、物力,调高的效率等信息;III、软件开发测试完成之后，接受 IT部门的软件使用培训，并填写参与培训确认单;IV、软件试用结束后，填写软件验收表，完成软件项目的开发流程；V、在开发测试过程中,遇到开发风险增加、需求变更等，都需要配合 IT软件开发人员填写相关的项目风险管理表和项目变更管理表。二、IT部门：I、积极对需求部门提出的软件需求申请表进行评审、审批,限 个工作日完成,及时反馈结果给需求部门；II、指导需求部门填写各类表格;II、积极评审需求部门填写的表格、积极沟通,有效获得相对准确的需求,并填写完善，让需求部门签字确认；IV、进入开发流程后，积极填写项目成员组成表、项目策划任务书、W 表、项目进度计划表等(具体见附件）;V、积极开展人员培训和软件试用工作，编写完善的XXX软件试用说明书,并要求相关人员签字确认,并存档处理。三、附件附件一、编码规范1、命名空间.公共类库（公司功能业务)：(1)全局公共类库：例：CO.CommonDBhlper/Exel/eail，生成ll文件，添加至最小应用库可全程序引用（2)局部公共类库（主要区分公司)，命名方式为专有业务场景+专有业务名具体类名:例:ECO。(总部）/In（国内市场)/b(生产)注：（公共类库)信息登记、评审、信息共享,命名空间最多三层2.项目程序文件:项目文件名，以核心功能的英文名称为准,格式：ECO英文名词首字母大写2、命名规则2。1文件夹及相关文件命名规则） 文件夹:功能文件夹,采用驼峰形式，首字母大写全称b) 窗体文件：采用驼峰形式,首字母大写全称) 接口:I+采用驼峰形式,首字母大写全称) 方法名:采用驼峰形式，首字母大写全称e） 窗体控件：同上f） 局部变量:变量类型缩写（nt,f,)+驼峰形式g) 全局变量:不建议使用h) 常量:全英文大写，不建议出现在页面i） 数组：功能名称首字母小写+驼峰rj）Li集合：功能名称首字母小写+驼峰+Litk）字典:功能名称首字母小写+驼峰+Dil）ateset:功能名称首字母小写驼峰+m) Daeable：功能名称首字母小写驼峰+Dt附表1:类型前缀(小写)+驼峰样式名词或名词短语对于基本类型变量,前缀如下表:类型前缀intintduledoufloatflstrigstbolbooldatetdatybt.。.。.对于对象类型变量,也可以采用类似基本类型方式，如 Srigulder 类型,可使用 作为前缀开头,后跟变量名驼峰样式。对于集合类型变量，如数组、Lis、Ditioar,可以在变量命名的基础上结尾加入集合类型简写如,qlList,data等。2。2数据库表命名规则命名方法:项目大写首字母+_功能(全英文大写）【多单词组成的,取单词首字母大写组合】表字段：类似变量命名索引:表名（或缩写）+_列名+idx注：ID、创建人(reatr）、创建时间(createTie)、状态(sta）、创建人工号（cretI)等字段为必须创建的字段；3、代码规范3。1代码分层结构建议每个模块中代码至少分三层结构，根据项目大小决定是否采用这种方式,可以先以一两个项目测试一下这种结构；表现层数据层逻辑层例如一个项目的一个模块,可以创建文件夹结构如下所示:表现层页面 *.aspx 数据层 *.cs 逻辑层 *.cs表现层直接面向用户,逻辑层负责后端逻辑处理，数据层负责和底层数据库交互.表现层调用逻辑层代码，只有查询数据时，表现层可以直接调用数据层;逻辑层负责处理逻辑,为表现层提供调用接口,其数据操作需要调用数据层提供接口;数据层负责提供和处理数据,需要为逻辑层提供调用接口,所有与数据库的操作都只能在该层实现。3。2编码规范3.2。1通用a)类功能必须唯一：每个文件中只有一个类（不包括内部类)b)行宽限制在0个字符内,必须按最低优先级换行c)方法代码限制在0行内d)类代码建议限制在150行内e）方法参数过长,应分行显示，逗号至于末尾f)每行声明一个变量,且尽量赋初值，同类型必须连续写g)复合语句都需加大括号,不要写在一行，f、else尽量配对出现,ty、atch、inalyh）高扇入、合理扇出（尽量不超过三层)i)缩进不允许空行)递归要慎用,goto不允许使用）方法内禁止更改传递过来的参数)实体类中变量应私有化，应包含每个变量的et及et方法m) 避免三层以上嵌套循环n）代码应包含正确性和容错性处理(try、cach、finall）o)编程时应考虑代码的效率（时间、空间)，多循环内侧,变量声明放在循环外p)对象比较用对应方法不用“=”,例如:ual，comparetoq)计算尽量避免除法r）设计方法可重用性s) lse、iall、cach、日志必须有出口t) 堆常量统一定义，避免用常量字符串） 变量必须初始化3.2.2表现层页面端1、代码和CS代码统一放置在html的head子元素中;、代码需要有注释;、页面控件有嵌套情况的,各级需要缩进，并且各级的头尾对齐;页面处理类1、页面加载时谨慎处理Session置空;、类中多处用到的变量建议创建成员变量，成员变量应私有化（prvate）,位于类代码上方;3、除用于E前台调用的如App.direct方法需为publi外,其他方法建议均为privat;4、Page_Loa方法:建议将页面加载方法中内容加入i(!X.IAjaxRquet)代码块中,避免页面每次操作后都调用age_Ld方法;5、获取页面的服务端控件的值前需对控件值的null和空进行判断，避免空指针异常;6、避免过多或复杂的逻辑处理代码，统一调用逻辑层代码,将展现和逻辑分离；7、对数据的增删改操作不要直接调用数据层,查询可直接调用数据层代码；3。逻辑层1、除对表现层提供的接口方法外，其他方法均保持私有pivate2、对数据库数据处理调用数据处理层代码3、对串行的数据处理时事务保证4、逻辑代码容错性保证3。2。4数据处理层1、除对外提供的接口方法外,其他方法均保持私有prvae2、对数据库的底层访问（获取数据库连接、执行 sql语句、数据库连接关闭)均调用数据库操作帮助类3、数据处理层类中只处理数据，避免业务逻辑代码4、q 语句编写时避免使用“+5、数据库操作帮助类中数据库操作的容错性和事务处理（插入、更新、删除操作需要事务保证)4、注释编写任何代码都需要有代码注释,并且代码修改后也要修改注释，保证代码注释同步。注释模板设置在vs安装目录，以下目录中，找到clss。cs文件,修改保存后，重启v，之后创建新类时即会自动产生注释.：roamFiles(86）icrosoftVialStdo1.0ConIDEIteTemplatesCaheCSharpCode202Cass。i但是修改后没有效果.4。2手工添加注释创建新对象可以手工添加注释:注释写法:块注释注释包含在/*和*/中,可以有多行。行注释以/开头，可以有多行，每行前面都以/开头。文件头注释/* =* Copyright 2013 ECOVACS Inc. All rights reserved!* 科沃斯机器人科技(苏州)有限公司*=*/类文件注释/*DESC: 类功能描述* SINCE: .net 版本* CREATOR: 创建人* DATE:创建日期*/方法注释/*DESC: 方法功能描述* PARAMS: 参数说明* RETURN: 返回值说明* CREATOR: 创建人* DATE:创建日期*/4.3注释要求)注释量：203%，项目完成周期延长2)注释地方:段前以及当行之后)上线之前无需版本号，上线之后需版本号,上线前统一为1。0)注释与自身方法之间不为空,其他方法必须为空）注释代码在上线后全删除,上线后不允许无效代码存在注:注释中的内容含创建人、创建时间、功能描述、参数说明、修改人、修改时间、修改描述、返回值;上线后每个源码备份空间附件二、软件需求申请表需求部门:申请人：用途描述目前工作状态基本功能描述部门主管建议签字确认(时间)附件三、软件开发申请表需求部门:申请人:具体功能模块说明目前工作流程项目完成所能带来的预期效益(可节省的人力、物力等）部门主管建议签字确认（时间)附件四、项目组成成员表一、项目基本情况项目名称（PoectName)：项目编号(ojeCode）：制作人(rearedby）：审核人(Revieeby）:项目经理(Poet nge):制作日期（Data)：二、项目组成员成员姓名e项目角色roectole所在部门Deptame职责Respnibility项目起止日期Data投入频度及工作量Ti联系电话Tel No.主管经理urvisor签字Sigture：日期Date:项目赞助人Sponsr项目经理 Prjecnagr项目角色包括项目赞助人(Spsor）、项目经理(Manae）、项目核心成员(Coe team)和项目非核心成员(xtendedteam).附件五、项目策划/任务书一、项目基本情况项目名称（Proec):项目编号（ProjctCoe)：制作人（Prepadby)：审核人(Reviewedb):项目经理（Project Mage）:制作日期(ata)：二、项目描述1、项目背景与目的（所有的项目均起始于某个商业问题，该部分简要描述这些问题）2、项目目标（包括质量目标,工期目标、费用目标和交付产品特征与特征的主要描述）3、项目里程碑计划（包含里程碑的时间和成果)4、评价标准(说明项目成果在何种情况下将被接受)5、项目假定与约束条件(说明项目的主要假设条件和限制性条件）6、项目主要利益干系人(包括高管、客户、职能部门主管、供应商、项目赞助人、项目经理、项目组成成员等干系人）姓名类别部门职务附件六、W表一、项目基本情况项目名称(Project Nae）：项目编号(ProjtCod）:制作人（Ppaedby）:审核人（Reviwedby）:项目经理（rojet Manage):制作日期（Daa)：二、工作分解结构分解代码Wd任务名称Tak包含活动AciitiesInclued工时估算timaedTim人力资源EtimtedHR其他资源Estmatesources费用估计EstiatdCost工期xpectedDays注：以上工期及费用估算均用最可能值附件七、项目进度计划表一、项目基本情况项目名称（ProjectName）:项目编号(ProjectCde):制作人（repay）:审核人（eviwedby):项目经 理 (ProjctManager):制作日期（Dta):二、项目进度表周(Wk）012责任人TeamMmbr关键里程碑ilesone开始Stat293031236781112开工会 Kckffetng附件八、项目风险管理表一、项目基本情况项目名称（rojet Name)：项目编号(PojecCoe）：制作人（Pparedby):审核人(Reviby)：项目经理(Prjt anage）:制作日期(Data)：二、项目风险管理风险发生概率的判断准则高风险:6发生风险的可能性中风险：60%发生风险的可能性低风险:30发生风险的可能性序号eueNO.风险描述RisDescription发生概率HapeingProbiliy影响程度luenedeee风险等级RiskLeve风险响应计划RikResponsla责任人Riswer开放/关闭Opn/Closd附件九、项目沟通计划表一、项目基本情况项目名称(Proect Na）:项目编号（Pojectde)：制作人(rearby):审核人（eiewb）：项目经理（PojctManager):制作日期（ata）：二、项目沟通计划利益干系人Stakeholrs所需信息noeeded频率Frquen方法Mes责任人Rskownr附件十、项目会议纪要一、基本情况会议名称（MetingNae)：召集人(Calledy)：会议日期(Meetgate）:开始时间(SttTim)：会议地点(MeetingPae）：持续时间（eetngurton)：记录人（Minut ):审核人(eviewdB）:二、会议目标简要说明会议的目标，包括期望达到的结果三、参加人员(列出参加会议的人员，他在项目中的头衔或角色)四、发放材料(列出会议讨论的所有项目资料）五、发言记录(记录发言人的观点、意见和建议)六、会议决议（说明会议结论）七、会议纪要发放范围附件十一、项目状态报告表一、项目基本情况项目名称（ProectNae):项目编号（PrectCode):制作人(Preparedy):审核人(Revewedy):项目经理（Projct anage)：制作日期(Data）:当前项目状况按计划进行比计划提前落后计划汇报周期二、当前任务状态(简要描述任务进展情况)关键人物状态指示状态描述三、本周期内的主要活动(对本周期内的主要交付物进行总结）四、下一个汇报周期内的活动计划（描述活动需要与项目计划和W相对应)五、财务状况六、上期遗留问题的处理（说明上一个汇报周期内问题的处理意见和处理结果)七、本期问题与求助附件十二、项目变更管理表一、项目基本情况项目名称（rc Nme):项目编号(Projectde)：制作人（Preparedby)：审核人（Revwby)：项目经理（Project anger）：制作日期（Da):二、历史变更记录（按时间顺序记录项目以往的每一次变更情况)序号equnce N.变更时间ChangeDae涉及项目任务akCocernd变更要点Chango变更理由WhyRquete申请人RestBy审批人AovedBy三、请求变更信息(建议的变更描述以及参考资料）、申请变更的内容2、申请变更原因四、影响分析受影响的基准计划1、进度计划2、费用计划、资源计划是否需要成本/进度影响分析?是否对成本的影响对进度的影响对资源的影响变更程度分类高中低若不进行变更有何影响申请人签字申请日期五、审批结果审批意见审批人签字日期附件十三、项目总结表一、项目基本情况项目名称（Pje)：项目编号（Prjecoe):制作人（Preparedby）:审核人(viweby):项目经理（Pojt Manger):制作日期（Data):二、项目完成情况总结1、时间总结开始时间：StartDate计划完成时间ExpeceFnishDe实际完成日期cua Finihat时间(差异）分析2、成本总结计划费用实际费用成本（差异）分析3、交付结果总结计划交付结果实际交付结果未交付结果交付结果（差异）分析三、项目经验、教训总结签字ignature日期Date项目赞助人 ProectSposor项目经理 ojecanaer