docs(M00): 接入V5基线与本地MQTT核验

2026-06-16 12:23:00 +08:00
parent b7b88fd13a
commit 289b64de5f
18 changed files with 4974 additions and 14 deletions
@@ -0,0 +1,29 @@
+# 开发日志：2026-06-16 M00 V5 基线核验
+
+## 范围
+
+- 接入 `V5.0.md` 作为当前权威总纲。
+- 恢复 `V4.8.md` 为上一版历史备份。
+- 新增 `docs/current-baseline.md`，按当前仓库事实校准模块完成度。
+- 新增 `docs/local-dev-mqtt.md` 和 `scripts/dev/wsl/check-local-mqtt.sh`，固化 WSL 本地 MQTT 服务级核验。
+
+## 复用/改写/弃用判断
+
+- 复用已有 M00 部署脚本、检查脚本和文档，不重新初始化项目。
+- 正式后端、后台、小程序和数据库迁移仍只有骨架，不把目录存在误判为 DONE。
+- WSL 本地 EMQX 仅作为开发 Broker，不替代生产 `101.42.38.246` 验收。
+
+## 部署影响
+
+有。新增本地 MQTT 核验脚本和文档，不改动生产部署脚本，不安装或重置 EMQX。
+
+## 测试记录
+
+- WSL 本地 MQTT 服务级核验：EMQX 包版本 `5.8.9`，服务 `active/enabled`，MQTTX CLI `/usr/local/bin/mqttx` 版本 `1.13.0`，端口 `1883/8883/8083/8084/18083` 均监听。
+- Git 历史敏感模式扫描已执行，只记录命中提交，不输出秘密值。
+
+## 风险
+
+- MQTT 认证账号、错误密码拒绝、ACL 越权拒绝、TLS、遗嘱消息和重复消息幂等尚未测试。
+- 本地 `admin` 调试账号的具体用途尚未区分 Dashboard 与 MQTT 客户端认证；口令不得写入 Git。
+- WSL 服务级健康不代表生产 Broker 或真实硬件联调完成。