软件开发文档标准docx.docx

软件开发文档标准docx.docx

《软件开发文档标准docx.docx》由会员分享，可在线阅读，更多相关《软件开发文档标准docx.docx（21页珍藏版）》请在冰豆网上搜索。

软件开发文档标准docx

可行性研究报告

来源：

国家计算机标准和文件模板作者：

可行性研究报告的编写目的是：

说明该软件开发项目的实现在技术、经济和社会条件方面的可行性；评述为了合理地达到开发目标而可能选择的各种方案；说明并论证所选定的方案。

可行性研究报告的编写内容要求如下：

1引言

1．1编写目的说明编写本可行性研究报告的目的，指出预期的读者。

1．2背景

说明：

a•所建议开发的软件系统的名称；

b•本项目的任务提岀者、开发者、用户及实现该软件的计算中心或计算机网络；

C.该软件系统同其他系统或其他机构的基本的相互来往关系。

1•3定义

列岀本文件中用到的专门术语的定义和外文首字母组词的原词组。

1•4参考资料

列岀用得着的参考资料，如：

a•本项目的经核准的计划任务书或合同、上级机关的批文；

b•属于本项目的其他已发表的文件；

C.本文件中各处引用的文件、资料，包括所需用到的软件开发标准。

|

列岀这些文件资料的标题、文件编号、发表日期和岀版单位，说明能够得到这些文件资料的来源。

2可行性研究的前提

说明对所建议的开发项目进行可行性研究的前提，如要求、目标、假定、限制等。

2.1要求

说明对所建议开发的软件的基本要求，如：

a•功能；

b•性能；

C.输岀如报告、文件或数据，对每项输岀要说明其特征，如用途、产生频度、接口以及分发对象；

d•输入说明系统的输入，包括数据的来源、类型、数量、数据的组织以及提供的频度；

e•处理流程和数据流程用图表的方式表示岀最基本的数据流程和处理流程，并辅之以叙述;

f．在安全与保密方面的要求；

g.同本系统相连接的其他系统；

h.完成期限。

2．2目标

说明所建议系统的主要开发目标，如：

a.人力与设备费用的减少；b.处理速度的提高；

C.控制精度或生产能力的提高；

d.管理信息服务的改进；

e.自动决策系统的改进；

f.人员利用率的改进。

2.3条件、假定和限制说明对这项开发中给出的条件、假定和所受到的限制，如：

a.所建议系统的运行寿命的最小值；

b•进行系统方案选择比较的时间；

c.经费、投资方面的来源和限制；

d•法律和政策方面的限制；

e•硬件、软件、运行环境和开发环境方面的条件和限制；

f.可利用的信息和资源；

g.系统投入使用的最晚时间。

2.4进行可行性研究的方法

说明这项可行性研究将是如何进行的，所建议的系统将是如何评价的。

摘要说明所使用的基本方法和策略，如调查、加权、确定模型、建立基准点或仿真等。

2.5评价尺度

说明对系统进行评价时所使用的主要尺度，如费用的多少、各项功能的优先次序、开发时间的长短及使用中的难易程度。

3对现有系统的分析

这里的现有系统是指当前实际使用的系统，这个系统可能是计算机系统，也可能是一个机械系统甚至是一个人工系统。

分析现有系统的目的是为了进一步阐明建议中的开发新系统或修改现有系统的必要性。

3.1处理流程和数据流程

说明现有系统的基本的处理流程和数据流程。

此流程可用图表即流程图的形式表示，并加以叙述。

3.2工作负荷列出现有系统所承担的工作及工作量。

3.3费用开支列出由于运行现有系统所引起的费用开支，如人力、设备、空间、支持性服务、材料等项开

支以及开支总额。

3．4人员列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。

3．5设备列出现有系统所使用的各种设备。

3．6局限性列出本系统的主要的局限性，例如处理时间赶不上需要，响应不及时，数据存储能力不足，处理功能不够等。

