ICS 01.120 CCS A 00 34 安徽省 地方 标准 DB34/T 4322—2022 水利业务移动端门户开发与应用接入规范 Specification for development and application access of water conservancy mobile terminal 2022 - 10 - 26发布 2022 - 11 - 26实施 安徽省市场监督管理局 发布 DB34/T 4322 —2022 I 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由安徽省水利厅提出并归口。 本文件起草单位： 安徽省 （水利部淮河水利委员会） 水利科学研究院、 讯飞智元信息科技有限公司 、 安徽省响洪甸水库管理处 。 本文件主要起草人： 马顺、刘超、王铭铭、程习华、刘怀利、马浩、王砚海、沈超、贾飞、赵辉、 丁晓磊、方婧、秦平、吴秋明、赵亮、李水兵、孙骁磊、管菁菁、方洋。 DB34/T 4322 —2022 1 水利业务移动端门户开发与应用接入规范 1 范围 本文件规定了水利业务移动端 的门户开发、应用接入和安全。 本文件适用于 水利业务移动端的门户开发和 应用接入。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 25000 （所有部分） 系统与软件工程 系统与软件质量要求和评价（ SQuaRE） GB/T 25068 （所有部分） 信息技术 安全技术 网络安全 3 术语和定义 下列术语和定义适用于本文件。 单点登录 single sign on 在多个应用系统中，用户只需要登录一次 即可访问所有相互信任的应用系统。 应用上架 application added 一种往应用门户中新增应用软件的操作 。 应用下架 application removed 一种从应用门户中 删除应用软件的操作 。 H5应用 H5 application 基于HTML5标准开发的一种适配手机端的 web应用。 4 门户开发 基本流程 4.1.1 业务需求分析 开发前应开展需求调研，完成业务需求分析和业务流程分析报告 。 4.1.2 系统架构设计 应根据业务流程与功能需求确定软件设计架构。 DB34/T 4322 —2022 2 4.1.3 界面设计 根据业务特点对主要界面进行布局设计，应体现主要功能菜单布置、色彩搭配、界面层次级别等信 息。 4.1.4 功能模块设计 应对主要功能模块进行单项设计， 功能模块应具备扩展性 。 4.1.5 代码编写、测试及集成 应编写软件各功能模 块代码，并 进行单模块测试和多模块组合测试，最终完成软件各项应用 集成。 4.1.6 试运行与测评 4.1.6.1 会同用户开展不少于 1个月试运行 ，并对软件试运行情况以及用户试用意见进行跟踪 完善。 4.1.6.2 试运行结束后， 应委托具有相应资质的第三方测评机构 按 GB/T 25000 （所有部分 ）的规定进 行软件测评。 4.1.7 发布与上线 经测试合格后可发布、上线。 技术要求 4.2.1 开发架构 应基于微服务的架构模式进行设计，前后端应分离，后端业务逻辑采用接口方式进行开发，前端通 过调用统一数据接口展现后台业务 数据。 4.2.2 接口开发 4.2.2.1 接口设计 接口设计应满足以下要求： a) 兼容性：在不需要更改软件业务逻辑的前提下可实现数据的共享； b) 独立性：一个接口服务中产生变化，不会导致关联接口服务发生变化； c) 安全性：应实现接口中传送数据的动态和静态加密解密； d) 灵活性和可扩展性： 在应用系统有变更的情况下， 只需对接口进行配置就可以有效调用数据。 4.2.2.2 接口标准 接口应统一使用 WebService 接口标准进行设计，并采用 REST 风格，服务应能够注册进入企业 服务总线，所有业务操 作应全部抽象出 REST 接口进行开放。接口设计应考虑版本兼容性，保持向下兼 容。 注1：Webservice 即web服务，是一种跨编程语言和跨操作系统平台的远程调用技术。 注2：REST即表征性状态转移（ Representational State Transfer），是通过创造一种资源的定义与描述原则，形 成一种标准化规范，从而减少技术人员在开发与沟通时候的成本。 4.2.2.3 接口数据响应 DB34/T 4322 —2022 3 应采用统一标准规格的 JSON数据进行响应，响应对象为 RespData ；应提供相应的接口说明、编码说 明文档，每 个接口对应一个接口说明表，每个业务模块对应一个响应编码说明表，编码说明表中的 0、 1为固定返回值 ，接口服务说明文档参考附录 A。 注： JSON即JavaScript 对象简谱 （JavaScript Object Notation ），是一种轻量级的数据交换格式采用完全独立 于编程语言的文本格式来存储和表示数据，易 于人阅读和编写，同时也易于机器解析和生成，并有效地提升网 络传输效率。 性能要求 4.3.1 响应时间 系统应具有快速响应的特性，用户打开界面和提交事务的平均响应时间应不大于 1.5 s，用户进行 在线实时查询业务操作的数据处理时间应 不大于5秒。 4.3.2 吞吐率 软件系统吞吐率应 达到不小于 10 M/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 ：用于搜索提示文字 。 DB34/T 4322 —2022 4 表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 ：用于返回按钮文字 ； PingFangSC -Medium[14px]#808080 ：用于备注文字 ； PingFangSC -Medium[15px]#B1B