从企业数据到监管平台的可配置上报网关
我们设计了一套上报平台:先把企业源数据映射为标准对象,再转换成各监管平台的报文格式。配置通过九步向导完成,密钥以只读方式挂载,用来替代两套写死在代码里的历史上报服务。
直接回答: 我们用一个上报网关替代了两套写死在代码里的历史服务:企业数据先映射为标准对象,再按配置转成各监管平台的报文;签名、发送、回执、重试和审计都内置在平台里。
概要
受监管安全行业中的工业企业,需要把作业票、人员、实时定位和双重预防等数据上报到政府平台。各平台的字段、签名、加密和回执规则都不一样。实施人员在九步向导里配置新接入,密钥以只读方式挂载在主机上。
问题
过去每接入一家新企业、一个新的企业系统版本或一个新的监管平台版本,都要修改历史服务的代码。业务语义分散在脚本和各种特例里,接入工作依赖开发人员,也很难审计。
约束
- 历史代码只用来识别业务特例,不能决定新平台的架构。
- 实施人员不编辑 SQL、YAML、JSON 或脚本。设计目标是至少 95% 的新接入通过界面配置完成,其余通过稳定的插件接口扩展;这个目标还需要用真实样本验证。
- 部署在客户现场,包括离线现场;镜像架构固定,镜像 ID 可以核验。
- 配置中不保存凭据,只保存逻辑引用。
架构
| 部分 | 实现 |
|---|---|
| 后端 | Java 21、Spring Boot 4.1、MySQL 8,Flyway 迁移 V1 至 V14 |
| 控制台 | Vue 3 + TypeScript 配置界面 |
| 映射 | 两阶段:源字段映射为标准对象,标准对象再映射为目标报文;用封闭表达式树表达,不用脚本语言 |
| 向导 | 九步:范围、数据源、探查、标准映射、目标报文、平台能力、测试、审批、发布 |
| 发送运行时 | 认证、签名与加密;HTTP、TCP、消息三种传输;同步与异步回执;调度、增量、幂等、重试、补报和对账 |
| 密钥 | 以只读方式挂载进容器的文件密钥库 |
关键决策
- 封闭的映射语言。 有边界的表达式树在发布前就能校验和审计,自由脚本做不到,审核人能看清一条映射到底会发出什么。
- 以标准对象作中间层。 数据源和目标平台只在标准对象处相接,所以新增企业系统或监管平台版本时,只改映射的一侧。
- 运维默认安全。 smoke 测试只查健康状态,真实发送必须显式开启;数据库已经迁到更新版本时,回滚脚本拒绝只回退镜像,并提示改用升级前的备份。
证据
- 后端有 78 个测试类和 14 个版本化迁移。首期覆盖四个业务域:作业票、人员、实时定位和双重预防。
- 交付物包括需求基线、审计报告、决策日志、阶段验收清单和部署手册。
边界
95% 配置化是设计目标,尚未在现场验证。监管平台名称、端点和企业数据均不公开。
常见问题
非开发人员能接入新企业吗?
这是设计目标。实施人员通过九步向导完成配置;超出产品能力范围的需求通过插件接口扩展,不修改核心代码。
凭据怎样保护?
配置中只保存凭据的逻辑引用,真实秘密从宿主机只读挂载的目录读取。
能离线部署吗?
支持离线部署:在有网络的机器上构建镜像并导出,到现场加载后按镜像 ID 核验。