changelog: 573e671 - fix: 新增管理端获取订单出行人接口 GET /admin/order/{orderId}/travelers

changelogs/2026-03/2026-03-21_0909_573e671_fix.md

@@ -0,0 +1,93 @@
+# 接口变更记录 — 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>