EIOT 物联网综合管理平台

轻量化、高性能、响应式的物联网设备综合管理平台

提供从 设备接入 → 数据采集 → 状态监控 → 控制下发 → 设备共享 → 移动端管理 → 规则引擎 → 配网管理 → 网关子设备 → 数据流转 的完整闭环

功能特性

核心能力（对标阿里云飞燕平台 + 云智能App）

产品即物模型 — 一个产品 = 一套物模型 + 一套移动端 UI 模板，属性/事件/服务三要素一体化
飞燕标准兼容 — 完整对接阿里云飞燕 Topic 体系与 Alink JSON 格式
规则引擎/场景联动 — 可视化规则配置，支持属性/事件/定时触发，控制/服务/场景/通知/Webhook 动作
设备影子 — 期望值/上报值同步，离线场景下发指令
设备模拟器/在线调试 — 模拟上报属性/事件、调用服务、MQTT 原始报文查看、调试日志
网关子设备管理 — 网关/子设备拓扑，批量添加/移除，状态同步
配网功能 — BLE/SoftAP/扫码/零配，PIN码生成、二维码生成、配网记录全生命周期
数据流转/SQL分析 — 数据流转规则，支持 SQL/重发布/转发/HTTP 目标类型
多协议网关 — CoAP/HTTP/Modbus 协议接入配置，协议映射转物模型
设备诊断/监控 — 连接性/性能/固件/安全诊断，在线时长/消息量/错误率/延迟统计
严格多租户 — 用户数据完全隔离，仅可通过设备共享机制跨用户授权
全响应式 — Web 管理后台适配桌面 / 平板 / 手机三端
可视化拖拽 — 产品级移动端 UI 通过拖拽方式生成，无需编写前端代码
云原生部署 — Docker Compose 一键拉起，Alpine 基础镜像，秒级启动
跨平台移动端 — Flutter 构建，一套代码支持 Android/iOS

技术栈

层级	技术	说明
后端	Go 1.24 + Gin + GORM	高性能 HTTP 路由 + ORM
数据库	MySQL 8.0	用户/产品/设备等结构化数据
缓存	Redis 7.2	设备在线状态、验证码、限流
MQTT	EMQX 5.7	设备消息接入/下发
鉴权	JWT (HS256) + bcrypt	无状态会话 + 密码哈希
Web 前端	Vue 3 + Vite + Element Plus	响应式管理后台
图表	ECharts 5	温湿度/能耗趋势曲线
移动端	Flutter 3.27 + Provider	跨平台 App
部署	Docker Compose + Nginx	一键容器化部署

架构图

┌──────────────────────────────────────────────────────────┐
│              移动端 App (Flutter)                          │
│      Android/iOS，/mobile 目录                            │
└────────────────────────────┬─────────────────────────────┘
                             │ HTTP REST
┌────────────────────────────▼─────────────────────────────┐
│              前端管理台 (Web)                              │
│   Vue3 + Vite + Element Plus + ECharts，/frontend 目录   │
└────────────────────────────┬─────────────────────────────┘
                             │ RESTful API (:8080)
┌────────────────────────────▼─────────────────────────────┐
│              后端服务 (Go + Gin)                           │
│   Gin 路由 / GORM / JWT，/backend 目录                    │
└──────────────┬─────────────┬─────────────┬───────────────┘
               │             │             │
        ┌──────▼─────┐ ┌─────▼──────┐ ┌────▼─────┐
        │   MySQL     │ │   Redis    │ │  EMQX    │
        │  业务数据   │ │ 缓存/验证码 │ │ MQTT消息 │
        └────────────┘ └────────────┘ └──────────┘

快速开始

环境要求

Docker + Docker Compose
Go 1.24+ （仅构建后端时需要）
Node.js 18+ （仅构建前端时需要）
Flutter 3.27+ （仅构建移动端时需要）

一键部署（Docker）

# 1. 克隆仓库
git clone https://github.com/yyefree/eiot.git
cd eiot

# 2. 构建后端二进制（Linux/amd64）
cd backend
$env:GOOS="linux"; $env:GOARCH="amd64"   # Windows PowerShell
go build -o ../deploy/eiot-server ./cmd/api-server
cd ..

# 3. 构建前端
cd frontend
npm install && npm run build
cd ..

# 4. 启动所有服务
cd deploy
docker compose up -d --build

访问入口

服务	地址	凭证
Web 管理台	http://localhost:8088	`13800000000` / `admin123`
后端 API	http://localhost:8080	同上
EMQX 控制台	http://localhost:18083	`admin` / `public`

演示账号

手机号	密码	角色
`13800000000`	`admin123`	管理员
`13900000001`	`123456`	普通用户

首次启动时后端会自动执行种子数据（5个产品 + 60台设备 + 6个用户 + 1家庭 + 4房间 + 3场景 + 2消息）。

