文件给制实施规定的实例(GB8567-88) 尽管在文件编制中存在着很多灵活性,然而,文件的编制确实是非常必要的, 其意义如前所述。为了控制这种灵活性,保证文件编制能达到应该达到的目的, 对于具体的软件开发任务,应编制的文件的种类、详细程度应取决于承担开发单 位的管理能力、任务的规模、复杂性和成败风险等因素。一个软件开发单位应该 根据本单位经营承包的应用软件的专业特点和本单位的管理能力,制定一个文件 编制实施规定,说明在什么情况下应该编制哪些文件。由于国内目前在这方面还 缺乏成熟的经验,这里提供参考国外经验制定的两个例子,用以向国内软件开发 单位说明如何建立这种实施规定,使项目负责人能确定本项目开发过程中应编制 的文件的种类。当然,例子毕竟只是例子,这两个例子各自都不免有其片面性, 它们两者之间也不免有不一致之处,之所以列出来无非是供国内软件开发单位参 例1: 此例规定用求和法来确定应编制的文件。该方法的要点是提出十二个考虑因 素来衡量一个应用软,件,每个因素可能取值的范围是互至5。任务负责人可用 这十二个因素对所要开发的程序进行衡量,确定每个因素的具体值。把这十二个 因素的值相加,得到一个总和。然后由这个总和的值来确定应该编制的文件的种 类。使用这个方法的具体过程如下: a.按表OI中的十二个因素衡量所要开发的程序,得到每个因素的值 b.把衡量所得的各个因素的值相加,得总和之值 c.根据总和之值,从表OZ查出应编制的文件的种类。 表1文件编制的十二项衡量因素 因素 因素取值准则 创造性要求同的设备上重很少一具有有限一一具有相当多一一应重大的一一应 编程序 严格的要求|新的接口用现有的技巧用先进的技巧 有限制一功有限的灵活性多用途,灵活|根福 通用程度单一目标|能的范围是参允许格式上有的格式有一个上处理范围广 泛的主题 工作范围 局部单位分指挥部单个指挥部多个指挥部/国防部,世界
1 文件给制实施规定的实例（GB8567-88） 尽管在文件编制中存在着很多灵活性，然而，文件的编制确实是非常必要的， 其意义如前所述。为了控制这种灵活性，保证文件编制能达到应该达到的目的， 对于具体的软件开发任务，应编制的文件的种类、详细程度应取决于承担开发单 位的管理能力、任务的规模、复杂性和成败风险等因素。一个软件开发单位应该 根据本单位经营承包的应用软件的专业特点和本单位的管理能力，制定一个文件 编制实施规定，说明在什么情况下应该编制哪些文件。由于国内目前在这方面还 缺乏成熟的经验，这里提供参考国外经验制定的两个例子，用以向国内软件开发 单位说明如何建立这种实施规定，使项目负责人能确定本项目开发过程中应编制 的文件的种类。当然，例子毕竟只是例子，这两个例子各自都不免有其片面性， 它们两者之间也不免有不一致之处，之所以列出来无非是供国内软件开发单位参 考。 例 1： 此例规定用求和法来确定应编制的文件。该方法的要点是提出十二个考虑因 素来衡量一个应用软，件，每个因素可能取值的范围是互至 5。任务负责人可用 这十二个因素对所要开发的程序进行衡量，确定每个因素的具体值。把这十二个 因素的值相加，得到一个总和。然后由这个总和的值来确定应该编制的文件的种 类。使用这个方法的具体过程如下： a. 按表 OI 中的十二个因素衡量所要开发的程序，得到每个因素的值； b. 把衡量所得的各个因素的值相加，得总和之值； c. 根据总和之值，从表 OZ 查出应编制的文件的种类。 表 1 文件编制的十二项衡量因素 序 号 因素 因素取值准则 1 2 3 4 5 1 创造性要求 没有——在不 同的设备上重 编程序 很少——具有 严格的要求 有限——具有 新的接口 相当多——应 用现有的技巧 重大的——应 用先进的技巧 2 通用程度 很强的限制— —单一目标 有限制——功 能的范围是参 量化的 有限的灵活性 允许格式上有 某些变化 多用途，灵活 的格式有一个 主题领域 很灵活——能 在不同的设备 上处理范围广 泛的主题 3 工作范围 局部单位 分指挥部 单个指挥部 多个指挥部 国防部，世界 范围
目标范围的变 没有 极少 偶尔有 经常 不断 5设备复杂性单机,常规处理,扩充的外/多机,标准外多机,复杂的主机控制系 理 设系统 外设系统 统,多机,自 设系统 动IO和显示 10~18人 18人以上 开发投资 6人月以下6人月至3人3人年至10人10人年至3030人年以上 数据处理常规过程控制 人身安 对程变的 完成时间要求 2周以上 3~7天 1~3天 24小时以内 10对数据输入的 2周以上 1~2周 1~7天 1~24小时60分钟内 程序语言 高级语言 高级语言带一|高级语言带相 些汇编 当多的汇编 汇编语言 机器语言 并行的软件开 没有 有限 中等程度 很多 完全的并行开 表1文件编制的十二项衡量因素 行/项|软|数概详级用 件|据要|细 测目开 研|开|要设设库操块测试开|发 和发求|求/计/计/设/ 作开试分发制 袈/计|说说说说计使手发设析总度 n读划明明|明/明/说用册卷计报结月 书书书/书/明/说 告报报 书 24~38 38~50 √ *在因素总和较低的情况下项目开发总结报告的内容应包括:程序的主要功能 基本流程、测试结果和使用说明。 **测试分析报告应该写,但不必很正规。 **数据要求说明和数据库设计说明是否需要编写应根据所开发软件的实际需要 来决定。 例2 为了避免在软件开发中文件编制的不足或过分,一个简便的办法是把对软件 文件的编制要求同软件的规模大小联系起来,这就是本例的出发点。软件的规模 不妨分为四级 1.小规模软件源程序行数小于5000的软件 2.中规模软件源程序行数为10000~50000的软件 3.大规模软件源程序行数为10000-500000的软件; 2
2 4 目标范围的变 化 没有 极少 偶尔有 经常 不断 5 设备复杂性 单机，常规处 理 单机，常规处 理，扩充的外 设系统 多机，标准外 设系统 多机，复杂的 外设系统 主机控制系 统，多机，自 动 I/O 和显示 6 人员 1～2 人 3～5 人 5～10 人 10～18 人 18 人以上 7 开发投资 6 人月以下 6 人月至 3 人 年 3 人年至 10 人 年 10 人年至 30 人年 30 人年以上 8 重要程度 数据处理 常规过程控制 人身安全 单位成败 国家安全 9 对程序改变的 完成时间要求 2 周以上 1～2 周 3～7 天 1～3 天 24 小时以内 10 对数据输入的 响应时间要求 2 周以上 1～2 周 1～7 天 1～24 小时 60 分钟内 11 程序语言 高级语言 高级语言带一 些汇编 高级语言带相 当多的汇编 汇编语言 机器语言 12 并行的软件开 发 没有 有限 中等程度 很多 完全的并行开 发 表 1 文件编制的十二项衡量因素 因 素 总 和 可 行 性 研 究 报 告 项 目 开 发 计 划 软 件 需 求 说 明 书 数 据 要 求 说 明 书 概 要 设 计 说 明 书 详 细 设 计 说 明 书 数 据 库 设 计 说 明 书 用 户 手 册 （ 使 用 说 明 ） 操 作 手 册 模 块 开 发 卷 宗 测 试 设 计 测 试 分 析 报 告 项 目 开 发 总 结 报 告 开 发 制 度 月 报 12～18* 14～24 24～38 38～50 48～60 √ √ √ √ √ √ √ √ √ √ √ √ *** *** *** *** √ √ √ *** *** *** *** √ √ √ √ √ √ √ √ √ √ √ √ √ √ √ √ ** ** √ √ √ √ √ √ √ √ √ √ √ *在因素总和较低的情况下,项目开发总结报告的内容应包括：程序的主要功能、 基本流程、测试结果和使用说明。 **测试分析报告应该写，但不必很正规。 ***数据要求说明和数据库设计说明是否需要编写应根据所开发软件的实际需要 来决定。 例 2： 为了避免在软件开发中文件编制的不足或过分，一个简便的办法是把对软件 文件的编制要求同软件的规模大小联系起来，这就是本例的出发点。软件的规模 不妨分为四级： 1. 小规模软件源程序行数小于 5000 的软件； 2. 中规模软件源程序行数为 10000～50000 的软件； 3. 大规模软件源程序行数为 100000—500000 的软件；
4.特大规模软件源程序行数大于50000的软件。 对上述的四级软件的文件编制要求分别列于表3 至于源程序行数为5000~10000,50000~100000的软件,其文件编制要求 介于两级之间,可根据一个软件产品的具体情况,由项目负责人参照表3的规定 确定需要编制的文件种类 对于源程序行数大于500000的特大规模软件,可进一步把本指南规定的十 四种文件按实际需要扩展成更多种类,这一点在本指南533已经提到。 表3产品文件体系 小规模软件 中规模软件 大规模软件 超大规模软件 「可行性报告 对应大规模软件 项目开发计划 所规定的文件可 项目开发计划 进一步细分 软件需求与开发计划 软件需求说明 软件需求说明 数据要求说明 测试 测试计划 概要设计说明 软件设计说明 软件设计说明 详细设计说明 数据库设计说明 使用说明 使用说明 用户手册 操作手册 ∫模块开发卷宗—模块开发卷 测试分析报告 测试分析报告 测试分析报告 项日开发总{开发光发损二一形数我
3 4. 特大规模软件源程序行数大于 500000 的软件。 对上述的四级软件的文件编制要求分别列于表 3。 至于源程序行数为 5000～10000，50000～100000 的软件，其文件编制要求 介于两级之间，可根据一个软件产品的具体情况，由项目负责人参照表 3 的规定， 确定需要编制的文件种类。 对于源程序行数大于 500000 的特大规模软件，可进一步把本指南规定的十 四种文件按实际需要扩展成更多种类，这一点在本指南 5.3.3 已经提到。 表 3 产品文件体系 可行性报告 项目开发计划 对应大规模软件 所规定的文件可 进一步细分 软件需求说明 数据要求说明 测试计划 项目开发计划 软件需求说明 测试计划 软件需求与开发计划 概要设计说明 详细设计说明 数据库设计说明 软件设计说明 软件设计说明 使用说明 使用说明 用户手册 操作手册 模块开发卷宗 测试分析报告 测试分析报告 模块开 发卷 宗测试分析报告 开发进度月报 项目开发总结 开发进度月报 项目开发总结 项目开发总结 小规模软件 中规模软件 大规模软件 超大规模软件