并且要说明，为什么对现有系统的改进性维护已经不能解决问题。

4所建议的系统本章将用来说明所建议系统的目标和要求将如何被满足。

4．1对所建议系统的说明概括地说明所建议系统，并说明在第A．2章中列出的那些要求将如何得到满足，说明所使

用的基本方法及理论根据。

4．2处理流程和数据流程给出所建议系统的处理流程和数据流程。

4．3改进之处按2．2条中列出的目标，逐项说明所建议系统相对于现存系统具有的改进。

4．4影响说明在建立所建议系统时，预期将带来的影响，包括：

4．4．1对设备的影响说明新提出的设备要求及对现存系统中尚可使用的设备须作出的修改。

4．4．2对软件的影响说明为了使现存的应用软件和支持软件能够同所建议系统相适应。

而需要对这些软件所进行的修改和补充。

4．4．3对用户单位机构的影响说明为了建立和运行所建议系统，对用户单位机构、人员的数量和技术水平等方面的全部要求。

4．4．4对系统运行过程的影响说明所建议系统对运行过程的影响，如：

a•用户的操作规程；b•运行中心的操作规程；C.运行中心与用户之间的关系；d•源数据的处理；e•数据进入系统的过程；f•对数据保存的要求，对数据存储、恢复的处理；g.输岀报告的处理过程、存储媒体和调度方法；

h•系统失效的后果及恢复的处理办法。

4．4．5对开发的影响说明对开发的影响，如：

a•为了支持所建议系统的开发，用户需进行的工作；

b•为了建立一个数据库所要求的数据资源；

C.为了开发和测验所建议系统而需要的计算机资源；d•所涉及的保密与安全问题。

4.4•6对地点和设施的影响说明对建筑物改造的要求及对环境设施的要求。

4．4．7对经费开支的影响扼要说明为了所建议系统的开发，设计和维持运行而需要的各项经费开支。

4．5局限性

说明所建议系统尚存在的局限性以．及这些问题未能消除的原因。

4．6技术条件方面的可行性本节应说明技术条件方面的可行性，如：

a•在当前的限制条件下，该系统的功能目标能否达到；

b．利用现有的技术，该系统的功能能否实现；

C.对开发人员的数量和质量的要求并说明这些要求能否满足；

d•在规定的期限内，本系统的开发能否完成。

5可选择的其他系统方案

扼要说明曾考虑过的每一种可选择的系统方案，包括需开发的和可从国内国外直接购买的，如果没有供选择的系统方案可考虑，则说明这一点。

5．1可选择的系统方案1

参照第4章的提纲，说明可选择的系统方案1，并说明它未被选中的理由。

5．2可选择的系统方案2

按类似5．1条的方式说明第2个乃至第。

个可选择的系统方案。

6投资及效益分析

6．1支出

对于所选择的方案，说明所需的费用。

如果已有一个现存系统，则包括该系统继续运行期间所需的费用。

6．1．1基本建设投资

包括采购、开发和安装下列各项所需的费用，如：

a．房屋和设施；

b．ADP设备；

C.数据通讯设备；

d•环境保护设备；

e•安全与保密设备；

f•ADP操作系统的和应用的软件；

g．数据库管理软件。

6．1．2其他一次性支出包括下列各项所需的费用，如：

a•研究（需求的研究和设计的研究）；b•开发计划与测量基准的研究；C.数据库的建立；d•ADP软件的转换；e•检查费用和技术管理性费用；f．培训费、旅差费以及开发安装人员所需要的一次性支出；g.人员的退休及调动费用等。

6．1．3非一次性支出列出在该系统生命期内按月或按季或按年支出的用于运行和维护的费用，包括：

a•设备的租金和维护费用；

b软件的租金和维护费用；

C.数据通讯方面的租金和维护费用；

d•人员的工资、奖金；

e．房屋、空间的使用开支；

f．公用设施方面的开支；

g.保密安全方面的开支；

