软件研发规范

1、拟制柳涛审核准页码1/5软件开发规范文件号版本/日期密级一、前言二、文档规范篇1. 概述2. 文档与软件开发过程3. 文档规范需求规格说明概要设计说明详细设计说明数据库设计说明测试计划测试设计说明测试用例说明测试总结报告系统指南用户操作手册三、编码规范篇1. 概述拟制柳涛审核准页码2/5软件开发规范文件号版本/日期密级2. 编码规范命名规范编程结构描述注释函数注释条件执行语句ifelse重复执行while和跳转语句goto书写格式字体数据对象的国际化3. 软件开发规范的控制拟制柳涛审核准页码3/5软件开发规范文件号版本/日期密级第一章前言拟制柳涛审核准页码4/5软件开发规范文件号版本/日期密级

2、第二章文档规范篇1.概述软件生存期的所有阶段都要求编制文档。因此文档编制和维护是必需的并且从 软件的概念阶段连续作用到它废止。文档编制开始于软件项目的初始阶段，并贯穿 于软件的设计、开发、测试、安装、使用、修改和增强。文档的编制是任何软件开发项目成功的基础，并且文档的产生需要有时间、人 工和资金的支撑。管理的职责是保证这些资源有效地利用重要文档的标识以使软件 产品成功开发并提高质量。本章重点在于规定在软件开发阶段各文档的编制规范2. 文档与软件开发过程阶段文件、需求分析设计实现测试运行与维护项目开发计划需求规格说明概要设计说明详细设计说明数据库设计说明测试计划测试总结系统指南用户操作手册开发进

3、度月报项目开发总结拟制柳涛审核准页码5/5软件开发规范文件号版本/日期密级3. 文档规范需求规格说明软件需求规格说明书1. 引言项目名称项目背景和内容概要（项目的委托单位、开发单位、主管部门、与其它项目的关系，与其他 机构的关系等）相关资料、缩写语、定义（相关项目计划、合同及上级机关批文，引用的文件、采用的标准，缩 写词和相关名词定义）2. 项目概述被开发软件的一般描述（被开发软件的主要组成部分，相互联系和外部接口，可用系统流程图 的层次结构描述）被开发软件的功能（简述被开发软件的功能）实现语言（列出所采用的编程语言）用户特点（描述最终用户具有的受教育水平、工作经验及技术专长）假定条件与约束限

4、制（尽量列出开展本项目的假定和约束，例如：经费限制，开发限制，设 备条件，用户现场环境准备等）3. 业务流程（描述项目的业务流程，可结合系统流程图进行描述）4. 数据描述原始数据描述静态数据动态数据数据流向图数据概念模型和描述拟制柳涛审核准页码6/5软件开发规范文件号版本/日期密级5. 功能需求功能描述（描述该软件功能及使用方法；列出与功能有关的背景资料）输入要求a）输入数据的描述，包括输入源、数量、度量单位和精度b）操作控制需求，包括输入格式、数据类型、精度和范围自动检验等c）输入设备接口资料，包括设备型号、数量处理要求a）输入数据有效性检查手段b）操作顺序和处理过程c）非正常情况的响应，如

5、溢出、通讯故障、错误处理等d）输出数据有效性检查手段输出要求a）输出数据的描述，包括目的地（存储媒体和用途）、数量、度量单 位和精度b）非法数据的处理c）指明引用的输出设备接口资料，包括设备型号和数量6. 界面要求 报表格式 图形要求 输入输出要求7. 接口要求（描述与本系统相连的系统的接口的数据格式， 数据交换协议，接口功能等） 硬件接口a）软件产品与系统硬件设备之间每一接口的逻辑特点b）硬件接口支持的设备c）软件与硬件设备接口之间以及硬件接口与支持设备之间的约定 软件接口描述该软件产品与其他有关软件的接口关系，并指出这些软件的名字和作用。通讯接口说明各种通讯接口及协议。8性能要求数据精确度