项目结构

eiot/
├── backend/                    # Go 后端
│   ├── api/config.yaml         # 配置文件
│   ├── cmd/api-server/         # 程序入口
│   ├── internal/
│   │   ├── dao/                # 数据访问层
│   │   ├── handler/            # HTTP 请求处理
│   │   ├── logic/              # 业务逻辑
│   │   ├── model/              # 数据模型
│   │   └── svc/                # 服务上下文
│   └── pkg/
│       ├── cache/              # Redis 封装
│       ├── config/             # 配置解析
│       ├── middleware/         # JWT 鉴权
│       ├── mqtt/               # EMQX 客户端
│       ├── tsdb/               # 时序数据库
│       └── util/               # 工具函数
│
├── frontend/                   # Vue3 前端
│   ├── src/
│   │   ├── router/             # 路由配置
│   │   ├── utils/              # Axios 封装
│   │   └── views/              # 页面组件
│   │       ├── Login.vue       # 登录
│   │       ├── Layout.vue      # 响应式布局
│   │       ├── Dashboard.vue   # 看板
│   │       ├── Project.vue     # 项目管理
│   │       ├── Product.vue     # 产品+物模型(事件/服务编辑器+导入导出)
│   │       ├── Device.vue      # 设备列表
│   │       ├── DeviceDetail.vue# 设备详情+控制+调试(事件/服务/影子/历史图表)
│   │       ├── MobileUI.vue    # 拖拽式UI配置
│   │       ├── Share.vue       # 设备共享
│   │       └── Users.vue       # 用户管理
│   └── vite.config.js
│
├── mobile/                     # Flutter 移动端
│   ├── lib/
│   │   ├── api/                # HTTP 客户端
│   │   ├── models/             # 数据模型
│   │   ├── pages/              # 页面
│   │   │   ├── login_page.dart
│   │   │   ├── device_list_page.dart
│   │   │   ├── device_detail_page.dart  # 5标签页: 属性/事件/服务/历史/影子
│   │   │   ├── share_page.dart
│   │   │   └── profile_page.dart
│   │   ├── providers/          # 状态管理
│   │   └── main.dart
│   └── android/                # Android 原生工程
│
├── deploy/                     # Docker 部署
│   ├── docker-compose.yml
│   ├── Dockerfile.backend
│   ├── Dockerfile.frontend
│   ├── nginx.conf
│   └── eiot-server             # 后端二进制
│
├── 功能说明文档.md
├── 物联网综合管理平台需求文档.md
└── README.md

核心功能

设备模型（飞燕三级层级）

项目 (Project) → 产品 (Product) → 设备 (Device)

产品本身就是物模型，包含属性、事件、服务三要素：

{
  "identifier": "temp_01",
  "name": "温度",
  "accessMode": "r",
  "dataType": {
    "type": "float",
    "specs": { "min": -40, "max": 85, "step": 0.1, "unit": "℃" }
  }
}

事件结构

{
  "identifier": "alarm_01",
  "name": "温度报警",
  "type": "warning",
  "description": "温度超过阈值时触发",
  "outputParams": [
    { "identifier": "temp_value", "name": "当前温度", "dataType": "float", "unit": "℃" },
    { "identifier": "threshold", "name": "阈值", "dataType": "float", "unit": "℃" }
  ]
}

服务结构

{
  "identifier": "set_mode",
  "name": "设置模式",
  "description": "设置设备工作模式",
  "callType": "sync",
  "inputParams": [
    { "identifier": "mode", "name": "模式", "dataType": "enum", "unit": "" }
  ],
  "outputParams": [
    { "identifier": "result", "name": "结果", "dataType": "bool", "unit": "" }
  ]
}

MQTT Topic（飞燕标准）

方向	Topic	说明
设备上报属性	`/sys/{ProductKey}/{DeviceName}/prop/post`	设备主动推送数据
云端下发控制	`/sys/{ProductKey}/{DeviceName}/prop/set`	云端控制设备
设备上报事件	`/sys/{ProductKey}/{DeviceName}/event/post`	设备主动上报事件
服务调用	`/sys/{ProductKey}/{DeviceName}/service/{ServiceId}`	云端调用设备服务
服务响应	`/sys/{ProductKey}/{DeviceName}/service/{ServiceId}/reply`	设备返回服务结果
固件版本上报	`/ota/device/inform/{ProductKey}/{DeviceName}`	设备上报版本

API 概览

认证接口

方法	路由	说明
POST	`/api/auth/login`	密码登录
POST	`/api/auth/send-code`	发送验证码
POST	`/api/auth/login-code`	验证码登录
POST	`/api/auth/register`	密码注册
POST	`/api/auth/refresh`	刷新Token
GET	`/api/user/info`	用户信息

