diff --git a/changelogs/2026-03/2026-03-21_0909_573e671_fix.md b/changelogs/2026-03/2026-03-21_0909_573e671_fix.md new file mode 100644 index 0000000..dcf810e --- /dev/null +++ b/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>` + +| 字段 | 类型 | 说明 | +| --- | --- | --- | +| `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` + +### 🆕 `PUT` /admin/order/{orderId}/surcharge/{surchargeId} — 修改费用增加项 + +> 修改已添加的费用增加项名称或金额,修改后自动重算订单尾款金额。 + +**参数** + + - `{orderId}` (`Long`) — 路径参数:订单ID + - `{surchargeId}` (`Long`) — 路径参数:费用增加项ID + +**请求体** `SurchargeRequest` + +**响应** `Result` + +### 🆕 `DELETE` /admin/order/{orderId}/surcharge/{surchargeId} — 删除费用增加项 + +> 删除已添加的费用增加项,删除后自动重算订单尾款金额。 + +**参数** + + - `{orderId}` (`Long`) — 路径参数:订单ID + - `{surchargeId}` (`Long`) — 路径参数:费用增加项ID + +**响应** `Result` + +--- + +
+📁 全部变更文件 (点击展开) + +``` +M hl-order-service/src/main/java/com/hulalv/order/controller/AdminOrderController.java +``` +
\ No newline at end of file