软件开发文档规范方案.docx

1、软件开发文档规范方案附2:软件文档编写向导文档分类工程包括如下几类文档：工程管理文档。包括：?软件工程方案?、?工程进度报告?、?工程开发总结报告?软件开发文档。包括：?需求规格说明?、?概要设计说明?、?详细设计说明?、?测试方案?、?软件测试分析报告?。产品文档。包括：?用户操作手册?演示文件?。软件工程方案Software Project Plan一引言1编写目的说明编写软件方案的目的，指出读者对象。2工程背景可包括：1工程委托单位、开发单位和主管部门；2该软件系统与其他系统的关系。3定义列出本文档中用到的专门术语的定义和缩略词的原文。4参考资料可包括：文档所引用的资料、规等；列出资料的

2、作者、标题、编号、发表日期、出版单位或资料来源。二工程概述1. 工作容简要说明工程的各项主要工作,介绍所开发软件的功能性能等. 假设不编写可行性研究报告,那么应在本节给出较详细的介绍。)2. 条件与限制说明为完成工程应具备的条件开发单位已具备的条件以及尚需创造的条件. 必要时还应说明用户及分合同承包者承当的工作完成期限及其它条件与限制。3. 产品 1程序列出应交付的程序名称使用的语言及存储形式。 2文档列出应交付的文档。 3运行环境应包括硬件环境软件环境。4效劳说明开发单位可向用户提供的效劳. 如人员培训安装保修维护和其他运行支持。5验收标准三实施方案1任务分解任务的划分及各项任务的负责人。2

3、进度按阶段完成的工程,用图表说明开场时间完成时间。3预算4关键问题说明可能影响工程的关键问题,如设备条件技术难点或其他风险因素,并说明对策。四人员组织及分工五交付期限六专题方案要点如测试方案等。工程开发进度报告一报告时间及所处的开发阶段二给出进度1本周的主要活动2实际进展与方案比拟三所用工时按不同层次人员分别计时。四所有机时五工作遇到的问题及采取的对策六本周完成的成果七下周的工作方案八特殊问题工程开发总结报告一引言1编写目的说明编写总结报告的目的,指明读者对象。2工程背景说明工程的来源、委托单位、开发单位及主管部门。3定义列出报告中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者

4、、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2需求规格说明书；3概要设计说明书；4详细设计说明书；5用户操作手册；6测试方案；7测试分析报告8本报告引用的其他资料、采用的开发标准或开发规。二开发结果1产品可包括：1列出各局部的程序名称、源程序行数包括注释行或目标程序字节数及程序总计数量、存储形式；产品文档名称等。2主要功能及性能3所用工时按人员的不同层次分别计时。4所用机时5进度给出方案进度与实际进度的比照。三评价1生产率评价如平均每人每周源程序行数、文档的字数等。2技术方案评价3产品质量评价四经历与教训需求规格说明书Requirements Specification

5、一引言1编写目的说明编写需求说明书的目的,指明读者对象。2工程背景可包括：1工程的委托单位,开发单位和主管部门；2该软件系统与其他系统的关系。3定义列出文档中用到的专门术语定义和缩写词的原文。4参考资料可包括：1工程开发方案；2文档所引用的资料，标准和规。列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源。二任务概述1目标2运行环境3条件与限制三数据描述1静态数据2动态数据包括输入数据和输出数据。3数据库描述给出使用数据库的名称和类型。4数据词典5数据采集四功能需求1功能划分2功能描述五性能需求1数据准确度2时间特性如响应时间、更新处理时间、数据转化与传输时间、运行时间等。3适应性在

6、操作方式运行环境与其他软件的接口以及开发方案等发生变化时，应具有的适应能力。六运行需求1用户界面如屏幕格式、报表格式、菜单格式、输入输出时间等。2硬件接口3软件接口4故障处理七其他需求如可使用性、平安、可维护性、可移植性等。概要设计说明书Architectural Design Specification一引言1编写目的说明编写概要设计说明书的目的，指明读者对象。2工程背景可包括：1工程的委托单位,开发单位和主管部门；2该软件系统与其他系统的关系。3定义列出文档中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2

7、需求规格说明书；3测试方案初稿；4用户操作手册初稿；5文档所引用的资料、采用的标准或规。二任务概述1目标2运行环境3需求概述4条件与限制三总体设计1处理流程2总体构造和模块外部设计3功能分配说明各项功能与程序构造的关系。四接口设计1外部接口包括用户界面软件接口与硬件接口。2部接口模块之间的接口。五数据构造设计1逻辑构造设计2物理构造设计3数据构造与程序的关系六运行设计1运行模块的组合2运行控制3运行时间七出错处理设计1出错输出信息2出错处理对策如设置后备、性能降级、恢复及再启动等。八平安设计九维护设计说明为方便维护工作的设施,如维护模块等。详细设计说明书Procedural Design Sp

8、ecification一引言1编写目的说明编写详细设计说明书的目的,指明读者对象。2工程背景应包括工程的来源和主管部门等。3定义列出文档中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2需求规格说明书；3概要设计说明书；4测试方案(初稿)；5用户操作手册(初稿)；5文档所引用的其他资料、软件开发标准或规。二总体设计1需求概述2软件构造如给出软件系统的结果图。三程序描述逐个模块给出以下的说明:：1功能2性能3输入工程4输出工程5算法模块所选用的算法。6程序逻辑详细描述模块实现的算法，可采用:：1标准流程图；2N-

