文件编制实施规定实例(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全部文件(全部打√)

关键要点

  1. 灵活性原则:文件编制存在灵活性,但必须保证达到目的
  2. 因素评估法:通过十二个因素的综合评估确定文件种类
  3. 动态调整:根据项目实际情况(规模、复杂度、风险)调整文档要求
  4. 实用导向:避免过度文档化,也不应文档不足

应用场景

  • 软件项目启动阶段评估文档需求
  • 制定项目文档编制计划
  • 质量控制与文档审查
  • 项目规模估算参考

注意事项

  • 国内缺乏成熟经验,参考国外经验制定的例子可能有不一致之处
  • 两个例子各有片面性,供参考而非照搬
  • 项目负责人应根据本单位管理能力、任务规模、复杂性、风险等因素灵活应用

关联知识