DB34/T 4322-2022 水利业务移动端门户开发与应用接入规范

ICS01.120

CCSA00

34

安徽省地方标准

DB34/T4322—2022

水利业务移动端门户开发与应用接入规范

Specificationfordevelopmentandapplicationaccessofwaterconservancymobile

terminal

2022-10-26发布2022-11-26实施

安徽省市场监督管理局发布

DB34/T4322—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由安徽省水利厅提出并归口。

本文件起草单位：安徽省（水利部淮河水利委员会）水利科学研究院、讯飞智元信息科技有限公司、

安徽省响洪甸水库管理处。

本文件主要起草人：马顺、刘超、王铭铭、程习华、刘怀利、马浩、王砚海、沈超、贾飞、赵辉、

丁晓磊、方婧、秦平、吴秋明、赵亮、李水兵、孙骁磊、管菁菁、方洋。

I

DB34/T4322—2022

水利业务移动端门户开发与应用接入规范

1范围

本文件规定了水利业务移动端的门户开发、应用接入和安全。

本文件适用于水利业务移动端的门户开发和应用接入。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T25000（所有部分）系统与软件工程系统与软件质量要求和评价（SQuaRE）

GB/T25068（所有部分）信息技术安全技术网络安全

3术语和定义

下列术语和定义适用于本文件。

单点登录singlesignon

在多个应用系统中，用户只需要登录一次即可访问所有相互信任的应用系统。

应用上架applicationadded

一种往应用门户中新增应用软件的操作。

应用下架applicationremoved

一种从应用门户中删除应用软件的操作。

H5应用H5application

基于HTML5标准开发的一种适配手机端的web应用。

4门户开发

基本流程

4.1.1业务需求分析

开发前应开展需求调研，完成业务需求分析和业务流程分析报告。

4.1.2系统架构设计

应根据业务流程与功能需求确定软件设计架构。

1

DB34/T4322—2022

4.1.3界面设计

根据业务特点对主要界面进行布局设计，应体现主要功能菜单布置、色彩搭配、界面层次级别等信

息。

4.1.4功能模块设计

应对主要功能模块进行单项设计，功能模块应具备扩展性。

4.1.5代码编写、测试及集成

应编写软件各功能模块代码，并进行单模块测试和多模块组合测试，最终完成软件各项应用集成。

4.1.6试运行与测评

会同用户开展不少于1个月试运行，并对软件试运行情况以及用户试用意见进行跟踪完善。

试运行结束后，应委托具有相应资质的第三方测评机构按GB/T25000（所有部分）的规定进

行软件测评。

4.1.7发布与上线

经测试合格后可发布、上线。

技术要求

4.2.1开发架构

应基于微服务的架构模式进行设计，前后端应分离，后端业务逻辑采用接口方式进行开发，前端通

过调用统一数据接口展现后台业务数据。

4.2.2接口开发

接口设计

接口设计应满足以下要求：

a)兼容性：在不需要更改软件业务逻辑的前提下可实现数据的共享；

b)独立性：一个接口服务中产生变化，不会导致关联接口服务发生变化；

c)安全性：应实现接口中传送数据的动态和静态加密解密；

d)灵活性和可扩展性：在应用系统有变更的情况下，只需对接口进行配置就可以有效调用数据。

接口标准

接口应统一使用WebService接口标准进行设计，并采用REST风格，服务应能够注册进入企业

服务总线，所有业务操作应全部抽象出REST接口进行开放。接口设计应考虑版本兼容性，保持向下兼

容。

注1：Webservice即web服务，是一种跨编程语言和跨操作系统平台的远程调用技术。

注2：REST即表征性状态转移（RepresentationalStateTransfer），是通过创造一种资源的定义与描述原则，形

成一种标准化规范，从而减少技术人员在开发与沟通时候的成本。

接口数据响应

2

DB34/T4322—2022

应采用统一标准规格的JSON数据进行响应，响应对象为RespData；应提供相应的接口说明、编码说

明文档，每个接口对应一个接口说明表，每个业务模块对应一个响应编码说明表，编码说明表中的0、

1为固定返回值，接口服务说明文档参考附录A。

注：JSON即JavaScript对象简谱（JavaScriptObjectNotation），是一种轻量级的数据交换格式采用完全独立

于编程语言的文本格式来存储和表示数据，易于人阅读和编写，同时也易于机器解析和生成，并有效地提升网

络传输效率。

性能要求

4.3.1响应时间

系统应具有快速响应的特性，用户打开界面和提交事务的平均响应时间应不大于1.5s，用户进行

在线实时查询业务操作的数据处理时间应不大于5秒。

4.3.2吞吐率

软件系统吞吐率应达到不小于10M/s的要求。

4.3.3并发用户数

系统应能够在并发用户数达到600的情况下稳定运行，且不会出现数据丢包。

4.3.4系统稳定性

系统应能保证稳定运行，且应具备故障检测、故障诊断、故障恢复等故障自检功能。在故障发生时

应能保证重要数据不丢失并能将故障模块自动隔离。

4.3.5页面加载与数据传输

页面数据的加载、修改、增加等操作应采用异步的方式操作，数据宜统一采用JSON格式进行传

输。

界面开发要求

4.4.1页面规范

页面布局、页面尺寸比例、主色调色彩、重要行间距等页面布局应合理、规范。

4.4.2文字规范

同一层级的字体、字号、字色搭配应该保持一致。工作（主）界面、组织机构列表、通讯录页面、

应用市场页面及更多页面文字规范要求见表1。

表1文字规范要求

界面/页面文字规范要求

PingFangSC-Regular[15px]#333333：用于标题文字；

PingFangSC-Regular[14px]#333333：用于Icon图标应用文字；

工作（主）界面

PingFangSC-Regular[11px]#A9A9A9：用于Tab页签文字；

PingFangSC-Medium[13px]#FFFFFF：用于搜索提示文字。

PingFangSC-Medium[17px]#333333：用于列表标题文字；

PingFangSC-Medium[18px]#FFFFFF：用于顶部标题文字；

组织机构列表

PingFangSC-Medium[15px]#FFFFFF：用于返回按钮文字；

PingFangSC-Medium[15px]#B1B1B1：用于搜索提示文字。

3

DB34/T4322—2022

表1（续）

界面/页面文字规范要求

PingFangSC-Medium[17px]#333333：用于列表标题文字；

PingFangSC-Medium[18px]#FFFFFF：用于顶部标题文字；

通讯录页面

PingFangSC-Medium[14px]#A9A9A9：用于备注文字；

PingFangSC-Medium[15px]#B1B1B1：用于搜索提示文字。

PingFangSC-Medium[17px]#333333：用于列表标题文字；

PingFangSC-Medium[18px]#FFFFFF：用于顶部标题文字；

应用市场页面PingFangSC-Medium[15px]#FFFFFF：用于返回按钮文字；

PingFangSC-Medium[14px]#808080：用于备注文字；

PingFangSC-Medium[15px]#B1B1B1：用于搜索提示文字。

PingFangSC-Medium[17px]#333333：用于列表标题文字；

PingFangSC-Medium[18px]#FFFFFF：用于顶部标题文字；

更多页面PingFangSC-Medium[15px]#FFFFFF：用于返回按钮文字；