docs(changelog): 前端任务——订单列表撤掉团期ID精确筛输入框（#8252 遗留入口）

2026-09-24 09:50:57 +08:00
@@ -0,0 +1,101 @@
+---
+schema: "hl-changelog/v2"
+ticket: "frontend"
+title: "订单列表撤掉团期ID精确筛输入框"
+consumer: "admin"
+author: "wx(GIT)"
+change_type: "前端优化"
+backend_status: "not_required"
+gateway_status: "not_required"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "纯前端条目，后端零改动。按 wx 2026-09-24 要求撤掉订单列表（/order-v2/list）筛选区的「团期 ID」精确筛输入框，团期筛选统一走 #8252 交付的「团期」关键词框（团号/团期名/期次）。groupBatchId 入参后端保留不动（#7635 冻结契约，其它页面/链接仍有依赖），前端其它调用点也不得删除。"
+updated_at: "2026-09-24"
+base: "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