JGJ∕T90-92建设领域计算机软件工程技术规范.pdf

中华人民共和国行业标中华人民共和国行业标准 建 设 领 域 计算机软件工程技术规范 北京 中华人民共和国行业标准 建 设 领 域 计算机软件工程技术规范 主编单位 建 设 部 信 息 中 心 批准部门 中华人民共和国建设部 施行日期年月日 关于发布行业标准 建设领域计算机 软件工程技术规范 的通知 建标号 根据建设部建标字号文的要求 由建设部信息中心 主编的 建设领域计算机软件工程技术规范业经审查 现批准为 推荐性行业标准 编号自年月日起施行 本标准由建设部标准定额研究所归口管理 其具体解释工作 由建设部信息中心负责 本标准由建设部标准定额研究所组织出版 中华人民共和国建设部 年月日 注 本标准编号由调整为 目次 总则 术语 计算机软件开发 一般规定 文件编制要求 编程格式约定 计算机软件验收 计算机软件维护 附录软件开发表格式样 附录软件验收表格式样 附录软件维护表格式样 附录本规范用词说明 附加说明 总则 为使建设领域计算机软件开发 维护和验收各环节符合统 一的要求 做到软件生产中概念一致 格式统一 文档资料完整清 晰 以提高软件生产的质量和效率 并促进软件的工程化和商品 化 尽快形成建设领域的软件产业 制定本规范 本规范适用于建设领域中软件的开发 维护和验收工作 建设领域计算机软件的开发 维护和验收 除应执行本规 范外 尚应符合现行有关国家标准的规定 术语 软件生存周期 软件产品从形成概念开始 经过开发 使用和不断增补修订 直到最后被淘汰的整个过程 用户 为实际需要而使用程序的单位或个人 软件 计算机程序及其有关的数据和文档 包括固化的程序 接口 两个不同系统的交接部分例如 两种硬设备的接口装置 两 个程序块的接口程序 两个或多个程序共同访问的存储区等 用户 接口即为人与机器的交接部分 亦称用户界面 模块 程序中一个能逻辑地分开的部分 确认 在软件开发过程的各阶段结束时 对其成果进行评价 以确定 它是否和原提出的需求相一致 软件强度测试 在事先规定好的一段时间内 对软件进行系统设计能力范围 之内 临界状态下以及超出设计范围情况下的测试 任务承办单位 为任务委托单位开发 购买或选用软件产品的单位 任务委托单位 为产品开发提供资金 并确定产品需求的单位 正确性维护 为改正开发阶段产生而测试阶段未发现的软件错误而进行的 修改 其中包括改正程序错误 文件错误和设计错误 适应性维护 为适应运行环境改变而进行的软件修改 完善性维护 为扩充功能或改善性能而进行的修改和补充 维护管理员 负责组织 管理和协调维护工作的人员 软件维护员 具体完成软件修改的工作人员 工作文件 软件开发过程中填写的各种图表 产品文件 软件开发过程中编制的技术资料或技术管理资料 计算机软件开发 一般规定 计算机软件开发过程 可划分为可行性研究与计划 需求 分析 概要设计 详细设计 实现 组装测试 确认测试七个阶段 计算机软件开发过程各阶段的任务 实施步骤和要求 应 符合现行国家标准 计算机软件开发规范 的规定 计算机软件开发过程各阶段应交付的文件 应符合表 的规定 软件开发阶段应交付的文件表 软件开发过程 各阶段名称 应交付的文件 可行性研究与计划可行性研究报告 项目开发计划 初稿 需求分析 软件需求说明书 项目开发计划 修改稿用户 手册概要 概要设计概要设计说明书 详细设计详细设计说明书 组装测试计划 实现用户手册 组装测试组装测试报告 可运行的程序清单 确认测试 确认测试报告 最终的用户手册 项目开发总结 报告 文件编制要求 文件的种类 计算机软件开发的文件应分为产品文件和工作文件 产品文件 产品文件应包括下列内容 可行性研究报告 项目开发计划 软件需求说明书 概要设计说明书 详细设计说明书 用户手册 测试计划 测试报告 项目开发总结报告 产品文件的内容要求应符合现行国家标准 计算机软 件产品开发文件编制指南 的规定 工作文件 工作文件应采用表格形式表示 表格代号应符合下列规定 用两位数字表示本阶段中表格种类 用一个字母表示开发阶段 其中规定如下 通用表 项目开发计划阶段 概要设计阶段 详细设计阶段 软件开发阶段工作文件采用的表格 宜符合表 的规定 工作文件采用的表格表 项目开发阶段表号表格名称采用表格式样 项目开发计划通用表见附录 阶段现行系统流程图见附录 费用分析报告见附录 进度计划见附录 人员培训计划见附录 软硬件配置表见附录 概要设计阶段通用表见附录 数据流程图见附录 系统流程图见附录 功能模块结构图见附录 功能模块通讯接口表见附录 数据结构描述 同时适用输入 输出数据结构 见附录 输入 输出数据格式描述见附录 标准代码一览表见附录 输入 输出清单见附录 文件 库 清单见附录 功能模块清单见附录 详细设计阶段通用表见附录 程序模块结构图见附录 程序模块通讯接口表见附录 程序模块设计任务书见附录 程序与文件 库 交互关系图见附录 程序流程图及算法描述见附录 程序模块清单见附录 内部变量一览表见附录 软件移交说明见附录 注 凡工作文件各图表后有号的 中规模 含中规模 以下的软件可酌情省略 工作文件的图示格式应符合现行国家标准 信息处理 数据流程图 程序流程图 系统流程图 程序网络图和系统资 源图的文件编制符号及约定 的规定 软件规模分级和对应的产品文件要求 软件的规模宜分为下列三级 小规模软件源程序少于行或存储量小于 中规模软件源程序在行或存储量在 大规模软件源程序多于行或存储量在以上 不同规模软件应提交的产品文件应符合表的 规定 不同规模软件应提交的产品文件表 产品文件名称 小规模 软件 中规模 软件 大规模 软件 可行性研究报告可选 项目开发计划 可行性研究及 开发计划 软件需求说明书 概要设计说明书 详细设计说明书 软件 设计 说明书 软件需求和概要 设计说明书 用户手册 测试计划可选 测试报告 项目开发总结报告 测试和 总结报告 注 有标志为必选 无标志为不选 编程格式约定 元符号 符号用作缩格指示符 在实际的程序行文中并 不出现指示该行相对于上行向右缩格 箭头左端与上行左端对 齐 箭头右端指示本行开始位置 具体缩格数可一次选定 应为 格 符号为可选择符号 表示括在其内的内容是可 有可无的 基本约定 程序单元 主程序或子程序 下同 的长度不宜超过四页打印 纸 约行 其中包括注释行所有标识应具有明显的含义 必 要时可通过注释加以说明 程序结构应包括下列内容 描述体 说明语句 或标识符 参数表 程序体 描述体可以注释形式给出 它的前后应各用一行号与 程序的其它部分隔开描述体应包括下述信息 程序名及含义说明 版本号和完成日期 程序功能 编程人员姓名和单位 修改人员姓名 单位和修改日期 对环境的依赖性 输入数据 或参数 说明 输出数据 或参数 说明 其它需说明的问题 程序应加注释 注释语句的行数宜占整个程序语句总行数 的注释行应书写整齐 注释的左端应对齐 其它约定 在程序中 除去括在字符串内的之外 其余在任何 地方遇均应换行 换行后 除按该格式要求应缩格的外 其余的 均应与上行左端对齐 当一个逻辑行太长时 应折行 在折行时 不应将一个 单词拆开 而且续行也应缩格若表达式太长需折行时 续行表达 式与前一行表达式左端应对齐 在程序中所有用空格作分隔符的地方 宜只保留一个 空格 注释和中内容除外在算术运算符关系运 算符和赋值号 的前后 宜各留一个空格 计算机软件验收 软件验收必须由专门的软件验收机构进行 并应遵守验收 程序及依据合同和软件需求说明书 或概要设计说明书 软件验收程序应符合下列规定 提交软件验收申请报告 成立软件验收机构 软件文件验收 演示 程序验收 测试 测试结果评审 形成软件验收报告 软件验收的工作文件的编制 应符合本规范第条的 规定其中 表格代号应为采用的表格宜符合表的规 定 软件验收采用的表格表 表号表格名称采用表格式样 软件验收申请报告 见 见附录 软件验收报告 见 见附录 软件验收条件具备时 应由开发单位向委托单位提出正式 软件验收申请报告 软件验收机构应符合下列规定 验收机构应由任务委托单位负责建立 验收机构应由委托单位选派的人员 邀请的软件专 家 软件对象 业务应用部门 的专家以及任务承担单位代表组成 可根据工作任务 分文件验收 程序验收两个小组分头进行验收 被验收软件必须满足本规范的规定 应在正式开始验收前 一个月 将被验收软件的有关资料 文件 程序和其它有关报告 提 交验收机构成员 软件文件验收应符合下列规定 必须交付表所列的产品文件 软件文件的编制应符合本规范第节的有关规定 必须保证文件与程序的一致性 文件不全者 不应继续进行验收的下一步骤 承办单位应向验收机构演示软件的所有功能 程序验收应符合下列规定 被验收程序在可靠性方面应符合下列规定 对结构分析程序 应利用结构试验或国内外已公认的结构 计算程序 甚至采用人工校验方法 严格进行解题的正确性验算 并应至少有五个使用单位提出该程序的实用性检查报告 对工程管理程序 应至少利用五个以上人工计算结果 进 行解题的正确性验算 对工程设计程序 应至少有三个以上使用单位提出该程序 的使用性检查报告 被验收程序错误的分级应符合表的规定 程序的错误分级表 错误级别定义 第一级 妨碍完成规定的操作 基本功能未完全实现 影响人员安全或 导致国民经济造成重大损失的错误 第二级 对规定的操作或基本功能的实现产生有害的影响 且不存在 变通解决办法 第三级 对规定的操作或基本功能的实现产生有害的影响 但存在合 理的变通解决办法 第四级其它轻微错误 在功能和性能测试中 不得出现第一 二级错误 随机 性错误和非正常的程序中断 允许出现少量第三 四级错误 其错 误数量限制值宜为第三级错误每机器指令个 第四级错误 每机器指令个 被验收软件必须根据软件需求说明书 或概要设计说 明书 的规定 完成功能测试和性能测试 被验收软件应进行软件强度测试 并应将软件强度测 试中发现的错误清单提交验收机构强度测试应至少包括下列内 容 临界状态下的测试 提供要处理的信息超过设计允许的范围 数据传输能力的饱和试验 要求比设计能力传输更多的数 据内存的写入和读出 外部设备 其它系统及内部接口的数据 传输等 超出规定存贮量的能力 如缓冲区等 在软件验收工作结束时 经验收机构评审后形成的软件 验收报告 应记录文件验收和程序验收的结论及评价 验收机构成 员应在软件验收报告上签字 并由验收机构负责人根据表决情况 签署验收意见 验收意见分为两种 通过 有以上成员同意验收 和不通 过 计算机软件维护 软件维护的工作文件应符合本规范第条的规定 其 中表格代号应为当为时 为软件退役文件软件维护 采用的表格宜符合表的规定 软件维护采用的表格表 表号表格名称采用表格式样 软件维护申请表 见 见附录 软件维护任务单 见见附录 软件退役报告 见见附录 软件维护应包括正确性维护 适应性维护和完善性维护三 种类型 正确性维护申请应填写软件维护申请表 必要时补充 下列资料 运行时打印的出错信息 输入数据清单 硬件环境情况 现用软件情况 维护要求 适应性维护申请应填写软件维护申请表 必要时补充 下列资料 软件运行环境变动情况 现用软件情况 维护要求 完善性维护申请应填写软件维护申请表 必要时补充 下列资料 拟维护软件功能和性能说明 现用软件情况 维护情况 软件维护组织与实施应符合下列规定 根据维护工作规模和要求 维护组织应由维护管理员 和软件维护人员组成 应由维护管理员承接维护申请 确定维护任务范围 所需资源 维护需求 成本 进度安排和其它条件 以 软件维护任 务单 形式向软件维护员下达任务 软件维护员承接任务后 应按分析 设计 编程和测试等步骤 进行维护 并应提交必要的维护文件 软件维护记录应符合下列规定 对维护过程中的重要工作应做记录 作为维护文件保 存同时应做维护统计 可视软件规模选用下列内容 维护的类型 程序变动前与变动后的源语句总数 修改的源语句总数 增加的源语句总数 删减的源语句总数 程序变动所发生的总人时和总机时数 对每一维护类型程序变动花费的人时和机时数 维护记录作为维护文件的组成部分 应有软件维护员和维 护管理员签名 维护中对原版本有关文件进行修改和整理时 必须严 格遵守本规范第节中的有关规定 做到文件与程序相符 维护后软件的测试与验收应符合下列规定 经过正确性维护的软件 应重新测试被修改过的程 序 经过适应性维护和完善性维护的软件产生新版本时 应按照本规范第章中的有关规定 重新进行验收 不宜继续使用 且已没有维护价值的软件应办理软件退役 手续 填写软件退役报告 附录软件开发表格式样 通用表表格式样 第页共页 开发阶段制表人审查人年月日 现行系统流程图表格式样 现行系统流程图第页共页 项目开发计划制表人审查人年月日 费用分析报告表格式样 费用分析报告第页共页 费用项目 分析设 计阶段 实现阶段 运行维护阶段 第年第年第年 设 备 费 计算机及外围设备 机房建设及设备购置 开 发 费 系统软件程序开发 软件安装调试 培 训 费 人员技术培训费 技术资料费 工 时 费 人员工资 奖金津贴 材 料 费 消耗性材料费 燃料动力费 维 护 费 设备租金折旧 软硬件维护 其 它 运输费 差旅杂费 总费用 效益回收 差额 项目开发计划制表人审查人年月日 进度计划表格式样 进度计划第页共页 单位定义 本工程项目开始时间由 系 统 开 发 过 程 可行性研究与计划 需求分析 概要设计 详细设计 编程 实现 组装测试 确认测试 运行维护 成果评价 机器订货 机器安装 项目开发计划制表人审查人年月日 人员培训计划表格式样 人员培训计划第页共页 人 员 内 容 阶 段 用户 经理 数据 管理 人员 终端 用户 程序 员 操作员 及数据 录入员 可行性研究 与计划 需求分析 概要设计 详细设计 编程 组装测试 确认测试 运行与维护 项目开发阶段制表人审查人年月日 软硬件配制表表格式样 软硬件配置表第页共页 硬 件 配 置 名称型号内存容量外存容量数量备注 辅 助 设 备 软 件 配 置 名称英文缩写备注 项目开发计划制表人审查人年月日 数据流程图表格式样 数据流程图第页共页 业务功能名称标识 概要设计制表人审查人年月日 系统流程图表格式样 系统流程图第页共页 概要设计制表人审查人年月日 功能模块结构图表格式样 功能模块结构图第页共页 模块名称模块标识被调用 概要设计制表人审查人年月日 功能模块通讯接口表表格式样 功能模块通讯接口表第页共页 模块名称模块标识 接口编号输入类型输出类型 概要设计制表人审查人年月日 数据结构描述表格式样 数据结构描述第页共页 子系统标识 数据 结构名 数据结 构标识 数据结构 类型 用途 存贮介质 记录组 合系数 记录 长 主键 名 数据结构 存贮容量 本数据结构定义的其它各种键文件及其性质 序号层号 数据项 名称 数据 标识 类型及 长度 关键字说明 概要设计制表人审查人年月日 输入 输出数据格式描述表格式样 输入 输出数据格式描述第页共页 模块名称标识处理程序名 输入 输出方式 使用部门 保密处理周期复制份数 输入数 据名称 标识 类型及 长度 输出数 据名称 标识 类型及 长度 概要设计制表人审查人年月日 标准代码一览表表格式样 标准代码一览表第页共页 代码名称代码标识 代码结构标准级别 国 部标 国际 概要设计制表人审查人年月日 输入 输出清单表格式样 输入 输出清单第页共页 输入来源参考号输出去处参考号 注 参考号指业务流程描述表中的描述分列序号 概要设计制表人审查人年月日 文件 库 清单表格式样 文件 库 清单第页共页 文件库名文件库标识文件类型 概要设计制表人审查人年月日 功能模块清单表格式样 功能模块清单第页共页 功能模块名标识功能简介 概要设计制表人审查人年月日 程序模块结构图表格式样 程序模块结构图第页共页 模块名称模块标识被调用 详细设计制表人审查人年月日 程序模块通讯接口表表格式样 程序模块通讯接口表第页共页 模块名称模块标识 接口编号输入类型输出类型 详细设计制表人审查人年月日 程序模块设计任务书表格式样 程序模块设计任务书第页共页 程序模块 标识 程序 标识 程序 语言 系统 分析员 程序员 设计 期限 程序目标概述 系统处理流程图 局部 与本程序有关的文件 库 的说明 文件 库 名 文件 库 标识 文件 库 结构访问方式 关键字 详细设计制表人审查人年月日 程序与文件 库 交互关系图表格式样 程序与文件 库 交互关系图第页共页 详细设计制表人审查人年月日 程序流程图及算法描述表格式样 程序流程图及算法描述第页共页 模块名称模块标识程序标识 详细设计制表人审查人年月日 程序模块清单表格式样 程序模块清单第页共页 模块名称模块标识功能表述模块长度 详细设计制表人审查人年月日 内部变量一览表表格式样 内部变量一览表第页共页 子 系 统 名 称 子 系 统 标 识 模块名 模块 标识 变量 名称 变量 标识 类型长度含义 详细设计制表人审查人年月日 软件移交说明表格式样 软件移交说明第页共页 本软件包括张 软盘盘 磁带 本软件的磁介质规格用户签字 序号软盘 磁带 标记 盘 带 包含的 程序名 主要功能说明 详细设计制表人审查人年月日 附录软件验收表格式样 软件验收申请报告表格式样 软件验收申请报告第页共页 项目名称合同号 委托单位承办单位 软件功能和性能描述 文件描述 承办单位申请意见 技术负责人签字年月日 承办单位盖章 软件验收报告表格式样 软件验收报告第页共页 项目名称合同号 委托单位承办单位 验收项目及评价 验收意见 表决 情况 同意不同意弃权 主任签字年月日 软件验收委员会名单及签名 姓名 职务或 职称 工作单位 所学 专业 现 从 事 专业 签字 附录软件维护表格式样 软件维护申请表表格式样 软件维护申请表第页共页 申请人姓名登记号 申请单位登记日期 联系电话问题发现时间 申请维护类型 申请理由 维护内容概述 处理意见 签名 年月日 附注 软件维护任务单表格式样 软件维护任务单第页共页 登记号登记日期 版本号批准时间 申请人维护开始时间 维护管理员软件维护员 变动描述 变动影响 附注 资源 估计 人时数 机时数 软件退役报告表格式样 软件退役报告第页共页 登记日期维护单位 用户单位开发单位 登记人姓名地址电话 子 系统标记子 系统名称 用户关于软件退役原因描述 批准人 开发及维护者意见 负责人 附注 退役制表人审查人年月日 附录本规范用词说明 为便于在执行本规范条文时区别对待 对于要求严格程 度不同的用词说明如下 表示很严格 非这样做不可的 正面词采用 必须 反面词采用 严禁 表示严格 在正常情况下均应这样做的 正面词采用 应 反面词采用 不应 或 不得 表示允许稍有选择 在条件许可时首先应这样做的 正面词采用 宜 或 可 反面词采用 不宜 条文中指明必须按其它有关标准执行的写法为 应按 执行 或 应符合的要求 或规定非必须按所规定的标准执行 的写法为 可参照的要求 或规定 附加说明 本规范主编单位 参加单位和 主要起草人名单 主编单位建设部信息中心 参加单位建设部标准定额研究所 中国建筑科学研究院 中国建筑工程总公司 建设部城市建设司 建设部设计管理司 建设部科技发展司 建设部施工管理司 建设部房地产业司 建设部城市规划司 主要起草人郝力马进忠魏绥臣张红吕运德 王春富方天培张汉义周庭友迟计 魏天翔刘行蔡子琛董爱军