比较提交

...

3 次代码提交

作者 SHA1 备注 提交日期
API Changelog Bot
1a2a1bdb65 docs(changelog): #5744 lint 修正(frontmatter+占位符)
一些检查失败了
changelog-filename-gate / validate (push) Failing after 2s
2026-08-09 16:16:18 +08:00
API Changelog Bot
2f613a6ea9 docs(changelog): #5744 补 frontmatter 2026-08-09 16:15:14 +08:00
API Changelog Bot
fe3fe0e248 docs(changelog): #5744 改派后vehicle_control_status卡PROCESSING修复(五层根因) 2026-08-09 16:14:35 +08:00

查看文件

@ -0,0 +1,47 @@
---
schema: "hl-changelog/v2"
ticket: "5744"
title: "改派后订单 vehicle_control_status 卡 PROCESSING 不推进 DONE五层根因修复"
consumer: "admin"
author: "wx"
change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "not_required"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
updated_at: "2026-08-09"
base: "dev-v3"
generated: "2026-08-09T16:20:00+08:00"
---
# 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 五 PRdev-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 PASSevidence/5744/gateway-probe-output.txt
## 前端交接
无。流程条「配车·处理中→下一步」由后端回写驱动,前端无需改动。