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