xlhlw/资料/planner_teacher/docs/api/order.md

# 订单服务API文档

本文档描述了订单服务的API接口使用方法。

## 订单状态说明

| 状态码 | 状态名称 | 说明                         |
|-----|------|----------------------------|
| 0   | 未开始  | 订单创建后的初始状态                 |
| 1   | 规划中  | 规划师已开始为学员进行规划，对应学员step为1-5 |
| 2   | 已结束  | 规划全部完成，对应学员step为6          |
| 3   | 已取消  | 预约失败或订单被取消                 |
| 4   | 待审核  | 学员发起预约，等待规划师审核             |

## 学员步骤说明

| 步骤码 | 步骤名称 | 说明       |
|-----|------|----------|
| 1   | 专业规划 | 进行专业选择规划 |
| 2   | 院校规划 | 进行院校选择规划 |
| 3   | 志愿填报 | 进行志愿填报规划 |
| 4   | 待修改  | 规划需要修改   |
| 5   | 待确认  | 规划待学员确认  |
| 6   | 已完成  | 规划已完成    |

## API接口

### 1. 获取订单列表

```
GET /order/list
```

查询订单列表，支持按类型筛选和分页。

**请求参数**

| 参数名   | 类型      | 必填 | 说明                   |
|-------|---------|----|----------------------|
| type1 | String  | 否  | 一级类型：待审核/进行中/已完成/已取消 |
| type2 | String  | 否  | 二级类型：筛选条件            |
| page  | Integer | 否  | 页码，默认1               |
| size  | Integer | 否  | 每页大小，默认10            |
| pid   | Long    | 是  | 规划师ID                |
| mid   | Long    | 否  | 会员ID，如果指定则只查询该会员的订单  |

**响应结果**

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "records": [
      {
        "orderNo": "订单号",
        "studentName": "学员姓名",
        "studentPhone": "学员手机号",
        "area": "所在地区",
        "startTime": "任务开始时间",
        "endTime": "任务完成时间",
        "operation": "操作类型",
        "currentStep": "当前步骤",
        "memberId": 123,
        "status": 1,
        "plannerId": 456
      }
    ],
    "total": 100,
    "size": 10,
    "current": 1
  }
}
```

### 2. 创建订单

```
POST /order/create
```

创建新订单。

**请求参数**

```json
{
  "memberId": 123,
  "plannerId": 456
}
```

**响应结果**

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "orderNo": "订单号",
    "memberId": 123,
    "plannerId": 456,
    "status": 0
  }
}
```

### 3. 审核订单

```
POST /order/audit
```

审核待审核状态的订单。

**请求参数**

```json
{
  "orderNo": "订单号",
  "approved": true
}
```

**响应结果**

```json
{
  "code": 200,
  "message": "订单审核通过"
}
```

### 4. 完成订单

```
POST /order/complete
```

将规划中的订单标记为已完成。

**请求参数**

```json
{
  "orderNo": "订单号"
}
```

**响应结果**

```json
{
  "code": 200,
  "message": "订单已完成"
}
```

### 5. 取消订单

```
POST /order/cancel
```

取消订单。

**请求参数**

```json
{
  "orderNo": "订单号"
}
```

**响应结果**

```json
{
  "code": 200,
  "message": "订单已取消"
}
```

### 6. 更新订单状态

```
POST /order/status
```

直接更新订单状态（一般情况下推荐使用审核、完成、取消等特定接口）。

**请求参数**

```json
{
  "orderNo": "订单号",
  "status": 2
}
```

**响应结果**

```json
{
  "code": 200,
  "message": "订单状态已更新"
}
```

## 订单操作流程

1. 学员发起预约 -> 订单状态为**待审核(4)**
2. 规划师审核订单:
    - 通过 -> 订单状态变为**规划中(1)**，学员步骤变为**专业规划(1)**
    - 拒绝 -> 订单状态变为**已取消(3)**
3. 规划师进行规划，学员步骤依次为:
    - 专业规划(1) -> 院校规划(2) -> 志愿填报(3) -> 待修改(4) -> 待确认(5)
4. 规划完成，规划师确认 -> 订单状态变为**已结束(2)**，学员步骤变为**已完成(6)**

## 错误码说明

| 错误码 | 说明      |
|-----|---------|
| 400 | 请求参数错误  |
| 404 | 订单不存在   |
| 500 | 服务器内部错误 |