mqtt对接嵌入式

.workbuddy/memory/2026-06-10.md

@@ -0,0 +1,73 @@
+# 2026-06-10 工作日志
+
+## MQTT 分发重构 & 设备下发业务层
+
+### 9. MqttMessageDispatcher 策略模式重构
+
+**问题**：Dispatcher 硬编码 7 个 Regex Pattern 的 if-else 链，新增 Topic 必须改 Dispatcher 类。
+
+**方案**：
+- 创建 `MqttTopicHandler` 接口（`topicPattern()` + `handle(deviceNo, payload)`）
+- 每个 Handler 实现该接口并声明自己的 Topic 正则
+- `MqttMessageDispatcher` 改为注入 `List<MqttTopicHandler>`，启动时自动收集，循环匹配
+- 新增 Topic：只需新增 Handler Bean，Dispatcher 零改动
+
+**修复的 Bug**：
+- `DeviceCommandAckHandler` 原来是空壳（只打日志），现在委托到 `IDeviceCommandAckHandler` → `MqttCommandAckService`
+- `DeviceStatusHandler` 原来存在但 Dispatcher 从未路由到它（缺少 PATTERN），现已补全
+- 新增 `ScheduleFinishHandler`、`KeyFinishHandler`、`DeviceCommandReceiptHandler` 替代原来只打日志的空处理
+
+**文件变更**：
+| 文件 | 变更 |
+|---|---|
+| `app/mqtt/MqttTopicHandler.java` | **新增** 策略接口 |
+| `app/mqtt/MqttMessageDispatcher.java` | **重写** 策略模式 |
+| `app/handler/DeviceDataHandler.java` | 实现 MqttTopicHandler |
+| `app/handler/DeviceRegisterHandler.java` | 实现 MqttTopicHandler |
+| `app/handler/DeviceStatusHandler.java` | 实现 MqttTopicHandler（新增 /status Topic） |
+| `app/handler/ErromesHandler.java` | 实现 MqttTopicHandler |
+| `app/handler/DeviceCommandAckHandler.java` | 实现 MqttTopicHandler + 委托 IDeviceCommandAckHandler |
+| `app/handler/ScheduleFinishHandler.java` | **新增** |
+| `app/handler/KeyFinishHandler.java` | **新增** |
+| `app/handler/DeviceCommandReceiptHandler.java` | **新增** |
+
+### 10. 新增设备下发业务层 DeviceCommandService
+
+**问题**：`AppDeviceServiceImpl.switchDevice()` 直接拼装 `DeviceCommand` 并调用底层 `IDeviceCommandPublisher`，缺少统一的下发入口。
+
+**方案**：
+- 创建 `IDeviceCommandService` 接口
+- `DeviceCommandServiceImpl` 封装命令构造、设备校验、下发生效、浇水日志
+- 提供类型化方法：`sendSwitchCommand()`、`sendCustomCommand()`、`sendCommand()`
+- `AppDeviceServiceImpl.switchDevice()` 改为调用 `deviceCommandService.sendSwitchCommand()`
+
+**文件变更**：
+| 文件 | 变更 |
+|---|---|
+| `app/service/IDeviceCommandService.java` | **新增** 接口 |
+| `app/service/impl/DeviceCommandServiceImpl.java` | **新增** 实现 |
+| `app/service/impl/AppDeviceServiceImpl.java` | 重构 switchDevice，注入 IDeviceCommandService，移除废弃的私有方法 |
+
+### 11. 修复循环依赖根因
+
+`MqttCommandAckService.mqttClientManager` 字段保留 `final` 导致 Lombok `@RequiredArgsConstructor` 仍将其放入构造器，`@Lazy` 注解在字段上不生效。已去掉 `final`，确保字段注入 + @Lazy 代理正确工作。
+
+### 12. 删除冗余 /publish/status Topic
+
+设备上传电量数据本身就证明在线，单独的 `/publish/status` Topic 没必要。删除 `DeviceStatusHandler` 和 `AppMqttDeviceStatusProperties`。策略模式下 Dispatcher 自动感知，零改动。
+
+### 13. 修复两处循环依赖（构造器注入导致）
+
+**大循环**（6个Bean）：
+```
+DeviceMqttCommandPublisher → MqttClientManager → MqttMessageDispatcher
+  → DeviceRegisterHandler → AppDeviceServiceImpl → DeviceCommandServiceImpl
+  → DeviceMqttCommandPublisher（闭合）
+```
+修复：`DeviceCommandServiceImpl.commandPublisher` 去掉 `final`，改为 `@Lazy @Autowired` 字段注入。
+
+**双向循环**（2个Bean）：
+```
+AppDeviceServiceImpl ↔ DeviceCommandServiceImpl
+```
+修复：`AppDeviceServiceImpl.deviceCommandService` 去掉 `final`，改为 `@Lazy @Autowired` 字段注入。