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

2026-06-22 17:27:24 +08:00
parent c140613718
commit 07790a7924
11 changed files with 113 additions and 28 deletions
@@ -1,5 +1,17 @@
 # 部署变更记录

+## 2026-06-22 / M06-A-mqtt-foundation
+
+- 关联模块：M06-A/IOT-001
+- 关联 commit：`c140613`
+- 变化内容：菜单 3 从只读检查扩展为管理员确认后安装/更新 EMQX；新增正式厂商 Topic ACL；后端接入 MQTT.js 3.1/QoS 1、重连、订阅恢复与健康检查。
+- 配置变化：新增 MQTT Client ID、重连间隔、连接超时和消息大小环境变量；生产必须配置成对的 MQTT 用户名与密码。
+- 数据库变化：无。
+- 兼容性：健康接口只新增检查字段；未配置 MQTT 凭据的开发/测试环境不启动连接，生产环境缺凭据会拒绝启动。
+- 已执行验证：Windows 全量回归、WSL Bash 语法、WSL EMQX 5.8.9 服务级检查通过；认证冒烟因本地账号缺失按预期 SKIP。
+- 回滚方式：回退工程 commit，并恢复旧 ACL 模板；生产若已应用配置，先备份 EMQX 数据和配置后再回滚。
+- 生产环境人工步骤：在 `101.42.38.246` 执行菜单 3，创建 `qipai_backend_prod` 和设备账号，应用 ACL，限制 18083，执行备份和三个 Topic 冒烟。
+
 ## 2026-06-16 / V5.0-status-doc-guard

 - 关联模块：M00-B/SCM-001