From fe3fe0e248b2e94617e0ff3964cd1123821d2334 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 9 Aug 2026 16:14:35 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#5744=20=E6=94=B9=E6=B4=BE?= =?UTF-8?q?=E5=90=8Evehicle=5Fcontrol=5Fstatus=E5=8D=A1PROCESSING=E4=BF=AE?= =?UTF-8?q?=E5=A4=8D=EF=BC=88=E4=BA=94=E5=B1=82=E6=A0=B9=E5=9B=A0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...rol_status卡PROCESSING修复-修改接口-管理后台.md | 30 +++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 changelogs-v2/2026-08/08_5744_改派后订单vehicle_control_status卡PROCESSING修复-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/08_5744_改派后订单vehicle_control_status卡PROCESSING修复-修改接口-管理后台.md b/changelogs-v2/2026-08/08_5744_改派后订单vehicle_control_status卡PROCESSING修复-修改接口-管理后台.md new file mode 100644 index 0000000..f7fa88b --- /dev/null +++ b/changelogs-v2/2026-08/08_5744_改派后订单vehicle_control_status卡PROCESSING修复-修改接口-管理后台.md @@ -0,0 +1,30 @@ +# 08_5744_改派后订单vehicle_control_status卡PROCESSING修复-修改接口-管理后台 + +- **date**: 2026-08-09 +- **ticket**: 5744 +- **change_type**: 修改接口 +- **service**: hl-fleet-service, hl-order-service-v3 +- **frontend_status**: not_required +- **status_note**: 修复改派（含接续/按天改派）后订单 vehicle_control_status 卡 PROCESSING 不回写 DONE 的问题（实证 26-6436）。五层修复全部为 fleet→order 快照回写链路的行为修正，前端无改动项；订单流程条由后端回写自然推进。 + +## 变更接口或验证证据 + +### 接口契约 + +**无契约变更**：POST /admin/fleet/assignments/{assignmentId}/change、/{assignmentId}/confirm、/{assignmentId}/driver-confirmation、/requirements/{requirementId}/confirm 的请求/响应字段、错误码均不变；internal 新增补偿端点 POST /internal/fleet/jobs/vehicle-assignment-snapshot/refinalize（运维补偿用，不影响对外契约）。 + +### 验证证据 + +- **根因（五层，代码级实证 26-6436 全程行+改派）**： + 1. `isFinalizedDispatchPlanTopologyRows` 全程槽（serviceDate=null 单行覆盖全程）逐日覆盖检查误判 → HOLD 确认/改派确认的 finalPlan 事件不发布（直派无条件发布故正常）； + 2. 改派生成的全程行携带非空 assignment_group_id，快照工厂 isFullTripRow 要求 groupId 为空 → 快照按逐日拓扑校验失败，confirm 回滚； + 3. order 侧最终确认 fence 占用（582092，暂时性）被快照投递按业务错误隔离而非重试； + 4. 隔离事件计入前驱阻塞 → 后续 revision 永久 PENDING； + 5. order 侧未初始化（contract_version 为空）强绑 revision=1，fleet 重发更高 revision 永远冲突。 +- **修复**：#5745/#5747/#5748/#5749/#5753 五 PR（dev-v3），fleet 3 处 + order 1 处 + 补偿端点； +- **测试**：AssignmentServiceTest 407/407、FactoryTest 12/12、OutboxSenderTest 26/26、OutboxMapperTest 13/13、order DailyVehicleAssignmentSnapshotServiceTest 17/17；fleet 全量 verify 3313 tests 失败项全部归账（ReleaseEMixedBinaryHarnessTest 2F + ReleaseEOccupancyMysql8033RecoveryTest 10E 为既有环境类基线）； +- **部署自验（TEST 实单 26-6436 全链）**：change(HOLD)→driver-confirmation→confirm 全部成功；快照 rev=5 生成；fence 占用期间投递重试（retry_count=6, HTTP_582092，非隔离）；fence 过期后自动投递 SUCCESS；**order_main.vehicle_control_status PROCESSING→DONE、order_vehicle_requirement.status=DONE、contract=DAILY_V3 rev=5**；探针 4/4 PASS（evidence/5744/gateway-probe-output.txt）。 + +## 前端交接 + +无。流程条「配车·处理中→下一步」由后端回写驱动，前端无需改动。