docs(M06-A): 记录MQTT基础验收并推进设备资产

This commit is contained in:
Codex
2026-06-22 17:27:24 +08:00
parent c140613718
commit 07790a7924
11 changed files with 113 additions and 28 deletions
+9 -7
View File
@@ -1,17 +1,19 @@
# MQTT 协议映射
当前尚未完成厂商协议深度录入。M00 仅提供 EMQX ACL 安全基线,后续 M06 必须以正式协议文档为准,记录 Topic、命令字段、回包、超时重试和审计要求
M06-A 已按正式协议固定 MQTT Topic、QoS 和客户端权限;具体命令字段、回包、超时重试在 M06-C/D/E 继续录入
| 设备 | Topic/命令 | 方向 | 字段 | 状态 |
|---|---|---|---|---|
| 4G 智能门禁控电箱 | 待补充 | 双向 | 待补充 | TODO |
| Sub-1G 智能门锁 | 待补充 | 双向 | 待补充 | TODO |
| 4G 智慧插座 | 待补充 | 双向 | 待补充 | TODO |
| 4G 智能门禁控电箱 | `/devicesend/{DeviceID}``/devicewill/{DeviceID}``/deviceaccept/{DeviceID}` | 双向 | M06-C/D 补命令字段 | PARTIAL |
| Sub-1G 智能门锁 | 经父控制箱使用相同三个 Topic | 双向 | M06-C/D 补 `subID/subtype` 与命令字段 | PARTIAL |
| 4G 智慧插座 | `/devicesend/{DeviceID}``/devicewill/{DeviceID}``/deviceaccept/{DeviceID}` | 双向 | M06-C/E 补命令字段 | PARTIAL |
## M00 ACL 基线
## M06-A ACL 基线
| 客户端 | 允许发布 | 允许订阅 | 状态 |
|---|---|---|---|
| 设备客户端 `qipai-device-*` | `qipai/${clientid}/telemetry``qipai/${clientid}/status``qipai/${clientid}/event/#` | `qipai/${clientid}/command/#` | 模板已生成,M06 精化 |
| 后端服务 `qipai_backend` | `qipai/+/command/#` 等业务命令与事件主题 | 设备遥测、状态和事件主题 | 模板已生成,M06 精化 |
| 设备客户端 `qipai-device-{DeviceID}`,用户名等于 DeviceID | `/devicesend/{DeviceID}``/devicewill/{DeviceID}` | `/deviceaccept/{DeviceID}` | 模板已固定,生产未应用 |
| 后端服务 `qipai_backend_prod` | `/deviceaccept/+` | `/devicesend/+``/devicewill/+` | 模板已固定,生产未应用 |
| 普通客户端 | 禁止 `$SYS/#``#``+/#` | 禁止未显式允许主题 | 模板已生成 |
后端 MQTT.js 固定使用 MQTT 3.1`protocolVersion: 3`)、QoS 1、持久会话、自动重连,并在每次连接成功后显式恢复两个上行订阅。单条应用消息默认限制为 64 KiB。