From 2b1c3e0859b818661df2c72d24090e4f1942ced3 Mon Sep 17 00:00:00 2001 From: yst Date: Mon, 18 May 2026 19:58:37 +0800 Subject: [PATCH] =?UTF-8?q?fix(=C2=A72):=20traveler=204=20=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E8=B7=AF=E5=BE=84=E5=AF=B9=E9=BD=90=E5=AE=9E=E9=99=85?= =?UTF-8?q?=20Controller=EF=BC=88=E5=8A=A8=E8=AF=8D=E9=A3=8E=E6=A0=BC?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .../18_§2_traveler模块-新增接口-管理后台.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md b/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md index 17d765c..f45216d 100644 --- a/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md +++ b/changelogs-v2/2026-05/18_§2_traveler模块-新增接口-管理后台.md @@ -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} ```