h•其他经常性的支岀等。

6．2收益

对于所选择的方案，说明能够带来的收益，这里所说的收益，表现为开支费用的减少或避免、

差错的减少、灵活性的增加、动作速度的提高和管理计划方面的改进等，包括；

6．2．1一次性收益说明能够用人民币数目表示的一次性收益，可按数据处理、用户、管理和支持等项分类叙述，如：

a•开支的缩减包括改进了的系统的运行所引起的开支缩减，如资源要求的减少，运行效率的改进，数据进入、存贮和恢复技术的改进，系统性能的可监控，软件的转换和优化，数据压缩技术的采用，处理的集中化／分布化等；

b•价值的增升包括由于一个应用系统的使用价值的增升所引起的收益，如资源利用的改进,

管理和运行效率的改进以及岀错率的减少等；

C其他如从多余设备岀售回收的收入等。

6．2．2非一次性收益说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民币数目表示

的收益，包括开支的减少和避免。

6．2．3不可定量的收益

逐项列岀无法直接用人民币表示的收益，如服务的改进，由操作失误引起的风险的减少，息掌握情况的改进，组织机构给外界形象的改善等。

有些不可捉摸的收益只能大概估计或进行极

值估计（按最好和最差情况估计）。

6．3收益／投资比求出整个系统生命期的收益／投资比值。

6．4投资回收周期求出收益的累计数开始超过支出的累计数的时间。

些

7

7.

6．5敏感性分析所谓敏感性分析是指一些关键性因素如系统生命期长度、系统的工作负荷量、工作负荷的类型与这些不同类型之间的合理搭配、处理速度要求、设备和软件的配置等变化时，对开支和收益的影响最灵敏的范围的估计。

在敏感性分析的基础上做出的选择当然会比单一选择的结果要好一

社会因素方面的可行性

本章用来说明对社会因素方面的可行性分析的结果，包括：

1法律方面的可行性法律方面的可行性问题很多，如合同责任、侵犯专利权、侵犯版权等方面的陷井，软件人员通常是不熟悉的，有可能陷入，务必要注意研究。

7．2使用方面的可行性

例如从用户单位的行政管理、工作制度等方面来看，是否能够使用该软件系统；从用户单位的工作人员的素质来看，是否能满足使用该软件系统的要求等等，都是要考虑的。

8结论

在进行可行性研究报告的编制时，必须有一个研究的结论。

结论可以是：

a•可以立即开始进行；

b•需要推迟到某些条件（例如资金、人力、设备等）落实之后才能开始进行；

c•需要对开发目标进行某些修改之后才能开始进行；

d•不能进行或不必进行（例如因技术不成熟、经济上不合算等）。

项目开发计划

来源：

国家计算机标准和文件模板作者：

编制项目开发计划的目的是用文件的形式，把对于在开发过程中各项工作的负责人员、开发

进度、所需经费预算、所需软、硬件条件等问题作出的安排记载下来，以便根据本计划开展和

检查本项目的开发工作。

编制内容要求如下：

1引言

1.1编写目的

说明编写这份项目开发计划的目的，并指出预期的读者。

1．2背景

说明：

a•待开发的软件系统的名称；

b•本项目的任务提岀者、开发者、用户及实现该软件的计算中心或计算机网络；

C.该软件系统同其他系统或其他机构的基本的相互来往关系。

1•3定义

列岀本文件中用到的专门术语的定义和外文首字母组词的原词组。

1•4参考资料列岀用得着的参考资料，如：

a•本项目的经核准的计划任务书或合同、上级机关的批文；b•属于本项目的其他已发表的文件；

C.本文件中各处引用的文件、资料，包括所要用到的软件开发标准。

列岀这些文件资料的

标题、文件编号、发表日期和岀版单位，说明能够得到这些文件资料的来源。

2项目概述

2.1工作内容简要地说明在本项目的开发中须进行的各项主要工作。

