2995840376 10344e0b05 feat(D): Android 端消费物模型语义, 开关通道以物模型为唯一权威
ControlSchema.ControlItem:
- 新增 semantic / grp / isPrimary / enumLabels 字段
- 拆分隐式 key() 为显式 dpKey()(涂鸦 publishDps 用数字dpId) 与
  codeKey()(平台无关稳定标识, 场景规则/Mesh/云端用)
  原实现两条链路口径不一致(一处dpId一处code), 极易用错

DeviceControlActivity:
- 4 处 it.key() -> it.dpKey()(publishDps 路径)
- 主开关选择新增物模型兜底: 后端 mainSwitchCode -> is_primary -> semantic=power
  (语义由后端 SpecSemanticResolver 落库, 取代客户端按名称猜测)

新增 SpecSwitchResolver:
- 物模型驱动的开关通道解析器
- 通道来源 = control-schema 中 grp=switch 的功能点(即物模型 switch 组)
- 物模型不可用(设备无产品/未同步/网络失败)返回 null -> 调用方回退本地打分
- 保证离线与新设备场景不降级

DeviceRowAdapter:
- 新增物模型通道缓存(setSpecChannels), 回填后按设备局部刷新(不整表重绘)
- 统一内部 SwChannel 视图, 屏蔽物模型/本地打分两种来源差异
- 通道解析优先级: 后端物模型 > 本地打分兜底

DevicesFragment:
- 首次加载后异步拉取各设备 control-schema, 解析开关通道回填 adapter
- 通道属静态数据, 只拉一次, 避免每次刷新发 N 个请求

SceneDetailActivity:
- 规则下发的动作 key 改用 codeKey(), 并注释说明与 publishDps 的区别

验证: javac 编译 ControlSchema + SpecSwitchResolver 通过(两者不依赖 Android SDK);
其余改动为结构性替换, 待 Android Studio 编译验证
2026-10-27 13:23:24 +08:00

物联网系统平台

项目简介

企业级物联网系统平台,支持万级设备接入,兼容涂鸦、小度、小米等第三方平台,预留Matter协议扩展接口。

技术栈

后端

  • Java 17
  • Spring Boot 3.2.x
  • Spring Security (认证鉴权)
  • MyBatis Plus (持久层)
  • MySQL 8.0 (关系数据库)
  • InfluxDB 2.x (时序数据库)
  • Redis 7.x (缓存)
  • RabbitMQ (消息队列)
  • EMQX (MQTT Broker)
  • XXL-Job (任务调度)

前端

  • Vue 3 + TypeScript
  • Vite 5.x
  • Element Plus (UI组件库)
  • Pinia (状态管理)
  • Axios (HTTP客户端)
  • ECharts (数据可视化)
  • UniApp (移动端)

项目结构

iotsaas/
├── backend/                 # 后端项目
│   ├── iot-common/         # 公共模块
│   ├── iot-auth/           # 认证服务
│   ├── iot-gateway/        # API网关
│   ├── iot-device/         # 设备管理服务
│   ├── iot-data/           # 数据采集服务
│   ├── iot-rule/           # 规则引擎服务
│   ├── iot-alarm/          # 告警服务
│   └── iot-adapter/        # 设备适配器模块
│       ├── tuya/          # 涂鸦适配器
│       ├── dueros/        # 小度适配器
│       ├── miot/          # 小米适配器
│       └── matter/        # Matter适配器
├── frontend/               # 前端项目
│   ├── admin/             # Web管理后台
│   └── mobile/            # 移动端APP
├── docs/                  # 文档
├── docker/                # Docker配置
├── scripts/               # 脚本工具
└── deploy/                # 部署配置

快速开始

环境要求

  • JDK 17+
  • Node.js 18+
  • MySQL 8.0+
  • Redis 7.x
  • Docker & Docker Compose

后端启动

cd backend
mvn clean install
mvn spring-boot:run

前端启动

cd frontend/admin
npm install
npm run dev

Docker一键启动

docker-compose up -d

核心功能

  • 设备管理与监控
  • 实时数据采集
  • 规则引擎与联动
  • 告警服务
  • 多平台设备适配
  • 数据可视化看板
  • 用户权限管理

开发文档

详细开发文档请参考 docs/ 目录。

许可证

Copyright © 2026 IoT Platform

Description
No description provided
Readme 27 MiB
Languages
Java 75.4%
Vue 18.9%
TypeScript 4.3%
Batchfile 0.9%
JavaScript 0.3%
Other 0.1%