程序文件编写指南

231 GB 8567－88软件开发主要文档编写规范本附录中列出了《计算机软件产品开发文件编制指南》GB 8567－88中主要软件文档的编写说明，供编写时参考。

这些文档主要是：可行性研究报告、项目开发计划、软件需求说明书、概要设计说明书、详细设计说明书、模块开发卷宗、测试计划、测试分析报告、项目开发总结报告。

一、可行性研究报告l 引言1.1 编写目的说明：说明本可行性研究报告的编写目的，指出预期的读者。

1.2 背景 说明：a ．所建议开发的软件系统的名称。

b ．本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络。

c ．该软件系统同其他系统或其他机构的基本的相互来往关系。

1.3 定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。

1.4 参考资料列出用得着的参考资料，如：a ．本项目的经核准的计划任务书或合同、上级机关的批文。

b ．属干本项目的其他已发表的文件。

c. 本文件中各处引用的文件、资料，包括所需用到的软件开发标准。

列出这些文件资料的标题、文件编号、发表日期和出版单位，说明能够得到这些文件资料的来源。

2 可行性研究的前提说明对建议开发项目进行可行性研究的前提，如要求、目标、条件、假定和限制等。

2.1 要求说明对所建议开发软件的基本要求，如： a ．功能。

b ．性能。

c ．输出如报告、文件或数据，对每项输出要说明其特征，如用途、产生频度、接口以及分发对象。

d. 输入说明。

系统的输入包括数据的来源、类型、数量、数据的组织以及提供的频度。

e ．处理流程和数据流程。

用图表的方式表示出最基本的数据流程和处理流程，并输之以叙述。

f. 在安全与保密方面的要求。

g. 同本系统相连接的其他系统。

h. 完成期限。

2.2 目标说明所建议系统的主要开发目标，如： a. 人力与设备费用的减少。

b. 处理速度的提高。

c. 控制精度或生产能力的提高。

232 d ．管理信息服务的改进。

团体标准原则流程及标准编写指南文章被点击次日期:2019-01-21一、制定原则（1）各团体协会或联盟所生产的相同产品，在没有相应国家标准、行业标准和地方标准时，制定团体产品标准；（2）对技术进步和提高产品质量而制定严于国家标准、行业标准和地方标准的，制定的有关团体的产品标准；（3）需要对国家标准、行业标准的选择或补充的，制定团体标准；（4）各团体协会或联盟在产品开发、生产过程中需要统一的设计方法、计算方法、零部件、元器件、工艺和工艺装备等团体标准。

二、制定主体具有法人资格和相应专业技术能力的学会、协会、商会、联合会以及产业技术联盟等社会团体可协调相关市场主体自主制定发布团体标准，供社会自愿采用。

社会团体应组建或依托相关技术机构，负责团体标准制定工作。

三、制定范围社会团体可在没有国家标准、行业标准和地方标准的情况下，制定团体标准，快速响应创新和市场对标准的需求，填补现有标准空白。

鼓励社会团体制定严于国家标准和行业标准的团体标准，引领产业和企业的发展，提升产品和服务的市场竞争力。

四、要求团体标准应符合法律法规和强制性标准要求，不得损害人身健康和生命财产安全、国家安全、生态环境安全。

社会团体应遵循开放、公平、透明和协商一致的原则，吸纳利益相关方广泛参与，遵守WTO/TBT协定中关于制定、采用和实施标准的良好行为规范，制定团体标准化工作相关的管理办法，严格团体标准制修订程序。

五、编号规则团体标准编号依次由团体标准代号（T/）、社会团体代号、团体标准顺序号和年代号组成。

示例如下：六、制定程序团体标准制定程序是团体开展标准化工作的重要制度保障。

为了保证在制定团体标准过程中的程序一致性，社会团体宜通过制度文件的形式把团体标准制定程序确定并发布出来，以便所有团体成员遵照执行。

团体标准制定程序应符合开放、公平、透明、协商一致、促进贸易和交流的原则。

