jgj90t-92建设领域计算机软件工程技术规范

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