feat: 确认河南三农推送协议,8个接口完整字段

- 新增第0章:设备推送协议(认证+统一入口+塔吊4接口+升降机4接口)
- 架构图更新:数据流改为厂家主动推送
- 推送地址/appid/secret待部署时配置
- API文档结构重排,H5接口和设备接口分开
This commit is contained in:
2026-04-14 12:01:34 +08:00
parent 7b71edf17a
commit 6c8760c6c5
3 changed files with 179 additions and 9 deletions

View File

@@ -69,10 +69,10 @@
### 3.1 设备数据采集
```
已有设备 API自带预警判断
│ (定时轮询: 每 30s 或设备主动推送)
河南三农厂家系统(推送
│ (统一推送接口 POST /input/post/call)
device_adapter (协议解析)
device_adapter (协议解析,统一入口)
monitor (写入 DB)
@@ -86,6 +86,8 @@ SQLite alert_handler
alert_records (预警记录表)
```
> 注:数据为主动推送,无需后台定时轮询。推送频率由厂家控制。
### 3.2 H5 数据请求
```
@@ -131,5 +133,6 @@ MVP 阶段采用轻量部署:
## 6. 待细化
- [x] ~~预警阈值配置~~ → 设备 API 自带预警判断,本系统仅做聚合展示
- [ ] 设备 API 协议细节(塔吊/升降机数据字段)— 厂家文档后续提供
- [x] ~~设备 API 协议细节~~ → 河南三农统一推送接口8个接口已确认
- [ ] 后台 API 公网部署地址(阿里云服务器,部署时配置)
- [ ] 多租户隔离方案(目前 MVP 单租户设计)