软件开发文档说明书完整流程.docx
《软件开发文档说明书完整流程.docx》由会员分享，可在线阅读，更多相关《软件开发文档说明书完整流程.docx（14页珍藏版）》请在冰豆网上搜索。
软件开发文档说明书完整流程
在软件行业有一句话：
一个软件能否顺利的完成并且功能是否完善，重要是看这个软件有多少文档，软件开发文档是一个软件的支柱，如果你的开发文档漏洞百出，那么你所开发出来的软件也不可能会好；开发文档的好坏可以直接影响到所开发出来软件的成功与否。
一、软件开发设计文档：
软件开发文档包括软件需求说明书、数据要求说有书、概要设计说明书、详细设计说明书。
1、软件需求说明书：
也称为软件规格说明。
该说明书对所开发软件的功能、性能、用户界面及运行环境等做出详细的说明。
它是用户与开发人员双方对软件需求取得共同理解基础上达成的协议，也是实施开发工作的基础。
软件需求说明书的编制U的的就是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解、并使之面成为整个开发工作的基础。
其格式要求如下：
1引言
1・1
编写目的。
1.2
背景
1・3
定义
2任务概述
2.1目标
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接口
4.4控制
2、概要设讣说明书：
乂称系统设讣说明书，这里所说的系统是指程序系统。
编制的LI的是说明对程序系统的设讣考虑，包括程序系统的基本处理。
流程、程疗;系统的组织结构、模块划分、功能分配、接口设计。
运河行设计、数据结构设计和出错处理设计等，为程序的详细设计提供基础。
其格式要求如下：
1引言
1.1编写目的
1.2背景
1.3定义
1.4参考资料
2总体设计
2.1需求规定
2.3基本设讣概念和处理流程
2.4结构
2.5功能需求与程序的关系
2.6人工处理过程
2.7尚未解决的问题
3接口设计
3.1用户接口
3.2外部接口
3.o3内部接口
4运行设计
4.1运行模块的组合
4.2运行控制
4.3运行时间
5系统数据结构设讣
5.1逻辑结构设计要点
5.2物理结构设计要求
5.3数据结构与程序的关系
6系统出错处理设汁
6.1出错信息
6.2补救措施
6.3系统维护设计。
3.详细设计文档：
主要是把我们每个小模块，小功能的业务逻辑处理用文字的方式表达出来，让程序员在编码的时候有一个依据和参照；同时，在进行详细文档设计的时候，有的软件公司也会根据不同的项I」作出相应的《软件开发代码规范》性文档，以保障我们所做工作的统一性。
如果一个软件系比较简单，层次很少,本文件可以不单独编写，有关内容合并入概要设计说明书。
其格式要求如下:
1引言
1.1编写目的
1.2背景
1.3定义
1.4参考资料
2程序设讣系统的结构
3程序1设计说明
3.
1
程序描述
3.
2
功能
3.
3
性能
3.
4
输入项
3.
5
输出项
3.
6
算法
3.
7
流程逻辑
3.
8
接口
3.
9
存储分配
3.
10
注释设计
3.
11
限制条件
3.
12
测试计划
3.
13
尚未解决的问题
二、软件开发管理文档：
可行性研究报告、项H开发计划、开发进度月报、项口开发总结、模块开发卷宗。
1.可行性研究报告：
编写LI的是，说明该软件开发项L1的实现在技术、经济和社会条件方面的可行性：
评述为了合理达到开发U标而可能选择的各种方案：
说明并论证所选定的方案。
其格式要求如下：
1引言
1・1
编写目的
1.2
背景
1.3
定义
1・4
参考资料
2可行性研究的前提
2.1要求
2.2目标
2.3条件、假定和限制
2.4进行可行性研究的方法
2.5评价尺度
3对现有系统的分析
3.1处理流程和数据流程
3.2工作负荷
3.5设备
3.6局限性
4所建议的系统
4.1对所建议系统的说明
4.2处理流程和数据流程
4.3改进之处
4.4影响
4.4.1结设备的影响
4.4.2对软件的影响
4.4.3对用户单位机构的影响
4.4.4对系统运行过程的影响
4.4.5对开发的影响
4.4.6对地点和设备的影响
4.4.7对经费开支的影响
4.5局限性
4.6技术条件方面的可行性
5可选择的其他系统的可行性
5.1可选择的系统方案1
5.2可选择的系统方案2
6投资及效益分析
6.1支出
6.1.1基本建设投资
6.1.2其他一次性支出
6.2.1一次性收益
6.2.2非一次性收益
6.2.3不可定量的收益
6.3收益投资比
6.4投资回收周期
6.5敏感性分析
7社会因素方面的可行性
7.1法律方面的可行性
7.2使用方面的可行性
8结论
2.项U开发计划：
是为软件项口实施方案制定出的具体计划。
项U开发讣划应提前给管理部门，并作为开发阶段评审的基础。
编制项訂开发讣划的止的是用文件的形式，把对于在开发过程中各项工作的负责人员、开发进度、所需经费预算、所需的软硬条件等问题做出的安排记载下来，以便根据本讣划开展和检查项口的开发工作。
其格式要求如下：
1引言
1.1编写目的
1.2定义
1.3参考资料
2项目概述
2.1工作内容
2.2主要参加人员
2.3.2方件
2.3.3服务
2.3.4非移交的产品
2.4验收标准
2.5完成项目的最迟期限
2.6本计划的批准者和批准日期
3实施计划
3.1工作任务的分配与人员分工
3.2接口人员
3.3进度
3.4预算
3.5关键问题
4支持条件
4.1计算机系统支持
4.2需收用户承担的工作
4.3由外单位提供的条件
5专题计划要点
3.开发进度月报：
开发进度月报的编制U的是及时向有关部门汇报项U开发的进度和情况，以便及时发现和处理开发过程中出现的问题，一般开发进度月报是以项LI组单位每月编写的。
如果被开发的软件系统规模比较大，整个工程项LI被划分给若干个分项訂殂承担，开发进度月报将以分项H为单位搂月编写。
其格式要求如下：
1标题
2工程进度与状态
2.1进度
2.2状态
3资源耗用与状态
3.1资源耗用
3.1.1工时
3.1.3机时
3.2状态
4经费支出与状态
4.1经费支出
4.1.1支持性费用
4.1.2设备购置费
4.2状态
5下一个月的工作计划
6建议
4.项U开发总结：
软件项口开发完成之后，应当与项L1实施计划对照，总结实际执行的情况，如进度、成果、资源利用、成本和投入的人力。
此外，还需对开发丄作做出评价，总结经验和教训。
项LI开发总结报告的编制是为了总结本项LI开发工作的经验，说明实际取得的开发结果以及对整个开发工作的各个方面的评价。
其格式要求如下：
1引言
1・1
编写口的
1.2
背景
1・3
定义
1.4参考资料
2实际开以结果
2.1产品
2.2主要功能和性能
2.3基本流程
2.4进度
2.5费用
3开发工作评价
3.1对生产效率的评价
3.2对产品质量的评价
3.3对技术方法的评价
3.4出错原因的分析
4经验与教训
3.模块开发卷宗：
模块开发卷宗是在模块开发过程中逐步编写出来的，每完成一个模块或一组密切相关的模块的复制进编写一份，应该把所有的模块开发卷宗汇集在一起。
编写的U的是记录和汇意低层次开发的进度和结果，经便于对整个模块开发工作的管理和复审，并为将来的维护提供非常有用的技术信息。
1标题
2模块开发情况表：
其中模块开发情况表的格式如下表:
模块标识符
模块的描述性名称
代码设计（计划开始日期实际开始日期）
模块测试（计划开始日期实际开始|］期）
组装测试（计划开始日期实际开始日期）
代码复査（日期/签字）
源代码行数（预计/实际）
目际模块大小（预讣实际）
项目负责人批准（日期/签字）
3功能说明
4设计说明
5源代码清单
6测试说明
7复审的结论
三.软件开发测试文档：
概要测试计划、详细测试计划、测试实施计划、测试分析报告。
1•概要测试计划：
是软件项LI实施计划中的一项重要的内容，应当在软件开发初期、即需求分析阶段制订。
项计划应当定义被测试对象和测试U标，确定测试阶段和测试周期的划分；制订测试人员、软硬件资源和测试进度等方面的计划，规定软件测试方法，测试标准以及支持环境和测试工具。
2.详细测试计划：
是针对子系统在特定的测试阶段所要进行的测试丄作制订详细计划，它详细说明规定了测试小组的各项测试任务，测试策略、任务分配和进度安排等。
3.测试实施讣划：
测试人员的测试实施讣划是根据详细讣划制订的测试者的测试具体实施计划。
它规定了测试者在每一轮测试中负责测试的内容，测试强度和工作进度等。
测试实施讣划是整个软件测试的组成部分，是检查测试实际执行情况的重要依据。
1引言
1.1编写目的
1.2背景
1.3定义
1.4参考资料
2计划
2.1软件说明
2.2测试内容
2.3测试
2.3.1进度安排
2.3.2条件
2.3.3测试资料
2.3.4测试培训
2.4测试
3测试设计说明
3.1测试
3.1.1控制
3.1.2输入
3.1.3输出
3.1.4过程
3.2测试
4评价准则
4.1范围
4.2数据整理
4.3尺度
4.测试分析报告：
测试工作完成以后，应当提交测试计划情况说明书，对测试结果加以分析，并提出测试的结论性意见。
其格式要求如下：
1引言
1.1编写目的
1.2背景
1.3定义
1.4参考资料
2测试概要
3测试结果及发现
3.1测试1
3.2测试2
4对软件功能的结论
4.1功能1
4.1.1能力
4.1.2限制
4.2功能2
5分析摘要
5.1能力
5.2缺陷和限制
5.3建议
5.4评价
6测试资源消耗
四、用户文档：
用户手册、操作手册。
1•用户手册：
用户手册的编制是要使用非专门术语的语言，充分地描述该软件系统所具有的功能及基本的使用方法，使用户（或潜在用户）通过本手册能够了解该软件的用途，并且能够确定在什么情况下，如何使用它。
其格式要求如下：
1引言
1.1
编写目的
1.2
背景
1.3
定义
1.4
参考资料
2用途
2.1
功能
2.2
性能
2.2.1精度
2.2.2时间特性
2.2.3灵活性
2.3安全保密
3运行环境
3.1硬设备
3.2支持软件
3.3数据结构
4使用过程
4.1安装与初始化
4.2输入
4.2.1输入数据的现实背景
4.2.2输入格式
4.3输出
4.3.1输出数据的现实背景
4.3.2输岀格式
4.3.3输出举例
4.4文卷查询
4.5出错处理和恢复
4.6终端操作
2.操作手册:
操作手册的编制是为了向操作人员提供该软件每一个运行的具体过程和有关知识，包括操作方法的细节。
其格式要求如下：
1引言
1.1编写目的
1.2背景
1.3定义
1.4参考资料
2软件征述
2.1软件的结构
2.2程序表
2.3文卷表
3安装与初始化
4运行说明
4.1运行表
4.2运行步骤
4.3.1运行控制
4.3.2操作控制
4.3.3
升级会员 