docs(changelog): 前端缺陷——团期详情配导游/配摄影保存报 589553，弹窗误传订单侧团期 ID（应传 productBatchId）
changelog-filename-gate / validate (push) Failing after 3s
changelog-filename-gate / validate (push) Failing after 3s
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
这个提交包含在：
Claude Opus 5.5
@@ -0,0 +1,121 @@
|
||||
---
|
||||
schema: hl-changelog/v2
|
||||
ticket: "frontend"
|
||||
title: "团期详情「配置导游 / 配置摄影」保存必报 589553「团期尚未创建」：弹窗把订单侧团期 ID 当成产品侧排期 ID 传给人员配置接口"
|
||||
consumer: admin
|
||||
author: "jw(GIT)"
|
||||
change_type: "前端缺陷"
|
||||
backend_status: "not_required"
|
||||
gateway_status: "not_required"
|
||||
frontend_status: "pending"
|
||||
frontend_owner: "mmg"
|
||||
frontend_ref: ""
|
||||
target_release: ""
|
||||
verified_at: ""
|
||||
status_note: "2026-09-24 jw 在 TEST 团期详情（/order-v2/batch/detail/2101506167098511362，jw测试产品 第1期，已成团 12 户）点「配置导游」勾选两人保存，弹出「团期尚未创建（该班期还没有任何订单），请先建团并完成成团后再操作」（589553）。根因在 hl-ui：团期详情页把路由上的订单侧团期 ID（groupBatchId）传给 GroupBatchStaffConfigModal，弹窗再原样拼进 GET / PUT /v3/admin/group-batch/{productBatchId}/staff 与候选分页接口，而这组接口的路径变量是产品侧排期 ID。后端按产品侧排期 ID 反查团期，拿团期 ID 当排期 ID 查不到，按设计抛 589553。同页「设置主报账人」弹窗传的是 productBatchId，是对的。后端与数据均正常：该团期 order_group_batch 行存在（group_batch_id=2101506167098511362 / product_batch_id=2101502082564407299 / RESOURCE_PREPARING / 子订单 14 张）；order_batch_staff 中按团期 ID 错存的活跃行 0 条，无需修数。本条无后端改动。"
|
||||
updated_at: "2026-09-24"
|
||||
base: dev-v3
|
||||
---
|
||||
|
||||
# 团期详情「配置导游 / 配置摄影」保存报 589553：弹窗传错了 ID
|
||||
|
||||
> **服务**: hl-order-service-v3（**后端零改动，后端与数据均正常**）
|
||||
> **页面**: 管理后台 → 团期订单 → 团期详情 → 「配导游」/「配摄影」Tab → 「配置导游」/「配置摄影」弹窗
|
||||
> **接口**: `GET` / `PUT /v3/admin/group-batch/{productBatchId}/staff`、`GET /v3/admin/group-batch/{productBatchId}/staff/candidates/page`
|
||||
> **日期**: 2026-09-24
|
||||
> **影响范围**: 仅前端。所有团期、所有用户，配置导游 / 配置摄影一保存就失败；人员配置实际一直存不进去
|
||||
|
||||
---
|
||||
|
||||
## 一、现象
|
||||
|
||||
团期已成团，打开「配置导游」，候选列表正常显示，勾选人员点「保存」，右上角报错：
|
||||
|
||||
`团期尚未创建（该班期还没有任何订单），请先建团并完成成团后再操作`
|
||||
|
||||
「已配置人员」一直显示「暂未配置」。同一页的「设置主报账人」正常。
|
||||
|
||||
---
|
||||
|
||||
## 二、根因（对 hl-ui `origin/v2.1` = `9eb8268f` 源码实读）
|
||||
|
||||
**① 详情页传给弹窗的是订单侧团期 ID**
|
||||
|
||||
`src/views/order-v2/batch/detail/index.vue`：
|
||||
|
||||
```vue
|
||||
<!-- :258-263 -->
|
||||
<GroupBatchStaffConfigModal
|
||||
v-model:show="staffConfigShow"
|
||||
:group-batch-id="groupBatchId"
|
||||
:role="staffConfigRole"
|
||||
@saved="onStaffConfigSaved"
|
||||
/>
|
||||
```
|
||||
|
||||
`groupBatchId`（`:454`）取自路由，就是地址栏里的订单侧运营团期 ID（例：`2101506167098511362`）。
|
||||
|
||||
**② 弹窗把它拼进三个接口的路径**
|
||||
|
||||
`src/views/order-v2/batch/detail/components/GroupBatchStaffConfigModal.vue`：
|
||||
|
||||
| 行 | 调用 |
|
||||
|---|---|
|
||||
| `:182` | `getGroupBatchStaff(props.groupBatchId, …)` → `GET /v3/admin/group-batch/{id}/staff` |
|
||||
| `:197` | `getGroupBatchStaffCandidatesPage(props.groupBatchId, …)` → `GET …/{id}/staff/candidates/page` |
|
||||
| `:274` | `saveGroupBatchStaff(props.groupBatchId, …)` → `PUT /v3/admin/group-batch/{id}/staff` |
|
||||
|
||||
**③ 这组接口的路径变量是产品侧排期 ID**
|
||||
|
||||
后端 `GroupBatchStaffAdminController` 四个端点的路径变量都是 `{productBatchId}`（`group_tour_batch.batch_id`）。
|
||||
前端自己的 API 封装 `src/api/orderV2GroupBatch.js` 在 `getGroupBatchStaff` 注释里也写明
|
||||
「`@param groupBatchId 产品侧班期 ID(group_tour_batch.batch_id)`」——**只是参数名起成了 groupBatchId，调用方就按名字传了团期 ID**。
|
||||
|
||||
**④ 为什么只有保存报错**
|
||||
|
||||
- 查询已配置人员（GET staff）按排期 ID 查人员表，传错 ID 只是查到空列表，不报错 → 页面显示「暂未配置」。
|
||||
- 候选分页不校验团期存在性，候选照常出来；但它的返回里已经露了馅：每条记录的 `productBatchId` 回显成了团期 ID、`groupBatchId` 为 `null`（后端认为「这个排期还没建团」）。
|
||||
- 保存（PUT staff）先按排期 ID 反查团期、校验可配置窗口；拿团期 ID 当排期 ID 查不到团期行，按设计返 `589553`。
|
||||
|
||||
**对照**：同页「设置主报账人」弹窗（`index.vue:268-273`）传的是 `:product-batch-id="productBatchId"`（`:756`，取 `detail.productBatchId`），所以它是好的。
|
||||
|
||||
---
|
||||
|
||||
## 三、后端与数据侧的核查结果（均正常，供排除用）
|
||||
|
||||
| 项 | 结果 |
|
||||
|---|---|
|
||||
| 团期是否存在 | `order_group_batch`：`group_batch_id=2101506167098511362`、`product_batch_id=2101502082564407299`、`batch_status=RESOURCE_PREPARING`，子订单 14 张 |
|
||||
| 按错误 ID 反查 | `product_batch_id=2101506167098511362` 的团期行不存在 → 589553 是正确的后端行为 |
|
||||
| 是否有错存数据 | `order_batch_staff` 中 `product_batch_id` 等于某个团期 ID 的活跃行：**0 条**，无需修数 |
|
||||
| 两个 ID 调 GET staff | 均返回 `200` + `[]`（GET 不校验团期存在性，所以传错也不报错） |
|
||||
| 用团期 ID 调候选分页 | `200`，`total=7`，记录里 `productBatchId=2101506167098511362`、`groupBatchId=null` |
|
||||
|
||||
---
|
||||
|
||||
## 四、修复建议
|
||||
|
||||
**最小改动**（一行）：`index.vue:260` 改为传产品侧排期 ID。
|
||||
|
||||
```vue
|
||||
<GroupBatchStaffConfigModal
|
||||
v-model:show="staffConfigShow"
|
||||
:group-batch-id="productBatchId"
|
||||
:role="staffConfigRole"
|
||||
@saved="onStaffConfigSaved"
|
||||
/>
|
||||
```
|
||||
|
||||
弹窗内部读取、候选、保存三处都走这个 prop，会一起变对。
|
||||
|
||||
**建议一并做**：把弹窗 prop 与三个 API 封装的参数名改成 `productBatchId`（与 `ReporterRankModal` / `setGroupBatchStaffReporterRank` 一致），避免下一个调用方再按名字传错。
|
||||
|
||||
**建议补的回归**：`GroupBatchStaffConfigModal.spec.js` / `index.spec.js` 断言保存请求 URL 里的 ID 等于 `detail.productBatchId`，而不是路由 ID——现有弹窗用例只给了一个 `groupBatchId: '2099751575655247875'`，没有同时构造两种 ID，所以传错也测不出来。
|
||||
|
||||
---
|
||||
|
||||
## 五、业务边界
|
||||
|
||||
- 修复后可配窗口按后端现行规则：招募中、资源准备中可配，确认（物料准备中）之后返 `589598`（#8231 / #8269）。
|
||||
- `detail.productBatchId` 为空时（极端情况）应禁用「配置导游 / 配置摄影」按钮，不要拼出 `/group-batch//staff`。
|
||||
- 本条不涉及后端改动，接口契约不变。
|
||||
在新工单中引用
屏蔽一个用户