docs(changelog): 回写 #7635 重开修复验收

2026-09-14 16:02:16 +08:00
@@ -10,10 +10,10 @@ gateway_status: "verified"
 frontend_status: "verified"
 frontend_owner: "mmg"
 frontend_ref: "261dc0aa60514cc4725a0b9b52899d044c91cf15"
-target_release: ""
+target_release: "hl-ui@261dc0aa"
 verified_at: "2026-09-14"
-status_note: "后端测试服 ca252347e 已部署并经网关 35 请求验证；破坏性缺省行为变更，前端筛选控件仍 pending，生产必须同批上线【前端 2026-09-14 交付 verified】orderV2.js getOrderPage/getOrderStatusGroupCounts 透传 orderKind/groupBatchId+新增 ORDER_KIND 常量与选项(散客/团单/全部);order-v2/list/index.vue 搜索区加订单类型下拉(初值 NORMAL 切换即刷)+团期 ID 输入,Tab 计数同组团属性切换同刷,清空按 NORMAL(空串省略=NORMAL 与后端缺省一致),groupBatchId 非空强制 GROUP 后端处理。orderV2.spec 3 例,checkpoint 13 项全绿(全量 Vitest+生产构建)。ref=261dc0aa。"
-updated_at: "2026-09-13"
+status_note: "重开修复 fbf86094f 经 PR #7678 合入 dev-v3；测试服 dev-v3@83c1b1743（包含 merge 7f5bc6ee7）已部署，order-v3/gateway 取证前后均 0/N ok。缺省 NORMAL/GROUP 的 ABNORMAL、AFTERSALE 徽标现严格等于点击对应 Tab 的列表 total；缺省 ALL 仍排除取消，显式 ALL 保留含取消历史口径，AFTERSALE 不并入 ALL。网关/DB 8 项断言全绿，临时夹具已精确恢复。【前端 2026-09-14 交付 verified】orderV2.js getOrderPage/getOrderStatusGroupCounts 透传 orderKind/groupBatchId+新增 ORDER_KIND 常量与选项(散客/团单/全部);order-v2/list/index.vue 搜索区加订单类型下拉(初值 NORMAL 切换即刷)+团期 ID 输入,Tab 计数同组团属性切换同刷,清空按 NORMAL(空串省略=NORMAL 与后端缺省一致),groupBatchId 非空强制 GROUP 后端处理。orderV2.spec 3 例,checkpoint 13 项全绿(全量 Vitest+生产构建)。ref=261dc0aa。生产必须前后端同批上线。"
+updated_at: "2026-09-14"
 base: "dev-v3"
 generated: "2026-09-13T16:41:30+08:00"
 ---
@@ -21,7 +21,7 @@ generated: "2026-09-13T16:41:30+08:00"
 # 订单列表补 orderKind/groupBatchId 筛选并将缺省改为散客

 > **服务**: hl-order-service-v3
-> **PR**: #7650
+> **PR**: #7650（原实现）/ #7678（重开修复）
 > **Issue**: #7635
 > **日期**: 2026-09-13
 > **影响范围**: 管理后台订单列表与顶部 Tab 计数
@@ -44,7 +44,7 @@ generated: "2026-09-13T16:41:30+08:00"
 | # | 接口 | 方法 | 路径 | 变更类型 | 说明 |
 |---|---|---|---|---|---|
 | 1 | 管理端订单列表 | GET | `/v3/admin/order` | 修改接口 | 新增 `orderKind` / `groupBatchId`，缺省改为 NORMAL |
-| 2 | 订单列表 Tab 分组计数 | GET | `/v3/admin/order/status-group-counts` | 修改接口 | 复用团属性筛选；缺省计数与列表一致，显式 ALL 保留改前数字 |
+| 2 | 订单列表 Tab 分组计数 | GET | `/v3/admin/order/status-group-counts` | 修改接口 | 每个徽标与点击对应 Tab 后的列表宇宙一致；显式 ALL 保留改前口径 |

 ## 三、接口详情

