From 26b3f7516a998ce49a58209606f855ec81f03ff1 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 23 Sep 2026 11:14:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(8202):=20=E8=A1=A5=E7=82=B9=E5=90=8D?= =?UTF-8?q?=E5=8F=97=E5=BD=B1=E5=93=8D=E7=9A=84=E5=89=8D=E7=AB=AF=E7=BB=84?= =?UTF-8?q?=E4=BB=B6=EF=BC=88AC-6=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原正文只写了泛指的「下拉组件」，没有具体文件名，mmg 拿到后仍要自己找落点。 实测点名（非推断）：hl-ui origin/v2.1 上唯一调用 putVehicleRequirement 的 .vue 是 src/views/order-v2/detail/modals/FunItemAdjustModal.vue（:1177 import， :2968 TRAVEL / :2970 TRANSFER 两个调用点）。阳性对照：该函数在 src/api/orderV2.js 与两个 __tests__ spec 里同样命中，证明 grep 正常工作、.vue 只有 1 个命中是真的。 顺带记一条可查证事实：src/api/orderV2.js 中 putVehicleRequirement 的 JSDoc 错误码一行写的是 582024 / 582091，不含本次新增的 582032 / 582033。 Refs #8202 Co-Authored-By: Claude Opus 5 (1M context) --- ...订单行程用车车型大类接入车队字典校验-修改接口-管理后台.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/changelogs-v2/2026-09/23_8202_子订单行程用车车型大类接入车队字典校验-修改接口-管理后台.md b/changelogs-v2/2026-09/23_8202_子订单行程用车车型大类接入车队字典校验-修改接口-管理后台.md index 88482b6a..66166096 100644 --- a/changelogs-v2/2026-09/23_8202_子订单行程用车车型大类接入车队字典校验-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/23_8202_子订单行程用车车型大类接入车队字典校验-修改接口-管理后台.md @@ -264,6 +264,10 @@ mmg `v2.1` 分支 `7df292624`（2026-09-23 09:27）已将车型录入从自由 尚待前端覆盖的场景：**存量已落库需求的编辑态回显**——若某行 `vehicleType` 不在当前字典返回值内（历史遗留或大类刚被下线），下拉组件默认会渲染成空选项且用户无法感知原因；此时应显式提示"当前值不在字典内，请重新选择"，而非静默清空。 +**受影响的前端组件（实测点名，非推断）**：`src/views/order-v2/detail/modals/FunItemAdjustModal.vue`——hl-ui `v2.1` 上唯一调用 `putVehicleRequirement` 的 `.vue`（`:1177` import，`:2968` TRAVEL / `:2970` TRANSFER 两个调用点）；api 封装在 `src/api/orderV2.js:1345` `putVehicleRequirement`。该组件已引入车型字典 api（`getVehicleTypesList`），本次要补的是「回显值不在字典返回集内」这一态的显式提示，不是接入下拉本身。 + +⚠️ 顺带一条可查证的事实：`src/api/orderV2.js` 中 `putVehicleRequirement` 的 JSDoc 错误码一行写的是 `582024 / 582091`，不含本次新增的 `582032 / 582033`。注释不影响运行，但下一个照注释排错的人会找不到新码。 + --- ## 五、数据库行为（涉及写操作时必写） @@ -328,7 +332,7 @@ mmg `v2.1` 分支 `7df292624`（2026-09-23 09:27）已将车型录入从自由 - **是否破坏向后兼容**: 部分破坏，且是有意为之。请求/响应结构不变；仅"归一成功但大类已被下线"这一种此前被接受的取值，改为拒绝。影响面严格限定在"大类已整类下线"这一种运营主动下线的场景，不影响任何仍在营的大类。 - **前端是否必须同步上线**: 否，mmg 已提前于本次后端上线（`7df292624` 早于 `b439565be`）改为字典下拉，新提交路径已规避新码。 -- **前端 workaround 清理点**: 存量已落库需求在编辑态若命中已下线大类，需前端显式提示"当前值不在字典内，请重新选择"（见"四、契约约束"节），避免下拉渲染成空白且用户无法定位原因。 +- **前端 workaround 清理点**: 存量已落库需求在编辑态若命中已下线大类，需前端显式提示"当前值不在字典内，请重新选择"（见"四、契约约束"节），避免下拉渲染成空白且用户无法定位原因。落点组件：`src/views/order-v2/detail/modals/FunItemAdjustModal.vue`。 ---