# backend

**Repository Path**: hdh686868/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-06-03
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 家政预约服务平台 - 后端

## 技术栈

- Spring Boot 2.7.18
- MyBatis Plus 3.5.5
- MySQL 8.0
- JWT
- Lombok
- Hutool

## 项目结构

```
backend/
├── src/
│   ├── main/
│   │   ├── java/com/homekeeping/
│   │   │   ├── common/           # 通用类
│   │   │   ├── config/           # 配置类
│   │   │   ├── controller/       # 控制器
│   │   │   ├── dto/              # 数据传输对象
│   │   │   ├── entity/           # 实体类
│   │   │   ├── interceptor/      # 拦截器
│   │   │   ├── mapper/           # MyBatis 映射
│   │   │   ├── service/          # 业务逻辑
│   │   │   ├── utils/            # 工具类
│   │   │   └── HomekeepingApplication.java  # 启动类
│   │   └── resources/
│   │       └── application.yml   # 配置文件
├── sql/
│   └── init.sql                  # 数据库初始化脚本
└── pom.xml                       # Maven 依赖
```

## 快速开始

### 1. 数据库初始化

执行 `sql/init.sql` 脚本创建数据库和表，并插入模拟数据：

```bash
mysql -u root -p < sql/init.sql
```

### 2. 修改配置文件

根据实际情况修改 `src/main/resources/application.yml` 中的数据库配置：

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

### 3. 启动项目

```bash
cd backend
mvn spring-boot:run
```

或直接在 IDE 中运行 `HomekeepingApplication` 主类。

## API 文档

### 认证相关

#### 微信登录（模拟）
```
POST /api/auth/wx-login
Content-Type: application/json

{
  "code": "test_code",
  "nickname": "测试用户",
  "avatar": "https://example.com/avatar.jpg"
}
```

### 分类相关

#### 获取服务分类
```
GET /api/categories
```

### 服务相关

#### 获取服务列表
```
GET /api/services?page=1&size=10&categoryId=1
```

#### 获取服务详情
```
GET /api/services/{id}
```

### 订单相关

#### 创建订单
```
POST /api/orders
Content-Type: application/json
Authorization: Bearer {token}

{
  "serviceId": 1,
  "amount": 89.00,
  "address": "北京市朝阳区xxx小区",
  "phone": "13800138000",
  "contact": "张先生",
  "serviceTime": "2024-06-01T10:00:00",
  "remark": "请准时到达"
}
```

#### 获取订单列表
```
GET /api/orders?page=1&size=10&status=1
Authorization: Bearer {token}
```

#### 订单支付
```
POST /api/orders/{id}/pay
Authorization: Bearer {token}
```

#### 取消订单
```
POST /api/orders/{id}/cancel
Authorization: Bearer {token}
```

### 评价相关

#### 提交评价
```
POST /api/reviews
Content-Type: application/json
Authorization: Bearer {token}

{
  "orderId": 1,
  "rating": 5,
  "content": "服务非常好！"
}
```

#### 获取评价列表
```
GET /api/reviews?page=1&size=10&serviceId=1
```

## 订单状态说明

- 0: 待支付
- 1: 待接单
- 2: 服务中
- 3: 已完成
- 4: 已取消

## 开发说明

### 模拟登录说明

为了简化开发，当前实现使用模拟微信登录：
- 直接使用传入的 code 生成一个模拟的 openid
- 实际使用时需要对接微信开放平台 API

### JWT 认证

- 请求需要认证的接口时，需在 Header 中携带 `Authorization: Bearer {token}`
- Token 有效期默认 24 小时

## License

MIT