团体标准制修订工作包括申请、立项、起草、审查、审批及发布等程序，按附件一所示的流程进行，如申请未通过或者未进行流程前一项程序,则不得进行下一程序。

《计算机软件文档编写指南》一．计算机软件文档由封面、目录、正文、注释和附录组成。

封面格式：密级：编号：文档名称：项目名称：编制：审核：批准：×××××××××××××研究所年月日二．计算机软件文档包括：1）软件开发计划2）软件需求规格说明3）接口需求规格说明4）接口设计文档5）软件设计文档6）软件产品规格说明7）版本说明文档8）软件测试计划9）软件测试说明10）软件测试报告11）计算机系统操作员手册12）软件用户手册13）软件程序员手册14）计算机资源综合保障文件软件开发计划一．引言1．编写目的（阐明编写软件计划的目的，指出读者对象。

）2．项目背景（可包括：（1）项目委托单位、开发单位和主管部门；（2）该软件系统与其他系统的关系。

）3．定义（列出本文档中用到的专门术语的定义和缩略词的原文。

）4．参考资料（可包括：（1）项目经核准的计划任务书、合同或上级机关的批文；（2）文档所引用的资料、规等；列出资料的作者、标题、编号、发表日期、出版单位或资料来源。

）二．项目概述1.工作容（简要说明项目的各项主要工作,介绍所开发软件的功能性能等. 若不编写可行性研究报告,则应在本节给出较详细的介绍。

)2.条件与限制（阐明为完成项目应具备的条件开发单位已具备的条件以及尚需创造的条件.必要时还应说明用户及分合同承包者承担的工作完成期限及其它条件与限制。

）3.产品（1）程序（列出应交付的程序名称使用的语言及存储形式。

）（2）文档（列出应交付的文档。

）（3）运行环境（应包括硬件环境软件环境。

）4．服务（阐明开发单位可向用户提供的服务. 如人员培训安装保修维护和其他运行支持。

）5．验收标准三．实施计划1．任务分解（任务的划分及各项任务的负责人。

）2．进度（按阶段完成的项目,用图表说明开始时间完成时间。

201010567506.2 一种基于对称密码算法的实体鉴别方法及 系统
专利持有人姓名：西安西电捷通无线网络通信股份有限公司 地址：西安市高新区科技二路68号西安软件园秦风阁A201 联系人：刘长春 电话：029-87607836 请注意除上述专利外，本文件的某些内容仍可能涉及专利。本文件的
20发布机构不承担识别这些专利的责任。
规范性技术要素的比较
要素 规范性技术要素
规范
术语的定义 ...... 要求 证实方法 ...... 规范性附录
规范类型
要求 方法
产品规范 过程规范 服务规范
三 规范类标准的编写
标准的要求
规范标准中的要素“要求”应通过直接或引用的方式规定以下内容： ——保证产品/过程/服务适用性的所有特性； ——特性值； ——适宜时,描述证实方法。 当标准化对象为系统时，规范标准中的要素“要求”应通过直接或引用 的方式规定以下内容： ——保证完整的、已安装的系统适用性的所有特性，根据具体情况,还可 包括系统各构成要素(或子系统)的特性； ——特性值； ——适宜时,描述证实方法。 内容根据具体情况,还可包括确立系统的构成要素(或子系统)以及各要素
36
三 规范类标准的编写
逐批检验 • 批量生产或连续生产的产品，进行全数逐批检验，检验中，出现任一项不
合格时，返修后重新进行检验，若再次出现任一项不合格时，该台产品被 判为不合格产品。逐批检验中性能和外观结构检查两项，允许按GB/T 2828.1进行抽样检验，产品标准中应规定抽样方案和拒收后的处理方法。 • 逐批检验由产品制造单位的质量检验部门负责进行。
的特点 • 分类与技术发展有关的，如GB/T 9813、打印机类规范
32
三 规范类标准的编写