软件开发文档说明书完整流程样本.doc

在软件行业有一句话：一种软件能否顺利完毕并且功能与否完善，重要是看这个软件有多少文档，软件开发文档是一种软件支柱，如果你开发文档漏洞百出，那么你所开发出来软件也不也许会好；开发文档好坏可以直接影响到所开发出来软件成功与否。  

一、软件开发设计文档：软件开发文档涉及软件需求阐明书、数据规定说有书、概要设计阐明书、详细设计阐明书。

1、软件需求阐明书：也称为软件规格阐明。 该阐明书对所开发软件功能、性能、顾客 界面及运营环境等做出详细阐明。它是顾客与开发人员双方对软件需求获得共同理 解基本上达到合同，也是实行开发工作基本。软件需求阐明书编制目就是 为了使顾客和软件开发者双方对该软件初始规定有一种共同理解、并使之面成为 整个开发工作基本。
其格式规定如下：  
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、概要设计阐明书：又称系统设计阐明书，这里所说系统是指程序系统。编制目是阐明对程序系统设计考虑，涉及程序系统基本解决。流程、程序系统组织 构造、模块划分、功能分派、接口设计。运河行设计、数据构造设计和出错解决设计等，为程序详细设计提供基本。
其格式规定如下：  
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 系统维护设计。  

3.详细设计文档：重要是把咱们每个小模块，小功能业务逻辑解决用文字方式表达出来，让程序员在编码时候有一种根据和参照；同步，在进行详细文档设计时候，有软件公司也会依照不同项目作出相应《软件开发代码规范》性文档，以保障咱们所做工作统一性。如果一种软件系比较简朴，层次很少，本文献可以不单独编写，关于内容合并入概要设计阐明书。
其格式规定如下： 

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 尚未解决问题  
4 程序 2设计阐明 ...    

二、软件开发管理文档：可行性研究报告、项目开发筹划、开发进度月报、项目开发总结、模块开发卷宗。

1.可行性研究报告：编写目是，阐明该软件开发项目实当前技术、经济和社会条件方面可行性：评述为了合理达到开发目的而也许选取各种方案；阐明并论证所选定方案。
其格式规定如下：  
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 人员 
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．1．3 非一次性支出 
6．2 收益 
6．2．1 一次性收益 
6．2．2 非一次性收益 
6．2．3 不可定量收益 
6．3 收益投资比 
6．4 投资回收周期 
6．5 敏感性分析  
7 社会因素方面可行性 
7．1 法律方面可行性 
7．2 使用方面可行性  
8 结论  

2.项目开发筹划：是为软件项目实行方案制定出详细筹划。项目开发筹划应提前给管理部门，并作为开发阶段评审基本。编制项目开发筹划止是用文献形式，把对于在开发过程中各项工作负责人员、开发进度、所需经费预算、所需软硬条件等问题做出安排记载下来，以便依照本筹划开展和检查项目开发工作。
其格式规定如下：  
1 引言 
1．1 编写目 
1．2 定义 
1．3 参照资料  
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 接口人员 
3．3 进度 
3．4 预算 
3．5 核心问题  
4 支持条件 
4．1 计算机系统支持 
4．2 需收顾客承担工作 
4．3 由外单位提供条件  
5 专项筹划要点  

3.开发进度月报：开发进度月报编制目是及时向关于部门报告项目开发进度和状况，以便及时 发现和解决开发过程中浮现问题，普通开发进度月报是以项目组单位每月编写。如果被开发软件系统规模比较大，整个工程项目被划分给若干个分项目驵承担，开发进度月报将以分项目为单位搂月编写。 其格式规定如下： 
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.项目开发总结：软件项目开发完毕之后，应当与项目实行筹划对照，总结实际执行状况，如进度、 成果、资源运用、成本和投入人力。此外，还需对开发工作做出评价，总结经验和教训。项目开发总结报告编制是为了总结本项目开发工作经验，阐明实际获得开发成果以及对整个开发工作各个方面评价。
其格式规定如下：  
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 经验与教训  

5.模块开发卷宗：模块开发卷宗是在模块开发过程中逐渐编写出来，每完毕一种模块或一组密切有关模块复制进编写一份，应当把所有模块开发卷宗汇集在一起。编写目是记录和汇意低层次开发进度和成果，经便于对整个模块开发工作管理和复审，并为将来维护提供非常有用技术信息。 1 标题 
2 模块开发状况表：
其中模块开发状况表格式如下表：
模块标记符

模块描述性名称

代码设计（筹划开始日期 实际开始日期）

模块测试（筹划开始日期 实际开始日期）

组装测试（筹划开始日期 实际开始日期）

代码复查(日期/签字)

源代码行数（预测/实际）

目际模块大小（预测 实际）

项目负责人批准(日期/签字)

3 功能阐明  
4 设计阐明  
5 源代码清单  
6 测试阐明  
7 复审结论    

三、软件开发测试文档：概要测试筹划、详细测试筹划、测试实行筹划、测试分析报告。

1.概要测试筹划：是软件项目实行筹划中一项重要内容，应当在软件开发初期、即需求分析阶段制定。项筹划应当定义被测试对象和测试目的，拟定测试阶段和测试周期划分；制定测 试人员、软硬件资源和测试进度等方面筹划，规定软件测试办法，测试原则以及支持环境和测试工具。

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．2．3 输入举例 
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．1 运营控制 
4．3．2 操作控制 
4．3．3 输入输出文卷 
4．3．4 输出文段 
4．3．5 输出文段复制
4．3．6 恢复过程 
4．4 运营 2 ...
5 非常规过程  
6 远程操作  

3.维护建议：软件产品投入运营之后，也许有修改、改正等问题。应当对存在问题、修改考虑以及修改影响预计等作详细描述，写成维护修改建议、提交审批。
其格式规定如下： 
1 引言  
1．1 综述 
1．2 术语及缩写语 
1．3 参照资料  
2 程序构造描述  
3 维护过程  
3．1 启动 
3．2 系统查询及事件报告功能 
3．3 硬件状态能功能描述  
4 出错解决及非常规过程  
4．1 系统重启动过程 
4．2 严重故障时紧急解决 
4．3 普通故障解决 
4．4 数据备份工作  
5 附录  
5．1 附录一 
5．2 附录二  

文档编制阐明：文档标题用于阐明项目名称，文档主题用于阐明本文档内容，文档编号和文档版本重要用于归档和检索。