T-ZNZ 263-2024 浙江乡村大脑应用场景接入技术规范

CCSA00T/ZNZ浙江省农产品质量安全学会发布IT/ZNZ263—2024本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件浙江省农产品质量安全学会提出并归口。本文件起草单位：浙江省农业农村大数据发展中心、浙江森特信息技术有限公司、浙江省农业科学院农产品质量安全与营养研究所、杭州市萧山区农（林）业技术推广中心、临安区农业农村信息服务中心、象山县农业农村信息中心、德清县农业农村综合服务中心、平湖市数字农业发展中心、衢州市数字乡村建设中心。本文件主要起草人：任璐怡、吴晓柯、王兵、林家琦、王慧智、朱莹、吴家满、黄海龙、钱帅吉、陆林峰、朱伊平、吴飞艳、孙旭璟、管孝锋、孙彩霞、傅潇霞、罗煦钦、陶安安、张东升、邵洁、徐斌、汤朱敏、冯锡禹。1T/ZNZ263—2024浙江乡村大脑应用场景接入技术规范本文件规定了应用场景接入浙江乡村大脑平台的要求。本文件适用于需要接入浙江乡村大脑的各类应用场景。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T2260中华人民共和国行政区划代码GB/T22239信息安全技术网络安全等级保护基本要求GB/T39477信息安全技术政务信息共享数据安全技术要求NY/T4261农业大数据安全管理指南3术语和定义3.1乡村大脑ruralbrain农业农村领域的数字化智能化能力中心，基于一体化智能化公共数据平台，聚焦农业高质高效、乡村宜居宜业、农民富裕富足，运用数字技术，综合集成算力、数据、算法、模型、智能模块等数字资源，搭建11153（即：1仓1图1码5库3能力）核心构架，形成具备数据计算分析、知识集成应用、逻辑推理判断等功能的智能系统，支撑农业农村数字化改革应用，提升农业智能、乡村智治、农民智富能力，助力农业农村现代化、乡村振兴和农民农村共同富裕。3.2应用场景applicationscenarios农业农村各领域的业务应用系统，包括“浙农机”“浙农优品”“浙农经营”等17个应用场景。3.3驾驶舱cockpit作为一个集成的数据管理平台，可以提供数据集成、数据挖掘、数据分析、数据可视化和数据应用等功能，帮助使用者快速有效地收集、分析和可视化数据。4符号和缩略语2T/ZNZ263—2024下列符号和缩略语适用于本文件。HTTPS超文本传输安全协议（HyperTextTransferProtocolSecure）JSONJavaScrip对象标记（JavaScripObjectNotation）5浙江乡村大脑应用平台5.1基本要求各应用场景的界面设计风格一致、统一基础底图、功能区域划分合理。驾驶舱两级页面至少能支持省、市、县（市、区）三级数据贯通，数据应支持从宏观到微观下钻。数据通过地区下钻后，模块间切换应保持在同一地区。涉及地图应用的，地图边界应细分到乡（镇、街道）。5.2整体架构浙江乡村大脑应用平台以“大脑+应用场景”为主体架构，集成“浙农机”“浙农优品”“浙农经营”等“浙农”系列应用场景。浙江乡村大脑应用场景总体架构图见图1。图1浙江乡村大脑应用场景总体架构图5.3功能5.3.1应用组织管理浙江乡村大脑提供可灵活定制的应用全环节管理：a）应用发布：提供应用注册、应用生命周期管理；b）应用接入：可对接认证功能，实现灵活安全的访问鉴权等。5.3.2应用运维监控浙江乡村大脑提供多样的运维管控功能，获取及时详尽的系统状态信息：a）运行监控：提供各应用场景运行状态监控等内容；b）埋点监控：提供各应用场景访问量、活跃用户数等情况。6应用场景接入要求6.1接入安全要求3T/ZNZ263—20246.1.1网络安全浙江乡村大脑在政务云网络环境下运行，应用场景应使用HTTPS协议进行访问并接入。网络安全应符合GB/T22239的规定。6.1.2系统安全应用场景接入浙江乡村大脑应用平台应采用HamcSHA1方法来验证请求的发送者身份。如果计算结果和提供的验证码一致，则该请求有效；如果计算结果和提供的验证码不一致，则数据交换平台将拒绝这次请求，并返回errorCode为“14”，message为“应用APP签名错误”的JSON报文信息，保证数据传输安全。6.1.3数据安全浙江乡村大脑应用场景有关数据安全管理应符合国家有关法律法规要求，在数据的隐私性、保密性、完整性、可用性以及数据权限设置等方面实现整体安全。政务数据应符合GB/T39477的规定。农业大数据应符合NY/T4261的规定。6.2接入条件应用场景接入浙江乡村大脑应用平台，应满足以下条件：a）应用场景网络环境应与浙江乡村大脑网络环境对接联通；b）浙江乡村大脑应用场景应完成系统的联调和测试。6.3接入方式分为script标签静态引入和script标签动态引入两种方式，埋点接入前宜明确接入方式。埋点参数说明见表1。表1参数说明是是针对需要登录的访问来源，ZZD、ZLB、PC、NMXX、ZFB、WX，三项中的其中一项；ZZD（浙政钉）、ZLB（浙里办）、PC（电脑端）、NMXX（农民信箱）、ZFB（支付宝是用户所在地区编码：6位地区编码，按GB/T2260的规定执行针对需要登录的），针对需要登录的所监测应用的类型：YINGY（应用）、ZUJ（组件）、ZHINMK（智能模块）、ZHISTP6.4接入流程6.4.1申请。拟接入浙江乡村大脑的应用场景主管部门，应通过浙江乡村大脑进行应用注册。注册内容应包括但不限于：应用场景名称、应用场景主管部门、联系人、联系方式、IP白名单、回调地址等信息。6.4.2密钥分配。注册成功后，浙江乡村大脑给应用场景生成一个应用接入使用的密钥。4T/ZNZ263—20246.4.3开发。完成应用注册后的应用场景管理部门应严格按照浙江乡村大脑的技术要求进行系统对接开发工作。6.4.4联调验证。应用场景对接开发完成后，通过浙江乡村大脑测试入口进行联调和验证。6.4.5埋点。应用场景对接开发、联调完成，应按照浙江乡村大脑的接入要求进行应用采集埋点，采集内容包括但不限于应用编码、用户编码、用户所在地区、访问来源、应用的类型等。6.4.6技术审核与发布。应用场景联调验证完成后，应用场景管理部门可申请上线，获得浙江乡村大脑主管部门审核批准后上线发布。6.5驾驶舱设计要求6.5.1PC端首页PC端首页设计示例参见附录B中的图B.1，主要分为以下模块：——场景名称。包括“浙农机”“浙农优品”“浙农经营”等17个领域，要求字体为雅黑，位置居——链接服务。“浙江乡村大脑”链接放置于PC端左上角，业务系统后台链接放置于右上角；——子场景设置。综合基层治理的实际需求和浙江的特点，实现数据对比和统计分析。以“浙农机”为例，主要包括研发制造、试验鉴定、购机补贴、生产作业、技术服务和安全监理；——预警信息。采用红黄蓝三色预警，红色（颜色代码：#e71a19）表示严重，黄色（颜色代码：#ebb21a）表示一般，绿色（颜色代码：#1e913f）表示正常；预警颜色见图2：图2红黄绿三色预警——核心指标。针对不同应用场景，实现关键数据可视化。以“浙农机”为例，核心指标包括补贴总额、补贴机具、补贴面积、农机总动力、驾驶员数和农机机械；——地图导航。实现浙江省、市、县（市、区）的海量、实时数据的整合和分析；——热力图。用于显示大量数据的空间分布或趋势，实现数据的可视化。通过颜色的明暗程度来表示不同区域的数据密集程度。较亮的颜色表示高密度，较暗的颜色表示低密度。6.5.2PC端子场景“浙农”系列应用场景页面中左上角的“浙江乡村大脑”链接，宜采用统一的图标标识，设计示例参见附录B中的图B.2。6.5.3手机端手机端“浙农”系列应用场景页面包括子场景导航、子场景、预警信息和核心指标，设计示例参见附录B中的图B.3。5T/ZNZ263—2024（资料性）地区字典地区字典见表A.1。表A.1地区字典1234567896T/ZNZ263—2024表A.1地区字典（续）7T/ZNZ263—2024表A.1地区字典（续）8T/ZNZ2