@@ -140,9 +140,17 @@ GET /v3/admin/order?page=1&pageSize=20&orderKind=GROUP
 |---|---|---|:---:|---|---|
 | orderKind | Query | String | 否 | ALL / GROUP / NORMAL；空串按缺省 | 与列表一致，缺省 NORMAL |
 | groupBatchId | Query | Long | 否 | Snowflake ID；非数字返回 100001 | 精确团期，非空时强制 GROUP |
-| cancelled | Query | Boolean | 否 | true / false | NORMAL/GROUP 与列表对齐；显式 ALL 为 AC-6 保留改前含取消计数 |
+| cancelled | Query | Boolean | 否 | true / false | 裸列表与 ALL 行沿用入参；各 status-group 徽标按点击该 Tab 时列表实际归一化后的 cancelled 语义计算 |
 | 其它公共筛选 | Query | 多种 | 否 | 既有约束 | keyword、出发日期、顾问、来源和标签等继续 AND |

+#### 徽标 / 点击列表一致性（2026-09-14 重开修订）
+
+- 每个徽标必须等于携带同一公共筛选与团属性筛选、再点击该 `statusGroup` 时列表返回的 `total`；不能复用裸列表缺省 `cancelled=false` 去排除该 Tab 本来应展示的取消单。
+- `ABNORMAL` 点击后列表强制纳入取消单，因此 NORMAL、GROUP 和指定团期的 ABNORMAL 徽标也必须纳入对应取消单。
+- `AFTERSALE` 点击后列表强制纳入取消单，因此 `order_status=CANCELLED AND aftersale_status=IN_PROGRESS` 仍计入 AFTERSALE 徽标。
+- `ALL` 不是六个徽标之和：AFTERSALE 是横切分组，永不汇入 ALL；缺省 NORMAL/GROUP ALL 排除 ABNORMAL，只有显式 `orderKind=ALL` 或 `cancelled=true` 时 ALL 纳入 ABNORMAL。
+- 判团依据仍只有 `order_main.group_batch_id`；本轮未改变 Controller、VO/DTO、Feign 或共享 Java 签名。
+
 #### 出参 `Result<List<StatusGroupCountVO>>`

 | 字段 | 类型 | 说明 |
@@ -210,7 +218,7 @@ GET /v3/admin/order/status-group-counts?orderKind=ALL
 #### 业务边界

 - 不传团属性参数时，ALL Tab 等于缺省散客列表 total，并缺省排除已取消。
- GROUP/指定团期按列表 cancelled 口径；显式 `orderKind=ALL` 的六个 Tab 严格保持改动前含取消口径。
+- 每个 status-group 徽标按点击对应 Tab 后的实际列表 `cancelled` 语义；ABNORMAL/AFTERSALE 均纳入该 Tab 应展示的取消单。显式 `orderKind=ALL` 的 ALL 行保留含 ABNORMAL 口径。
 - `orderStatus` / `flowStatus` / `statusGroup` 仍按既有 Tab 语义不缩窄计数基数。

 ## 四、契约约束与正确调用方式（接口类必写）
@@ -244,7 +252,7 @@ GET /v3/admin/order/status-group-counts?orderKind=ALL
 1. 在管理后台订单列表增加 NORMAL / GROUP / ALL 控件，初始值 NORMAL。
 2. 切换团属性后同时刷新列表和 Tab；选择团期时传 groupBatchId。
 3. 查看旧全集时显式传 ALL；不要依赖省略参数。
-4. 与后端同批上生产；本 changelog 的 frontend_status 在前端完成前保持 pending。
+4. 与后端同批上生产；前端已在 `261dc0aa` 完成并验证，`frontend_status=verified`。

 ## 六.6、修改前后对比

@@ -279,24 +287,27 @@ GET /v3/admin/order/status-group-counts?orderKind=ALL

 ## 八、测试环境已验证

