8.5 KiB
8.5 KiB
App Wallbox 充电墙盒模块
模块概述
app_wallbox 是 OneApp 车联网生态中的充电墙盒管理模块，负责家用充电桩（墙盒）的管理、安装、配置和监控等功能。该模块为用户提供完整的家庭充电解决方案管理服务。
基本信息
- 模块名称: app_wallbox
- 版本: 0.2.29
- 描述: 充电墙盒应用模块
- Flutter 版本: >=2.10.5
- Dart 版本: >=3.0.0 <4.0.0
功能特性
核心功能
-
墙盒设备管理
- 设备注册和绑定
- 设备状态监控
- 设备配置管理
- 设备固件升级
-
安装服务
- 安装预约申请
- 安装进度跟踪
- 安装城市选择
- 安装文件上传
-
充电管理
- 远程充电控制
- 充电计划设置
- 充电记录查看
- 电费统计分析
-
智能功能
- 智能充电调度
- 电网负荷优化
- 太阳能集成
- 能源管理优化
技术架构
目录结构
lib/
├── app_wallbox.dart # 模块入口文件
├── src/ # 源代码目录
│ ├── devices/ # 设备管理
│ ├── installation/ # 安装服务
│ ├── charging/ # 充电控制
│ ├── monitoring/ # 监控组件
│ ├── smart/ # 智能功能
│ ├── pages/ # 页面组件
│ ├── models/ # 数据模型
│ └── utils/ # 工具类
├── generated/ # 代码生成文件
└── l10n/ # 国际化文件
依赖关系
核心依赖
basic_modular: ^0.2.3- 模块化框架basic_modular_route: ^0.2.1- 路由管理basic_resource: ^0.2.10- 资源管理basic_intl: ^0.2.0- 国际化支持basic_storage: ^0.2.2- 本地存储basic_network: ^0.2.3+3- 网络通信basic_track: ^0.1.3- 数据埋点
业务依赖
ui_business: ^0.2.23- 业务UI组件
第三方依赖
json_annotation: ^4.6.0- JSON序列化dartz: ^0.10.1- 函数式编程extended_image: ^8.2.3- 增强图片组件url_launcher: ^6.1.4- URL启动collection: ^1.17.1- 集合工具path_provider: ^2.0.15- 文件路径path: ^1.8.3- 路径操作
核心模块分析
1. 模块入口 (app_wallbox.dart)
功能职责:
- 模块对外接口统一导出
- 墙盒服务初始化
- 设备管理启动
2. 设备管理 (src/devices/)
功能职责:
- 墙盒设备注册和绑定
- 设备状态实时监控
- 设备配置参数管理
- 设备固件和软件升级
主要组件:
DeviceManager- 设备管理器DeviceRegistry- 设备注册表StatusMonitor- 状态监控器ConfigManager- 配置管理器FirmwareUpdater- 固件升级器
3. 安装服务 (src/installation/)
功能职责:
- 安装服务预约和申请
- 安装进度实时跟踪
- 安装城市和地区选择
- 安装相关文件上传管理
主要组件:
InstallationService- 安装服务ProgressTracker- 进度跟踪器CityPicker- 城市选择器UploadManager- 文件上传管理器AppointmentManager- 预约管理器
4. 充电控制 (src/charging/)
功能职责:
- 远程充电启停控制
- 充电计划和策略设置
- 充电过程监控
- 充电数据记录和分析
主要组件:
ChargingController- 充电控制器ScheduleManager- 计划管理器ProcessMonitor- 过程监控器DataRecorder- 数据记录器
5. 监控组件 (src/monitoring/)
功能职责:
- 设备运行状态监控
- 充电过程实时监控
- 异常检测和告警
- 性能指标收集
主要监控器:
DeviceMonitor- 设备监控器ChargingMonitor- 充电监控器AlertManager- 告警管理器MetricsCollector- 指标收集器
6. 智能功能 (src/smart/)
功能职责:
- 智能充电调度算法
- 电网负荷平衡优化
- 可再生能源集成
- 能源成本优化
主要组件:
SmartScheduler- 智能调度器LoadBalancer- 负荷均衡器EnergyOptimizer- 能源优化器GridInterface- 电网接口
7. 页面组件 (src/pages/)
功能职责:
- 用户界面展示
- 设备管理界面
- 充电控制界面
- 安装服务界面
主要页面:
WallboxHomePage- 墙盒主页DeviceManagementPage- 设备管理页ChargingControlPage- 充电控制页InstallationPage- 安装服务页MonitoringDashboard- 监控仪表板
8. 数据模型 (src/models/)
功能职责:
- 设备信息数据模型
- 充电数据模型
- 安装服务模型
- 配置参数模型
主要模型:
WallboxDevice- 墙盒设备模型ChargingSession- 充电会话模型InstallationOrder- 安装订单模型DeviceConfig- 设备配置模型
9. 工具类 (src/utils/)
功能职责:
- 墙盒工具方法
- 数据处理辅助
- 文件操作工具
- 计算辅助工具
主要工具:
PowerCalculator- 功率计算器EnergyAnalyzer- 能源分析器FileUploader- 文件上传器DataFormatter- 数据格式化器
业务流程
设备安装流程
graph TD
A[用户申请安装] --> B[选择安装城市]
B --> C[填写安装信息]
C --> D[上传相关文件]
D --> E[提交安装申请]
E --> F[系统审核申请]
F --> G{审核是否通过}
G -->|是| H[安排安装服务]
G -->|否| I[通知修改申请]
H --> J[派遣安装团队]
J --> K[现场安装施工]
K --> L[设备调试测试]
L --> M{测试是否通过}
M -->|是| N[设备注册绑定]
M -->|否| O[问题排查修复]
N --> P[安装完成]
O --> L
I --> C
P --> Q[用户验收]
智能充电流程
graph TD
A[用户设置充电需求] --> B[系统分析用电负荷]
B --> C[获取电价信息]
C --> D[检查电网状态]
D --> E[计算最优充电策略]
E --> F[生成充电计划]
F --> G[用户确认计划]
G --> H{用户是否同意}
H -->|是| I[执行充电计划]
H -->|否| J[调整计划参数]
I --> K[监控充电过程]
K --> L[动态调整功率]
L --> M{是否达到目标}
M -->|是| N[充电完成]
M -->|否| O[继续充电]
J --> E
O --> K
N --> P[生成充电报告]
墙盒系统设计
设备类型
-
家用标准墙盒
- 7kW交流充电
- 单相/三相供电
- WiFi/以太网连接
- 基础智能功能
-
商用快充墙盒
- 22kW交流快充
- 三相供电
- 有线网络连接
- 高级智能功能
-
智能墙盒
- 可变功率充电
- 太阳能集成
- 储能系统集成
- AI优化算法
通信协议
- OCPP: 开放充电点协议
- Modbus: 工业通信协议
- HTTP/HTTPS: Web API通信
- MQTT: 物联网消息协议
安全特性
设备安全
- 设备身份认证
- 通信数据加密
- 固件签名验证
- 安全升级机制
用户安全
- 用户身份验证
- 操作权限控制
- 敏感数据保护
- 安全审计日志
性能优化
通信优化
- 数据压缩传输
- 断线重连机制
- 离线数据缓存
- 网络自适应
能效优化
- 智能功率调节
- 负荷均衡算法
- 能源损耗最小化
- 电网友好充电
扩展性设计
协议支持
- 多种通信协议适配
- 标准协议兼容
- 自定义协议扩展
- 协议版本升级
设备兼容
- 多厂商设备支持
- 不同型号适配
- 新设备快速接入
- 设备能力自动识别
测试策略
单元测试
- 充电控制逻辑测试
- 设备通信测试
- 数据模型测试
- 算法功能测试
集成测试
- 设备集成测试
- 系统端到端测试
- 协议兼容性测试
- 性能压力测试
现场测试
- 实际设备测试
- 网络环境测试
- 用户场景测试
- 长期稳定性测试
部署和维护
设备管理
- 设备远程配置
- 固件OTA升级
- 故障远程诊断
- 预防性维护
系统监控
- 设备在线率监控
- 充电成功率统计
- 系统性能监控
- 用户满意度跟踪
总结
app_wallbox 模块作为 OneApp 的家庭充电解决方案中心，为用户提供了完整的充电墙盒管理服务。通过智能的设备管理、便捷的安装服务和高效的充电控制，用户可以享受到安全、智能、经济的家庭充电体验。模块具有良好的设备兼容性和扩展能力，能够适应不断发展的充电技术和用户需求。