下载文档原格式
231 GB 8567－88软件开发主要文档编写规范本附录中列出了《计算机软件产品开发文件编制指南》GB 8567－88中主要软件文档的编写说明，供编写时参考。
这些文档主要是：可行性研究报告、项目开发计划、软件需求说明书、概要设计说明书、详细设计说明书、模块开发卷宗、测试计划、测试分析报告、项目开发总结报告。
一、可行性研究报告l 引言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. 控制精度或生产能力的提高。
232 d ．管理信息服务的改进。
《需求规格说明书》编写参考指南1．概述（Summary）本文档是进行项目策划、概要设计和详细设计的基础，也是软件企业测试部门进行内部验收测试的依据。
1.1 用户简介（User Synopsis）在本章节中要将用户的基本情况描述清楚，以便于分析人员划定系统范围，进行功能、进度、成本、性能等方面的平衡决策。
对于产品开发类项目，需要在此将该产品定义的用户群的特点描述清楚。
1.2 项目的目的与目标（Purpose and Aim of Project）项目的目的是对开发本系统的意图的总概括。
项目的目标是将目的细化后的具体描述。
项目目标应是明确的、可度量的、可以达到的, 项目的范围应能确保项目的目标可以达到。
对于项目的目标可以逐步细化，以便与系统的需求建立对应关系，检查系统的功能是否覆盖了系统的目标。
1.3 术语定义（Terms Glossary）将该需求规格说明书中的术语、缩写进行定义, 包括用户应用领域与计算机领域的术语与缩写等。
1.4 参考资料（References）说明该用户需求报告使用的参考资料，如：[1] 商务合同[2] 招标书[3] 用户领域的资料[4] 用户需求调查表[5] 用户需求报告[6] 参照的标准每一个文件、文献要有标题、或文件号，发布或发表日期以及出版单位。
1.5 相关文档（Related Documents）[1] 项目开发计划[2] 概要设计说明书[3] 详细设计说明书1.6 版本更新信息（V ersion Updated Record）版本更新记录格式，如表5-19所示。
表5-19 版本更新记录2．目标系统描述（System in Target）2.1 组织结构与职责（Organizing Framework and Function）将目标系统的组织结构逐层详细描述，建议采用树状的组织结构图进行表达，每个部门的职责也应进行简单的描述。
组织结构是用户企业业务流程与信息的载体，对分析人员理解企业的业务、确定系统范围很有帮助。
附2:软件文档编写向导文档分类项目包括如下几类文档：项目管理文档。
包括：《软件项目计划》、《项目进度报告》、《项目开发总结报告》软件开发文档。
包括：《需求规格说明》、《概要设计说明》、《详细设计说明》、《测试计划》、《软件测试分析报告》。
产品文档。
包括：《用户操作手册》《演示文件》。
软件项目计划（Software Project Plan）一．引言1．编写目的（阐明编写软件计划的目的，指出读者对象。
）2．项目背景（可包括：（1）项目委托单位、开发单位和主管部门；（2）该软件系统与其他系统的关系。
）3．定义（列出本文档中用到的专门术语的定义和缩略词的原文。
）4．参考资料（可包括：文档所引用的资料、规范等；列出资料的作者、标题、编号、发表日期、出版单位或资料来源。
）二．项目概述1. 工作内容（简要说明项目的各项主要工作,介绍所开发软件的功能性能等. 若不编写可行性研究报告,则应在本节给出较详细的介绍。
)2. 条件与限制（阐明为完成项目应具备的条件开发单位已具备的条件以及尚需创造的条件. 必要时还应说明用户及分合同承包者承担的工作完成期限及其它条件与限制。
）3. 产品（1）程序（列出应交付的程序名称使用的语言及存储形式。
）（2）文档（列出应交付的文档。
）（3）运行环境（应包括硬件环境软件环境。
）4．服务（阐明开发单位可向用户提供的服务. 如人员培训安装保修维护和其他运行支持。
）5．验收标准三．实施计划1．任务分解（任务的划分及各项任务的负责人。
）2．进度（按阶段完成的项目,用图表说明开始时间完成时间。
）3．预算4．关键问题（说明可能影响项目的关键问题,如设备条件技术难点或其他风险因素,并说明对策。
）四．人员组织及分工五．交付期限六．专题计划要点（如测试计划等。
）项目开发进度报告一．报告时间及所处的开发阶段二．给出进度1．本周的主要活动2．实际进展与计划比较三．所用工时（按不同层次人员分别计时。
）四．所有机时五．工作遇到的问题及采取的对策六．本周完成的成果七．下周的工作计划八．特殊问题项目开发总结报告一．引言1．编写目的（阐明编写总结报告的目的,指明读者对象。
二、项目开发计划1．引言 (1)1.1编写目的 (1)1.2项目背景 (1)1.3定义 (2)1.4参考资料 (2)2．项目概述 (2)2.1工作内容 (2)2.2条件与限制 (3)2.3产品 (5)2.4运行环境 (6)2.5服务 (6)2.6验收标准 (7)3．实施计划 (7)3.1任务分解 (7)3.2进度 (7)3.3预算 (9)3.4关键问题 (10)4．人员组织及分工 (10)5．交付期限 (11)6．专题计划要点 (11)6.1测试计划 (11)6.2质量保证计划 (12)6.3配置计划 (12)6.4人员培训 (13)6.5系统安装 (13)1．引言1.1编写目的为了保证项目团队按时保质地完成项目目标，便于项目团队成员更好地了解项目情况，使项目工作开展的各个过程合理有序，有必要以文件化的形式，把对于在项目生命周期内的工作任务范围、各项工作的任务分解、项目团队组织结构、各团队成员的工作责任、团队内外沟通协作方式、开发进度、经费预算、项目内外环境条件、风险对策等内容以书面的方式描述出来，作为项目团队成员以及项目干系人之间的共识与约定，项目生命周期内的所有项目活动的行动基础，项目团队开展和检查项目工作的依据。
1.2项目背景在日常生活中，在既是个人场所又是公共场所的地方。
例如：宿舍、公司等。
当我们外出时，可能会出现私人物品被盗或丢失的情况，此时保安人员也无法分辨物品是否属于携带者。
这时就需要一种设备来保护财务的安全。
根据这一需求，本文提出了一种简化式的防盗报警系统。
目前市场上的防盗报警系统装置为较常见的红外报警器，适用于没人的环境，不适用于多人居住的集体宿舍。
还有一些磁敏报警器，它们虽然可以用于门窗，但是每次使用都要人为地打开或关闭，不能够实现自动化，一旦忘记打开就形同虚设，如果素色无人的情况下即使报警也很容易被破坏，无法起到报警的作用。
因此，设计一款安全可靠的防盗报警系统变得十分有必要。
实用文档【软件名称】版本号：V1.0用户手册2022年3月9日目录目录第一章引言 (1)1.1编写目的 (1)1.2项目背景 (1)1.3定义 (1)1.4参考资料 (1)第二章软件概述 (1)2.1目标 (1)2.2功能 (1)2.3性能 (2)第三章运行环境 (2)3.1硬件 (2)3.2支持软件 (2)第四章使用说明 (2)4.1安装和初始化 (2)4.1.1 软件安装 (3)4.2软件使用 (3)4.3出错和恢复 (3)4.4求助查询 (3)第五章运行说明 (4)5.1运行表 (4)1第一章引言1.1编写目的1.2项目背景开发软件的名称：开发软件版本号：V1.0开发者：代码行数：行软件开发语言：软件编译环境:1.3定义1.4参考资料1．可行性研究报告2．项目开发计划；3．需求规格说明书；4．概要设计说明书；5．详细设计说明书；6．测试计划；7．《计算机软件文档编制规范GB/T8567-----2006》第二章软件概述2.1目标2.2功能图表 1 软件设计构成11、防伪码模块功能：查询防伪码的信息2、添加防伪码模块功能：添加新的防伪码3、添加管理员模块：功能：添加新的后台管理员2.3性能第三章运行环境3.1硬件（1）软件开发环境CPU:Intel(R)Core(TM)*******************内存:16 GB磁盘:NVMe SanDisk Ultra 3D 1TB显卡:NVIDIA NVIDIA GeForce RTX 2060（2）软件支持环境CPU:Intel(R) Core(TM) i5-2400以上内存：2GB以上磁盘：128M可用空间以上显卡：Intel HD3000 核心显卡以上运行环境：Tomcat 9.0.313.2支持软件操作系统： Windows7及以上更高64位版本第四章使用说明4.1安装和初始化该系统需要安装TomCat 9.0.31环境、Mysql 5.5.62。
HHHH大学航空订票系统（Airline Reservation System）姓名：AAA（项目经理）BBB、CCC、DDDEEE、FFF专业：软件工程指导老师：GGG目录一、可行性研究报告1、报告编写目的2、项目概述--------------------------------------------------------（主要负责人：EEE）2.1、项目背景2.2、项目意义2.3、项目目标2.4、项目用途3、技术可行性-----------------------------------（主要负责人：FFF）3.1、可行性因素3.2、技术条件3.3、用户使用可行性3.4、系统可行性简要描述3.5、系统可行性处理流程二、项目开发计划----------------------------------（主要负责人：AAA）1、工作内容2、主要参与人员3、产品3.1、软件包3.2、设计文档3.3、软件操作手册3.4、服务4、完成项目的期限5、项目的计划进度表6、实施计划6.1、工作任务的分解与人员的分工三、需求规格说明书--------------------------------（主要负责人：AAA）1、用户需求2、功能性需求2.1、运行环境2.2、系统层次结构图2.2.1、航空机票预订网站2.2.2、航空订票管理系统3、非功能性需求3.1、性能需求3.2、安全性需求3.3、可靠性和可用性需求3.4、出错处理需求3.5、接口需求3.6、约束3.7、逆向需求3.8、将来可能提出的要求4、其他需求四、概要设计说明书--------------------------------（负责人：所有人）1、总体设计1.1、总体结构设计1.2、运行环境设计1.3、功能模块清单设计2、模块（部件）清单设计2.1、公用模块功能分配2.2、专用模块功能分配3、数据结构设计3.1、数据库表名清单3.2、数据库表之间关系说明3.3、数据库表的详细清单4、接口设计五、详细设计说明书--------------------------------（负责人：所有人）1、模块实现设计1.1、公用模块设计1.2、专用模块设计2、接口实现设计六、数据库设计说明书------------------------------（主要负责人：AAA）1、数据库结构设计2、数据库的安全保密性设计3、数据库优化4、数据库源代码七、测试计划--------------------------------------（负责人：所有人）1、单元测试2、功能测试八、测试分析报告----------------------------------（主要负责人：AAA）1、测试计划执行情况2、软件需求测试结论九、项目开发总结报告------------------------------（负责人：所有人）AAABBBCCCDDDEEEFFF十、系统源程序------------------------------------（负责人：所有人）十一、操作手册------------------------------------（负责人：所有人）一、可行性研究报告1、报告编写目的可行性研究的目的是为了对问题进行研究，以最小的代价在最短的时间内确定问题是否可解。
在软件行业有一句话：一个软件能否顺利的完成并且功能是否完善，重要是看这个软件有多少文档，软件开发文档是一个软件的支柱，如果你的开发文档漏洞百出，那么你所开发出来的软件也不可能会好；开发文档的好坏可以直接影响到所开发出来软件的成功与否。
一、软件开发设计文档：软件开发文档包括软件需求说明书、数据要求说有书、概要设计说明书、详细设计说明书。
1、软件需求说明书：也称为软件规格说明。
该说明书对所开发软件的功能、性能、用户界面及运行环境等做出详细的说明。
它是用户与开发人员双方对软件需求取得共同理解基础上达成的协议，也是实施开发工作的基础。
软件需求说明书的编制目的的就是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解、并使之面成为整个开发工作的基础。
其格式要求如下：1 引言1．1 编写目的。
1．2 背景1．3 定义2 任务概述2．2 用户的特点2．3 假定和约束3 需求规定3．1 对功能的规定3．2 对性能的规定3．2．1 精度3．2．2 时间特性的需求3．2．3 灵活性3．3 输入输出要求3．4 数据管理能力要求3．5 故障处理要求3．6 其他专门要求4 运行环境规定4．1 设备4．2 支持软件4．3 接口2、概要设计说明书：又称系统设计说明书，这里所说的系统是指程序系统。
编制的目的是说明对程序系统的设计考虑，包括程序系统的基本处理。
流程、程序系统的组织结构、模块划分、功能分配、接口设计。
运河行设计、数据结构设计和出错处理设计等，为程序的详细设计提供基础。
其格式要求如下：1 引言1．1 编写目的1．2 背景1．3 定义1．4 参考资料2 总体设计2．1 需求规定2．2 运行环境2．3 基本设计概念和处理流程2．4 结构2．5 功能需求与程序的关系2．6 人工处理过程2．7 尚未解决的问题3 接口设计3．1 用户接口3．2 外部接口3.。
3 内部接口4 运行设计4．1 运行模块的组合4．2 运行控制4．3 运行时间5 系统数据结构设计5．1 逻辑结构设计要点5．2 物理结构设计要求5．3 数据结构与程序的关系6 系统出错处理设计6．1 出错信息6．2 补救措施6．3 系统维护设计。
软件设计文档国家标准GB8567-88一、文档编写标准化在整个项目开发及使用过程中，应该有完备的文档支持，文档编制要求具有针对性、精确性、清晰性、完整性、灵活性和可追溯性。
完备的文档对软件的开发及使用起了很大的作用。
一般要求编写好十三种文档。
1、可行性分析报告说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供选择的各种可能实施方案，说明并论证所选定实施方案的理由。
2、项目开发计划为软件项目实施方案制订出具体计划，应该包括各部分工作的负责人员、开发的进度、开发经费的预算、所需的硬件及软件资源等。
3、软件需求说明书（软件规格说明书）对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明。
它是在用户与开发人员双方对软件需求取得共同理解并达成协议的条件下编写的，也是实施开发工作的基础。
该说明书应给出数据逻辑和数据采集的各项要求，为生成和维护系统数据文件做好准备。
4、概要设计说明书是概要设计阶段的工作总结。
主要包括功能分配、模块划分、程序总体结构、输入输出以及接口设计、运行设计、数据结构设计和出错处理等，为详细设计作好准备。
5、详细设计说明书着重描述每一模块是怎样实现的，包括实现算法、逻辑流程等。
6、用户操作手册详细描述了该软件的功能、性能和用户界面，使用该软件的具体方法等。
7、测试计划包括测试内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。
8、测试分析报告测试计划的执行情况，对测试结果的分析，提出测试结论。
9、开发进度月报按月提交的项目进展情况报告。
包括计划与实际执行情况的对比、阶段成果、遇到的问题、解决的方法以及下一步的打算。
10、项目开发总结报告项目完成以后，总结实际执行情况。
如进度、成果、资源利用、成本和投入的人力，对项目开发作出评价，总结经验与教训。
11、软件维护手册主要包括软件系统说明、程序模块说明、操作环境、支持软件说明、维护过程说明等。
软件设计文档国家标准GB8567-88一、文档编写标准化在整个项目开发及使用过程中，应该有完备的文档支持，文档编制要求具有针对性、精确性、清晰性、完整性、灵活性和可追溯性。
完备的文档对软件的开发及使用起了很大的作用。
一般要求编写好十三种文档。
1、可行性分析报告说明该软件开发项目的实现在技术上、经济上和社会因素上的可行性，评述为了合理地达到开发目标可供选择的各种可能实施方案，说明并论证所选定实施方案的理由。
2、项目开发计划为软件项目实施方案制订出具体计划，应该包括各部分工作的负责人员、开发的进度、开发经费的预算、所需的硬件及软件资源等。
3、软件需求说明书（软件规格说明书）对所开发软件的功能、性能、用户界面及运行环境等作出详细的说明。
它是在用户与开发人员双方对软件需求取得共同理解并达成协议的条件下编写的，也是实施开发工作的基础。
该说明书应给出数据逻辑和数据采集的各项要求，为生成和维护系统数据文件做好准备。
4、概要设计说明书是概要设计阶段的工作总结。
主要包括功能分配、模块划分、程序总体结构、输入输出以及接口设计、运行设计、数据结构设计和出错处理等，为详细设计作好准备。
5、详细设计说明书着重描述每一模块是怎样实现的，包括实现算法、逻辑流程等。
6、用户操作手册详细描述了该软件的功能、性能和用户界面，使用该软件的具体方法等。
7、测试计划包括测试内容、进度、条件、人员、测试用例的选取原则、测试结果允许的偏差范围等。
8、测试分析报告测试计划的执行情况，对测试结果的分析，提出测试结论。
9、开发进度月报按月提交的项目进展情况报告。
包括计划与实际执行情况的对比、阶段成果、遇到的问题、解决的方法以及下一步的打算。
10、项目开发总结报告项目完成以后，总结实际执行情况。
如进度、成果、资源利用、成本和投入的人力，对项目开发作出评价，总结经验与教训。
11、软件维护手册主要包括软件系统说明、程序模块说明、操作环境、支持软件说明、维护过程说明等。
附录五国家标准《计算机软件产品开发文件编制指南》国家标准《计算机软件产品开发文件编制指南》（GB 8567—88）是一份指导性文件。
它建议在软件的开发过程申编下述14个文件：可行性研究报告、项目开发计划、软件需求说明书、数据要求说明书、总体设计说明书、详细设计说明、数据库设计说明书、用户手册、操作手册、模块开发卷、测试计划、测试分析报告、开发进度表、项目开发总结。
该指南给出了这14个文件的编制提示，它同时也是这14个文件编写质量的检验准则。
下面详细介绍这14种文件的编写目的与内容要求。
l、可行性研究报告可行性研究报告的目的是：说明该软件开发项目的实现在技术上、经济上和社会条上的可行性，论述为了合理地达到开发目标而可能选择的各种方案，说明并论证所选定的方案。
可行性研究报告的编写内容见表l。
表l 可行性研究报告2、项目开发计划编制项目开发计划的目的是用文件的形式，并在开发过程中各项工作的负责人员、开发进度、经费预算、所需软硬件条件等问题做出的安排记录下来，以便根据本计划开展和检查项目的开发工作。
编制内容要求如表2所示。
表2 项目开发计划3、软件需求说明书软件需求说明书的编制是为了使用户和软件开发人员双方对该软件的初始规定有一个共同的理解，使之成为整个软件开发工作的基础。
其内容要求见表3。
表3 软件需求说明书4、数据要求说明书数据要求说明书的编制目的是为了向整个软件开发时期提供关于被处理数据的描述和数据采集要求的技术信息，其内容要求列于表4中。
表4 数据要求说明书5、概要设计说明书概要设计说明书又称为总体设计说明书，编制目的是说明对项目系统的设计考虑，包括基本处理流程、组织结构、模块结构、功能配置、接口设计、运行设计、系统配置、数据结构设计和出错处理设计等，为程序的详细设计提供基础。
其内容要求见表5。
表5 概要设计说明书6、详细设计说明书详细设计说明书又称为程序设计说明，编制目的是说明一个软件系统各个层次中的每一个程序（模块）的设计考虑。