管理员接口 (/api/admin/*)

方法	路由	说明
GET/POST	`/api/admin/project`	项目管理
GET/POST	`/api/admin/product`	产品管理
PUT	`/api/admin/product/:id/thing-model`	物模型配置
GET/PUT	`/api/admin/product/:id/mobile-ui`	移动端UI配置
POST	`/api/admin/device/batch`	批量生成设备
GET	`/api/admin/stats`	看板统计
POST/GET	`/api/admin/rule`	规则引擎 CRUD
POST/GET	`/api/admin/device-group`	设备分组管理
POST/GET	`/api/admin/device/:id/tag`	设备标签管理
POST/GET	`/api/admin/gateway`	网关子设备管理
POST/GET	`/api/admin/provisioning`	配网管理
POST/GET	`/api/admin/data-flow`	数据流转规则
POST/GET	`/api/admin/protocol-gateway`	协议网关
POST/GET	`/api/admin/device-diagnostic`	设备诊断

用户接口 (/api/device/*)

方法	路由	说明
POST	`/api/device/bind`	绑定设备
GET	`/api/device`	设备列表
GET	`/api/device/:id`	设备详情
POST	`/api/device/:id/control`	控制下发
POST	`/api/device/:id/event`	上报事件
GET	`/api/device/:id/event`	事件历史
POST	`/api/device/:id/service`	调用服务
GET	`/api/device/:id/service`	服务历史
GET	`/api/device/:id/shadow`	设备影子
PUT	`/api/device/:id/shadow`	设置期望值
GET	`/api/device/data/:sn`	属性历史数据
POST	`/api/device/report`	测试上报属性

完整 API 文档见功能说明文档.md。

移动端 App

Flutter 跨平台移动端，支持：

密码登录 / 验证码登录 / 密码注册 / Token刷新
5标签页导航：首页 / 场景 / 添加设备 / 消息 / 个人中心
设备详情 5标签页：属性 / 事件 / 服务 / 历史 / 影子
场景快捷执行 + 场景详情
设备共享管理
个人中心（修改密码/分享/固件/关于）
物模型完整支持：enum/step/description/required

构建 APK

cd mobile
flutter pub get
flutter build apk --release
# 产物：build/app/outputs/flutter-apk/app-release.apk

响应式设计

断点	场景	布局策略
< 768px	手机竖屏	汉堡菜单 + 卡片列表
768–1200px	平板	侧边栏固定 + 两列栅格
≥ 1200px	桌面	多列布局 + 完整表格

关键设计决策

决策	理由
产品即物模型	简化结构，避免 N+1 关联
JWT 无状态会话	便于横向扩展
多租户数据隔离	用户仅可见自有 + 共享设备
拖拽式 UI 生成	新增设备无需改 App 代码
种子数据幂等	重复启动不报错
Alpine + 静态编译	镜像 < 20MB，秒级启动

开发

后端开发

cd backend
go run ./cmd/api-server

前端开发

cd frontend
npm install
npm run dev    # 启动开发服务器 (热更新)

移动端开发

cd mobile
flutter pub get
flutter run

License

MIT License - 详见 LICENSE

Name		Name	Last commit message	Last commit date
backend		backend
deploy		deploy
frontend		frontend
mobile		mobile
.gitignore		.gitignore
Dockerfile.swagger		Dockerfile.swagger
Dockerfile.test		Dockerfile.test
LICENSE		LICENSE
README.md		README.md
inspect_login.py		inspect_login.py
inspect_ui.py		inspect_ui.py
parse_ui.py		parse_ui.py
test_api.py		test_api.py
test_app.py		test_app.py
test_comprehensive.ps1		test_comprehensive.ps1
test_consistency.py		test_consistency.py
test_new_features.ps1		test_new_features.ps1
test_web.py		test_web.py
test_web_control.py		test_web_control.py
功能说明文档.md		功能说明文档.md
物联网综合管理平台需求文档.md		物联网综合管理平台需求文档.md

Navigation Menu

Repository navigation

About

Repository files navigation

EIOT 物联网综合管理平台

功能特性

核心能力（对标阿里云飞燕平台 + 云智能App）

技术栈

架构图

快速开始

环境要求

一键部署（Docker）

访问入口

演示账号

项目结构

核心功能

设备模型（飞燕三级层级）

事件结构

服务结构

MQTT Topic（飞燕标准）

API 概览

移动端 App

构建 APK

响应式设计

关键设计决策

开发

后端开发

前端开发

移动端开发

License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

EIOT 物联网综合管理平台

功能特性

核心能力（对标阿里云飞燕平台 + 云智能App）

技术栈

架构图

快速开始

环境要求

一键部署（Docker）

访问入口

演示账号

项目结构

核心功能

设备模型（飞燕三级层级）

事件结构

服务结构

MQTT Topic（飞燕标准）

API 概览

移动端 App

构建 APK

响应式设计

关键设计决策

开发

后端开发

前端开发

移动端开发

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages