changelog-filename-gate / validate (push) Successful in 2s

详情

docs(fleet): 6107 告知 clear-cancelled-occupancy 端点（终止行程后已取消派单释放车/司机占用入口）

端点 #5921 已交付部署但当初漏发 changelog，前端不知其存在导致看板详情缺释放按钮。
本次纯告知取值+UI挂载点，后端无代码变更。

2026-08-20 06:34:25 +00:00

4.4 KiB

原始文件 Blame 文件历史

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated

schema	ticket	title	consumer	author	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base	generated
hl-changelog/v2	6107	终止行程后已取消派单「释放车辆/司机占用」入口（一键清除占用端点告知）	admin	wx	新增接口	deployed	verified	pending	mmg			2026-08-20	端点 POST /admin/fleet/assignments/clear-cancelled-occupancy 由 #5921（关联 #5913/#5828）交付并部署 TEST，但当初未单独发 changelog，前端不知其存在，导致「终止行程后已取消派单仍占着车/司机、无释放按钮」。本文补告知取值与 UI 挂载点。后端本次无代码变更。	2026-08-20	dev-v3	2026-08-20T00:00:00+08:00

终止行程后已取消派单「释放车辆/司机占用」入口（#6107）

背景

订单中止行程后，订单侧已把对应车务派单截断为 canceled，看板正确显示「已取消」。

但「已取消」只是把派单行冻结，该行原本锁住的车辆/司机资源占用（脏 busy）不会自动全部归还——需要车务同事手动触发一次「释放占用」。此前前端不知道后端已有这个释放端点，导致看板详情里看不到任何释放按钮，资源一直被冻结，影响后续派车。

本文一次性告知：释放占用的后端能力早已上线，前端只需补挂一个按钮。

变更接口

接口	变更
`POST /admin/fleet/assignments/clear-cancelled-occupancy`	已上线，本次补告知。一键圈定某订单/需求下全部已取消(canceled)派单的车辆/司机，清掉它们的脏占用（合法 busy 不动）。只清占用，不修改派单任何字段
`POST /admin/fleet/assignments/{assignmentId}/soft-clear-assignment`	已上线（#5936）。单条软清备用；本单默认用上面的整单一键清

一、调用方式（clear-cancelled-occupancy）

入参（body）：

{
  "orderId": "1934567890123456789",
  "requestId": "clear-cancel-20260820-001"
}

orderId 与 requirementId 二选一（都填/都不填返 100001）。车务看板详情页天然有 orderId，用它即可。
requestId 必填，幂等标识，≤64 字符，前端生成（如 clear-cancel- + 时间戳）。

返回（data）：

{
  "vehicleDriverPairs": 2,
  "intentsWritten": 2,
  "assignmentIds": ["1934567890123456701"]
}

assignmentIds 为本次实际圈到的已取消派单 ID 列表（雪花按字符串返回）。
intentsWritten=0 表示没有可清的脏占用（幂等安全，可视为成功）。

错误码：100001（orderId 与 requirementId 二选一）/ 605047（行程已结束）/ 605054（终止冻结中，稍后重试）/ 605600（已关账）。

二、前端动作（本次唯一要改的地方）

在车务看板 → 订单详情抽屉 → 「车辆执行段」列表补一个入口：

可见条件：GET /admin/fleet/board/orders/{orderId} 返回的 activeAssignments[] / vehicleSlots[] 里存在 assignmentStatus === "canceled" 的行，且该行 assignmentId 非空时，显示「释放车辆/司机占用」按钮（或文字链）。
点击：弹确认框（文案建议「将释放该订单下已取消派单占用的车辆/司机，是否继续？」），确认后调 clear-cancelled-occupancy，orderId 取当前订单、requestId 前端生成。
成功后：提示成功并重新拉取详情（占用释放是异步 outbox 反算，稍候在矩阵/资源日历可见车、司机恢复 idle）。
非 canceled 行不展示该入口；holding/assigned 仍走既有「清空司机/车辆」(#5936)，语义不同，别混用。

三、取值字段（详情接口已返回，无需后端改）

GET /admin/fleet/board/orders/{orderId}（BoardOrderDetailVO）已含：

vehicleSlots[].assignmentStatus / assignmentStatusLabel（canceled = 已取消）
vehicleSlots[].assignmentId、assignmentSlotId、vehicleId、driverId
activeAssignments[].assignmentStatus / assignmentId

验证证据

后端 ClearCancelledOccupancy 单测 7 例随 #5921 交付即绿；端点已在 TEST 部署。
全量 API 测试（2026-08-20，232 用例）复核：终止行程后 fleet assignment 正确置 canceled，仅缺前端释放按钮——纯前端缺口。

4.4 KiB 原始文件 Blame 文件历史 Unescape Escape