文档介绍：该【软件设计文档模板 】是由【Bonnacon】上传分享，文档一共【67】页，该文档可以免费在线阅读，需要了解更多关于【软件设计文档模板 】的内容，可以使用淘豆网的站内搜索功能，选择自己适合的文档，以下文字是截取该文章内的部分文字，如需要获得完整电子版，请下载此文档到您的设备，方便您编辑和打印。软件设计文档模板
----GB8567-88
1目的.......................................................................................................................................22范围.......................................................................................................................................23文件的使用者.......................................................................................................................3
4软件生存周期与各种文件的编制.......................................................................................4
5文件编制中的考虑因素.......................................................................................................5
6文件编制的管理工作...........................................................................................................8
7可行性研究报告.................................................................................................................10
附录A.............................................................................................................................118项目开发计划.....................................................................................................................16
附录B.............................................................................................................................179软件需求说明书.................................................................................................................18
附录C.............................................................................................................................1910数据要求说明书...............................................................................................................21
附录D.............................................................................................................................2111概要设计说明书...............................................................................................................23
附录E.............................................................................................................................2412详细设计说明书................................................................................................................26
附录F.............................................................................................................................2713数据库设计说明书...........................................................................................................28
附录G.............................................................................................................................2914用户手册...........................................................................................................................30
附录H.............................................................................................................................3115操作手册...........................................................................................................................34
附录I..............................................................................................................................3516模块开发卷宗...................................................................................................................37
附录J..............................................................................................................................3817测试计划............................................................................................................................38
附录K.............................................................................................................................39
1
一项计算机软件的筹划、研制及实现,构成一个软件开发项目。一个软件开发项目的进
行,一般需要在人力和自动化资源等方面作重大的投资。为了保证项目开发的成功,最经
济地花费这些投资,并且便于运行和维护,在开发工作的每一阶段,都需要编制二定的文
件。这些文件连同计算机程序及数据一起,构成为计算机软件。文件是计算机软件中不可
缺少的组成部分,它的作用是:
;
,把软件开发过程中的一些“不可见的”
事物转换成“可见的”文字资料。以便管理人员在各个阶段检查开发计划的实施进展,使之
能够判断原定目标是否已达到,还将继续耗用资源的种类和数量;
,便于协调以后的软件开发、使用和修改;
、维护和培训的信息,便于管理人员、开发人员、操作人员和
用户之间相互了解彼此的工作;
,使他们能判定该软件能否服务于自己的需要。
换言之,本指南认为:文件的编制必须适应计算机软件整个生存周期的需要。
计算机软件所包含的文件有两类:一类是开发过程中填写的各种图表,可称之为工作表
格;另一类则是应编制的技术资料或技术管理资料,可称之为文件。本指南规定软件文件
的编制形式,并提供对这些规定的解释。本指南的目的是使得所编制的软件文件确实能够起
到软件文件应该发挥的作用。
2
本指南是一份指导性文件。本指南建议,在一项计算机软件的开发过程中,一般地说,
应该产生十四种文件。这十四种文件是:
可行性研究报告;
项目开发计划;
软件需求说明书;
数据要求说明书;
概要设计说明书;
详细设计说明书;
数据库设计说明书;
用户手册;
操作手册;
模块开发卷宗;
测试计划;
测试分析报告;
开发进度月报;
项目开发总结报告。
本指南将给出开发过程中建议产生的这十四种文件的编制指导,同时,本指南也是这十
四种文件的编写质量的检验准则。但是,本指南并未涉及软件开发过程中如何填写工作表格
的问题。
一般地说,一个软件总是一个计算机系统(包括硬件、固件和软件)的组成部分。鉴于
计算机系统的多样性,本指南一般不涉及整个系统开发中的文件编制问题,本指南仅仅是
软件开发过程中的文件编制指南。
3
对于使用文件的人员而言,他们所关心的文件的种类,随他们所承担的工作而异。
管理人员:可行性研究报告,项目开发计划,模块开发卷宗,开发进度月报,项目开发
总结报告;
开发人员:可行性研究报告,项目开发计划,软件需求说明书,数据要求说明书,概要
设计说明书,详细设计说明书,数据库设计说明书,测试计划,测试分析报告;
维护人员:设计说明书,测试分析报告,模块开发卷宗;
用户:用户手册,操作手册。
尽管本指南提出了在软件开发中文件编制的要求,但并不意味着这些文件都必须交给用
户。一项软件的用户应该得到的文件的种类由供应者与用户之间签订的合同规定
4
一项计算机软件,从出现一个构思之日起,经过这项软件开发成功投入使用,直到最后
决定停止使用,并被另一一项软件代替之时止,被认为是该软件的一个生存周期。一般地
说这个软件生存周期可以分成以下六个阶段:可行性与计划研究阶段
需求分析阶段
设计阶段
实现阶段
测试阶段
运行与维护阶段
在可行性研究与计划阶段内,要确定该软件的开发目标和总的要求,要进行可行性分析、
投资一收益分析、制订开发计划,并完成应编制的文件。
在需求分析阶段内,由系统分析人员对被设计的系统进行系统分析,确定对该软件的各
项功能、性能需求和设计约束,确定对文件编制的要求,作为本阶段工作的结果,一般地说,
软件需求说明书、数据要求说明书和初步的用户手册应该编写出来。
在设计阶段内,系统设计人员和程序设计人员应该在反复理解软件需求的基础上,提出
多个设计,分析每个设计能履行的功能并进行相互比较,最后确定一个设计,包括该软件的
结构、模块的划分、功能的分配以及处理流程。在被设计系统比较复杂的情况下,设计阶段
应分解成概要设计阶段和详细设计阶段两个步骤。在一般情况下,应完成的文件包括:概要
设计说明书、详细设计说明书和测试计划初稿。
在实现阶段内,要完成源程序的编码、编译(或汇编)和排错调试得到无语法错的程序
清单,要开始编写模块开发卷宗,并且要完成用户手册、操作手册等面向用户的文件的编写
工作,还要完成测试计划的编制。
在测试阶段,该程序将被全面地测试,已编制的文件将被检查审阅。一般要完成模块开
发卷宗和测试分析报告,作为开发工作的结束,所生产的程序、文件以及开发工作本身将逐
项被评价,最后写出项目开发总结报告。
在整个开发过程中(即前五个阶段中),开发集体要按月编写开发进度月报。
在运行和维护阶段,软件将在运行使用中不断地被维护,根据新提出的需求进行必要而且可
能的扩充和删改。
对于一项软件而言,其生存周期各阶段与各种文件编写工作的关系可见表1,其
中有
些文件的编写工作可能要在若干个阶段中延续进行。
表1软件生存周期各阶段中的文件编制
5
文件编制是一个不断努力的工作过程。是一个从形成最初轮廓,经反复检查和修改,直
到程序和文件正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证
文件编制的质量,要体现每个开发项目的特点,也要注意不要花太多的人力。为此,编制中
要考虑如下各项因素。
每一种文件都具有特定的读者。这些读者包括个人或小组、软件开发单位的成员或社会
上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期待着使用这些文件的内