hl-api-changelog/changelogs-v2/2026-08/15_5936_排车软清司机车辆选中-新增接口-管理后台.md

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	5936	排车新增「清空司机/车辆选中(软清·保留行)」轻动作	admin	wx	新增接口	deployed	verified	pending					后端完成：PR #5981 已合并 dev-v3 并部署 TEST（hl-fleet-service 双实例 UP）。网关真 token 实测软清端点：软清后行保留/vehicle+driver 置空/状态回 unassigned/无取消历史/占用释放可重派；已出发 605043、已结束 605047 门禁拦截。	2026-08-15	dev-v3	2026-08-15T23:55:00+08:00

排车新增「清空司机/车辆选中(软清·保留行)」轻动作（#5936）

背景

排车已选司机/车辆后，之前要么整行取消（DELETE，过重、进取消历史、价格口径被清），要么 driver-reject（硬性转 HOLDING 且清确认痕迹）。运营需要一个轻动作：只把当前选中的司机/车辆清空、行本身留下继续重派。

变更接口

接口	变更
POST /admin/fleet/assignments/{assignmentId}/soft-clear-assignment	新增。软清：vehicle_id/driver_id 置空 → 状态回 unassigned，保留派车行本体、价格/收费口径不动、不算取消、不进取消历史

行为口径

• 可软清状态：holding、assigned。已出发返 605043、已结束返 605047；canceled/completed 历史行不动。
• 保留：派车行、价格快照、确认痕迹；不清排车确认痕迹、不发取消事件。
• 副作用：撤需求级定稿章（否则软清行被定稿封死无法重派）；占用按组 OCCUPANCY_RECOMPUTE 释放，可同槽位重派。
• 与取消（DELETE）、driver-reject 三者的语义边界见 API-SPEC-FLEET §8.x。

前端动作

• 新增「清空司机/车辆」按钮（仅 holding/assigned 态可见），调本端点。
• 软清成功后行留在看板「待派车」，可直接重派；不要跳取消历史、不要刷新价格。
• 对已出发（605043）/已结束（605047）按钮置灰或拦截提示。

验证证据

• AssignmentServiceTest 499/499（基线 489 + 新增 10 个软清用例）+ ClearCancelledOccupancy 7 + FleetRedLineArchTest 13 全绿，spotless 通过。
• 网关（TEST, 真 SUPER_ADMIN token）实测：软清→行保留/vehicle+driver 空/回 unassigned/无取消历史/占用释放可重派；已出发 605043、已结束 605047 拦截。