mqtt集成初步实现

springboot-init-main/doc/development_stages/stage_2_mqtt_integration.md

@@ -120,13 +120,13 @@
         *   处理 JSON 解析异常、任务未找到等情况。
 7.  **实现任务超时处理 (`TaskTimeoutHandler`)**: 
     *   创建 `src/main/java/com/yupi/project/schedule/TaskTimeoutHandler.java` (或放在 service 包)。
-    *   注入 `RobotTaskService`, 以及可能需要更新状态的 `ChargingRobotService`, `ChargingSessionService`。
+    *   注入 `RobotTaskService`。
     *   添加 `@Component` 和 `@EnableScheduling` (在主启动类或配置类上)。
     *   创建一个方法，使用 `@Scheduled(fixedRate = 60000)` (例如每分钟执行一次)。
     *   在该方法中：
         *   调用 `robotTaskService.findAndMarkTimedOutTasks(timeoutSeconds)` (例如超时设为 120 秒)。
         *   获取超时的任务列表。
-        *   对每个超时任务，根据业务逻辑更新关联的 `charging_robot` (如设为 `offline` 或 `error`) 和 `charging_session` (如设为 `error`) 的状态。
+        *   **注意**: 对每个超时任务，根据业务逻辑更新关联的 `charging_robot` 和 `charging_session` 状态的逻辑，将依赖于第三阶段实现的 `ChargingRobotService` 和 `ChargingSessionService`。本阶段仅标记 `RobotTask` 自身状态。
         *   添加日志记录。
 
 ## 4. 前端 (移动端 App) 开发详解

springboot-init-main/doc/development_stages/stage_3_core_charging_logic.md

@@ -31,6 +31,13 @@
     *   **Entity**: 创建 `ChargingSession.java`。
     *   **Mapper**: 创建 `ChargingSessionMapper.java`。
     *   **Service**: 创建 `ChargingSessionService.java` 接口和实现类。包含创建、更新状态、记录时间/费用、查询用户历史记录等方法。
+        *   **注意**: 实现此 Service 后，需要回顾第二阶段的 `TaskTimeoutHandler.java`，补充当 `RobotTask` 超时后，调用此 Service 更新关联 `ChargingSession` 状态的逻辑。
+    *   **创建 `ChargingController`**: 
+        *   注入 `ChargingService`。
+        *   实现 `POST /api/charging/request` 接口: 调用 `chargingService.requestCharging(...)`。
+        *   实现 `POST /api/charging/stop` 接口: 调用 `chargingService.stopChargingByUser(...)`。
+        *   实现 `GET /api/charging/history` 接口: 调用 `chargingSessionService.getUserHistory(...)`。
+        *   实现 `GET /api/charging/sessions` 接口 (管理员): 调用 `chargingSessionService.getAllSessions(...)`。
 4.  **充电流程实现**: 
     *   **创建 `ChargingService` (核心业务编排)**: 创建接口 `ChargingService.java` 和实现 `ChargingServiceImpl.java`。
         *   注入 `UserService`, `ChargingRobotService`, `ParkingSpotService`, `ChargingSessionService`, `MqttService`, `RobotTaskService`。