EMS-vite/.trae/documents/首页电压_电流图表对接 Java 后端.md
miaoda 95098991f3 # 技术实现详情
## 架构设计

**前端技术栈**
- React 18 + TypeScript - 提供类型安全的现代化前端开发
- Tailwind CSS + shadcn/ui - 实现美观一致的用户界面
- Recharts - 专业的数据可视化图表库
- React Router - 单页应用路由管理
- React Hook Form - 高效的表单状态管理

**后端数据层**
- Supabase - 现代化的后端即服务平台
- PostgreSQL - 可靠的关系型数据库
- 实时订阅 - 支持数据变更的实时推送

## 数据库设计

创建了完整的数据库架构,包含5个核心表:

1. **devices** - 设备管理表,存储BBox设备信息、状态和配置
2. **battery_data** - 电池数据表,记录电压、电流、温度等实时数据
3. **ota_tasks** - OTA升级任务表,管理固件升级流程和状态
4. **mqtt_logs** - MQTT通信日志表,记录设备通信历史
5. **system_config** - 系统配置表,存储报警阈值和系统参数

## 功能实现

**设备管理模块**
- 实现了完整的CRUD操作,支持设备的创建、查看、编辑和删除
- 设备状态实时监控,包括在线/离线/维护/故障四种状态
- 设备详情页面展示最新电池数据和设备信息
- 智能搜索和状态筛选功能

**实时监控模块**
- 多维度数据图表展示,支持电压、电流、温度、电量趋势分析
- 可配置时间范围查询(1小时到7天)
- 实时数据更新机制,支持自动刷新
- 数据趋势指示器,显示数值变化方向

**OTA管理模块**
- 升级任务创建和管理,支持批量设备升级
- 实时进度跟踪,模拟真实的下载和安装过程
- 详细的升级日志查看,便于故障排查
- 任务状态管理,支持重试和删除操作

**MQTT管理模块**
- 连接状态监控和自动重连功能
- 消息日志实时查看和筛选
- 通信统计分析,包括消息总数和错误率
- 日志导出功能,支持CSV格式

**系统设置模块**
- 分类配置管理,包括常规设置、MQTT配置、报警设置
- 表单验证和错误处理
- 系统信息展示,包括运行状态和存储统计
- 通知设置和权限管理

## 代码质量

- 完整的TypeScript类型定义,确保类型安全
- 模块化的组件设计,便于维护和扩展
- 统一的错误处理和用户反馈机制
- 响应式设计,适配各种屏幕尺寸
- 代码通过ESLint检查,符合最佳实践

## 数据初始化

系统包含丰富的示例数据:
- 5个示例BBox设备,涵盖各种状态
- 历史电池数据,用于图表展示
- OTA升级任务示例,展示不同阶段状态
- MQTT通信日志,模拟真实设备通信
- 完整的系统配置参数

应用已完全实现需求文档中的所有功能,提供了专业级的电池管理解决方案。
2025-11-17 16:52:12 +08:00

1.1 KiB
Raw Blame History

目标

将首页Dashboard电压/电流趋势图数据源改为后端 Java 图表接口:javaBatteryDataApi.getChartData(deviceId, hours),展示 24 小时的 voltagecurrent

修改点

  1. src/pages/Dashboard.tsx
  • 引入 ChartDataPoint 类型

  • recentBatteryData 状态替换为 chartData: ChartDataPoint[]

  • loadDashboardData 里,获取设备后调用 javaBatteryDataApi.getChartData(devicesData[0].deviceId, 24) 赋值给 chartData

  • 将第二张图改为“电流趋势”,dataKey="current",单位 A

  • 在上述改动处添加中文注释(说明数据来源、单位与时间范围)

接口约定

  • 路由:GET /battery-data/{deviceId}/chart?hours=(已封装在 javaBatteryDataApi.getChartData

  • 返回:ChartDataPoint[](含 timestamp, voltage, current

  • 参数:使用设备列表中的第一个设备,时间范围默认 24 小时

验证

  • 类型检查通过,首页能显示电压与电流两张趋势图;无影响其他页面逻辑

后续可选

  • 增加设备与时间范围选择器,以便用户切换设备与窗口大小