From 2f02fbb3a307e74b55e6084b6797bfd2887a18ff Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 27 Sep 2026 21:40:09 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8446=20=E8=AE=A2=E5=8D=95?= =?UTF-8?q?=E5=88=97=E8=A1=A8=20productType=20=E6=9F=A5=E8=AF=A2=E5=8F=82?= =?UTF-8?q?=E6=95=B0=20+=20=E5=89=8D=E7=AB=AF=E8=AE=A2=E5=8D=95=E7=B1=BB?= =?UTF-8?q?=E5=9E=8B=E6=94=B9=E9=A1=B5=E7=AD=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 接口：GET /v3/admin/order（含 /list 别名）与 /status-group-counts 新增 productType，测试服实测样本与读数 - 前端：订单列表「订单类型」下拉改为核心 / 定制 / 团期页签（交 mmg） Refs wx/HL#8446 Co-Authored-By: Claude Opus 5.5 (1M context) --- ...单列表按产品类型筛选-修改接口-管理后台.md | 375 ++++++++++++++++++ ...单列表订单类型改页签-前端优化-管理后台.md | 121 ++++++ 2 files changed, 496 insertions(+) create mode 100644 changelogs-v2/2026-09/27_8446_订单列表按产品类型筛选-修改接口-管理后台.md create mode 100644 changelogs-v2/2026-09/27_frontend_订单列表订单类型改页签-前端优化-管理后台.md diff --git a/changelogs-v2/2026-09/27_8446_订单列表按产品类型筛选-修改接口-管理后台.md b/changelogs-v2/2026-09/27_8446_订单列表按产品类型筛选-修改接口-管理后台.md new file mode 100644 index 00000000..3a8c1a07 --- /dev/null +++ b/changelogs-v2/2026-09/27_8446_订单列表按产品类型筛选-修改接口-管理后台.md @@ -0,0 +1,375 @@ +--- +schema: "hl-changelog/v2" +ticket: "8446" +title: "订单列表与状态计数新增查询参数 productType（核心 / 定制 / 团期页签）" +consumer: "admin" +author: "wx(GIT)" +change_type: "修改接口" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "PR #8454 已合入 dev-v3（22145977d），order-v3 已部署测试服，经网关实测三个端点。新增查询参数 productType，与其他条件取 AND；只传 productType、不传 orderKind 时不按团属性过滤。前端改动见同日前端 changelog。" +updated_at: "2026-09-27" +base: "dev-v3" +--- + +# 订单服务(order-v3): 订单列表与状态计数新增查询参数 productType + +> **服务**: hl-order-service-v3（端口 8086/8186） +> **PR**: #8454（合并提交 `22145977d`） +> **Issue**: #8446 +> **日期**: 2026-09-27 +> **影响范围**: 管理后台「订单管理v2 › 订单列表」的列表与状态计数接口 + +--- + +## ⚠️ 关键变化 + +1. 列表 `GET /v3/admin/order`（别名 `/v3/admin/order/list`）与状态计数 `GET /v3/admin/order/status-group-counts` 新增查询参数 **`productType`**：`CORE` / `ROUTE` / `CUSTOM` / `GROUP`，英文逗号多值，空串等同不传。 +2. **只传 `productType`、不传（或传空串）`orderKind` 时，不再缺省 `orderKind=NORMAL`，不按「是否挂团期」过滤。** 页签「团期」因此能查到团期订单。 +3. 其余组合行为不变：显式传 `orderKind` 与 `productType` 取 AND；传 `groupBatchId` / `groupBatchKeyword` 时仍强制按团期，再与 `productType` 取 AND。两个参数都不传时仍缺省 NORMAL。 +4. 非法值（如 `productType=XYZ`）返回 HTTP 200 + `code=100001`，与 `orderKind` 非法值同码。 +5. 响应结构不变。 + +--- + +## 一、背景 + +wx 2026-09-27 要求订单列表的「订单类型」下拉（散客 / 团单 / 全部）改成「核心 / 定制 / 团期」页签。页签按**产品类型**切分，而原 `orderKind` 按「订单有没有挂运营团期」切分，两者不是同一口径，所以新增 `productType`，`orderKind` 保留原语义不废弃。 + +--- + +## 二、变更接口清单 + +| # | 接口 | 方法 | 路径 | 变更类型 | 说明 | +|---|------|------|------|----------|------| +| 1 | 订单列表 | GET | `/v3/admin/order` | 新增参数 | `productType`，别名路径 `/v3/admin/order/list` 同样生效 | +| 2 | 订单列表 Tab 分组计数 | GET | `/v3/admin/order/status-group-counts` | 新增参数 | `productType`，与列表同口径 | + +--- + +## 三、接口详情 + +### 1. 订单列表 `GET /v3/admin/order` + +**VO**: `OrderListReqVO` → `Result>` + +#### 使用场景 + +订单列表页签「核心 / 定制 / 团期」切换时，按当前页签传 `productType=CORE|CUSTOM|GROUP` 取列表。 + +#### 入参字段表 + +| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | +|------|------|------|------|------|------| +| productType | query | String | 否 | `CORE`/`ROUTE`/`CUSTOM`/`GROUP`，多值用英文逗号分隔（如 `CORE,CUSTOM`），空串等同不传 | **新增**。按订单产品类型过滤，与其他条件取 AND | +| orderKind | query | String | 否 | `ALL`/`GROUP`/`NORMAL`，空串等同不传 | 原有。未传时缺省 NORMAL；**例外**：传了 productType 而本参数未传或为空串时不缺省、不按团属性过滤 | + +其余参数（`keyword`、`orderStatus`、`statusGroup`、`groupBatchId`、`groupBatchKeyword`、`page`、`pageSize` 等）不变，`pageSize` 上限 100。 + +#### 出参字段表 + +| 字段 | 类型 | 说明 | +|------|------|------| +| data.records[] | Array | 订单行（前端 `request.js` 拦截器会同步映射为 `list`） | +| data.records[].id | String | 订单 ID | +| data.records[].productType | String | 产品类型 CORE/ROUTE/CUSTOM/GROUP | +| data.total | Number | 符合条件的总条数 | +| data.page | Number | 当前页 | +| data.pageSize | Number | 每页条数 | + +订单行其余字段不变。 + +#### 请求示例 + +```http +GET /v3/admin/order?productType=CORE&page=1&pageSize=100 +``` + +#### 响应示例 + +测试服 2026-09-27 实测，节选前 2 条、每条只保留关键字段： + +```json +{ + "code": 200, + "message": "成功", + "success": true, + "data": { + "total": 71, + "page": 1, + "pageSize": 100, + "records": [ + { + "id": "2104192144560553985", + "orderNo": "HL20260927205115753", + "productType": "CORE", + "groupBatchId": null, + "orderStatus": "CUSTOMIZING" + }, + { + "id": "2104161383220457474", + "orderNo": "HL20260927184901765", + "productType": "CORE", + "groupBatchId": null, + "orderStatus": "CUSTOMIZING" + } + ] + } +} +``` + +#### 空数据 / 降级响应 + +没有符合条件的订单时 `records` 为空数组、`total` 为 0，例如 `productType=CORE` 加一个只挂了团期订单的团期关键词。 + +```json +{ + "code": 200, + "message": "成功", + "success": true, + "data": { + "total": 0, + "page": 1, + "pageSize": 20, + "records": [] + } +} +``` + +#### 错误响应 + +非法值返回 HTTP 200，`code=100001`（测试服实测原文）： + +```json +{ + "code": 100001, + "message": "productType 非法，可选值: CORE, ROUTE, CUSTOM, GROUP（多值用逗号分隔）", + "data": null, + "traceId": null, + "success": false +} +``` + +#### 业务边界 + +- 多值用英文逗号，命中任一即返回；空串等同不传。 +- 只传 `productType` 时不按团属性过滤；默认仍排除已取消订单，传 `statusGroup=ALL` 才含已取消（与原口径一致）。 +- 显式传 `orderKind` 时与 `productType` 取 AND，例如 `productType=GROUP&orderKind=NORMAL` 恒为空。 +- 传 `groupBatchId` / `groupBatchKeyword` 时强制按团期，再与 `productType` 取 AND；在「核心 / 定制」页签下填团期关键词，只会查到挂了该团期、且产品类型是核心 / 定制的订单。 +- `ROUTE`（自驾路书）后端接受，本次前端不设页签。 +- 别名 `/v3/admin/order/list` 入参出参完全相同。 + +--- + +### 2. 订单列表 Tab 分组计数 `GET /v3/admin/order/status-group-counts` + +**VO**: `OrderListReqVO` → `Result>` + +#### 使用场景 + +页签切换时与列表一起请求，传同一个 `productType`，刷新顶部状态分组徽标。 + +#### 入参字段表 + +| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | +|------|------|------|------|------|------| +| productType | query | String | 否 | `CORE`/`ROUTE`/`CUSTOM`/`GROUP`，多值用英文逗号分隔，空串等同不传 | **新增**。与列表同口径 | +| orderKind | query | String | 否 | `ALL`/`GROUP`/`NORMAL`，空串等同不传 | 原有。与列表同口径，含上面的例外 | + +其余参数与列表相同（不传 `statusGroup` / `orderStatus` / `page` / `pageSize`）。 + +#### 出参字段表 + +| 字段 | 类型 | 说明 | +|------|------|------| +| data[].group | String | 分组标识，固定 6 项，顺序 ALL、BEFORE_TRIP、ON_TRIP、SETTLEMENT、ABNORMAL、AFTERSALE | +| data[].label | String | 分组中文名：全部 / 出行前 / 出行中 / 核单 / 异常/取消 / 售后 | +| data[].orderCount | Number | 该分组订单数 | + +#### 请求示例 + +```http +GET /v3/admin/order/status-group-counts?productType=GROUP +``` + +#### 响应示例 + +测试服 2026-09-27 实测原文： + +```json +{ + "code": 200, + "message": "成功", + "data": [ + { "group": "ALL", "label": "全部", "orderCount": 14 }, + { "group": "BEFORE_TRIP", "label": "出行前", "orderCount": 14 }, + { "group": "ON_TRIP", "label": "出行中", "orderCount": 0 }, + { "group": "SETTLEMENT", "label": "核单", "orderCount": 0 }, + { "group": "ABNORMAL", "label": "异常/取消", "orderCount": 8 }, + { "group": "AFTERSALE", "label": "售后", "orderCount": 0 } + ], + "traceId": null, + "success": true +} +``` + +#### 空数据 / 降级响应 + +没有符合条件的订单时 6 项仍全部返回，`orderCount` 均为 0。 + +```json +{ + "code": 200, + "message": "成功", + "data": [ + { "group": "ALL", "label": "全部", "orderCount": 0 }, + { "group": "BEFORE_TRIP", "label": "出行前", "orderCount": 0 }, + { "group": "ON_TRIP", "label": "出行中", "orderCount": 0 }, + { "group": "SETTLEMENT", "label": "核单", "orderCount": 0 }, + { "group": "ABNORMAL", "label": "异常/取消", "orderCount": 0 }, + { "group": "AFTERSALE", "label": "售后", "orderCount": 0 } + ], + "traceId": null, + "success": true +} +``` + +#### 错误响应 + +与列表相同，非法值返回 HTTP 200 + `code=100001`（测试服实测原文）： + +```json +{ + "code": 100001, + "message": "productType 非法，可选值: CORE, ROUTE, CUSTOM, GROUP（多值用逗号分隔）", + "data": null, + "traceId": null, + "success": false +} +``` + +#### 业务边界 + +- 与列表共用 `OrderListReqVO` 和同一套过滤，页签徽标与列表条数同口径。 +- 「全部」= 出行前 + 出行中 + 核单，**不含**「异常/取消」，只有显式 `orderKind=ALL` 或 `cancelled=true` 时才计入。只传 `productType` 时不含，与两个参数都不传时一致。上例 14 = 14 + 0 + 0。 +- 「售后」是横切计数，任何情况下都不计入「全部」。 + +--- + +## 四、契约约束与正确调用方式 + +- 页签「核心 / 定制 / 团期」→ 列表与计数都传 `productType=CORE|CUSTOM|GROUP`，**不传 `orderKind`**。 +- 如果仍带着旧的 `orderKind=NORMAL`，会与 `productType` 取 AND，「团期」页签恒为空。 +- 旧调用方（只传 `orderKind` 或都不传）行为不变。 + +| 组合 | 结果 | +|------|------| +| `productType=CORE` | 核心产品订单，不看是否挂团期 | +| `productType=CORE,CUSTOM` | 核心 + 定制 | +| `productType=GROUP&orderKind=NORMAL` | 恒为空 | +| 两个都不传 | 缺省 NORMAL（未挂团期的订单），与改动前一致 | +| `productType=XYZ` | HTTP 200，`code=100001` | + +--- + +## 五、数据库行为 + +无数据库变更，只新增查询条件 `product_type IN (...)`。 + +--- + +## 六、边界行为 + +1. `productType` 是独立追加的 AND 条件，不进团属性判断链，所以不会和 `groupBatchId` / `groupBatchKeyword` 互相吞掉（`OrderListScopeFilter.java:44`、`:54-55`）。 +2. 只传 `productType` 时 Service 把 `orderKind` 置 null 而不是 `ALL`：置 `ALL` 会让「全部」徽标计入已取消（`OrderService.java:529`）。 +3. `ROUTE` 测试服当前产品与订单都是 0 条，后端已支持，将来加页签无需改后端。 + +--- + +## 六.5、枚举 / 数据字典 + +### productType（产品类型） + +**所属字段**: 入参 `OrderListReqVO.productType`、出参 `records[].productType` | **类型**: `String` + +| 值 | 中文 | 页签 | +|----|------|------| +| `CORE` | 核心 | 核心 | +| `CUSTOM` | 定制 | 定制 | +| `GROUP` | 团期 | 团期 | +| `ROUTE` | 自驾路书 | 本次不设 | + +--- + +## 六.6、修改前后对比 + +| 场景 | 改前 | 改后 | +|------|------|------| +| 入参 `productType` | 无 | 新增，多值 | +| 只传 `productType`、不传 `orderKind` | —（参数不存在） | 不缺省 NORMAL，不按团属性过滤 | +| 只传 `orderKind` 或都不传 | 都不传时缺省 NORMAL | 不变 | + +--- + +## 六.7、影响评估 + +- **向后兼容**：是。不传 `productType` 的调用方行为不变。 +- **前端是否必须同步**：前端改页签时列表与计数都要改传 `productType`、删掉 `orderKind`；不改前端时现有下拉照常可用。 + +--- + +## 七、不影响范围 + +- 订单详情、创建、编辑等其他接口不变。 +- 定制师待办列表（`DesignerOrderListService`）、财务订单查询（`FinanceOrderQueryApiImpl`）复用同一查询对象但不设 `productTypes`，行为不变。 +- 小程序（`MpOrderListReqVO`）、H5 不涉及。 + +--- + +## 八、测试环境已验证 + +测试服 order-v3 `22145977d`，经网关、测试专用 ADMIN 账号，逐条与同条件 SQL（`hl_order_service_v3.order_main`，`deleted_at IS NULL`，默认排除已取消）比对，全部一致： + +| 请求 | total / 计数 | SQL | +|------|------|------| +| `productType=CORE` / `CUSTOM` / `GROUP` | 71 / 2 / 14，逐条 productType 全匹配 | 71 / 2 / 14 | +| 同上 + `statusGroup=ALL` | 86 / 2 / 22 | 86 / 2 / 22 | +| `/v3/admin/order/list?productType=GROUP` | 14 | 与主路径相同 | +| `productType=CORE,CUSTOM` | 73 | 71 + 2 | +| `productType=`（空串）/ 都不传 | 73 / 73 | NORMAL 口径 73 | +| `orderKind=GROUP` / `orderKind=ALL` | 14 / 87 | 14 / 87 | +| 计数 `productType=GROUP` | 全部 14、出行前 14、出行中 0、核单 0、异常/取消 8、售后 0 | 逐组一致 | +| 计数不传 productType | 全部 73、出行前 43、出行中 0、核单 30、异常/取消 15、售后 0 | 与上一行不同，参数生效 | +| 团期关键词 / + `productType=GROUP` / + `productType=CORE` | 12 / 12 / 0 | 该团期 CORE 订单 0 条 | +| `productType=XYZ`（列表、计数） | HTTP 200，`code=100001` | — | + +单测：OrderServiceTest 323、OrderListScopeFilterTest 18、OrderListReqVOValidationTest 16、OrderGlobalExceptionHandlerTest 9、OrderControllerTest 56、OrderInfoMapperIT 30（Testcontainers 真库），全绿。 + +--- + +## 十、相关文档 + +- 接口文档：`docs/order-v3/api/API-SPEC.html`（订单列表参数表、orderKind 例外、§1.11 计数口径） +- 入参：`hl-order-service-v3/src/main/java/com/hulalv/order/core/controller/admin/vo/OrderListReqVO.java:91-104`（productType）、`:59-63`（orderKind 例外说明） +- 过滤：`hl-order-service-v3/src/main/java/com/hulalv/order/core/mapper/OrderListScopeFilter.java:54-55` +- 错误码：`hl-order-service-v3/src/main/java/com/hulalv/shared/exception/OrderGlobalExceptionHandler.java:104-110` + +--- + +## 关联 / 联系人 + +### 链接 + +- **Issue**: [#8446](https://git.1814.love/wx/HL/issues/8446) +- **PR**: [#8454](https://git.1814.love/wx/HL/pulls/8454) +- **前端 changelog**: `27_frontend_订单列表订单类型改页签-前端优化-管理后台.md` + +### 联系人 + +- **后端负责人**: @wx +- **前端负责人**: @mmg diff --git a/changelogs-v2/2026-09/27_frontend_订单列表订单类型改页签-前端优化-管理后台.md b/changelogs-v2/2026-09/27_frontend_订单列表订单类型改页签-前端优化-管理后台.md new file mode 100644 index 00000000..9ba3204c --- /dev/null +++ b/changelogs-v2/2026-09/27_frontend_订单列表订单类型改页签-前端优化-管理后台.md @@ -0,0 +1,121 @@ +--- +schema: "hl-changelog/v2" +ticket: "8446" +title: "订单列表「订单类型」下拉改为「核心 / 定制 / 团期」页签" +consumer: "admin" +author: "wx(GIT)" +change_type: "前端优化" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端查询参数 productType 已部署测试服并实测（#8446，PR #8454）。前端：订单列表「订单类型」下拉改为「核心 / 定制 / 团期」页签，默认核心；列表与状态计数请求传 productType，不再传 orderKind。" +updated_at: "2026-09-27" +base: "dev-v3" +--- + +# 前端优化：订单列表「订单类型」下拉改为「核心 / 定制 / 团期」页签 + +## ⚠️ 关键变化 + +1. **订单管理v2 › 订单列表**：删除搜索区「订单类型」下拉（散客 / 团单 / 全部，默认散客），改为表格工具栏左侧的页签「核心 / 定制 / 团期」，默认「核心」。样式同「财务管理 › 核单列表」的「常规产品 / 团期产品」页签。 +2. **列表请求与状态计数请求都传当前页签的 `productType=CORE|CUSTOM|GROUP`，不再传 `orderKind`。** + - 限定：如果请求里还带着 `orderKind=NORMAL`，后端会与 `productType` 取 AND，「团期」页签恒为空（团期订单都挂了团期）。 + +--- + +## 一、背景 + +wx 2026-09-27：「把订单列表的页面的类型也换成tab 也是 核心/定制/团期」。页签按订单**产品类型**切分，与同日房务管家订单列表的页签口径一致。原「散客 / 团单」按「订单有没有挂团期」切分，和产品类型不是一回事。 + +后端新增查询参数 `productType`（#8446，PR #8454），契约详见同日接口 changelog `27_8446_订单列表按产品类型筛选-修改接口-管理后台.md`。 + +--- + +## 二、现状（hl-ui `origin/v2.1` @ `1c555f5`，逐行核过） + +文件 `src/views/order-v2/list/index.vue`： + +| 位置 | 现状 | +|------|------| +| `:55-64` | 搜索区「订单类型」`n-select`：`v-model:value="searchForm.orderKind"`、`:options="orderKindOptions"`、`@update:value="handleSearch"` | +| `:139` | `import { …, ORDER_KIND_OPTIONS } from '@/api/orderV2'` | +| `:234-235` | `const orderKindOptions = ORDER_KIND_OPTIONS` 及 #7635 注释 | +| `:236-255` | `adaptedApi.getPage`：`searchForm` 除日期 / 定制师 / 标签外的字段经 `...rest` 原样透传给 `getOrderPage` | +| `:279-280` | `useListPage` 的 `searchFields`：`{ key: 'orderKind', default: 'NORMAL' }` | +| `:306-308`、`:322-323` | `fetchGroupCounts` 手工拼参数：`if (searchForm.orderKind) params.orderKind = searchForm.orderKind`，以及描述入参的注释 | +| `:344-347` | `handleSearch()`：`doSearch()` 刷列表 + `fetchGroupCounts()` 刷状态计数 | +| `:103-120` | ProTable `#toolbar`：左「共 N 条」，右「新增订单」按钮 | + +`src/api/orderV2.js`：`:25-33` 定义 `ORDER_KIND` / `ORDER_KIND_OPTIONS`；`getOrderPage`（`:114`）与 `getOrderStatusGroupCounts`（`:137`）的 jsdoc 列了 `orderKind`（`:108`、`:133`）。 + +--- + +## 三、改动要点 + +1. **删除下拉**：删掉 `index.vue:55-64` 整个「订单类型」`form-item`、`:234-235` 的 `orderKindOptions`、`:139` 的 `ORDER_KIND_OPTIONS` import。 +2. **搜索字段**：`:279-280` 的 `{ key: 'orderKind', default: 'NORMAL' }` 改为 `{ key: 'productType', default: 'CORE' }`。列表请求经 `...rest` 自动带上 `productType`，`adaptedApi.getPage` 不用改。 +3. **状态计数**：`:322-323` 改为 `if (searchForm.productType) params.productType = searchForm.productType`，`:306-308` 注释里的 `orderKind` 同步改成 `productType`。 +4. **页签**：放在 ProTable `#toolbar` 左侧，写法照核单列表 `src/views/finance/settlement/index.vue:52-66`：外层 ``，左边页签，右边放现有的「共 N 条」和「新增订单」按钮。样式照该文件 `:213-219`：`.table-summary { width: 100%; }`、`.product-tabs { width: 280px; }`。 + + ```vue + + 核心 + 定制 + 团期 + + ``` + + ```js + // 切页签 = 原下拉的 @update:value="handleSearch"：列表与状态计数一起刷新 + function onProductTypeChange(v) { + searchForm.productType = v + handleSearch() + } + ``` + + 核单列表用的是 `v-model:value`，切换时不发请求，这里不能照抄。 +5. **重置**：「重置」走 `doReset`，按 `searchFields` 默认值把页签恢复为「核心」，与原下拉重置回「散客」同构，不用额外处理。 +6. **`src/api/orderV2.js`**：`getOrderPage` 与 `getOrderStatusGroupCounts` 的 jsdoc 补 `productType`。`ORDER_KIND` / `ORDER_KIND_OPTIONS` 列表页不再使用；如果删除，同步删 `src/api/__tests__/orderV2.spec.js:444-448` 的断言，保留也不影响功能。 + +--- + +## 四、调用时会撞上的限定 + +- `productType` 取 `CORE` / `CUSTOM` / `GROUP`。后端还接受 `ROUTE`（自驾路书），本次不设页签。非法值返回 HTTP 200 + `code=100001`。 +- 不传 `orderKind` 时，后端不再按「是否挂团期」过滤，只按产品类型分。状态计数「全部」的取消口径与不传 `productType` 时一致。 +- **「团期」关键词输入框**（`groupBatchKeyword`，`index.vue:67-76`）：填了关键词时，后端只查挂了命中团期的订单，再与 `productType` 取 AND。在「核心 / 定制」页签下填团期关键词，结果基本为空（测试服当前没有「核心产品却挂了团期」的订单）。建议该输入框只在「团期」页签显示，由前端决定。 +- 响应结构不变：列表后端返回 `{ records, total, page, pageSize }`，`src/utils/request.js:445` 拦截器已映射为 `list`，前端照旧读 `res.list`；状态计数 `[{ group, label, orderCount }]` 固定 6 项。 + +--- + +## 五、验证清单（前端改完自查） + +- [ ] 订单列表不再有「订单类型」下拉，工具栏左侧出现「核心 / 定制 / 团期」页签，默认「核心」 +- [ ] 切换页签时，列表与顶部状态分组计数一起刷新；两个请求的 query 都带 `productType`，不带 `orderKind` +- [ ] 「团期」页签有数据；「核心」页签不再混入团期订单 +- [ ] 点「重置」回到「核心」 +- [ ] 若删了 `ORDER_KIND_OPTIONS`，`orderV2.spec.js` 断言同步删除，单测绿 + +--- + +## 六、不影响范围 + +- 订单详情、出团管理、房务管家订单列表不涉及 +- 小程序、H5 不涉及 + +--- + +## 联系人 + +- **后端负责人**: @wx +- **前端负责人**: @mmg