From 77092f1ae47f50b0618a07c03767f4cc442bc65c Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 30 Sep 2026 12:24:07 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8619=20=E5=9B=A2=E6=9C=9F?= =?UTF-8?q?=E5=AD=90=E8=AE=A2=E5=8D=95=E5=88=97=E8=A1=A8=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=8F=AA=E6=8A=A5=E6=8E=A5=E9=80=81=E6=9C=BA=E7=9A=84=E6=88=B7?= =?UTF-8?q?=E4=B8=8D=E5=86=8D=E5=88=A4=E6=9C=AA=E6=8F=90=E4=BA=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GET /v3/admin/order/group-batch/{groupBatchId}/orders： - requirementStatus/requirementStatusName 放宽取值范围（纯接送机户不再恒为「未提交」） - 新增 vehicleRequirements[] 逐类用车需求清单（TRAVEL 在前、TRANSFER 在后） Refs #8619 Co-Authored-By: Claude Opus 5 (1M context) --- ...列表接送机户不再判未提交-修改接口-管理后台.md | 405 ++++++++++++++++++ 1 file changed, 405 insertions(+) create mode 100644 changelogs-v2/2026-09/30_8619_团期子订单列表接送机户不再判未提交-修改接口-管理后台.md diff --git a/changelogs-v2/2026-09/30_8619_团期子订单列表接送机户不再判未提交-修改接口-管理后台.md b/changelogs-v2/2026-09/30_8619_团期子订单列表接送机户不再判未提交-修改接口-管理后台.md new file mode 100644 index 00000000..3c102504 --- /dev/null +++ b/changelogs-v2/2026-09/30_8619_团期子订单列表接送机户不再判未提交-修改接口-管理后台.md @@ -0,0 +1,405 @@ +--- +schema: "hl-changelog/v2" +ticket: "8619" +title: "团期子订单列表：只报接送机的户不再判未提交，新增逐类用车需求清单字段" +consumer: "admin" +author: "wx(GIT)" +change_type: "修改接口" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "PR #8624 已 squash 合并 dev-v3（ce7cd238e9355bdc17c45f90ace02827c7db60f5），hl-order-service-v3 dev-v3 分支已滚测试服。GET /v3/admin/order/group-batch/{groupBatchId}/orders 对真实团期 2104839654727618562 实测：同户 TRAVEL+TRANSFER 两类需求状态互不覆盖、vehicleRequirements[] 按 TRAVEL 在前 TRANSFER 在后下发，589500 团期不存在错误码实测通过。所有既有字段未删改，只放宽了车需求那组字段的取值范围并新增 vehicleRequirements。" +updated_at: "2026-09-30" +base: "dev-v3" +--- + +> **存放目录**: `changelogs-v2/2026-09/` +> **服务**: hl-order-service-v3 (端口 8086) +> **PR**: #8624 +> **Issue**: #8619 +> **日期**: 2026-09-30 +> **影响范围**: 管理后台团期详情页「子订单列表」/ A3 接口消费方 + +## ⚠️ 关键变化 + +- **改前**：`GET /v3/admin/order/group-batch/{groupBatchId}/orders` 的车需求四个单值字段（`vehicleRequirementStatus`/`StatusName`/`Kind`/`KindName`）只从该户 **TRAVEL（行程用车）** 类需求行取值。若一个户只提交了 **TRANSFER（接送机）** 需求、没有 TRAVEL 需求，这四个字段恒被渲染成「未提交」，即使接送机需求已经在流转甚至已完成。 +- **改后**：改为按展示序（TRAVEL 优先于 TRANSFER）取该户**当前活跃需求行中的首条**，只提交接送机的户会如实报出接送机自己的状态，不再被误判未提交。 +- **新增字段 `vehicleRequirements`**：`GroupBatchOrderItemRespVO` 新增该数组字段，逐类列出该户全部活跃车需求行（TRAVEL 在前、TRANSFER 在后），每类各自独立的 `kind`/`kindName`/`status`/`statusName`，不再只能看到"展示序首条"这一个值。该户没有任何活跃车需求行时数组是 `[]`（空数组），不是 `null`。 +- **`vehicleRequirementKind` 不再恒为 `"TRAVEL"`**：只提交接送机的户，该字段与 `vehicleRequirementKindName` 现在会如实报出 `"TRANSFER"`/`"接送机"`。前端如果曾经硬编码假设这两个字段只会是 TRAVEL/行程用车，需要一并放开。 +- 其余约 25 个既有字段（订单状态、支付状态、酒店需求、出行人等）取值逻辑未变。 + +## 一、背景（选填） + +本单与已发布的 `changelogs-v2/2026-09/30_8577_...-修改接口-管理后台.md`（#8577）修的是**同一症状家族**（只提交接送机被误判"未提交"），但**改动的是完全不同的接口/代码路径**，请勿混淆： + +| | #8577 | #8619（本单） | +|---|---|---| +| 涉及接口 | `PUT` 保存车需求、`GET` 聚合草稿、`GET` 提交前校验（均在 `GroupVehicleRequirementService`） | `GET /v3/admin/order/group-batch/{groupBatchId}/orders`（团期子订单列表，`GroupBatchQueryService`/`GroupBatchConverter`） | +| 涉及错误码 | 809121/809122/809123 | 不涉及新增/变更错误码，沿用既有 589500 | +| 根因层 | 提交/校验链路 | 列表查询的取值范围（原只查 TRAVEL 类活跃行） | + +两单互不覆盖，`#8577` 的改动对本接口没有影响；本接口过去存在的误判问题，`#8577` 也没有修到。 + +## 二、变更接口清单 + +| # | 接口 | 方法 | 路径 | 变更类型 | 说明 | +|---|------|------|------|----------|------| +| 1 | 团期下子订单列表（A3） | GET | `/v3/admin/order/group-batch/{groupBatchId}/orders` | 响应字段语义收窄 + 新增字段 | `vehicleRequirementKind` 不再恒为 TRAVEL；新增 `vehicleRequirements[]` 逐类需求清单 | + +## 三、接口详情 + +### 1. 团期下子订单列表 `GET /v3/admin/order/group-batch/{groupBatchId}/orders` + +**VO**: `GroupBatchOrderItemRespVO` + +#### 使用场景 + +管理后台团期详情页展示该团期下全部子订单（一个订单=一个"户"）的汇总信息，含车需求配车状态一栏。前端据此渲染列表行的车需求状态标签，并可能据 `vehicleRequirementKind` 决定展示"行程用车"或"接送机"图标。 + +#### 入参 + +| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 | +|------|------|------|------|------|------| +| groupBatchId | path | Long | 是 | 团期需存在 | 团期ID | +| page | query | Integer | 否 | 缺省 1，<1 归一为 1 | 页码，从 1 起 | +| pageSize | query | Integer | 否 | 缺省 20，<1 归一为 20，>200 截断为 200 | 每页条数 | +| includeTravelers | query | Boolean | 否 | 缺省 true | 是否附出行人明细（证件号/手机号一律不返回） | +| includeNeeds | query | Boolean | 否 | 缺省 true | 是否附 roomCount/roomType/specialNeeds | +| includeCancelled | query | Boolean | 否 | 缺省 false | 是否含已取消子订单（缺省只返活跃集） | + +#### 出参 `Result>` + +| 字段 | 类型 | 说明 | +|------|------|------| +| orderId | String | 订单ID（Long 序列化为字符串） | +| orderNo | String | 订单号 | +| teamNo | String | 团号；订金支付成功后生成，未付订金为 null | +| customerName | String | 客户姓名 | +| participantCount | Integer | 出行人数 | +| orderStatus / orderStatusName | String / String | 订单状态/名称 | +| flowStatus / flowStatusName | String / String | 流程状态/名称（12 值枚举） | +| reviewStatus / reviewStatusName | String / String | 复核状态/名称；⚠️ 与团期核单 `GroupSettlementRespVO` 同名字段含义相反 | +| settlementStatus / settlementStatusName | String / String | 结算状态/名称；⚠️ 同样与团期核单含义相反，也不是财务 tab 的 settleStatus | +| payStatus / payStatusName | String / String | 支付状态/名称 | +| contractStatus / contractStatusName | String / String | 合同状态/名称 | +| insuranceStatus / insuranceStatusName | String / String | 投保状态/名称 | +| paidAmount / balanceAmount | String / String | 已付金额/待付余额（BigDecimal 序列化为字符串） | +| hotelRequirementStatus / hotelRequirementStatusName | String / String | 酒店需求状态/名称；#8249 起无活跃行时为 null，不回落 PENDING | +| **vehicleRequirementStatus** | String | 车需求状态；**本单起**取该户展示序（TRAVEL 优先）首条活跃需求行的状态，不再恒来自 TRAVEL | +| **vehicleRequirementStatusName** | String | 车需求状态名；PENDING_REVIEW 按 kind 分叉：TRAVEL="待提交车务"，TRANSFER="待审核"；"未提交"现在只在该户两类需求行都不存在时才出现 | +| **vehicleRequirementKind** | String | 车需求类别；**本单起不再恒为 "TRAVEL"**，只提交接送机的户会报 "TRANSFER" | +| **vehicleRequirementKindName** | String | 车需求类别名；未知类别给 null，不回落编码 | +| **vehicleRequirements** | Array | **本单新增**。该户全部活跃车需求行，TRAVEL 在前、TRANSFER 在后；一条都没有时为 `[]`（非 null） | +| consultantName | String | 顾问姓名 | +| totalPrice | String | 订单总价 | +| tierCode / tierName | String / String | 价格档位编码/名称 | +| travelerInfoComplete | Boolean | 出行人信息是否完整 | +| roomCount | Integer | 房间数；`includeNeeds=true` 时返回 | +| roomType / roomTypeName | String / String | 房型编码/名称；`includeNeeds=true` 时返回 | +| specialNeeds | String | 特殊需求；`includeNeeds=true` 时返回 | +| contactPhone | String | 联系电话（脱敏，如 `138****3046`） | +| groupChatUnreadCount | Integer | 群聊未读数；user-service 不可达/Feign 超时/未登录时降级为 0 | +| travelers | Array | 出行人明细；`includeTravelers=true` 时返回 | + +`VehicleRequirementItem`（`vehicleRequirements` 数组元素）： + +| 字段 | 类型 | 说明 | +|------|------|------| +| kind | String | 需求类别，TRAVEL / TRANSFER | +| kindName | String | 类别名，"行程用车" / "接送机" | +| status | String | 该类需求自己的状态（见六.5 枚举） | +| statusName | String | 状态名（PENDING_REVIEW 按 kind 分叉，见上） | + +#### 请求示例 + +```http +GET /v3/admin/order/group-batch/2104839654727618562/orders?page=1&pageSize=5&includeTravelers=false&includeNeeds=false +Authorization: Bearer {token} +``` + +#### 响应示例 + +测试服真实返回（团期 `2104839654727618562`，3 个子订单，覆盖"两类需求并存且状态不同""仅 TRAVEL"两种场景）： + +```json +{ + "code": 200, + "message": "成功", + "data": { + "records": [ + { + "orderId": "2104839654652121090", + "orderNo": "HL20260929154414207", + "teamNo": "26-2313", + "customerName": "李文博", + "participantCount": 2, + "orderStatus": "CUSTOMIZING", + "orderStatusName": "定制中", + "flowStatus": "RESOURCE_PREPARING", + "flowStatusName": "资源准备", + "reviewStatus": null, + "reviewStatusName": null, + "settlementStatus": "NONE", + "settlementStatusName": "未结算", + "payStatus": "FULLY_PAID", + "payStatusName": "已付全款", + "contractStatus": null, + "contractStatusName": null, + "insuranceStatus": null, + "insuranceStatusName": null, + "paidAmount": "7360.00", + "balanceAmount": "0.00", + "hotelRequirementStatus": null, + "hotelRequirementStatusName": null, + "vehicleRequirementStatus": "DONE", + "vehicleRequirementStatusName": "配车完成", + "vehicleRequirementKind": "TRAVEL", + "vehicleRequirementKindName": "行程用车", + "vehicleRequirements": [ + {"kind": "TRAVEL", "kindName": "行程用车", "status": "DONE", "statusName": "配车完成"}, + {"kind": "TRANSFER", "kindName": "接送机", "status": "PENDING", "statusName": "待车队配"} + ], + "consultantName": "cw_test_7443", + "totalPrice": "7360.00", + "tierCode": "2A", + "tierName": "2成人", + "travelerInfoComplete": true, + "roomCount": null, + "roomType": null, + "roomTypeName": null, + "specialNeeds": null, + "contactPhone": "138****3046", + "groupChatUnreadCount": 0, + "travelers": null + }, + { + "orderId": "2104839686486888449", + "orderNo": "HL20260929154421828", + "teamNo": "26-9436", + "customerName": "张丽娟", + "participantCount": 2, + "orderStatus": "CUSTOMIZING", + "orderStatusName": "定制中", + "flowStatus": "PENDING_CONFIRM", + "flowStatusName": "待确认", + "payStatus": "FULLY_PAID", + "payStatusName": "已付全款", + "paidAmount": "7360.00", + "balanceAmount": "0.00", + "vehicleRequirementStatus": "DONE", + "vehicleRequirementStatusName": "配车完成", + "vehicleRequirementKind": "TRAVEL", + "vehicleRequirementKindName": "行程用车", + "vehicleRequirements": [ + {"kind": "TRAVEL", "kindName": "行程用车", "status": "DONE", "statusName": "配车完成"} + ], + "totalPrice": "7360.00", + "tierCode": "2A", + "tierName": "2成人", + "contactPhone": "138****3047", + "groupChatUnreadCount": 0 + }, + { + "orderId": "2104839729176514562", + "orderNo": "HL20260929154432061", + "teamNo": "26-6559", + "customerName": "那顺", + "participantCount": 3, + "orderStatus": "CUSTOMIZING", + "orderStatusName": "定制中", + "flowStatus": "PENDING_CONFIRM", + "flowStatusName": "待确认", + "payStatus": "FULLY_PAID", + "payStatusName": "已付全款", + "paidAmount": "11620.00", + "balanceAmount": "0.00", + "vehicleRequirementStatus": "DONE", + "vehicleRequirementStatusName": "配车完成", + "vehicleRequirementKind": "TRAVEL", + "vehicleRequirementKindName": "行程用车", + "vehicleRequirements": [ + {"kind": "TRAVEL", "kindName": "行程用车", "status": "DONE", "statusName": "配车完成"}, + {"kind": "TRANSFER", "kindName": "接送机", "status": "PENDING_REVIEW", "statusName": "待审核"} + ], + "totalPrice": "11620.00", + "tierCode": "3A", + "tierName": "3成人", + "contactPhone": "138****3048", + "groupChatUnreadCount": 0 + } + ], + "total": 3, + "page": 1, + "pageSize": 5 + }, + "traceId": null, + "success": true +} +``` + +以上三条均取自 TRAVEL+TRANSFER 两类需求并存的户，展示了两类需求各自独立取值（第三条 TRANSFER 处于 `PENDING_REVIEW` 显示为"待审核"，TRAVEL 处于 `DONE` 不受影响）。**只提交接送机、完全没有 TRAVEL 需求**的户是本次修复要解决的核心场景，测试服当前团期数据中暂无这类现成样本（该形态的订单目前都不挂团期），该场景由自动化回归覆盖，见"八、测试环境已验证"。 + +#### 空数据 / 降级响应 + +分页越界的真实返回（`page=999` 超出总页数）： + +```json +{ + "code": 200, + "message": "成功", + "data": { + "records": [], + "total": 3, + "page": 999, + "pageSize": 5 + }, + "traceId": null, + "success": true +} +``` + +`groupChatUnreadCount` 在 user-service 不可达、Feign 调用超时或当前登录态失效时降级返回 `0`，不抛错、不影响本接口其余字段。 + +#### 错误响应 + +团期不存在的真实返回： + +```json +{ + "code": 589500, + "message": "团期不存在", + "data": null, + "traceId": null, + "success": false +} +``` + +无操作权限时返回错误码 `589507`（"无操作权限（当前角色未授予团期权限，或该团期不在您名下）"，源自 `GroupBatchErrorCode`，本轮测试账号为 admin 全权角色未触发，未做活体验证）。 + +#### 业务边界 + +- `groupBatchId` 对应团期不存在返回 589500，`data` 为 `null`。 +- `pageSize` 超过 200 会被后端静默截断为 200，不报错。 +- `includeCancelled` 缺省 `false`，不传时列表不含已取消子订单。 +- `vehicleRequirements` 为空数组 `[]` 表示该户当前没有任何活跃车需求行，不是接口异常；不要用 `null` 判空。 +- `vehicleRequirementKind`/`KindName` 在该户尚无任何车需求行时为 `null`，不回落成某个默认编码。 +- 两类需求同时存在时，单值字段（`vehicleRequirementStatus`/`Kind` 等）取的是**展示序（TRAVEL 优先）首条**，并非"最近更新"或"按查询顺序"；需要拿到每一类各自的真实状态必须读 `vehicleRequirements[]`，不能只读单值字段。 + +## 四、契约约束与正确调用方式（接口类必写） + +### ✅ 正确 / ❌ 错误 payload 对照 + +- ✅ 正确：判断某个户是否已提交任意车需求，遍历 `vehicleRequirements`（长度 > 0 即已提交），或分别读取 `vehicleRequirements` 中 `kind=TRAVEL`/`kind=TRANSFER` 各自的 `status`。 +- ❌ 错误：继续假设 `vehicleRequirementKind` 恒为 `"TRAVEL"` 并据此做条件分支——只提交接送机的户会被分支判空/判错。 +- ❌ 错误：把 `vehicleRequirementStatusName === "未提交"` 当作"该户任意一类车需求都未提交"的充分条件——本单之后它只代表"两类都未提交"，不能再用它反推"TRAVEL 未提交"或"TRANSFER 未提交"这类更细的判断，要细分请读 `vehicleRequirements[]`。 + +### 切换状态时的必要动作 + +无需前端触发任何状态切换动作；本次是纯读接口的响应字段语义调整，不涉及写操作。 + +## 五、数据库行为（涉及写操作时必写） + +本接口是纯查询接口，本单未新增/变更任何表结构，也未变更任何写路径。改动仅收窄/放宽了查询车需求行时的过滤条件（原实现只按 `requirement_kind = 'TRAVEL'` 取活跃行，现改为按展示序取该户全部活跃行的首条，并额外把全部活跃行一并下发到 `vehicleRequirements`）。 + +## 六、边界行为 + +- 团期不存在 → 589500，`data: null`。 +- 当前登录角色对该团期无权限 → 589507（源码定义，未做活体验证）。 +- `page`/`pageSize` 非法值（<1 或超范围）由后端静默归一/截断，不报参数校验错误。 +- 分页越界 → 返回 `records: []`，`total` 仍是真实总数，不报错。 +- `hotelRequirementStatus`/`vehicleRequirementKind` 等状态类字段在对应需求不存在时给 `null`，均不回落到某个默认状态码。 +- `groupChatUnreadCount` 在下游不可达时静默降级为 `0`。 + +## 六.5、枚举 / 数据字典（接口出现枚举时必写） + +### vehicleRequirementKind / vehicleRequirements[].kind（`VehicleRequirementKind`） + +| 值 | 中文名 | +|----|--------| +| TRAVEL | 行程用车 | +| TRANSFER | 接送机 | + +### vehicleRequirementStatus / vehicleRequirements[].status（`RequirementStatus`） + +| 值 | 中文名（车需求语境） | 备注 | +|----|----------------------|------| +| PENDING | 待车队配 | | +| PROCESSING | 配车中 | | +| DONE | 配车完成 | | +| PENDING_REVIEW | TRAVEL="待提交车务"；TRANSFER="待审核" | 同一状态码按 kind 分叉出不同中文名 | +| REJECTED_TO_CONSULTANT | 驳回顾问 | | +| REJECTED_TO_ADMIN | 驳回管理员 | | +| （该户无对应需求行） | 未提交 | `vehicleRequirementStatus`/`StatusName` 单值字段专属，`vehicleRequirements[]` 数组元素不会出现这个取值——没有对应行就不会出现在数组里 | + +## 六.6、修改前后对比（修改/删除类接口必写，新增跳过） + +### 字段级对比 + +| 字段 | 改前 | 改后 | +|------|------|------| +| vehicleRequirementStatus / StatusName | 只取该户 TRAVEL 类需求行的值；无 TRAVEL 行则恒为 "未提交" | 取展示序（TRAVEL 优先）首条**活跃**需求行的值；只要该户存在任意一类需求行就不再是"未提交" | +| vehicleRequirementKind / KindName | 恒为 "TRAVEL"/"行程用车"（或该户无 TRAVEL 行时为 null） | 如实反映展示序首条需求行的真实类别，可能是 "TRANSFER"/"接送机" | +| vehicleRequirements | 不存在该字段 | 新增，数组，逐类列出该户全部活跃需求行，空时为 `[]` | + +### 行为级对比 + +| 场景 | 改前 | 改后 | +|------|------|------| +| 只提交接送机（TRANSFER），无 TRAVEL 需求 | 单值字段恒报"未提交"，即便接送机已在流转甚至完成 | 单值字段如实报接送机自己的状态；`vehicleRequirements` 含 1 条 TRANSFER 记录 | +| 只提交行程用车（TRAVEL） | 与改后一致（回归测试覆盖，行为未变） | 行为不变 | +| 两类需求都提交 | 单值字段只能看到 TRAVEL 一类的状态，无法从列表接口直接得知 TRANSFER 的独立状态 | 单值字段仍取 TRAVEL（展示序优先），但 `vehicleRequirements` 同时给出两类各自独立的真实状态 | +| 两类需求都未提交 | "未提交"（#8249 起已是该行为） | 行为不变，`vehicleRequirements` 为 `[]` | + +## 六.7、影响评估（修改/删除类必写） + +- 破坏兼容：否。既有字段名称、类型、语义边界（`null` 代表无对应需求行）均未变，改动只是放宽了 `vehicleRequirementKind` 的实际取值范围、扩大了 `vehicleRequirementStatus`/`StatusName` 能反映的真实状态覆盖面。 +- 前端是否必须同步上线：若前端曾经硬编码假设 `vehicleRequirementKind` 恒为 `"TRAVEL"`（例如据此固定展示"行程用车"图标、或对非 TRAVEL 值做兜底成空白），需要同步放开，否则只提交接送机的户在前端会展示错误的类别图标/文案，但不会报错或崩溃。 +- 若前端此前为规避"接送机被误判未提交"这个已知问题，在自己代码里做过特判/兜底逻辑，本单上线后该特判可以删除。 + +## 七、不影响范围 + +- `hotelRequirementStatus`/`hotelRequirementStatusName` 及其判空逻辑（#8249 行为）未变。 +- 订单状态、支付状态、合同状态、投保状态、复核/结算状态、价格档位、出行人相关字段等约 25 个既有字段未变。 +- 分页参数默认值与归一/截断规则未变。 +- `includeCancelled`/`includeNeeds`/`includeTravelers` 三个开关的既有行为未变。 +- `#8577` 修复的三个车需求提交/校验接口（`PUT` 保存、`GET` 聚合草稿、`GET` 提交前校验）及其错误码 809121/809122/809123，与本接口是不同代码路径，互不影响。 +- 团期详情页的"车队"chips 维度接口（`/chips/vehicle`）已支持 TRANSFER 类别展示，本次改动前后行为一致，不受影响。 + +## 八、测试环境已验证 + +**活体实测（本会话，2026-09-30，测试服 dev-v3）：** + +1. `GET /v3/admin/order/group-batch/2104839654727618562/orders?page=1&pageSize=5&includeTravelers=false&includeNeeds=false` → HTTP 200，返回 3 条真实子订单记录，其中 2 条同时具有 TRAVEL+TRANSFER 两类活跃需求行，单值字段与 `vehicleRequirements[]` 均按预期独立报出各自状态（含 `PENDING_REVIEW` 在 TRANSFER 语境下正确显示为"待审核"）。原文见上「响应示例」。 +2. `GET /v3/admin/order/group-batch/999999999999999999/orders` → HTTP 200，`code:589500, message:"团期不存在"`。 +3. `GET /v3/admin/order/group-batch/2104839654727618562/orders?page=999&pageSize=5` → HTTP 200，`records:[]`，`total:3` 保留真实总数。 + +**自动化回归（`ce7cd238e9355bdc17c45f90ace02827c7db60f5`，已随 PR #8624 合入 dev-v3，覆盖测试服当前暂无现成样本的场景）：** + +- `GroupBatchConverterTest#toOrderItemVO_transferOnly_reportsRealStatusNotNotSubmitted`：该户只有一条 TRANSFER/`PENDING_REVIEW` 活跃行 → `vehicleRequirementStatusName` 报"待审核"（不是"未提交"），`vehicleRequirementKind`="TRANSFER"，`vehicleRequirements` 含 1 条对应记录。这正是本单要修复的核心场景。 +- `GroupBatchConverterTest#toOrderItemVO_travelOnly_legacyFieldsUnchanged`：只有 TRAVEL 行时行为与改前一致（回归保护）。 +- `GroupBatchConverterTest#toOrderItemVO_bothKinds_statusesStayIndependent`：TRAVEL 与 TRANSFER 两类状态互不覆盖，且与查询返回顺序无关（用 TRANSFER 先于 TRAVEL 的输入顺序验证展示序不受取数顺序影响）。 +- `GroupBatchConverterTest#toOrderItemVO_neitherKind_stillNotSubmitted`：两类都无活跃行时仍报"未提交"，`vehicleRequirements` 为空数组而非 null（#8249 行为回归保护）。 +- `GroupBatchConverterTest#toOrderItemVO_nullVehicleRows_emptyListNotNull`：上游传入 null 行集合时 `vehicleRequirements` 仍是空列表，不会是 null。 +- `GroupBatchConverterTest#toOrderItemVO_anyExistingRow_neverRendersNotSubmitted`（参数化，覆盖 TRAVEL/TRANSFER × 6 种状态共 12 种组合）：只要该户存在任意一条需求行，`statusName` 永不为"未提交"或空白。 +- `GroupVehicleStatusNameCrossOutletTest`（#8218 既有门禁）：同一 `(状态码, kind)` 对在本接口与其他读口的中文名保持一致，本次改动未破坏该跨口一致性。 + +## 十、相关文档 + +- 工单：#8619 +- PR：#8624（squash 合并 `ce7cd238e9355bdc17c45f90ace02827c7db60f5`） +- 关联但独立的历史修复：`changelogs-v2/2026-09/30_8577_只提交接送机的户不再被判未提交用车需求-修改接口-管理后台.md`（#8577，见本文「一、背景」的区分说明） + +## 关联 / 联系人 + +### 链接 + +- Issue: https://git.1814.love/wx/HL/issues/8619 +- PR: https://git.1814.love/wx/HL/pulls/8624 + +### 联系人 + +- 后端负责人：@wx