# 接口变更记录 — 2026-03-21 09:09

> **提交** `573e671` · **作者** wx · **时间** 2026-03-21 09:09:39 +0800
>
> fix: 新增管理端获取订单出行人接口 GET /admin/order/{orderId}/travelers

## 变更总览

- **订单服务**
  - AdminOrder (+4)

---

## 订单服务

### AdminOrder

> 📖 **接口文档**: [http://192.168.100.236:8084/doc.html](http://192.168.100.236:8084/doc.html) → 分组 **「3.1 订单管理」** → 标签 **「管理端订单接口」**

### 🆕 `GET` /admin/order/{orderId}/travelers — 获取订单出行人列表

> 返回指定订单的所有出行人信息，用于保险投保时自动填充被保人。

**参数**

  - `{orderId}` (`Long`) — 路径参数：订单ID

**响应** `Result<List<OrderTraveler>>`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `orderTravelerId` | `Long` | 出行人记录ID |
| `orderId` | `Long` | 订单ID |
| `name` | `String` | 出行人姓名 |
| `idCardType` | `String` | 证件类型（字典：id_card_type） |
| `idCardNo` | `String` | 证件号码（加密存储） |
| `phone` | `String` | 手机号码（加密存储） |
| `gender` | `Integer` | 性别（字典：gender） |
| `birthday` | `LocalDate` | 出生日期 |
| `travelerType` | `String` | 出行人类型（字典：traveler_type） |
| `nationality` | `String` | 国籍 |
| `emergencyContact` | `String` | 紧急联系人姓名 |
| `emergencyPhone` | `String` | 紧急联系人电话（加密存储） |
| `email` | `String` | 邮箱地址 |
| `deletedAt` | `LocalDateTime` | 删除时间（软删除） |
| `createTime` | `LocalDateTime` | 创建时间 |
| `updateTime` | `LocalDateTime` | 更新时间 |

### 🆕 `POST` /admin/order/{orderId}/surcharge — 添加费用增加项

> 为订单添加费用增加项（如升级房型补差价、加座费等）。

**参数**

  - `{orderId}` (`Long`) — 路径参数：订单ID

**请求体** `SurchargeRequest`

**响应** `Result<OrderSurcharge>`

### 🆕 `PUT` /admin/order/{orderId}/surcharge/{surchargeId} — 修改费用增加项

> 修改已添加的费用增加项名称或金额，修改后自动重算订单尾款金额。

**参数**

  - `{orderId}` (`Long`) — 路径参数：订单ID
  - `{surchargeId}` (`Long`) — 路径参数：费用增加项ID

**请求体** `SurchargeRequest`

**响应** `Result<Void>`

### 🆕 `DELETE` /admin/order/{orderId}/surcharge/{surchargeId} — 删除费用增加项

> 删除已添加的费用增加项，删除后自动重算订单尾款金额。

**参数**

  - `{orderId}` (`Long`) — 路径参数：订单ID
  - `{surchargeId}` (`Long`) — 路径参数：费用增加项ID

**响应** `Result<Void>`

---

<details>
<summary>📁 全部变更文件 (点击展开)</summary>

```
M	hl-order-service/src/main/java/com/hulalv/order/controller/AdminOrderController.java
```
</details>