标准规范下载简介：

内容预览由机器从pdf转换为word，准确率92%以上，供参考

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

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

DB34/T4322—2022

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

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用 该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用 件。 GB/T25000（所有部分）系统与软件工程系统与软件质量要求和评价（SQuaRE） GB/T25068（所有部分）信息技术安全技术网络安全

下列术语和定义适用于本文件。 3.1 单点登录singlesignon 在多个应用系统中GB／T 17005-2019 滨海设施外加电流阴极保护系统通用要求，用户只需要登录一次即可访问所有相互信任的应用系统 3.2 应用上架applicationadded 一种往应用门户中新增应用软件的操作。 3.3 应用下架applicationremoved 一种从应用门户中删除应用软件的操作。 3.4 H5应用H5application 基于HTML5标准开发的一种适配手机端的web应用

4.1.1业务需求分析

4.1.2系统架构设计

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

DB34/T4322 —2022

4.1.4功能模块设计

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

4.1.5代码编写、测试及集成

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

4.1.6试运行与测评

4.1.6.1会同用户开展不少于1个月试运行，并对软件试运行情况以及用户试用意见进行跟踪完善。 4.1.6.2试运行结束后，应委托具有相应资质的第三方测评机构按GB/T25000（所有部分）的规定进 行软件测评。

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

应基于微服务的架构模式进行设计，前后端应分离，后端业务逻辑采用接口方式进行开发，前端通 过调用统一数据接口展现后台业务数据。

4.2.2.1接口设计

接口设计应满足以下要求： a 2 兼容性：在不需要更改软件业务逻辑的前提下可实现数据的共享； b) 1 独立性：一个接口服务中产生变化，不会导致关联接口服务发生变化； C） 2 安全性：应实现接口中传送数据的动态和静态加密解密； d) ）灵活性和可扩展性：在应用系统有变更的情况下，只需对接口进行配置就可以有效调用数据。

4.2.2.2接口标准

接口应统一使用WebService接口标准进行设计，并采用REST风格，服务应能够注册进入企业 服务总线，所有业务操作应全部抽象出REST接口进行开放。接口设计应考虑版本兼容性，保持向下兼 容。 注1：Webservice即web服务，是一种跨编程语言和跨操作系统平台的远程调用技术。 注2：REST即表征性状态转移（RepresentationalStateTransfer），是通过创造一种资源的定义与描述原则，形 成一种标准化规范，从而减少技术人员在开发与沟通时候的成本

接口应统一使用WebService接口标准进行设计，并采用REST风格，服务应能够注册进入企业 服务总线，所有业务操作应全部抽象出REST接口进行开放。接口设计应考虑版本兼容性，保持向下兼 容。 注1：Webservice即web服务，是一种跨编程语言和跨操作系统平台的远程调用技术。 注2：REST即表征性状态转移（RepresentationalStateTransfer），是通过创造一种资源的定义与描述原则， 州 成一种标准化规范，从而减少技术人员在开发与沟通时候的成本

4.2.2.3接口数据响应

应采用统一标准规格的JSON数据进行响应，响应对象为RespData；应提供相应的接口说明、编码说 明文档，每个接口对应一个接口说明表，每个业务模块对应一个响应编码说明表，编码说明表中的0、 为固定返回值，接口服务说明文档参考附录A。 注：JSON即JavaScript对象简谱（JavaScriptObjectNotation），是一种轻量级的数据交换格式采用完全独立 于编程语言的文本格式来存储和表示数据，易于人阅读和编写，同时也易于机器解析和生成，并有效地提升网 络传输效率。

系统应具有快速响应的特性，用户打开界面和提交事务的平均响应时间应不大于1.5s，用户 线实时查询业务操作的数据处理时间应不大于5秒，

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

够在并发用户数达到600的情况下稳定运行，

系统应能保证稳定运行，且应具备故障检测、故障诊断、故障恢复等故障自检功能。在故障发 能保证重要数据不丢失并能将故障模块自动隔离。

4.3.5页面加载与数据传输

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

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

同一层级的字体、字号、字色搭配应该保持一致。工作（主）界面、组织机构列表、通讯录） 用市场页面及更多页面文字规范要求见表1

DB34/T4322 —2022

4.4.3.1应用图标尺寸大小宜控制在80×80像素以内，分辨率应不低于72dpi； 4.4.3.2标签栏图标尺寸大小宜控制在46×46像素以内，图标要有选中、未选中两种状态，分辨率 应不低于72dpi

4.5.1开发文档整理

应及时整理系统开发实施各阶段的技术文件、图表资料、测试报告、验收报告等，形成完整的开 资料，具体开发文档表参见附录B。

4.5.2编制开发情况说明表

应提取软件设计开发过程中的关键技术指标并形成软件开发情况说明表，具体情况说明表参见

4.5.3操作指南编写

指南用于指导用户安装使用，明确硬件配置要求

应用可进行上架操作，上架后应用就可以发布到移动门户APP供用户使用。上架后的应 被下架，下架后移动门户APP中用户将无法再使用该应用。

DB34/T4322—2022

用户接入认证应采用0Auth方式， 注：OAuth方式是一种授权机制，它是在客户端和资源所有者之间的授权层，用来分离两种不同的角色。在资源所有 者同意并向客户端颁发令牌后，客户端携带令牌可以访问资源所有者的资源

用户采用OAuth方式接入后通过usertoken来完成不同移动应用之间的单点登录和用户认证与 授权，用户认证与授权流程图见图1。

图1 移动门户认证与授权流程图

DB34/T4322 —2022

MZ／T 163-2020 地名信息库规范.pdf附录A (资料性） 接口服务说明文档

见表A.1和表A.2。

表A.1接口服务基本信息表

表A.2接口响应编码说明表

DB34/T 4322—2022附录B（资料性）水利业务移动端软件开发文档表见表B.1。表B.1水利业务移动端软件开发文档资料参照表序号文档类型文档名称1需求调研报告需求文档2需求规格说明书3系统总体设计方案4系统详细设计方案5输入、输出设计方案6开发文档接口设计方案7程序模块说明书8数据字典9数据流程图10项目计划书项目管理文档11项目需求变更单12实施详细设计方案13实施文档项目实施计划14质量保证计划15测试方案16测试文档测试用例17测试报告18管理员手册19用户手册用户手册20系统部署手册21日常运维手册22培训手册培训手册23试运行计划及方案24试运行文档试运行总结报告25用户试运行总结报告26项目验收方案27验收文档监理文档28项目实施总结报告

高炉炉体设备安装施工组织设计DB34/T4322—2022

附录C （资料性） 水利业务移动端软件开发情况说明

表C.1水利业务移动端软件开发情况说明表