2.2主要参加人员扼要说明参加本项目开发工作的主要人员的情况，包括他们的技术水平。

2.3产品

2.3•1程序

列岀需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式，并通过引用有关文件，逐项说明其功能和能力。

2．3．2文件列岀需移交给用户的每种文件的名称及内容要点。

2．3．3服务列岀需向用户提供的各项服务，如培训安装、维护和运行支持等，应逐项规定开始日期、所

提供支持的级别和服务的期限。

2．3．4非移交的产品说明开发集体应向本单位交岀但不必向用户移交的产品（文件甚至某些程序）。

2．4验收标准对于上述这些应交岀的产品和服务，逐项说明或引用资料说明验收标准。

2．5完成项目的员迟用限2．6本计划的批准者和批准日期

3实施计划3．1工作任务的分门与人员分工对于项目开发中需完成的各项工作，从需求分析、设计、实现、测试直到维护，包括文件的编制、审批、打印、分发工作，用户培训工作，软件安装工作等，按层次进行分解，指明每项任务的负责人和参加人员。

3．2接口人员说明负责接口工作的人员及他们的职责，包括：

a．负责本项目同用户的接口人员；

b•负责本项目同本单位各管理机构，如合同计划管理部门、财务部门、质量管理部门等的接口人员；

c•负责本项目同各分合同负责单位的接口人员等。

3.3进度

对于需求分析、设计、编码实现、测试、移交、培训和安装等工作，给出每项工作任务的预。

定开始日期、完成日期及所需资源，规定各项工作任务完成的先后顺序以及表征每项工作任务完成的标志性事件（即所谓"里程碑"）。

3.4预算

逐项列出本开发项目所需要的劳务（包括人员的数量和时间）以及经费的预算（包括办公费、差旅费、机时费、资料费、通讯设备和专用设备的租金等）和来源。

3•5关键问题

逐项列出能够影响整个项目成败的关键问题、技术难点和风险，指出这些问题对项目的影响。

4支持条件

说明为支持本项目的开发所需要的各种条件和设施。

4.1计算机系统支持

逐项列出开发中和运行时所需的计算机系统支持，包括计算机、外围设备、通讯设备、模拟

器、编译（或汇编）程序、操作系统、数据管理程序包、数据存储能力和测试支持能力等，逐项给出有关到货日期、使用时间的要求。

4．2需由用户承担的工作

逐项列出需要用户承担的工作和完成期限。

包括需由用户提供的条件及提供时间。

4．3由外单位提供的条件逐项列出需要外单位分合同承包者承担的工作和完成的时间，包括需要由外单位提供的条件

和提供的时间。

5专题计划要点

说明本项目开发中需制订的各个专题计划（如分合同计划、开发人员培训计划、测试计划、

安全保密计划、质量保证计划、配置管理计划、用户培训计划、系统安装计划等）的要点

软件需求说明书

来源：

自国家计算机标准和文件模板作者：

软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理

解，使之成为整个开发工作的基础。

编制软件需求说明书的内容要求如下：

1引言

1．1编写目的说明编写这份软件需求说明书的目的，指出预期的读者。

1．2背景

说明：

a•待开发的软件系统的名称；

b•本项目的任务提岀者、开发者、用户及实现该软件的计算中心或计算机网络；

C.该软件系统同其他系统或其他机构的基本的相互来往关系。

1•3定义

列岀本文件中用到的专门术语的定义和外文首字母组词的原词组。

1•4参考资料

列岀用得着的参考资料，如：

a•本项目的经核准的计划任务书或合同、上级机关的批文；

b•属于本项目的其他已发表的文件；

c•本文件中各处引用的文件、资料、包括所要用到的软件开发标准。

列岀这些文件资料的标

题、文件编号、发表日期和岀版单位，说明能够得到这些文件资料的来源。

2任务概述

2.1目标

叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开发的背景材料。

解释被开发软件与其他有关软件之间的关系。

