系统开发
约 1287 字大约 4 分钟
平台管理系统开发Hook扩展字典管理
2026-08-12
系统开发模块面向平台的技术运维与扩展场景,提供业务扩展点(Hook)、基础数据(字典)、外部数据接入(数据源与查询配置)以及定时任务等能力。
Hook 扩展管理
访问路径:平台管理 → 系统开发 → Hook 扩展管理
Hook 扩展用于注册第三方 HTTP 回调服务,让平台业务事件通知外部系统,或在特定业务节点接入外部逻辑。
- 服务列表:展示已注册的回调服务(名称、所属企业、服务端点、鉴权类型、失败策略、状态)
- 新增服务:填写企业归属、名称、服务端点,选择鉴权方式(无鉴权 / HMAC 签名 / 自定义请求头)、失败策略(忽略继续业务 / 阻断拦截业务)、超时秒数与最大重试次数
- 能力管理:为每个服务声明其关注的事件点(能力 = 编码 + 子编码),类型分为同步扩展点(调用方等待返回)与异步事件通知
平台内置的可用 Hook 点参考:区域创建前、WebSocket 订阅权限校验、数据查询过滤、设备绑定前、告警对象树等。

高频事件通知类场景建议选择「忽略继续业务」失败策略并设置较小超时,避免影响主流程。
字典管理
访问路径:平台管理 → 系统开发 → 字典管理
字典管理维护全局数据字典(下拉选项、枚举中文名等),供各业务模块引用。
- 字典列表:按分组(基础 / 系统 / 业务等)查看字典,支持按名称查询;展示字典名称、编码、结构类型(列表 / 树型)、描述与拓展字段
- 新建字典:填写名称、编码、分组、结构类型、描述与拓展字段(定义 Key-Label 结构)
- 字典详情:按结构类型维护字典项;列表型维护字典值,树型支持添加子项、拖拽调整层级
- 导入 / 导出:支持 JSON 格式的字典导入导出,可全部或选中导出

数据源管理
访问路径:平台管理 → 系统开发 → 数据源管理
数据源管理为平台的数据查询能力注册外部数据库连接,支持 MySQL、PostgreSQL、SQLite、TDengine 等:
- 数据源列表:展示数据源标识、名称、数据库类型、连接状态(未检测 / 检测中 / 正常 / 离线)与描述
- 新建数据源:填写标识(创建后不可改)、名称、数据库类型、连接串(密码字段加密存储)与连接数限制
- 连接检测:支持单条检测与全部检测,实时确认数据源连通性
查询配置管理
访问路径:平台管理 → 系统开发 → 查询配置管理
查询配置管理把"表或 SQL"暴露为可被前端按标识调用的通用查询接口,平台看板的趋势图即依赖此机制:
- 查询配置列表:展示标识、名称、数据源、查询类型(直查表 / SQL 模板)、表名或 SQL 预览
- 新建配置:填写标识、名称、选择数据源(来自数据源管理)、查询类型,配置表名或 SQL(支持占位符)、默认查询列、排序、驼峰转换、数据过滤与角色过滤等
- 模拟查询:填写参数执行查询,验证配置正确性后再接入页面
任务管理
访问路径:平台管理 → 系统开发 → 任务管理
任务管理维护平台级定时任务,采用「任务组 → 任务」两级结构:
- 任务组:按业务域分组(编码、名称、状态、描述),支持新增、编辑、删除与查看详情
- 任务组详情:包含任务组信息与任务列表两个页签
- 任务:填写任务编码、名称、类型(周期任务 / 延时任务)、Cron 表达式或执行时间、任务参数、优先级与描述
- 启停控制:按任务状态显示启动 / 停止 / 编辑 / 删除操作

使用建议
- Hook 服务上线前先在小流量业务节点验证,再开放到高频事件
- 字典变更会同步影响引用该字典的业务页面,调整前确认影响范围
- 查询配置接入页面前先用「模拟查询」验证结果
- 任务参数使用 JSON 格式,注意与业务方的约定
关联使用
更新日志
2026/8/12 22:41
查看所有更新日志
eb306-docs(use): 新增平台管理使用说明于
