114 lines
3.2 KiB
Markdown
114 lines
3.2 KiB
Markdown
# 任务006：充电记录与设备日志
|
||
|
||
## 目标
|
||
|
||
实现充电记录查询/导出、设备日志查看、异步导出下载中心。
|
||
|
||
## 后端API
|
||
|
||
### 充电记录
|
||
```
|
||
GET /api/charge-records # 充电记录列表
|
||
?cabinet_id=xxx&cabin_board_id=xxx&compartment_id=xxx
|
||
&start_time=xxx&end_time=xxx&page=1&page_size=20
|
||
|
||
GET /api/charge-records/export # 导出充电记录（异步）
|
||
?cabinet_id=xxx&start_time=xxx&end_time=xxx
|
||
```
|
||
|
||
### 设备日志
|
||
```
|
||
GET /api/device-logs # 设备日志列表
|
||
?cabinet_id=xxx&log_type=xxx
|
||
&start_time=xxx&end_time=xxx&page=1&page_size=20
|
||
```
|
||
|
||
### 下载中心
|
||
```
|
||
GET /api/downloads # 下载任务列表
|
||
GET /api/downloads/:id # 获取下载链接
|
||
POST /api/downloads/cleanup # 清理过期文件
|
||
```
|
||
|
||
## 异步导出流程
|
||
|
||
```
|
||
1. 用户点击"导出" → POST /api/charge-records/export
|
||
2. 后端创建下载任务，返回任务ID
|
||
3. 后台异步生成Excel文件
|
||
4. 用户到"下载中心"查看进度
|
||
5. 完成后点击下载
|
||
```
|
||
|
||
### 下载任务表
|
||
```sql
|
||
CREATE TABLE download_tasks (
|
||
id BIGINT AUTO_INCREMENT PRIMARY KEY,
|
||
user_id BIGINT NOT NULL,
|
||
task_type VARCHAR(50) NOT NULL COMMENT 'charge_records/energy_stats',
|
||
status TINYINT DEFAULT 0 COMMENT '0排队 1处理中 2完成 3失败',
|
||
file_path VARCHAR(500) COMMENT '文件路径',
|
||
file_name VARCHAR(200) COMMENT '文件名',
|
||
progress INT DEFAULT 0 COMMENT '进度百分比',
|
||
error_message TEXT,
|
||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||
completed_at TIMESTAMP,
|
||
FOREIGN KEY (user_id) REFERENCES users(id)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
|
||
```
|
||
|
||
### 文件名智能生成
|
||
```
|
||
充电记录_项目A_20260701-20260731.xlsx
|
||
能耗统计_组织B_2026年7月.xlsx
|
||
设备日志_柜子10-00000001_20260701.xlsx
|
||
```
|
||
|
||
## 前端页面
|
||
|
||
### 充电记录页
|
||
|
||
**顶部过滤：**
|
||
- 柜子下拉（可选）
|
||
- 仓板下拉（可选，依赖柜子）
|
||
- 通道下拉（可选，依赖仓板）
|
||
- 时间范围选择器
|
||
- 查询按钮 + 导出按钮
|
||
|
||
**列表显示：**
|
||
| 柜子ID | 仓板 | 通道 | 开始时间 | 结束时间 | 充电量 | 最高温度 | 状态 |
|
||
|--------|------|------|----------|----------|--------|----------|------|
|
||
|
||
**分页：** 每页20条
|
||
|
||
### 设备日志页
|
||
|
||
**顶部过滤：**
|
||
- 柜子下拉
|
||
- 日志类型（状态上报/故障/告警/停电）
|
||
- 时间范围
|
||
|
||
**列表显示：**
|
||
| 柜子ID | 类型 | 内容摘要 | 时间 |
|
||
|--------|------|----------|------|
|
||
|
||
### 下载中心
|
||
|
||
**位置：** 充电记录页/能耗管理页的"导出"按钮旁
|
||
|
||
**弹窗显示：**
|
||
| 任务名称 | 状态 | 进度 | 操作 |
|
||
|----------|------|------|------|
|
||
| 充电记录_项目A... | 处理中 | 65% | 等待... |
|
||
| 能耗统计_组织B... | 完成 | 100% | [下载] |
|
||
|
||
## 质量约束
|
||
|
||
1. 完成代码后执行 `cargo check` + `tsc --noEmit`，零报错零警告
|
||
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
||
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
||
4. 分支逻辑全覆盖，不遗漏兜底分支
|
||
5. 常量抽离，不使用废弃API
|
||
6. Rust内存安全，React函数组件+Hooks
|
||
7. 导出任务异步执行，不阻塞请求
|