82 lines
2.2 KiB
Markdown
82 lines
2.2 KiB
Markdown
# 任务007：能耗管理
|
||
|
||
## 目标
|
||
|
||
实现电表数据统计，柜子/项目维度的能耗分析，趋势图表。
|
||
|
||
## 后端API
|
||
|
||
```
|
||
GET /api/energy-stats/summary # 总览（今日/本月总能耗、电费估算）
|
||
GET /api/energy-stats/cabinets # 柜子能耗排行
|
||
GET /api/energy-stats/projects # 项目能耗统计
|
||
GET /api/energy-stats/trend # 趋势数据（日/周/月）
|
||
GET /api/energy-stats/export # 导出能耗报表（异步）
|
||
```
|
||
|
||
### 响应示例
|
||
|
||
**总览：**
|
||
```json
|
||
{
|
||
"today_energy": 3750.50,
|
||
"month_energy": 85200.00,
|
||
"estimated_cost": 68160.00,
|
||
"cabinet_count": 128,
|
||
"online_count": 125
|
||
}
|
||
```
|
||
|
||
**柜子排行：**
|
||
```json
|
||
[
|
||
{"cabinet_id": 1, "abstract_id": "10-00000001", "today_energy": 320.5},
|
||
{"cabinet_id": 2, "abstract_id": "10-00000002", "today_energy": 285.0}
|
||
]
|
||
```
|
||
|
||
**趋势（日）：**
|
||
```json
|
||
[
|
||
{"date": "2026-07-01", "energy": 3750.50, "charge_count": 423},
|
||
{"date": "2026-06-30", "energy": 3680.20, "charge_count": 415}
|
||
]
|
||
```
|
||
|
||
## 前端页面
|
||
|
||
### 能耗管理页
|
||
|
||
**顶部数据卡片：**
|
||
```
|
||
┌─────────┐ ┌───────── ┌─────────┐ ┌─────────
|
||
│今日能耗 │ │本月能耗 │ │电费估算 │ │在线柜子 │
|
||
│3,750 kWh│ │85,200 kWh│ │¥68,160 │ │ 125 │
|
||
└───────── └─────────┘ └───────── └─────────┘
|
||
```
|
||
|
||
**柜子能耗排行：**
|
||
- 表格显示柜子ID、今日能耗、本月能耗
|
||
- 支持排序
|
||
|
||
**项目能耗统计：**
|
||
- 表格显示项目名、柜子数、今日能耗、本月能耗
|
||
|
||
**趋势图：**
|
||
- 日/周/月切换
|
||
- 折线图显示能耗趋势
|
||
- 柱状图显示充电次数
|
||
|
||
**导出按钮：**
|
||
- 异步导出Excel
|
||
- 文件名：`能耗统计_2026年7月.xlsx`
|
||
|
||
## 质量约束
|
||
|
||
1. 完成代码后执行 `cargo check` + `tsc --noEmit`，零报错零警告
|
||
2. 分层拆分，单函数≤80行，命名语义化，完整注释
|
||
3. 所有外部IO/网络请求异常捕获，禁止裸panic
|
||
4. 分支逻辑全覆盖，不遗漏兜底分支
|
||
5. 常量抽离，不使用废弃API
|
||
6. Rust内存安全，React函数组件+Hooks
|