# charger

**Repository Path**: ithorns/charger

## Basic Information

- **Project Name**: charger
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EVCharger - 新能源充电管家

一款专为新能源车主设计的充电桩充电统计计费应用。

## 功能特性

- 充电记录管理：添加、编辑、删除充电记录
- 充电厂商管理：支持多厂商管理及时段分段计费配置
- 费用计算：自动根据时段单价计算电费和服务费
- 统计分析：按月、年、厂商等纬度统计充电数据
- 数据导出：支持数据备份和恢复

## 技术栈

- Android 16 (API Level 36)
- Java 原生开发
- Material Design 3
- SQLite3 本地数据库
- MVP 架构模式

## 项目结构

```
app/
├── src/main/
│   ├── java/com/evcharger/
│   │   ├── data/          # 数据层
│   │   │   ├── dao/       # DAO接口
│   │   │   ├── db/        # SQLite实现
│   │   │   ├── model/     # 数据模型
│   │   │   └── repository/# 数据仓库
│   │   ├── ui/            # UI层
│   │   │   ├── activity/  # Activity
│   │   │   ├── adapter/   # 适配器
│   │   │   └── fragment/  # Fragment
│   │   ├── contract/      # MVP Contract
│   │   ├── presenter/     # Presenter
│   │   └── util/          # 工具类
│   └── res/               # 资源文件
```

## 构建说明

### 环境要求

- Android Studio Hedgehog 或更高版本
- JDK 17+
- Android SDK Platform 36

### 构建步骤

1. 克隆项目到本地
2. 在 Android Studio 中打开项目
3. 等待 Gradle 同步完成
4. 选择 `app` 模块，点击 Run 按钮运行

或者使用命令行构建：

```bash
# 同步 Gradle
./gradlew tasks

# 构建 Debug APK
./gradlew assembleDebug

# 构建 Release APK
./gradlew assembleRelease
```

Debug APK 输出位置：`app/build/outputs/apk/debug/app-debug.apk`

## 数据库设计

### 充电厂商表 (charging_vendor)
- id: 主键
- name: 厂商名称
- location: 默认充电地点
- api_url: API地址(可选)
- remark: 备注

### 充电时段表 (charging_period)
- id: 主键
- vendor_id: 关联厂商ID
- period_name: 时段名称
- start_hour: 开始小时
- end_hour: 结束小时
- electricity_price: 电费单价
- service_price: 服务费单价

### 充电记录表 (charging_record)
- id: 主键
- vendor_id: 关联厂商ID
- charge_date: 充电日期
- start_time: 开始时间
- end_time: 结束时间
- electricity_amount: 充电电量
- total_amount: 消费金额
- electricity_fee: 电费
- service_fee: 服务费

## 使用说明

1. **添加厂商**：先在"厂商"页面添加充电运营商及其时段计费标准
2. **添加记录**：在首页点击"+"按钮添加充电记录
3. **查看统计**：在"统计"页面查看充电数据分析

## License

MIT License