详细设计说明书的目录.docVIP

详细设计说明书的目录 详细设计说明书又可称程序设计说明书。编制目的是说明一个软件系统各个层次中的每一个程序（每个模块或子程序）的设计考虑，如果一个软件系统比较简单，层次很少，本文件可以不单独编写，有关内容合并如概要设计说明书。对详细设计说明书的内容要求如下： 引言 编写目的 背景 定义 参考资料 程序系统的组织结构 程序1（标识符）设计说明 程序描述 功能 性能 输入项 输出项 算法 流程逻辑 接口 存储分配 注释设计 限制条件 测试计划 尚未解决的问题 程序2（标识符）设计说明 …… 详细设计说明书的编写提示 引言 编写目的 说明编写这份详细设计说明书的目的，指出预期的读者。 背景 说明： 待开发软件系统的名称； 本项目的任务提出者、开发者、用户和运行程序系统的计算中心。 定义 列出本文件中用到专门术语的定义和外文首字母组词的原词组。 参考资料 列出有关的参考资料，如： 本项目的经核准的计划任务书或合同，上级机关的批文； 属于本项目的其他已发表的文件； 本文件中各处引用到的文件资料，包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位。说明能够取得这些文件的来源。 程序系统的结构 用一系列图表列出本程序系统内的每个程序（包括每个模块和子程序）的 名称、标识符和它们之间的层次结构关系。 程序1（标识符）设计说明 从本章开始，逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一般情况的。对于一个具体的模块，尤其是层次比较低的模块或子程序，其很多条目的内容往往与它所隶属的上一层模块的对应条目的内容相同，在这种情况下，只要简单地说明这一点即可。 程序描述 给出对该程序的简要描述，主要说明安排设计本程序的目的意义，并且，还要说明本程序的特点（如是常驻内存还是非常驻？是否子程序？是可重入的还是不可重入的？有无覆盖要求？是顺序处理还是并发处理等 求。 输入项 给出对每一个输入项的特性，包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式、数量和频度、输入媒体、输入数据的来源和安全保密条件等等。 输出项 给出对每一个输出项的特性，包括名称、标识、数据的类型和格式、数据值的有效范围、输出的形式数量和频度、输出媒体、对输出图形及符号的说明、安全保密条件等等。 算法 详细说明本程序所选用的算法，具体的计算公式和计算步骤。 流程逻辑 用图表（例如流程图、判定表）等辅以必要的说明来表示本程序的逻辑流程。 接口 用图的形式说明本程序所隶属的上层模块及隶属于本程序的下一层模块、子程序、说明参数赋值和调用方式，说明与本程序相直接关联的数据结构（数据库、数据文卷）。 存储分配 根据需要，说明本程序的存储分配。 注释设计 说明准备在本程序中安排的注释，如： 加在模块首部的注释； 加在各分支点处的注释； 加各变量的功能、范围缺省条件等所加的注释； 对使用的逻辑所加的注释等等。 限制条件 说明本程序运行中所受到的限制条件。 测试计划 说明对本程序进行单体测试的计划，包括对测试的技术要求、输入 数据、预期结果、进度安排、人员职责、设备条件驱动程序及桩模块的规定。 尚未解决的问题 说明在本程序的设计中尚未解决而设计者认为在软件完成之前应解决的问题。 程序2（标识符）设计说明 用类似1.3的方式，说明第2个程序乃至第N个程序的设计考虑。 …… 附录二 程序流程图画法提示 程序流程图也称为程序框图，是软件开发者最熟悉的一种算法表达工具。它独立于任何一种程序设计语言，比较直观、清晰，易于学习掌握。因此，至今仍是软件开发者最普遍采用的一种工具。人们在需要了解别人开发软件的具体实现方法时，常常需要借助流程图，来理解其思路及处理方法。 但是，流程图也存在一些严重的缺点。例如流程图所使用的符号不够规范，常常使用一些习惯性用法。特别是表示程序控制流程的箭头，使用的灵活性极大，程序员可以不受任何约束，随意转移控制。这些问题常常会使程序质量受到很大的影响。这些现象显然是与软件工程化的要求相背离的。为了消除这些缺点，应对流程图所用的符号做出严格的定义，不允许人们随心所欲地画出各种不规范的流程图。 首先，为使用流程图描述结构化程序，必须限制流程图只能使用图1所给出的五种基本控制结构。 这五种基本的控制结构是： 顺序型：几个连续的加工步骤依次排列构成； 选择型：由某个逻辑判断式的取值决定选择两个加工中的一个； 先判定(while)型循环：在循环控制条件成立时，重复执行特定的加工； 后判定(unt