如果本软件产品是一项独立的软件，而且全部内容自含，则说明这一点。

如果所定义的产品是一个更大的系统的一个组成部分，则应说明本产品与该系统中其他各组成部分之间的关系，为此可使用一张方框图来说明该系统的组成和本产品同其他各部分的联系和接口。

|

2.2用户的特点列岀本软件的最终用户的特点，充分说明操作人员、维护人员的教育水平和技术专长，以及本

软件的预期使甩频度。

这些是软件设计工作的重要约束2.3假定和约束

列出进行本软件开发工作的假定和约束，例如经费限制、开发期限等。

3需求规定

3．1对功能的规定

用列表的方式（例如IPO表即输入、处理、输出表的形式），逐项定量和定性地叙述对软件所提出的功能要求，说明输入什么量、经怎样的处理、得到什么输出，说明软件应支持的终端数和应支持的并行操作的用户数。

3．2对性能的规定

3．2．1精度说明对该软件的输入、输出数据精度的要求，可能包括传输过程中的精度。

3．2．2时间特性要求

说明对于该软件的时间特性要求，如对：

a.响应时间；

b•更新处理时间；

c.数据的转换和传送时间；

d•解题时间；等的要求。

3.2.3灵活性

说明对该软件的灵活性的要求，即当需求发生某些变化时，该软件对这些变化的适应能力，如：

a•操作方式上的变化；

b•运行环境的变化；

c•同其他软件的接口的变化；

d•精度和有效时限的变化；

e.计划的变化或改进。

对于为了提供这些灵活性而进行的专门设计的部分应该加以标明。

3・3输人输岀要求

解释各输入输出数据类型，并逐项说明其媒体、格式、数值范围、精度等。

对软件的数据输出及必须标明的控制输岀量进行解释并举例，包括对硬拷贝报告（正常结果输岀、状态输岀及异常输岀）以及图形或显示报告的描述。

3・4数据管理能力要求

说明需要管理的文卷和记录的个数、表和文卷的大小规模，要按可预见的增长对数据及其分量的存储要求作岀估算。

3・5故障处理要求

列岀可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。

3・6其他专门要求

如用户单位对安全保密的要求，对使用方便的要求，对可维护性、可补充性、易读性、可靠性、运行环境可转换性的特殊要求等。

4运行环境规定

4．1设备列出运行该软件所需要的硬设备。

说明其中的新型设备及其专门功能，包括：

a•处理器型号及内存容量；

b•外存容量、联机或脱机、媒体及其存储格式，设备的型号及数量；

c•输入及输出设备的型号和数量，联机或脱机；

d•数据通信设备的型号和数量；

e•功能键及其他专用硬件

4.2支持软件

列出支持软件,包括要用到的操作系统、编译（或汇编）程序、测试支持软件等。

4.3接口说明该软件同其他软件之间的接口、数据通信协议等。

4.4控制说明控制该软件的运行的方法和控制信号，并说明这些控制信号的来源。

数据要求说明书

来源：

国家计算机标准和文件模板作者：

1引言

1.1编写目的

说明编写这份数据要求说明书的目的，指出预期的读者。

1.2背景

说明：

a•待开发软件系统的名称；

b•列岀本项目的任务提岀者、开发者、用户以及将运行该项软件的计算站（中心）或计算机网络系统。

1•3定义

列岀本文件中用到的专门术语的定义和外文首字母组词的原词组。

1•4参考资料

列岀有关的参考资料，如：

a•本项目的经核准的计划任务书或合同，上级机关的批文；

b•属于本项目的其他已发表文件；

c•本文件中各处引用的文件、资料，包括所要用到的软件开发标准。

列岀这些文件的标题、文件编号、发表日期和出版单位。

说明能够得到这些文件资料的来源。

2数据的逻辑描述

对数据进行逻辑描述时可把数据分为动态数据和静态数据。