6、（例如：数据内部精度，外部显示精度）拟制柳涛审核准页码7/5软件开发规范文件号版本/日期密级数据量时间特性要求（根据所开发系统的特点，规定系统对时间的特性要求。例如，系统响 应时间，界面更新处理时间，数据转换与传输时间）9. 运行环境要求网络和硬件设备平台（网络拓扑图及设备类型描述）操作系统平台数据库系统平台编程工具其他支撑软件10. 其他专门需求 安装与操作 安全与保密 维护服务概要设计说明概要设计说明书1. 引言项目名称项目背景和内容概要（项目的委托单位、开发单位、主管部门、与其它项目的关系，与其他 机构的关系等）相关资料、缩略语、定义（相关项目计划、合同及上级机关批文，引用的文件、采用的

7、标准，缩 写词和名词定义等）2. 概要设计软件体系结构（用图来表示软件系统的总体结构框架，并针对其进行描述）基本设计概念和处理流程软件结构子系统划分a）子系统清单拟制柳涛审核准页码8/5软件开发规范文件号版本/日期密级b）各子系统功能描述 程序模块划分和功能分配（包括前端程序模块和后端存储过程的划分和功能分配）a）子系统及程序模块清单b）各程序模块功能描述c）功能一一模块对照表d）模块数据实体对照表 人工处理过程（描述不能完全自动处理，需人工处理的过程。）3. 软件模块的物理分布（根据系统网络结构，描述软件模块在各个设备上的物理分布）4. 接口设计 与外系统的接口内部接口5. 用户界面设计（和

8、用户交互的最终界面在详细设计说明中设计解释，在此应对系统的 主界面和界面风格进行设计和描述）6. 数据结构和算法设计程序中数据结构描述（描述系统中主要的数据结构和模块间共享的数据结构） 主要算法设计7. 出错处理设计 出错信息（用表的方式说明可能的出错和故障情况出现时，系统输出信息、形式 和含义）出错处理措施8. 安全保密设计（描述安全保密方案，权限设置，保密算法，软件的实现方法等）详细设计说明详细设计说明书1.引言 项目名称拟制柳涛审核准页码9/5软件开发规范文件号版本/日期密级项目背景和内容概要（项目的委托单位、开发单位、主管部门、与其它项目的关系，与其他 机构的关系等）相关资料、缩略语、

9、定义（相关项目计划、合同及上级机关批文，引用的文件、采用的标准，缩 写词和名词定义等）2. 程序结构程序结构图（主要表示程序之间的调用关系）程序文件清单子系统名程序文件名运行平台编程语言简要描述3. 程序设计说明程序文件名 子系统名编写者 编写日期第次修改修改人 修改日期程序功能描述：输入输出项：主要数据结构：存取的数据库表和字段：调用的其他程序：调用的公共函数库或公共函数:拟制柳涛审核准页码10/5软件开发规范文件号版本/日期密级算法:逻辑流程图：测试要点：4. 用户界面设计说明用户界面图（可制作有关用户界面图集的附录参考） 用户界面与模块关系表用户界面名称用户界面编号隶属子系统相关模块名称

10、简要名称数据库设计说明数据库设计说明书1. 引言项目名称项目背景和内容概要（项目的委托单位、开发单位、主管部门、与其它项目的关系，与其他 机构的关系等） 相关资料、缩略语、定义（相关项目计划、合同及上级机关批文，引用的文件、采用的标准，缩 写词和名词定义等）2. 约定（数据库中各种元素的命名约定。例如表名，字段名的命名约定）3. 数据库概念模型设计数据实体关系图数据实体描述（数据实体中文名、数据库表名、数据实体描述）实体关系描述拟制柳涛审核准页码11/5软件开发规范文件号版本/日期密级（描述每一个实体间的关系）4. 数据库逻辑模型设计实体关系图（不含多对多关系）关系模型描述数据视图描述（用标准

11、SQL语言中创建数据视图的语句描述）数据库一致性设计（用标准SQL语言中创建表的语句描述）5. 物理实现数据库的安排a）说明是否采用分布式数据库，数据库表如何分布b）每个数据库服务器上建立几个数据库，其存储空间安排c）数据库表的分配方法安全保密的设计（用户角色划分方法，每个角色的权限）测试计划测试计划1. 引言项目名称测试计划名称项目背景和内容概要（项目的委托单位、开发单位、主管部门、与其它项目的关系，与其他 机构的关系等）相关资料、缩略语、定义（相关项目计划、合同及上级机关批文，引用的文件、采用的标准，缩 写词和名词定义等）2. 测试过程 测试目标a）测试目的b）测试类型c）测试级别测试分工

