JGJT 90-1992 建设领域计算机软件工程技术规范

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