From f720f990943e855bc03c22192870660c2c9dc73c Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 28 Jul 2026 09:41:39 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E8=A1=A5=E5=85=85=E6=B4=BE?= =?UTF-8?q?=E8=BD=A6=E5=BC=B9=E7=AA=97=E9=80=92=E5=BD=92=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E5=91=8A=E7=9F=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...阵车辆司机预选与常驻标记-修改接口-管理后台.md | 39 +++++++++++++++++-- 1 file changed, 36 insertions(+), 3 deletions(-) diff --git a/changelogs-v2/2026-07/27_5299_车务矩阵车辆司机预选与常驻标记-修改接口-管理后台.md b/changelogs-v2/2026-07/27_5299_车务矩阵车辆司机预选与常驻标记-修改接口-管理后台.md index a7d2260..ca71d94 100644 --- a/changelogs-v2/2026-07/27_5299_车务矩阵车辆司机预选与常驻标记-修改接口-管理后台.md +++ b/changelogs-v2/2026-07/27_5299_车务矩阵车辆司机预选与常驻标记-修改接口-管理后台.md @@ -11,7 +11,7 @@ frontend_owner: "hl-admin" frontend_ref: "bfcfafc69335f289071fe3e6dce74bacb636c55d" target_release: "" verified_at: "2026-07-27T22:12:19+08:00" -status_note: "后端 PR #5300 已合并并部署测试环境，矩阵新增字段经真实网关验证；前端待认领预选、司机展示和 #5292 逐日表单改造" +status_note: "前端实现 bfcfafc6 已回写，但测试页面 FleetAssignModal 出现响应式递归更新并阻断候选加载；修复并完成页面复验前不得流转为 released/verified" updated_at: "2026-07-28" base: "dev-v3" --- @@ -33,6 +33,39 @@ base: "dev-v3" 本次后端补齐稳定读契约。前端不得按姓名判断常驻关系，也不得复制相邻订单的临时司机作为新派单默认值。 +## 2026-07-28 前端运行态阻断：`FleetAssignModal` 递归更新 + +### 现场结论 + +前端实现提交 `bfcfafc69335f289071fe3e6dce74bacb636c55d` 已进入 `v2.1`，但当前测试页面打开逐日派车弹窗并加载车辆、司机候选后稳定出现： + +```text +Maximum recursive updates exceeded in component +``` + +浏览器 Console 同时记录多次 `unhandledrejection`；Network 中多条 `POST /admin/fleet/assignments/candidates` 均返回 HTTP 200，但车辆、司机区域持续停留在 loading，无法进入下一步。因此本次不是候选接口、日期冲突或后端状态机错误，而是前端实现后的响应式自反馈回归。`frontend_status: "implemented"` 仅表示代码已存在，不代表已发布或页面闭环。 + +### 高可信自反馈链 + +当前 `AssignModal.vue` 的深度 watcher 同时观察 `candidateEvidence`、`candidateSelectionReady`、`autoSelectedResidentDriverSource` 等候选派生状态，并在回调 `syncActiveSlotSelection()` 中无条件重建 `dailyPlan`、回写当前槽位。`dailyPlan` 又参与计算其他槽位排除 ID、候选可选态和新的 `candidateEvidence`；即使业务值没有变化，新数组/对象身份仍会再次触发同一 watcher，形成“观察候选派生值 → 回写逐日方案 → 候选派生值重新计算 → 再次回写”的闭环。 + +前端修复必须同时满足： + +1. `syncActiveSlotSelection()` 先比较当前日格与待写 payload；语义完全相同时直接返回，不创建新 `dailyPlan`/槽位对象。 +2. watcher 使用稳定原始值或稳定 fingerprint，不深度监听会被自身回写间接失效的派生对象；候选响应、用户选择和槽位同步应有单向边界。 +3. `updateDailyVehiclePlanCell()` 或等价更新器在无真实字段变化时返回原引用，禁止仅因对象重建触发后续 effect。 +4. 保留 #5283 的稳定 `initializationIdentity` 与 `requestSeq` 旧响应隔离；不得退回监听 `props.order` 对象身份或通过删除并发保护掩盖循环。 +5. 正常打开弹窗只允许一次初始候选请求；需要自动常驻司机二次校验时最多再请求一次。状态稳定后不得继续请求，loading 必须收敛。 + +### 前端回归验收 + +- [ ] 打开订单逐日派车弹窗并取得候选成功响应后，Console 不再出现 `Maximum recursive updates` 或相关 `unhandledrejection`。 +- [ ] 候选请求数量有明确上界；自动常驻司机场景最多“初始查询 + 携两侧 ID 二次校验”，不存在持续请求。 +- [ ] 车辆、司机列表结束 loading，接口返回的分页总数与页面一致，可正常进入下一步。 +- [ ] 已选车辆、司机、逐日费用和跨常驻确认写回一次后保持稳定，多轮 `nextTick` 不再重建相同 `dailyPlan`。 +- [ ] 相同业务身份的 SSE/列表对象替换仍保留候选与草稿；真实订单、需求、槽位或模式变化时才重新初始化。 +- [ ] 新增真实挂载 `FleetAssignModal` 的回归测试，模拟候选成功和自动常驻二次校验，断言无未处理 Promise、请求次数有界且草稿稳定；仅做静态源码断言不足以验收。 + ## 变更接口 ### `GET /admin/fleet/matrix/grid` @@ -128,6 +161,6 @@ base: "dev-v3" - 网关证据：`D:/work2/HL-v3/.tmp/5299-gateway.json`，SHA-256 `d94ee78fbe52cc193a28e5bf182e1353d2eca9d87824b1c2eb526c62a4fe645d`。 - OpenAPI/oasdiff：项目尚未配置可复现 Swagger2→OAS3 与 oasdiff，状态为 `not_configured`；使用源码字段对比、Controller 序列化测试及真实网关响应作为人工回退证据，未冒充工具通过。 -当前状态：后端已部署、网关已验证，前端消费保持 `pending`。 +当前状态：后端已部署、网关已验证；前端代码状态为 `implemented`，但运行态复验失败，修复并通过上述页面验收前不得流转为 `released` 或 `verified`。 -关联：#5299、#5292。 +关联：#5299、#5292、#5283。