backend/iot-server/README.md

# IoT Server

设备侧 MQTT 接入进程。使用 `github.com/mochi-mqtt/server/v2` 内嵌实现 MQTT Broker，监听 `devices/+/up` 与 `devices/+/ack`，按《气体探测器通讯协议》V1.8 校验、解密和解析原始二进制帧；下行命令由受保护的内部 HTTP 接口接收后发布到 `devices/{deviceId}/down`，不依赖 Eclipse Paho 或外部 EMQX/Mosquitto。

YAML 的 `MQTT.Devices` 为每台设备配置独立 Client ID、设备号和凭证，Broker ACL 只允许设备发布自己的 `up/ack` 并订阅自己的 `down`。生产环境必须启用 MQTT TLS，并通过密钥注入覆盖 YAML 开发占位密码；单设备开发配置可用 `HEQI_IOT_MQTT_PASSWORD` 覆盖密码。
-												feat: replace iot adapter with mqtt command pipeline

											
										
										
											2026-08-03 13:18:11 +08:00
+								# IoT Server
-												refactor: embed mochi mqtt broker

											
										
										
											2026-08-03 14:19:28 +08:00
+								设备侧 MQTT 接入进程。使用 `github.com/mochi-mqtt/server/v2` 内嵌实现 MQTT Broker，监听 `devices/+/up` 与 `devices/+/ack`，按《气体探测器通讯协议》V1.8 校验、解密和解析原始二进制帧；下行命令由受保护的内部 HTTP 接口接收后发布到 `devices/{deviceId}/down`，不依赖 Eclipse Paho 或外部 EMQX/Mosquitto。
-												feat: replace iot adapter with mqtt command pipeline

											
										
										
											2026-08-03 13:18:11 +08:00
-												refactor: embed mochi mqtt broker

											
										
										
											2026-08-03 14:19:28 +08:00
+								YAML 的 `MQTT.Devices` 为每台设备配置独立 Client ID、设备号和凭证，Broker ACL 只允许设备发布自己的 `up/ack` 并订阅自己的 `down`。生产环境必须启用 MQTT TLS，并通过密钥注入覆盖 YAML 开发占位密码；单设备开发配置可用 `HEQI_IOT_MQTT_PASSWORD` 覆盖密码。