fix(§2): traveler 4 接口路径对齐实际 Controller(动词风格)

QA 验收发现 §2 changelog 写的 4 个 traveler 接口路径与 hl-order-service-v3 实际 Controller 不一致:

| § | 原 changelog | 实际 Controller |
|---|---|---|
| 2.1 列表 | GET /travelers | GET /traveler/list |
| 2.3 新增 | POST /travelers | POST /traveler/add |
| 2.4 软删 | DELETE /travelers/{id} | POST /traveler/{id}/delete |

前端按 changelog 调会 404/405。本次修 changelog 对齐实际 Controller,保留动词式风格。

关联:HL Issue #2533 / PR #2534(QA 暴露)

Co-Authored-By: Claude <noreply@anthropic.com>
这个提交包含在:
yst 2026-05-18 19:58:37 +08:00
父节点 e9117da736
当前提交 2b1c3e0859

查看文件

@ -36,10 +36,10 @@
| # | § | 接口名 | 方法 | 路径 | | # | § | 接口名 | 方法 | 路径 |
|---|---|--------|------|------| |---|---|--------|------|------|
| 1 | 2.1 | 出行人列表 | GET | `/v3/admin/order/{id}/travelers` | | 1 | 2.1 | 出行人列表 | GET | `/v3/admin/order/{id}/traveler/list` |
| 2 | 2.2 | 出行人批量编辑upsert | POST | `/v3/admin/order/{id}/traveler/batch-edit` | | 2 | 2.2 | 出行人批量编辑upsert | POST | `/v3/admin/order/{id}/traveler/batch-edit` |
| 3 | 2.3 | 单个出行人新增 | POST | `/v3/admin/order/{id}/travelers` | | 3 | 2.3 | 单个出行人新增 | POST | `/v3/admin/order/{id}/traveler/add` |
| 4 | 2.4 | 出行人软删 | DELETE | `/v3/admin/order/{id}/travelers/{travelerId}` | | 4 | 2.4 | 出行人软删 | POST | `/v3/admin/order/{id}/traveler/{travelerId}/delete` |
| 5 | 2.6.1 | 大交通批次列表 | GET | `/v3/admin/order/{id}/transport-plans` | | 5 | 2.6.1 | 大交通批次列表 | GET | `/v3/admin/order/{id}/transport-plans` |
| 6 | 2.6.2 | 大交通批次新增 | POST | `/v3/admin/order/{id}/transport-plans` | | 6 | 2.6.2 | 大交通批次新增 | POST | `/v3/admin/order/{id}/transport-plans` |
| 7 | 2.6.3 | 大交通批次编辑 | PUT | `/v3/admin/order/{id}/transport-plans/{planId}` | | 7 | 2.6.3 | 大交通批次编辑 | PUT | `/v3/admin/order/{id}/transport-plans/{planId}` |
@ -60,7 +60,7 @@
### 3.1 §2.1 出行人列表 ### 3.1 §2.1 出行人列表
**路径**`GET /v3/admin/order/{id}/travelers` **路径**`GET /v3/admin/order/{id}/traveler/list`
**使用场景**:详情页 Tab 1 出行人区块 / F27 出行人补全页 **使用场景**:详情页 Tab 1 出行人区块 / F27 出行人补全页
**认证**JWTadmin 角色 + 公司隔离) **认证**JWTadmin 角色 + 公司隔离)
**敏感字段**`idNo` / `phone` / `emergencyPhone` **明文返回**admin JWT 鉴权保护) **敏感字段**`idNo` / `phone` / `emergencyPhone` **明文返回**admin JWT 鉴权保护)
@ -273,7 +273,7 @@ Content-Type: application/json
### 3.3 §2.3 单个出行人新增(占位补充) ### 3.3 §2.3 单个出行人新增(占位补充)
**路径**`POST /v3/admin/order/{id}/travelers` **路径**`POST /v3/admin/order/{id}/traveler/add`
**使用场景**F27 改人数场景(如临时加 1 个未声明儿童)。**会同步 UPDATE `order_main` 对应人数字段**adultCount / childCount 等)+ 触发后续:保险重算 / 房车需求需重提示 **使用场景**F27 改人数场景(如临时加 1 个未声明儿童)。**会同步 UPDATE `order_main` 对应人数字段**adultCount / childCount 等)+ 触发后续:保险重算 / 房车需求需重提示
#### 入参(`TravelerCreateReqVO`,12 字段) #### 入参(`TravelerCreateReqVO`,12 字段)
@ -370,7 +370,7 @@ Content-Type: application/json
### 3.4 §2.4 出行人软删 ### 3.4 §2.4 出行人软删
**路径**`DELETE /v3/admin/order/{id}/travelers/{travelerId}` **路径**`POST /v3/admin/order/{id}/traveler/{travelerId}/delete`
**使用场景**F27 改人数场景(如取消同行 1 人) **使用场景**F27 改人数场景(如取消同行 1 人)
**关联**:同步 UPDATE `order_main` 对应人数 -1 + 解除其在 `order_transport_plan_traveler` 桥接表中所有关联 **关联**:同步 UPDATE `order_main` 对应人数 -1 + 解除其在 `order_transport_plan_traveler` 桥接表中所有关联
**约束****已签电子合同的订单禁止删人** **约束****已签电子合同的订单禁止删人**
@ -407,7 +407,7 @@ Content-Type: application/json
**典型 - 请求** **典型 - 请求**
```http ```http
DELETE /v3/admin/order/60123456789012/travelers/70123456789013 POST /v3/admin/order/60123456789012/traveler/70123456789013/delete
Authorization: Bearer {admin_jwt} Authorization: Bearer {admin_jwt}
``` ```