9、S图；3PAD；4判定表等描述算法的图表。7接口8存储分配9限制条件10测试要点给出测试模块的主要测试要求。测试方案Test Plan一、引言1编写目的说明编写测试方案的目的,指明读者对象。2工程背景说明工程的来源委托单位及主管部门。3定义列出测试方案中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2需求规格说明书；3概要设计说明书；4详细设计说明书；5用户操作手册; (6) 本测试方案中引用的其他资料采用的软件开发标准或规。二任务概述1目标2运行环境3需求概述4条件与限制三方案1测试方案说明确定测试方法和选取

10、测试用例的原那么。2测试工程列出组装测试和确认测试中每一项测试的容、名称、目的和进度。3测试准备4测试机构及人员测试机构名称负责人和职责。四测试工程说明按顺序逐个对测试工程做出说明：1测试工程名称及测试容2测试用例1输入输入的数据和输入的命令。2输出预期的输出数据。3步骤及操作4允许偏差给出实测结果与预测结果之间允许偏差的围。3进度4条件给出项测试对资源的特殊要求，如设备、软件、人员等。5测试资料说明项测试所需的资料。五评价1围说明所完成的各项测试说明问题的围及其局限性。2准那么说明评价测试结果的准那么。测试分析报告Test Specification一引言1编写目的说明编写测试分析报告的目的

11、，指明读者对象。2工程背景说明工程的来源、委托单位及主管部门。3定义列出测试分析报告中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2需求规格说明书；3概要设计说明书；4详细设计说明书；5用户操作手册；6测试方案；7测试分析报告所引用的其他资料、采用的软件工程标准或软件工程规。二测试方案执行情况1测试工程列出每一测试工程的名称、容和目的。2测试机构和人员给出测试机构名称、负责人和参与测试人员。3测试结果按顺序给出每一测试工程的：1实测结果数据2与预期结果数据的偏差3该项测试说明的事实4该项测试发现的问题。三软件

12、需求测试结论按顺序给出每一项需求测试的结论。包括：1证实的软件能力2局限性即项需求未得到充分测试的情况及原因。四评价1软件能力经过测试所说明的软件能力。2缺陷和限制说明测试所揭露的软件缺陷和缺乏,以及可能给软件运行带来的影响。3建议提出为弥补上述缺陷的建议。4测试结论说明能否通过。用户操作手册User Guide一引言1编写目的说明编写手册的目的，指明读者对象。2工程背景说明工程的来源、委托单位、开发单位及主管部门。3定义列出手册中用到的专门术语定义和缩写词的原意。4参考资料列出这些资料的作者、标题、编号、发表日期、出版单位或资料来源，可包括：1工程开发方案；2需求规格说明书；3概要设计说明书

13、；4详细设计说明书；5测试方案；6手册中引用的其他资料、采用的软件工程标准或软件工程规。二软件概述1目标2功能3性能1数据准确度包括输入、输出及处理数据的精度。2时间特性如响应时间、处理时间、数据传输时间等。3灵活性在操作方式、运行环境需做某些变更时软件的适应能力。三运行环境1硬件列出软件系统运行时所需的硬件最小配置，如：1计算机型号、主存容量；2外存储器、媒体、记录格式、设备型号及数量；3输入、输出设备；4数据传输设备及数据转换设备的型号及数量。2支持软件如：1操作系统名称及版本号；2语言编译系统或汇编系统的名称及版本号；3数据库管理系统的名称及版本号；4其他必要的支持软件。四使用说明1安装

14、和初始化给出程序的存储形式、操作命令、反应信息及其含义、说明安装完成的测试实例以及安装所需的软件工具等。2输入给出输入数据或参数的要求。1数据背景说明数据来源、存储媒体、出现频度、限制和质量管理等。2数据格式如：1长度2格式基准3标号4顺序5分隔符6词汇表7省略和重复8控制。3输入举例3输出给出每项输出数据的说明。1数据背景说明输出数据的去向、使用频度、存放媒体及质量管理等。2数据格式详细说明每一输出数据的格式,如:首部主体和尾部的具体形式。3举例3出错和恢复给出：1出错信息及其含义2用户应采取的措施，如修改、恢复、再启动。4求助查询说明如何操作。五运行说明1运行表 列出每种可能的运行情况,说

15、明其运行目的.2运行步骤 按顺序说明每种运行的步骤,应包括:1运行控制2操作信息1运行目的2操作要求3启动方法4预计运行时间5操作命令格式及说明6其他事项。3输入/输出文件给出建立和更新文件的有关信息，如：1文件的名称及编号2记录媒体3存留的目录4文件的支配说明确定保存文件或废弃文件的准那么，分发文件的对象，占用硬件的优先级及控制等。4启动或恢复过程六非常规过程提供给急或非常规操作的必要信息及操作步骤，如出错处理操作、向后备系统切换操作以及维护人员须知的操作和考前须知。七操作命令一览表按字母顺序逐个列出全部操作命令的格式功能及参数说明。八程序文件或命令文件和数据文件一览表按文件名字母顺序或按功能与模块分类顺序逐个列出文件名称、标识符及说明。九用户操作举例