DB34∕T 3379-2019 水利信息系统软件开发集成规范.pdf

ICS 35.080 J 07 DB34 安徽省地方标准 DB 34/T 33792019 水利信息系统软件开发集成规范 Software development and integration specification for water information system 文稿版次选择 2019 - 07 - 01 发布 2019 - 08 - 01 实施安徽省市场监督管理局 发 布 DB34/T 33792019 I 目 次 前言 . III1 范围 . 12 规范性引用文件 . 13 术语和定义 . 14 缩略语 . 15 软件开发基本流程 . 25.1 适用性说明 . 25.2 开发前准备工作 . 25.3 系统架构设计 . 25.4 界面设计 . 25.5 软件单项功能模块开发 . 25.6 软件代码编写、测试及应用整合 . 25.7 系统试运行与测评 . 25.8 完善与优化 . 25.9 文档管理 . 36 软件开发性能及运行环境要求 . 36.1 软件性能 . 36.2 软件开发及运行环境 . 36.3 数据库 . 47 软件开发过程控制 . 47.1 系统软件架构 . 47.2 数据库设计 . 57.3 界面（UI）开发 . 67.4 单项功能模块开发 . 77.5 接口设计 . 77.6 软件测试 . 87.7 系统部署 . 87.8 参数设置 . 98 系统集成 . 98.1 基本要求 . 98.2 数据集成 . 98.3 应用集成 . 108.4 界面集成 . 128.5 权限控制与管理 . 12DB34/T 33792019 II 9 移动应用开发与集成 . 129.1 移动应用开发 . 129.2 移动应用集成 . 1310 系统安全策略 . 1310.1 权限、策略机制 . 1310.2 认证、授权机制 . 1310.3 编码开发安全控制 . 1310.4 数据存储控制 . 1310.5 数据传输安全 . 1310.6 异地容灾机制 . 1310.7 安全等级保护测评 . 1311 质量控制、培训及运维管理 . 1311.1 质量控制 . 1411.2 培训管理 . 1411.3 运维管理 . 14附录 A（资料性附录） 水利信息系统软件第三方测评情况说明表 . 16附录 B（资料性附录） 水利信息系统软件开发文档 . 17附录 C（资料性附录） 水利信息系统软件开发情况说明 . 18附录 D（规范性附录） 接口服务说明文档 . 20附录 E（资料性附录） 软件开发流程图 . 22附录 F（资料性附录） 某省级水资源监控管理系统集成样例 . 23 DB34/T 33792019 III 前 言 本标准按照 GB/T 1.1-2009 给出的规则起草。 本标准由安徽省水利厅提出并归口。 本标准起草单位：安徽省（水利部淮河水利委员会）水利科学研究院、安徽省大禹水利工程科技有限公司、安徽省水利信息中心。 本标准起草人：刘怀利、沈超、王跃国、刘超、胡卫权、李辉、贾飞、马浩、邓峰、王新、徐浩、王铭铭、朱文浩、朱小磊、陈明、马顺、商笑妍、顾庆玮、庄冬、芦韵琦、郭鑫。 DB34/T 33792019 1 水利信息系统软件开发集成规范 1 范围 本标准对水利信息系统软件开发基本流程、软件开发性能及运行环境、软件开发过程控制、系统集成、移动应用开发集成、系统安全策略、质量控制、培训及运维管理等重要环节进行了规定。 本标准适用于水利信息系统软件开发集成项目的设计、实施和维护升级等。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件， 仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 SL 478 水利信息数据库表结构及标识符编制规范 SL/Z 589 水利信息化业务流程设计方法通用指南 SL 701 水利信息分类 SL 715 水利信息系统运行维护规范 3 术语和定义 下列术语和定义适用于本文件。 3.1 软件开发流程 software development process 描述完成一项软件开发工作所进行的业务需求分析、架构设计、功能设计、程序编码、应用整合、功能测试等一系列工作的具体环节、步骤和程序。 3.2 系统集成 system integration 根据信息管理与应用的需求，通过应用、数据等方面的集成，实现信息系统之间网络互联、数据共享交换、功能及业务应用可相互调用，使资源达到充分共享，实现集中、高效、便利的管理。 4 缩略语 下列缩略语适用于本文件。 SSO：单点登录（Single Sign On） SOA：面向服务的架构(Service Oriented Architecture) JSON：JavaScript 对象简谱(JavaScript Object Notation) SSL：安全套接层（Secure Sockets Layer） DB34/T 33792019 2 PKI/CA：公钥基础设施（ Public Key Infrastructure ） ESB：企业服务总线（Enterprise Service Bus） 5 软件开发基本流程 5.1 适用性说明 本章规定了水利信息系统软件开发最为基本的流程，针对不同软件开发项目，可以有不同流程，但不限于 5.25.9 提出的基本要求。 5.2 开发前准备工作 根据实际业务需要，开展需求调研，完成业务需求分析和业务流程分析报告，软件业务流程设计应符合 SL/Z 589 的规定。 5.3 系统架构设计 根据业务流程与功能需求，确定系统设计架构。 5.4 界面设计 根据业务特点对主要界面进行布局设计，应体现主要功能菜单布置、色彩搭配、界面层次级别等信息，形成用户认可的界面设计成果。 5.5 软件单项功能模块开发 应对主要功能模块进行单项设计，功能模块划分应科学合理，以便于使用和扩展为原则。 5.6 软件代码编写、测试及应用整合 组织完成软件各功能模块的代码编写， 并分阶段组织单模块测试和多模块组合测试， 最后完成系统各项业务应用整合，整合后的系统功能应能充分满足用户使用需要。 5.7 系统试运行与测评 5.7.1 系统试运行 系统上线试运行，发布测试版软件供用户试用，并对系统试运行情况以及用户试用意见进行跟踪。 5.7.2 软件测评 委托测评机构进行软件测评，测评项目包括软件功能测评、性能效率测评、信息安全性测评等。测评完成后应形成测评情况说明文档，文档格式可参考附录A。 5.8 完善与优化 5.8.1 软件完善与优化 根据软件试运行结果及用户反馈意见对软件进行完善和优化。 5.8.2 正式版发布 软件经过用户试用、测评和修改完善后达到上线要求，形成正式版软件发布。 DB34/T 33792019 3 5.9 文档管理 5.9.1 开发文档整理 整理系统开发实施各阶段的技术文件、图表资料、测试报告、验收报告等，形成完整的开发文档资料，具体资料目录可参见附录B。 5.9.2 编制软件开发情况说明表 提取软件设计开发过程中的关键技术指标形成软件开发情况说明表， 可供后续开发人员参考， 也便于系统用户快速掌握软件的核心内容，表格具体设计可参见附录C。 5.9.3 操作指南编写 编写操作指南，指导用户安装使用，明确硬件配置要求以及注意事项等内容。 6 软件开发性能及运行环境要求 6.1 软件性能 6.1.1 响应时间 系统应具有快速响应的特性，用户打开界面和提交事务的平均响应时间应1.5 s，用户进行在线实时查询业务操作的数据处理时间应5 s。 6.1.2 吞吐率 软件系统吞吐率（单位时间内网络上传输的数据量）应能满足10 M/s。 6.1.3 并发用户数 系统应能够在并发用户数达到 300 的情况下稳定运行，不会出现数据丢包。 6.1.4 系统稳定性 系统应能保证稳定运行，且应具备故障检测、故障诊断、故障恢复等故障自检功能，在故障发生时应能保证重要数据不丢失并能将故障模块自动隔离。 6.1.5 页面加载与数据传输 页面数据的加载、 修改、 增加等操作应采用异步的方式操作， 数据宜统一采用 JSON 格式进行传输。 6.2 软件开发及运行环境 6.2.1 开发环境 宜使用 J2EE 环境进行系统软件开发，JDK 版本可使用当前最新版本的前一个版本号进行环境搭建。 6.2.2 Web 应用服务器 宜采用 weblogic 服务进行应用发布，对特殊要求的应用可通过申请采用其他应用服务。 6.2.3 内存使用控制及会话保存时间 DB34/T 33792019 4 单用户会话占用内存不应超过 5 兆， 应保存用户在 Session 会话中的核心数据 （包括菜单、 单位、用户信息等），非核心数据可通过数据库、接口等方式进行获取。用户 Session 会话时间应为 15 分钟。 6.2.4 运行环境 服务器端宜采用 WindowsServer、 Linux 等主流操作系统作为软件的运行支撑平台， 客户端应能够广泛兼容 IE、360、Chorme、Safari 等主流的浏览器版本。 6.3 数据库 各类系统数据库应优先选择已在水利行业广泛应用的数据库类型， 为方便集成和数据对接共享宜选择 oracle 数据库。 7 软件开发过程控制 7.1 系统软件架构 7.1.1 水利信息系统软件应按照“分层设计、模块构建”的思想，采用多层结构设计，形成可扩展、开放式的体系结构，主要包括数据存储层、业务支撑层、业务应用层以及用户界面层等 4 个层面，其中数据存储层实现数据存储管理与共享调用； 业务支撑层提供各项业务应用支撑服务和应用集成； 业务应用层进行业务逻辑封装，实现水利相关各类业务应用功能；用户界面层实现与用户的交互；系统的建设应遵循水利相关标准规范体系，依托水利信息安全保障体系。 7.1.2 水利信息系统软件总体组成架构如下图 1 所示。 图1 水利信息系统软件组成架构图 7.1.3 架构设计要求 水利信息系统软件架构设计包含如下基本要求： a) 应按照多层体系结构进行设计； b) 系统应采用 SOA（面向服务架构）进行设计和实现，前后端分离。后端为业务逻辑，采用接口方式进行开发，将访问的接口通过文档的方式进行共享；前端为展现逻辑，通过自行开发的数据接口进行调用； DB34/T 33792019 5 c) 应采用组件模式，保持业务应用层或业务支撑层功能组件的“松耦合”，且具有被封装为不同粒度“服务”的可能； d) 安全保障体系中与应用安全相关的信任和授权管理应遵循国家信息安全相关标准。 7.2 数据库设计 7.2.1 信息分类编码与表结构设计 信息分类编码与表结构设计应满足如下要求： a) 信息的分类与编码应符合 SL 701 的规定； b) 数据库表结构设计及标识符编制应符合 SL 478 的规定； c) 应充分保证数据结构的合理性，数据元素归类和划分应合理，对数据项应进行合理描述。 7.2.2 数据库分类 数据库建设应从总体上划分为基础数据库、业务数据库、监测数据库、空间数据库、多媒体数据库五大类。每一类数据库存储的数据信息如下： a) 基础数据库：各类基础数据信息，应至少包括行政区划、基础对象名录等信息； b) 业务数据库：与软件实现的核心功能相关的各类具体业务数据； c) 监测数据库：各类实时采集、动态更新变化的数据信息； d) 空间数据库：实现各类空间要素对象信息的存储； e) 多媒体数据库：各类图像、视频、音频信息的存储。 7.2.3 数据库详细设计 数据库详细设计应包括如下五个阶段： a) 需求分析：调查和分析用户的业务活动和数据的使用情况，掌握所用数据的种类、范围、数量以及围绕这些数据的业务处理需求，分析的结果应采用数据流程图进行图形化的描述； b) 概念设计：建立抽象的概念数据模型，描述各业务对象的信息结构、信息流动情况、信息间的互相制约关系以及信息存储、查询和加工的要求，最终应形成 E-R 图（实体-联系图）； c) 逻辑设计：将 E-R 图转换成具体