- 定向测试：focused reactor 351 tests，0 failures/errors/skips，含 Docker OrderInfoMapperIT 与 ArchTest。
- 网关验证：测试服提交 ca252347e；35 个 GET 请求、17 项断言全绿。缺省/NORMAL=171、GROUP=84、ALL=255；显式 ALL 各 Tab 保持改前 323/228/0/27/68/0；cancelled=true 三档 list/count 为 208/208、115/115、323/323。
- 回归：Designer total=17、首页 orderNo SHA-256 与 2 个团单的改前基线完全一致；团期页与团期订单入口均可达。
- 部署状态：hl-order-service-v3 为 ca252347e、0/N、ok；hl-gateway 为 a82367e15、25/N、ok。
+- 原始交付定向测试：focused reactor 351 tests，0 failures/errors/skips，含 Docker OrderInfoMapperIT 与 ArchTest。
+- 原始交付网关验证：测试服提交 ca252347e；35 个 GET 请求、17 项断言全绿。缺省/NORMAL=171、GROUP=84、ALL=255；显式 ALL 各 Tab 保持改前 323/228/0/27/68/0；cancelled=true 三档 list/count 为 208/208、115/115、323/323。
+- 原始交付回归：Designer total=17、首页 orderNo SHA-256 与 2 个团单的改前基线完全一致；团期页与团期订单入口均可达。
+- 原始交付部署状态：hl-order-service-v3 为 ca252347e、0/N、ok；hl-gateway 为 a82367e15、25/N、ok。
+- 重开修复回归：真实 MySQL 红测修复前 2/2 失败（list=1、badge=0）；修复后 focused 278/0/0/0，最终精确全量 `mvn -o -pl hl-order-service-v3 -am test` 为 10784/0/0/7、BUILD SUCCESS，skipped 类 `HouseE2EWalkthroughIT`(1)、`HouseAssignmentServiceTest`(6)。
+- 重开修复网关：缺省 ABNORMAL `37=37`、AFTERSALE `1=1`；GROUP ABNORMAL `32=32`、AFTERSALE `1=1`；缺省 ALL/list `173=173` 且 173 行取消数为 0；两个临时 AFTERSALE 夹具与测试账号角色均已恢复。
+- 重开修复部署：repair `fbf86094f` / merge `7f5bc6ee7` 已包含在测试服 `dev-v3@83c1b1743`；hl-order-service-v3 与 hl-gateway 在最终取证前后均 0/N、ok。

 ## 十、相关文档

 - 后端规范：`docs/order-v3/api/API-SPEC.html` §1.2、§1.11。
 - 团期冻结口径：`docs/group/团期模块接口文档-v2.0.html` §0A.2、已落地清单及订单列表筛选卡片。
- 脱敏证据：任务 #7635 的 gateway-verification-after.json、gateway-baseline-before.json、display-matrix.md。
+- 脱敏证据：原始交付 `gateway-verification-after.json` / `gateway-baseline-before.json` / `display-matrix.md`；重开 `reopen-gateway-after.json` / `reopen-verification-evidence.json` / `reopen-deployment-evidence.json` / `reopen-deploy-status-frozen-{before,after}.txt`。

 ## 关联 / 联系人

 ### 链接

 - **Issue**: [#7635](https://git.1814.love:8443/wx/HL/issues/7635)
- **PR**: [#7650](https://git.1814.love:8443/wx/HL/pulls/7650)
- **Merge commit**: [b84d2551d](https://git.1814.love:8443/wx/HL/commit/b84d2551df669dbc4307e620e5ea3800b7f904d4)
+- **PR**: [#7650](https://git.1814.love:8443/wx/HL/pulls/7650)（原实现）/ [#7678](https://git.1814.love:8443/wx/HL/pulls/7678)（重开修复）
+- **Merge commit**: [b84d2551d](https://git.1814.love:8443/wx/HL/commit/b84d2551df669dbc4307e620e5ea3800b7f904d4)（原实现）/ [7f5bc6ee7](https://git.1814.love:8443/wx/HL/commit/7f5bc6ee7eb1abe4809bb4971d32f5e673335aa3)（重开修复）

 ### 联系人