第三阶段核心业务开发完成

This commit is contained in:
2025-05-18 15:58:16 +08:00
parent 53f7fee73a
commit bab3f719e2
120 changed files with 4114 additions and 387 deletions

View File

@@ -126,6 +126,44 @@
* 对于超时的任务,更新其状态为 `TIMED_OUT`,记录错误信息。
* 根据业务需要,可能需要同步更新关联的 `charging_robot``charging_session` 的状态。
### 阶段 3: 管理端核心功能完善 与 前后端数据对接 (进行中)
**目标**: 搭建核心管理页面框架,并将部分用户端和管理端页面与真实后端数据对接。
**进行中 / 即将进行:**
1. **用户仪表盘 (`/dashboard`) 数据对接 (规划中)**
* **目的**: 将用户仪表盘的模拟数据替换为真实的后端数据,包括"当前充电状态"和"用户统计数据"(本月充电次数、本月总消费)。
* **后端接口需求**:
* `GET /api/session/my/active`: 获取用户当前激活的充电会话。若无激活会话,返回 null 或明确的空状态。
* **Controller**: `ChargingSessionController`
* **Service**: 查询用户状态为进行中(如 `CHARGING_IN_PROGRESS`)的会话。
* `GET /api/user/stats/mine`: 获取当前登录用户的统计数据。
* **响应示例**: `{ "monthlyCharges": 15, "monthlySpending": 250.75 }`
* **Controller**: `UserController` 或新的 `UserStatsController`
* **Service**: 计算用户本月已完成/已支付的充电次数和总消费。
* **前端修改 (`dashboard/page.tsx`)**:
* 移除相关模拟数据加载逻辑。
* 定义与后端响应匹配的数据接口。
* 使用 `axios` (api 实例) 并行调用上述两个接口。
* 根据真实数据更新UI组件的显示。
* 处理API错误和加载状态。
* **状态**: 等待后端接口实现。
2. **"我的充电记录" (`/my-sessions`) 页面数据对接 (已完成)**
* 前端已修改为调用 `POST /api/session/my/list/page` 接口。
* 后端 `ChargingSessionController``ChargingSessionVO` 已确认基本满足需求。
* **状态**: 已完成,等待用户测试确认。
3. **管理员仪表盘 (`/admin/dashboard`) 框架 (已完成)**
* 包含系统概览统计卡片(模拟数据)和管理模块导航卡片。
* **状态**: 初步完成,后续需对接真实统计数据和启用所有导航链接。
4. **机器人管理页面 (`/admin/robots`) 框架 (已完成)**
* 包含列表展示、搜索、筛选、分页(模拟数据)。
* 模拟的添加、编辑、删除按钮。
* **状态**: 初步完成后续需对接真实数据和实现CRUD操作。
## 4. 数据库 Schema (初步 DDL)
```sql
@@ -228,6 +266,6 @@ CREATE TABLE `activation_code` (
* 用于指令 (`robot/command/{clientId}`) 和状态 (`robot/status/{clientId}`) Topic 的用户名和密码。
* 与硬件团队确认最终的 MQTT Topic 和 Payload 结构。
2. **开始开发**: 在获取 MQTT 信息后,可以并行开始:
* **阶段一**: 数据库初始化、用户模块开发、**`robot_task` 相关基础 Service 开发**
* **阶段二**: MQTT 配置、基础连接、订阅实现、**集成 `robot_task` 检查与更新逻辑**、**任务超时处理实现**
* **阶段一**: 数据库初始化、用户模块开发、`robot_task` 相关基础 Service 开发。
* **阶段二**: MQTT 配置、基础连接、订阅实现、集成 `robot_task` 检查与更新逻辑任务超时处理实现。
3. 按照开发阶段逐步推进。