# backend

**Repository Path**: zhao-huanting/backend

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 电动车充电预约系统 - Spring Boot 后端

## 项目结构

```
backend/
├── src/main/java/com/charging/
│   ├── entity/          # 实体类
│   ├── repository/      # 数据访问层
│   ├── service/         # 业务逻辑层
│   ├── controller/      # 控制器层
│   └── ChargingReservationApplication.java  # 启动类
├── src/main/resources/
│   ├── application.yml  # 配置文件
│   └── init-data.sql    # 初始化数据
└── pom.xml             # Maven 配置
```

## 技术栈

- Spring Boot 2.7.14
- Spring Data JPA
- MySQL 8.0
- Lombok

## 运行步骤

### 1. 创建数据库

```sql
CREATE DATABASE charging_reservation CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 2. 修改数据库配置

编辑 `src/main/resources/application.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/charging_reservation?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
```

### 3. 运行项目

```bash
# 使用 Maven
mvn spring-boot:run

# 或者打包后运行
mvn clean package
java -jar target/charging-reservation-1.0.0.jar
```

### 4. 初始化数据（可选）

运行 `src/main/resources/init-data.sql` 插入测试数据。

## API 接口

### 充电位接口

- `GET /api/charge/list` - 获取所有充电位
- `GET /api/charge/status` - 获取充电位统计
- `GET /api/charge/{id}` - 获取充电位详情

### 订单接口

- `GET /api/order/list?userId={userId}&page={page}&pageSize={pageSize}` - 分页获取订单
- `GET /api/order/my-orders?userId={userId}` - 获取用户所有订单
- `GET /api/order/{id}` - 获取订单详情
- `POST /api/order/create` - 创建订单
  - 参数: `userId`, `userName`, `chargeId`, `duration`
- `POST /api/order/pay` - 支付订单
  - 参数: `orderId`
- `POST /api/order/cancel` - 取消订单
  - 参数: `orderId`
- `POST /api/order/complete` - 完成订单
  - 参数: `orderId`

### 用户接口

- `POST /api/user/login` - 用户登录
  - 参数: `openid`, `nickName`, `avatarUrl`
- `GET /api/user/info?openid={openid}` - 获取用户信息

## 端口

- 后端服务: http://localhost:8080
- 微信小程序需要配置不校验合法域名，或在微信开发者工具中设置