所谓静态数据，指在运行过程中主要作为参考的数据，它们在很长的一段时间内不会变化，一般不随运行而改变。

所谓动态数据．包括所有在运行中要发生变化的数据以及在运行中要输入、输出的数据。

进行描述时应把各数据元素逻辑地分成若干组，列如函数、源数据或对于其应用更为恰当的逻辑分组。

给出每一数据元的名称（包括缩写和代码）、定义（或物理意义）度量单位、值域、格式和类型等有关信息。

2．1静态数据

列出所有作为控制或参考用的静态数据元素。

2．2动态输人数据

列出动态输入数据元素（包括在常规运行中或联机操作中要改变的数据）。

2．3动态输出数据

列出动态输出数据元素（包括在常规运行中或联机操作中要改变的数据）。

2．4内部生成数据

列出向用户或开发单位中的维护调试人员提供的内部生成数据。

2．5数据约定

说明对数据要求的制约。

逐条列出对进一步扩充或使用方面的考虑而提出的对数据要求的限制（容量、文卷、记录和数据元的个数的最大值）。

对于在设计和开发中确定是临界性的限制更要明确指出。

3数据的采集

3．1要求和范围

按数据元的逻辑分组来说明数据采集的要求和范围，指明数据的采集方法，说明数据采集工作的承担者是用户还是开发者。

具体的内容包括：

a•输入数据的来源，例如是单个操作员、数据输入站，专业的数据输入公司或它们的一个分

组；

b•数据输入（指把数据输入处理系统内部）所用的媒体和硬设备。

如果只有指定的输入点的输入才是合法的，则必须对此加以说明；

c．接受者说明输出数据的接受者；

d•输岀数据的形式和设备列岀输岀数据的形式和硬设备。

无论接受者将接收到的数据是打印输岀，还是CRT上的一组字符、一帧图形，或一声警铃，或向开关线圈提供的一个电脉冲，或常用介质如磁盘、磁带、穿孔卡片等，均应具体说明；

e•数据值的范围给岀每一个数据元的合法值的范围；

f•量纲给岀数字的度量单位、增量的步长、零点的定标等。

在数据是非数字量的情况下，要给岀每一种合法值的形式和含意；

g.更新和处理的频度给岀预定的对输入数据的更新和处理的频度。

如果数据的输入是随机的，应给岀更新处理的频度的平均值，或变化情况的某种其他度量。

3.2输人的承担者说明预定的对数据输入工作的承担者。

如果输入数据同某一接口软件有关，还应说明该接口软件的来源。

3.3预处理

对数据的采集和预处理过程提岀专门的规定，包括适合应用的数据格式、预定的数据通信媒体

和对输入的时间要求等。

对于需经模拟转换或数字转换处理的数据量，要给岀转换方法和转换因子

等有关信息，以便软件系统使用这些数据。

3.4影响说明这些数据要求对于设备、软件、用户、开发单位所可能产生的影响，例如要求用户单位增设某个机构等。

概要设计说明书

来源：

国家计算机标准和文件模板作者：

1引言

1.1编写目的

说明编写这份概要设计说明书的目的，指岀预期的读者。

1.2背景

说明：

a•待开发软件系统的名称；

b•列岀此项目的任务提岀者、开发者、用户以及将运行该软件的计算站（中心）。

列出本文件中用到的专门术语的定义和外文首字母组词的原词组。

1．4参考资料

列出有关的参考文件，如：

a•本项目的经核准的计划任务书或合同，上级机关的批文；

b•属于本项目的其他已发表文件；

c•本文件中各处引用的文件、资料，包括所要用到的软件开发标准。

列岀这些文件的标题、

文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。

2总体设计

2.1需求规定

说明对本系统的主要的输入输岀项目、处理的功能性能要求，详细的说明可参见附录C。

2.2运行环境

简要地说明对本系统的运行环境（包括硬件环境和支持环境）的规定，详细说明参见附录C

2.3基本设计概念和处理流程

说明本系统的基