开发文档

开发扩展路径

1. 做模块级改造前，先阅读 后端架构、前端架构 和 数据与数据库架构。
2. 后端接口和业务模块定位先看 后端模块映射，表结构和接口关系看 数据模型与接口映射。
3. Vue3 页面、接口和联调开发先看 Vue3 前端开发与联调。
4. 设备协议扩展先看 协议管理、平台主题 和 Modbus 开发。
5. 规则和消息处理先看 规则引擎、规则视图 和 脚本说明。
6. AI 能力扩展阅读 AI 二次开发，组态和大屏组件扩展阅读 可视化与组态二开。
7. 固件升级、设备配对、网关采集等能力分别查看 OTA、设备配对和网关文档。

常见任务入口

后端模块映射按业务功能定位 Controller、模块职责、接口前缀和源码目录。数据模型映射按表名前缀、接口和前端入口理解业务数据关系。Vue3 前端开发本地开发、OpenAPI、Mock、requestId、E2E 和联调门禁。扩展设备协议查看协议管理模块、解码编码和协议集合。查看架构设计先理解前后端、数据、部署和性能边界，再做二次开发。开发规则脚本理解规则引擎上下文、脚本对象和消息转发。AI 二次开发模型供应商、知识库、协议适配、NL2SQL 和源码知识库扩展。可视化二开拖拽编辑器、组态组件、变量绑定、事件和素材维护。代码生成器数据表导入、字段配置、预览、生成、菜单权限和联调检查。开发 OTA 能力设备升级流程、固件类型和升级主题。开发网关采集查看网关、子设备和采集链路设计。查看数据库说明表结构、数据流转和二开关注点。查看 Topic 说明设备主题、平台主题和消息流转约定。