文件编制实施规定实例(GB8567-88)
概述
该文档提供了根据GB8567-88国家标准制定文件编制实施规定的两个参考实例。主要目的是帮助软件开发单位根据自身情况确定开发过程中应编制的文件种类和详细程度。
核心方法:求和法
十二个衡量因素
| 序号 | 因素 | 取值1 | 取值2 | 取值3 | 取值4 | 取值5 |
|---|---|---|---|---|---|---|
| 1 | 创造性要求 | 没有——在不同设备上重编程序 | 很少——有严格要求 | 有限——有新的接口 | 相当多——应用现有技巧 | 重大的——应用先进技巧 |
| 2 | 通用程度 | 很强的限制——单一目标 | 有限制——功能范围参数化 | 有限的灵活性允许格式上有某些变化 | 多用途,灵活的格式有一个主题领域 | 很灵活——能在不同设备上处理范围广泛的主题 |
| 3 | 工作范围 | 局部单位 | 分指挥部 | 单个指挥部 | 多个指挥部 | 国防部,世界范围 |
| 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 | 并行的软件开发 | 没有 | 有限 | 中等程度 | 很多 | 完全的并行开发 |
文件编制决策表
根据十二个因素的总和值确定应编制的文件种类:
| 总和值范围 | 应编制文件 |
|---|---|
| 12~18 | 可行性研究报告、项目开发计划、软件需求说明书、数据要求说明书、概要设计说明书、详细设计说明书、数据库设计说明书、用户手册 |
| 14~24 | 上述文件 + 操作手册、模块开发卷宗、测试设计、测试分析报告、项目开发总结报告 |
| 24~38 | 上述全部文件 + 开发制度月报 |
| 38~50 | 全部文件(全部打√) |
| 48~60 | 全部文件(全部打√) |
关键要点
- 灵活性原则:文件编制存在灵活性,但必须保证达到目的
- 因素评估法:通过十二个因素的综合评估确定文件种类
- 动态调整:根据项目实际情况(规模、复杂度、风险)调整文档要求
- 实用导向:避免过度文档化,也不应文档不足
应用场景
- 软件项目启动阶段评估文档需求
- 制定项目文档编制计划
- 质量控制与文档审查
- 项目规模估算参考
注意事项
- 国内缺乏成熟经验,参考国外经验制定的例子可能有不一致之处
- 两个例子各有片面性,供参考而非照搬
- 项目负责人应根据本单位管理能力、任务规模、复杂性、风险等因素灵活应用