hbyt/EMS-vite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
95098991f3
EMS-vite/docs/prd.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

2.2 KiB
Raw Blame History

电池管理系统需求文档

1. 系统概述

1.1 系统名称

电池管理系统（Battery Management System）

1.2 系统描述

基于VUE 3框架开发的现代化Web界面电池管理系统，专为BBox设备端与羿动新能源平台对接而设计，支持设备登录授权、实时数据监控、OTA固件升级管理等核心功能。

1.3 技术框架

VUE 3框架

2. 核心功能

2.1 设备管理功能

  • 设备登录授权和状态监控系统，确保设备安全接入
  • BBox设备登录支持
  • 与羿动新能源平台的无缝对接

2.2 数据传输与监控

  • 实时电池数据传输机制
  • 可视化展示界面
  • 实时数据图表展示和统计分析功能
  • 设备状态和数据趋势展示

2.3 OTA升级管理

  • OTA固件升级管理功能
  • 升级进度跟踪
  • 升级任务监控和日志查看功能，便于故障排查

2.4 通信管理

  • MQTT服务器连接管理
  • 消息传输情况监控

2.5 系统配置

  • 完整的系统设置和配置管理功能
  • 便捷的设备管理和操作界面

3. 用户界面要求

3.1 设计规范

  • 采用现代化的响应式设计
  • 兼容桌面和移动设备
  • 设计直观的仪表盘，清晰展示设备状态和数据趋势

3.2 功能界面

  • 实时数据图表展示和统计分析功能
  • 便捷的设备管理和操作界面
  • 完善升级任务监控和日志查看功能

4. 接口文档

4.1 设备管理接口

  • 设备登录授权接口
  • 设备状态查询接口
  • 设备列表获取接口
  • 设备信息更新接口

4.2 数据传输接口

  • 实时电池数据获取接口
  • 历史数据查询接口
  • 数据统计分析接口
  • 设备状态数据接口

4.3 OTA升级接口

  • 固件版本查询接口
  • OTA升级任务创建接口
  • 升级进度查询接口
  • 升级日志获取接口

4.4 通信管理接口

  • MQTT连接状态接口
  • 消息发送接口
  • 消息接收状态查询接口
  • 通信日志接口

4.5 系统配置接口

  • 系统参数配置接口
  • 配置信息获取接口
  • 用户权限管理接口
  • 系统状态监控接口

5. 参考文件

参考文件路径：

  1. 动力电池端采集设备与平台交互接口规范 - 羿动新能源科技有限公司技术文档