软件开发文档指南.doc

《软件开发文档指南.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、这个只是模板目录1.范围12.总体要求12.1总体功能要求12.2软件开发平台要求12.3软件项目的开发实施过程管理要求22.3.1软件项目实施过程总体要求22.3.2软件项目实施变更要求22.3.3软件项目实施里程碑控制23.软件开发33.1软件的需求分析33.1.1需求分析33.1.2需求分析报告的编制者43.1.3需求报告评审43.1.4需求报告格式43.2软件的概要设计43.2.1概要设计43.2.2编写概要设计的要求43.2.3概要设计报告的编写者43.2.4概要设计和需求分析、详细设计之间的关系和区别43.2.5概要设计的评审43

2、.2.6概要设计格式43.3软件的详细设计53.3.1详细设计53.3.2特例53.3.3详细设计的要求53.3.4数据库设计53.3.5详细设计的评审53.3.6详细设计格式53.4软件的编码53.4.1软件编码53.4.2软件编码的要求53.4.3编码的评审63.4.4编程规范及要求63.5软件的测试63.5.1软件测试63.5.2测试计划63.6软件的交付准备63.6.1交付清单63.7软件的鉴定验收73.7.1软件的鉴定验收73.7.2验收人员73.7.3验收具体内容73.7.4软件验收测试大纲73.8培训73.8.1系统应用培训73

3、.8.2系统管理的培训（可选）8附录A软件需求分析报告文档模板9附录B软件概要设计报告文档模板21附录C软件详细设计报告文档模板33附录D软件数据库设计报告文档模板43附录E软件测试(验收)大纲551.范围本指南用于指导软件开发者为南京市交通局开发软件项目的过程，通过规范软件项目承担单位的开发过程达到提高软件质量，降低维护成本的目的。开发者应根据本指南进行软件开发和编制软件开发文档。本指南是对软件项目承担单位的基本要求。在本指南的附录A至E中提供了文档的编写模板供开发者参考，在进行具体软件开发时，开发者可根据实际情况采编写，但必须提供双方约定

4、的文档，文档中约定的内容必须描述清楚。2.总体要求2.1总体功能要求网络应用环境以Internet/Intranet技术为核心。开发者应在充分分析需求的基础上，选择采用B/S结构或者C/S结构。软件系统的数据库应依照《南京市交通局信息化数据库建设规范》进行设计和建设。本指南中没有规定开发者采用何种具体的软件工程开发方法，开发者可根据项目具体特点、自身擅长来选择采用面向过程的方法、面向对象的方法或面向数据的方法，但建议开发商使用面向对象软件工程的方法，如：采用目前被广泛使用的RUP(RationalUnifiedProcess)方法来进行分析、

5、设计和开发。2.2软件开发平台要求开发者开发的软件必须能够在南京市交通局规定的软件平台上正常运行。目前软件平台为：数据库管理系统：Oracle9i以上版本中间件(应用服务器)系统：IBMWebSphereOA系统：LotusDomino/Notes网络架构：完全支持TCP/IP协议开发工具或技术体系：为保证软件的上下兼容性，开发者应选择比较通用的开发工具的较新版本进行开发，如MicrosoftVisualStudio.Net，BorlandDelphi，C++Builder,或J2EE(Java2P1atformEnterpriseEditi

6、on)等。1.1软件项目的开发实施过程管理要求1.1.1软件项目实施过程总体要求（一）开发者提交软件开发工作大纲，交通局组织专家组对工作大纲进行评审，并提出整改意见。（二）通过评审后，开发者根据整改意见完善工作大纲，经过交通局认可后组织项目组进行软件开发。软件开发工作按照需求分析、概要设计、详细设计、编码、测试等几个阶段进行，在开发过程中，开发者需分阶段提交相关文档。（三）在软件开发工作完成后，开发者应向交通局提交完整的软件文档，交通局组织验收组对软件进行验收审查。1.1.2软件项目实施变更要求在开发过程中，需求或设计不可避免地需要发生变更，

7、相关变更必须经过交通局书面同意方可进行。在需求或设计发生变更时，需要对原有文档进行修改，并提供完整的变更记录，以使变更处于可控制的状态。变更单如下表所示：表2-1变更单需求变更申请申请变更的需求文档输入名称，版本，日期等信息变更的内客及其理由评估需求变更将对项目造成的影响申请人签字变更申请的审批意见项目经理签字审批意见：签字日期客户签字(合同项目)审批意见：签字日期更改需求文档变更后的需求文档输入名称，版本，完成日期等信息更改人签字重新评审需求文档需求评审小组签字评审意见：签字日期变更结束项目经理签字签字日期1.1.3软件项目实施里程碑控制交

8、通局将分四个阶段进行把关，召开专家审查会。（一）需求分析（结合原型进行审查）确认；（四）概要设计+数据库设计；（一）预验收（试运行后）；（二）正式验收（推广使用后）