数据模型与接口映射

fastbee大约 4 分钟

数据模型与接口映射

页面导读

适用场景适合二次开发、问题排查、SQL 升级和接口联调时快速查找业务表、接口和页面关系。

源码位置SQL 位于 `springboot/sql`，当前主版本初始化脚本为 `fastbee-v2.9.0.sql`。

数据库范围包含 MySQL 主库、多数据库适配脚本、TDengine/IoTDB 时序数据和 AI 初始化脚本。

使用方式按业务模块查表名前缀，再反查接口、前端页面和二开注意事项。

一、表名前缀说明

前缀	业务范围	示例
`iot_`	物联网核心业务	产品、设备、物模型、规则、告警、工单、固件
`scene_`	场景模型	场景、变量、设备、标签
`sip_`	GB28181 视频	SIP 配置、设备、通道
`common_`	通用媒体通道	URL 拉流、通道绑定
`media_`	流媒体服务	媒体服务器配置
`notify_`	通知服务	渠道、模板、日志
`ai_`	AI 能力	模型、知识库、对话、协议适配
`report_`	报表中心	报表、规则、记录
`sys_`	系统管理	用户、角色、菜单、字典、配置
`oauth_`	OAuth/SSO	客户端、Token、授权码
`oss_`	文件存储	OSS 配置、文件详情
`qrtz_`	定时任务	Quartz 任务表

二、核心物联网表

业务	主要表	接口前缀	前端入口
产品	`iot_product`、`iot_category`、`iot_product_authorize`、`iot_product_ext_param`	`/iot/product`	`vue3/src/views/iot/product`
物模型	`iot_things_model`、`iot_things_model_tag`、`iot_things_model_template`	`/iot/model`、`/iot/template`	产品详情、物模型页面
设备	`iot_device`、`iot_device_user`、`iot_device_share`、`iot_device_group`	`/iot/device`、`/iot/deviceUser`	`vue3/src/views/iot/device`
日志	`iot_device_log`、`iot_event_log`、`iot_function_log`	`/iot/record`、`/iot/message`	设备详情日志 Tab
OTA	`iot_firmware`、`iot_firmware_task`、`iot_firmware_task_detail`	`/iot/firmware`	`vue3/src/views/iot/firmware`
规则	`iot_rule_el`、`iot_rule_trigger`、`iot_rule_log`	`/iot/ruletrigger`、`/rule/chain`	`vue3/src/views/ruleengine`
桥接	`iot_bridge`、`iot_script_bridge`	`/iot/bridge`	规则、桥接页面
告警	`iot_alert`、`iot_alert_log`、`iot_alert_scene`、`iot_alert_notify_template`	`/iot/alert`	`vue3/src/views/iot/alert`
工单维保	`iot_work_order`、`iot_device_maintenance`	`/iot/workOrder`、`/iot/maintenance`	工单、维保页面
物联网卡	`iot_card`、`iot_card_platform`	卡管理接口	`vue3/src/views/iot/card`

三、设备接入与协议表

业务	主要表	说明
协议管理	`iot_protocol`	平台协议配置和协议脚本
Modbus 配置	`iot_modbus_config`、`iot_modbus_params`、`iot_modbus_job`	设备级寄存器、参数和轮询任务
产品 Modbus	`iot_product_modbus_job`、`iot_product_sub_gateway`	产品级网关、子产品和轮询配置
网关子设备	`iot_sub_gateway`	网关与子设备关系
变量模板	`iot_var_temp`、`iot_var_temp_salve`	变量模板和从机配置
模拟日志	`iot_simulate_log`	模拟设备或调试记录

四、视频与可视化表

业务	主要表	接口前缀
SIP 配置	`sip_config`	`/sip/sipconfig`
SIP 设备	`sip_device`	`/sip/device`
SIP 通道	`sip_device_channel`、`iot_sip_relation`	`/iot/channel`
URL 通道	`common_channel`	`/iot/channel`
媒体服务器	`media_server`	`/mediaserver`
可视化项目	`iot_goview_project`、`iot_goview_project_data`	`/goview/project`、`/goview/projectData`

五、场景、报表、通知表

业务	主要表	接口前缀
场景模型	`scene_model`、`scene_model_data`、`scene_model_device`、`scene_model_tag`	`/scene/model`、`/scene/modelData`
场景标签点位	`scene_tag_points`	场景标签和点位
报表	`report`、`report_records`、`report_rule`、`report_rule_data`	报表相关接口
通知	`notify_channel`、`notify_template`、`notify_log`	`/notify/channel`、`/notify/template`、`/notify/log`

六、AI 表

业务	主要表	接口前缀
模型供应商	`ai_provider`	`/ai/provider`
模型配置	`ai_model`	`/ai/model`
对话	`ai_chat_session`、`ai_chat_message`	`/ai/chat`、`/ai/chatRecord`
知识库	`ai_knowledge_base`、`ai_knowledge_document`、`ai_knowledge_version`	`/ai/knowledge`
调用日志	`ai_invoke_log`、`ai_tool_call_log`	AI 调用审计
文件资源	`ai_file_asset`	知识库文件资产
协议适配	`ai_protocol_adaptation_task`、`ai_protocol_adaptation_artifact`、`ai_protocol_generation_record`	`/ai/protocol/adaptation`

七、系统与插件表

业务	主要表	接口前缀
用户角色	`sys_user`、`sys_role`、`sys_menu`、`sys_dept`	`/system/user`、`/system/role`、`/system/menu`
字典配置	`sys_dict_type`、`sys_dict_data`、翻译表	`/system/dict/*`
登录与操作日志	`sys_logininfor`、`sys_oper_log`	`/monitor/*`
定时任务	`sys_job`、`sys_job_log`、`qrtz_*`	`/monitor/job`
OAuth/SSO	`oauth_client_details`、`oauth_access_token`、`oauth_refresh_token`	`/oauth2/*`、`/iot/clientDetails`
OSS	`oss_config`、`oss_detail`	`/oss/config`、`/oss/detail`
代码生成	`gen_table`、`gen_table_column`	`/tool/gen`

八、升级脚本策略

场景	建议
新部署	使用当前主版本初始化 SQL
版本升级	按版本顺序执行 `upgrade` 脚本
多数据库	使用对应目录下的达梦、人大金仓、Oracle、Postgres、SQL Server 脚本
AI 初始化	确认 AI 表和初始化数据是否已合入主脚本，必要时执行 AI 初始化脚本
时序库	TDengine/IoTDB 使用独立初始化脚本和运行配置
上线前	备份数据库，记录当前版本，先在测试环境演练升级

九、二开注意事项

增加业务字段时，同步修改 Domain、Mapper、VO/DTO、Controller、前端表单和 SQL。
涉及多数据库支持时，不要只改 MySQL 脚本。
高频设备数据不要直接全部写入 MySQL，优先走时序数据链路。
涉及租户隔离时，确认 create_by、机构、角色数据范围和查询条件。
修改物模型、设备、规则等核心表时，要考虑缓存刷新。
删除数据前先确认是否有关联设备、规则、场景、组态、告警、工单和历史数据。

十、关联文档