# 车辆管理接口文档

## 基础信息

- **Base URL**: `http://localhost:端口号`
- **Content-Type**: `application/json`
- **认证方式**: 需要登录（请求头携带 token）

## 数据字典 - 车辆使用状态

| 枚举值 | 含义 |
|--------|------|
| `IDLE` | 空闲 |
| `IN_USE` | 使用中 |
| `MAINTENANCE` | 维修中 |
| `SCRAPPED` | 已报废 |

---

## 1. 分页查询车辆列表

### 请求信息

- **URL**: `/approve/vehicle/listPage`
- **Method**: `GET`

### 请求参数（Query String）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| current | Long | 是 | 当前页码，默认1 |
| size | Long | 是 | 每页条数，默认10 |
| plateNumber | String | 否 | 车牌号（模糊查询） |
| status | String | 否 | 使用状态（精确匹配） |

### 请求示例

```
GET /approve/vehicle/listPage?current=1&size=10&plateNumber=京&status=IN_USE
```

### 响应示例

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "records": [
      {
        "id": 1,
        "plateNumber": "京A12345",
        "mileage": 52000.00,
        "status": "IN_USE",
        "deleted": 0,
        "createUser": 1,
        "createTime": "2026-05-28 10:00:00",
        "updateUser": 1,
        "updateTime": "2026-05-28 10:00:00",
        "deptId": 100
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "pages": 1
  }
}
```

---

## 2. 新增车辆

### 请求信息

- **URL**: `/approve/vehicle/save`
- **Method**: `POST`
- **Content-Type**: `application/json`

### 请求体参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| plateNumber | String | 是 | 车牌号 |
| mileage | Number | 否 | 车辆公里数，默认0 |
| status | String | 是 | 使用状态：IDLE / IN_USE / MAINTENANCE / SCRAPPED |

### 请求示例

```json
{
  "plateNumber": "京A12345",
  "mileage": 0,
  "status": "IDLE"
}
```

### 响应示例

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": true
}
```

---

## 3. 车辆详情

### 请求信息

- **URL**: `/approve/vehicle/detail`
- **Method**: `GET`

### 请求参数（Query String）

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | Long | 是 | 车辆ID |

### 请求示例

```
GET /approve/vehicle/detail?id=1
```

### 响应示例

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1,
    "plateNumber": "京A12345",
    "mileage": 52000.00,
    "status": "IN_USE",
    "deleted": 0,
    "createUser": 1,
    "createTime": "2026-05-28 10:00:00",
    "updateUser": 1,
    "updateTime": "2026-05-28 10:00:00",
    "deptId": 100
  }
}
```

---

## 4. 修改车辆

### 请求信息

- **URL**: `/approve/vehicle/update`
- **Method**: `POST`
- **Content-Type**: `application/json`

### 请求体参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| id | Long | 是 | 车辆ID |
| plateNumber | String | 否 | 车牌号 |
| mileage | Number | 否 | 车辆公里数 |
| status | String | 否 | 使用状态 |

### 请求示例

```json
{
  "id": 1,
  "plateNumber": "京A12345",
  "mileage": 52000.00,
  "status": "IN_USE"
}
```

### 响应示例

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": true
}
```

---

## 5. 删除车辆

### 请求信息

- **URL**: `/approve/vehicle/delete`
- **Method**: `DELETE`
- **Content-Type**: `application/json`

### 请求体参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| ids | Array<Long> | 是 | 车辆ID数组 |

### 请求示例

```json
[1, 2, 3]
```

### 响应示例

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": true
}
```