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

docs/configuration.md

@@ -61,6 +61,15 @@ MYSQL_DATABASE=<以项目实际数据库名为准>
 
 检测结果只能使用 `PASS/WARN/FAIL`，不得回显密码。只有五项全部通过，数据库环境才可标记 `DONE`。
 
+## MQTT 后端连接
+
+- 生产变量：`QIPAI_MQTT_URL`、`QIPAI_MQTT_CLIENT_ID`、`QIPAI_MQTT_USERNAME`、`QIPAI_MQTT_PASSWORD`。
+- 调优变量：`QIPAI_MQTT_RECONNECT_MS=3000`、`QIPAI_MQTT_CONNECT_TIMEOUT_MS=10000`、`QIPAI_MQTT_MAX_MESSAGE_BYTES=65536`。
+- 生产账号固定建议为 `qipai_backend_prod`；真实密码只写 `/etc/qipai/qipai.secrets`，不得进入 Git、日志或错误响应。
+- 用户名和密码必须同时配置；生产环境缺任一项时后端拒绝启动。
+- 后端使用 MQTT 3.1（`protocolVersion: 3`）和 QoS 1，订阅 `/devicesend/+`、`/devicewill/+`，发布 `/deviceaccept/{DeviceID}`。
+- `/app-api/ready`、`/admin-api/ready` 返回 `mqttConfigured`、`mqttConnected`、`mqttSubscriptionsReady`，只有真实连接并恢复订阅后后两项才为真。
+
 ## 微信支付 v3
 
 - 运行变量：`QIPAI_WECHAT_PAY_CREDENTIALS`。