12、（分配参与到测试工作中所有人员的职责，如谁负责生成测试代码，谁负责进行具体的测试工作等）拟制柳涛审核准页码12/5软件开发规范文件号版本/日期密级测试步骤及方法（采用测试过程控制程序中规定的那些步骤和相应的测试内容及方 法）测试通过标准（由项目负责人组织制定，女口：执行完毕没有系统错误；满足性能要求； 产生了预期结果等）修正错误并重新测试的步骤与要求（填写错误报告表、修正程序错误、修改设计说明，重新测试等）3. 测试小结 测试环境要求（外部接口的设置；准备必要的资源）测试用例的简单描述（如测试用例命名规则，需要的测试特性）需求跟踪（创建一个跟踪矩阵来描述功能需求与测试用例之间的关系）测试设计说

13、明测试用例说明测试用例说明1. 序号2. 测试用例的名称（按照测试计划和测试设计给定的测试用例名称，例如：LN0102可表示辽宁电力局项目，第01个测试要点的第02个测试用例）3. 测试用例的目的（给出此测试用例要验证的功能，既给出针对的测试断言）4. 测试用例的输入（测试用例的输入项详细描述）5. 期待的输出（测试用例的程序预期输出项详细描述）6. 测试方法（如何执行测试用例）拟制柳涛审核准页码13/5软件开发规范文件号版本/日期密级7. 实际的输出（测试用例执行后进行填写）8. 相关测试用例（与本测试用例相关的测试用例，比如对统一需求进行验证的所有测试用例 及其关系）测试总结报告测试总结报

14、告1. 引言编写目的背景说明（被测试系统的名称，任务提出者，开发者，用户等。指出测试环境与 实际运行环境之间的差异以及其对测试结果的影响）2. 测试概要（用表格的形式表示每一个测试项的标识与其内容，指出实际测试内容与 测试计划的差别以及更改的原因）3. 测试结果（每一个测试项的每一个测试用例执行后的实际结果与与其结果向比较，说明所发现的结果）4. 对软件功能的结论（对软件的每一个功能，给出相应的结论）a）通过测试检验的能力b）发现的限制和缺陷5. 分析总结（通过以上几个步骤，对软件进行总体上的评价，说明限制和缺陷）6. 测试资源的消耗（在测试工作中的资源消耗，包括人员，时间等）系统指南拟制柳涛

15、审核准页码14/5软件开发规范文件号版本/日期密级系统指南1.引言编写目的背景2.系统功能 系统简介 系统功能 系统特性3.运行环境 网络结构 硬件设备 支持软件 运行环境要求4. 系统安装 安装准备 安装过程 系统初始化5. 出错处理用户操作手册拟制柳涛审核准页码15/5软件开发规范文件号版本/日期密级第二章编码规范篇1概述一个好的软件产品是众多程序设计和实现人员共同努力，协同开发的结果，而 源程序代码的逻辑简明清晰、易读易懂是好程序的一个重要标准。本章重点规定在程序编码过程中所有程序人员都应当遵守的规范。2. 编码规范命名规范文件名文件名采用小写，使用能够表达文件功能的词汇或词组进行命名。

16、女如: loop.c 表示此文件中的内容与循环操作或循环优化过程有关。函数名函数名应能够基本表达函数功能，采用字母的词组，可用下划线连接。女口：sim_fetch_register表示模拟从寄存器中读取数据的过程。变量名变量名应尽量能表达此变量的用途，采用字母。如：err_no表示此变量用作对错误号的纪录。表名表名以r_开头，能表明表的内容。如：r_stu_name表示此表用作纪录学生 姓名。视图名视图名以v_开头，应尽量体现各视图的功能。触发器名触发器名为相应的表名加上后缀，Insert触发器加Delete触发器加_d，Update触发器加_u，女口： r_bch_i， r_bch_d, r_bch_u。存储过程名存储过程应以sp_开头，后续部分主要以动宾形式构成。命名的其他注意事项以上命名不得超过29个字符的系统限制。数据对象、变量的命名都应采用英文字符，禁止使用中文命名。编程结构描述拟制柳涛审核准页码16/5软件开发规范文件号版本 / 日期密级注释a）注释以英文为主b）注释尽可能详细、全面c）视情况采用单行注释和多行注释的形式d）简洁，清晰函数说明为大多数函数编写函数说明。说明中应包含