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

ICS01.120CCSA0034SpecificationfordevelopmentandapplicationaccessofwaterconservancymobileIDB34/T4322—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省水利厅提出并归口。本文件起草单位：安徽省（水利部淮河水利委员会）水利科学研究院、讯飞智元信息科技有限公司、安徽省响洪甸水库管理处。本文件主要起草人：马顺、刘超、王铭铭、程习华、刘怀利、马浩、王砚海、沈超、贾飞、赵辉、丁晓磊、方婧、秦平、吴秋明、赵亮、李水兵、孙骁磊、管菁菁、方洋。DB34/T4322—20221水利业务移动端门户开发与应用接入规范本文件规定了水利业务移动端的门户开发、应用接入和安全。本文件适用于水利业务移动端的门户开发和应用接入。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T25000（所有部分）系统与软件工程系统与软件质量要求和评价（SQuaRE）GB/T25068（所有部分）信息技术安全技术网络安全3术语和定义下列术语和定义适用于本文件。3.1单点登录singlesignon在多个应用系统中，用户只需要登录一次即可访问所有相互信任的应用系统。3.2应用上架applicationadded一种往应用门户中新增应用软件的操作。3.3应用下架applicationremoved一种从应用门户中删除应用软件的操作。3.4H5应用H5application基于HTML5标准开发的一种适配手机端的web应用。4门户开发4,1基本流程4.1.1业务需求分析开发前应开展需求调研，完成业务需求分析和业务流程分析报告。4.1.2系统架构设计应根据业务流程与功能需求确定软件设计架构。2DB34/T4322—20224.1.3界面设计根据业务特点对主要界面进行布局设计，应体现主要功能菜单布置、色彩搭配、界面层次级别等信4.1.4功能模块设计应对主要功能模块进行单项设计，功能模块应具备扩展性。4.1.5代码编写、测试及集成应编写软件各功能模块代码，并进行单模块测试和多模块组合测试，最终完成软件各项应用集成。4.1.6试运行与测评会同用户开展不少于1个月试运行，并对软件试运行情况以及用户试用意见进行跟踪完善。试运行结束后，应委托具有相应资质的第三方测评机构按GB/T25000（所有部分）的规定进行软件测评。4.1.7发布与上线经测试合格后可发布、上线。4.2技术要求4.2.1开发架构应基于微服务的架构模式进行设计，前后端应分离，后端业务逻辑采用接口方式进行开发，前端通过调用统一数据接口展现后台业务数据。4.2.2接口开发接口设计接口设计应满足以下要求：a)兼容性：在不需要更改软件业务逻辑的前提下可实现数据的共享；b)独立性：一个接口服务中产生变化，不会导致关联接口服务发生变化；c)安全性：应实现接口中传送数据的动态和静态加密解密；d)灵活性和可扩展性：在应用系统有变更的情况下，只需对接口进行配置就可以有效调用数据。接口标准接口应统一使用WebService接口标准进行设计，并采用REST风格，服务应能够注册进入企业服务总线，所有业务操作应全部抽象出REST接口进行开放。接口设计应考虑版本兼容性，保持向下兼容。注2：REST即表征性状态转移（Representational），接口数据响应DB34/T4322—20223应采用统一标准规格的JSON数据进行响应，响应对象为RespData；应提供相应的接口说明、编码说明文档，每个接口对应一个接口说明表，每个业务模块对应一个响应编码说明表，编码说明表中的0、1为固定返回值，接口服务说明文档参考附录A。注：JSON即JavaScript对象简谱（JavaScriptObjectNotation），是一种轻量级的数据交4.3性能要求4.3.1响应时间系统应具有快速响应的特性，用户打开界面和提交事务的平均响应时间应不大于1.5s，用户进行在线实时查询业务操作的数据处理时间应不大于5秒。4.3.2吞吐率软件系统吞吐率应达到不小于10M/s的要求。4.3.3并发用户数系统应能够在并发用户数达到600的情况下稳定运行，且不会出现数据丢包。4.3.4系统稳定性系统应能保证稳定运行，且应具备故障检测、故障诊断、故障恢复等故障自检功能。在故障发生时应能保证重要数据不丢失并能将故障模块自动隔离。4.3.5页面加载与数据传输页面数据的加载、修改、增加等操作应采用异步的方式操作，数据宜统一采用JSON格式进行传输。4,4界面开发要求4.4.1页面规范页面布局、页面尺寸比例、主色调色彩、重要行间距等页面布局应合理、规范。4.4.2文字规范同一层级的字体、字号、字色搭配应该保持一致。工作（主）界面、组织机构列表、通讯录页面、应用市场页面及更多页面文字规范要求见表1。表1文字规范要求PingFangSC-Regular[11px]#A9A9A9：用于TaPingFangSC-Medium[13px]#FFFDB34/T4322—20224PingFangSC-Medium[14px]PingFangSC-Medium[15px]#B1BPingFangSC-Medium[14px]PingFangSC-Medium[15px]#B1BPingFangSC-Medium[14px]PingFangSC-Medium[15px]#B1B4.4.3图标应用图标尺寸大小宜控制在80×80像素以内，分辨率应不低于72dpi；标签栏图标尺寸大小宜控制在46×46像素以内，图标要有选中、未选中两种状态，分辨率应不低于72dpi。4.5资料要求4.5.1开发文档整理应及时整理系统开发实施各阶段的技术文件、图表资料、测试报告、验收报告等，形成完整的开发文档资料，具体开发文档表参见附录B。4.5.2编制开发情况说明表应提取软件设计开发过程中的关键技术指标并形成软件开发情况说明表，具体情况说明表参见附录C。4.5.3操作指南编写应编写操作指南用于指导用户安装使用，明确硬件配置要求以及注意事项等内容。5应用接入支持H5应用和APP应用接入，在接入应用时应在门户后台注册，注册信息应至少包括应用名称、应用说明、标识、入口调用方式等。5.2上架、下架应用可进行上架操作，上架后应用就可以发布到移动门户APP供用户使用。上架后的应用也可以被下架，下架后移动门户APP中用户将无法再使用该应用。DB34/T4322—202255.3权限用户权限应分为按组织、按标签、按用户三个维度，权限控制支持分级管理模式，可按组织架构分级设置管理员，可分级授权。5.4认证与授权5.4.1方式用户接入认证应采用OAuth方式。5.4.2流程用户采用OAuth方式接入后通过usertoken来完成不同移动应用之间的单点登录和用户认证与授权，用户认证与授权流程图见图1。图1移动门户认证与授权流程图网络安全应符合GB/T25068（所有部分）的规定。DB34/T4322—20226接口服务说明文档见表A.1和表A.2。表A.1接口服务基本信息表表A.2接口响应编码说明表023698DB34/T4322—20227表A.2（续）457DB34/T4322—20228水利业务移动端软件开发文档表见表B.1。表B.1水利业务移动端软件开发文档资料参照表123456789DB34/T4322—20229水利业务移动端软件开发情况说明见表C.1。表C.1水利业务移动端软件开发情况说明表 统12345…1234567…DB34/T4322—2022