5.6 KiB
5.6 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | frontend | 订单列表撤掉团期ID精确筛输入框 | admin | wx(GIT) | 前端优化 | not_required | not_required | verified | mmg | 45d946d615082e4c6fa3221b1bbc48fa2bb89cb9 | v2.1 | 2026-09-24 | 纯前端条目，后端零改动。按 wx 2026-09-24 要求撤掉订单列表（/order-v2/list）筛选区的「团期 ID」精确筛输入框，团期筛选统一走 #8252 交付的「团期」关键词框（团号/团期名/期次）。groupBatchId 入参后端保留不动（#7635 冻结契约，其它页面/链接仍有依赖），前端其它调用点也不得删除。 前端 2026-09-24 闭环 verified:筛选区「团期 ID」form-item/searchFields 项/fetchGroupCounts 透传 3 处全删并清理死引用注释,groupBatchKeyword(团号/团期名/期次)成唯一团期筛选入口;groupBatchId 入参契约保留,列表与六页签计数不再携带(hl-admin 45d946d6)。checkpoint 全过,列表 __tests__ 实证无引用。 | 2026-09-24 | dev-v3 |
订单列表撤掉团期 ID 精确筛输入框（前端优化）
页面: 管理后台「订单管理v2 → 订单列表」
/order-v2/list文件:src/views/order-v2/list/index.vue代码基线:origin/v2.1（2026-09-24 取，该文件最新改动 5f27c009） 日期: 2026-09-24 后端: 零改动，GET /v3/admin/order出入参不变
⚠️ 关键变化
团期筛选收敛为一个入口：按团号 / 团期名 / 期次检索的「团期」关键词框（#8252 已交付）。 撤掉「团期 ID」精确筛输入框——不再要求定制师/运营手输 19 位雪花运营团期 ID。
一、调整清单
1.1 删除筛选区的「团期 ID」输入框
src/views/order-v2/list/index.vue:65-73 现状：label 为「团期 ID」，placeholder 为 运营团期 ID(强制团单)，
v-model:value="searchForm.groupBatchId"。
文案提示：早期构建的 placeholder 是「运营团期 ID(定制团期)」（截图即该版本），现已改为「强制团单」。 请按
searchForm.groupBatchId绑定定位，不要按文案找。
三处一起收拾干净，避免留下死字段：
| # | 位置 | 现状 | 改法 |
|---|---|---|---|
| 1 | index.vue:65-73 |
团期 ID 的 form-item（含 n-input） |
整块删除 |
| 2 | index.vue:292 |
searchFields 中的 { key: 'groupBatchId', default: '' } |
删除该行 |
| 3 | index.vue:336 |
fetchGroupCounts() 中 if (searchForm.groupBatchId) params.groupBatchId = ... |
删除该行（页签计数与列表同口径） |
- 列表请求侧：
groupBatchId只经searchFields透传（同文件:244-245注释），删掉第 2 处后列表请求自然不再携带该参数。 - 无 URL 依赖：本页
syncUrl: false（:296），筛选不入 URL、也不消费 URL 入参，删除不影响任何跳转或刷新恢复。 - 无测试引用：列表模块内除
index.vue外没有第二处引用（含src/views/order-v2/list/__tests__/**），无需改测试。
1.2 保留不动（禁止顺手删）
| 保留项 | 位置 | 原因 |
|---|---|---|
「团期」关键词框 groupBatchKeyword |
index.vue:77-86、:294、:338 |
#8252 交付的团期筛选正主（团号/团期名/期次，maxlength 64），本次唯一保留的团期筛选入口 |
「订单类型」orderKind（NORMAL/GROUP/ALL） |
index.vue:55-64、:291、:335 |
#7635 的团属性筛选仍然需要；撤掉 ID 框后「只看团单」走这里，不再依赖「输 ID 强制 GROUP」 |
行级团期展示字段 groupBatchName / groupBatchLabel |
index.vue:212-215 |
#8252「第N期 团期名」列展示，与筛选无关 |
1.3 接口契约不变（groupBatchId 后端保留）
GET /v3/admin/order（别名 /v3/admin/order/list）与 GET /v3/admin/order/status-group-counts 的
可选入参 groupBatchId 照旧可用，本次只是管理后台不再露出输入入口：
- #8252 定案第 2 条原文：「是否改动既有
groupBatchId入参 → 保留不动，只新增groupBatchKeyword」； 依据是它属 #7635 冻结契约、有专门错误码兜底，且订单详情/团期看板侧仍有依赖。 - 因此其他页面/调用点不得同步删除
groupBatchId的调用能力，本页只是不再提供输入框。
二、验收
/order-v2/list筛选区不再出现「团期 ID / 运营团期 ID」输入框- 列表请求（
getOrderPage）与页签计数请求（getOrderStatusGroupCounts）都不再携带groupBatchId - 「团期」关键词框仍按团号/团期名/期次检索，列表与六个页签计数同口径
- 「订单类型」NORMAL/GROUP/ALL 切换后列表与页签计数同步刷新
- 点「重置」后回到：订单类型 NORMAL、出发日期今年至今、团期关键词为空
三、不影响范围
- 后端接口出入参、错误码、网关路由、权限码零变化；无 DDL、无 Flyway。
- 小程序端零影响；其它调用
groupBatchId的页面零影响。 - 订单列表列渲染（含团单行「第N期 团期名」）保持原样。
关联 / 联系人
- 需求出处：wx 2026-09-24 口述（圈出该筛选条件，要求去掉）
- 关联工单：#8252（订单列表团期筛选改为按团期名/期次检索）、#8261（其实现 PR）、#7635（引入
groupBatchId精确筛，本次撤掉其前端入口） - 后端：wx（本条目后端零改动）
- 前端：mmg