From 7dd6635195bab8b4ad86dfd92d952337d79ce336 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sat, 15 Aug 2026 23:52:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#5936=20=E6=8E=92=E8=BD=A6?= =?UTF-8?q?=E8=BD=AF=E6=B8=85=E5=8F=B8=E6=9C=BA=E8=BD=A6=E8=BE=86(?= =?UTF-8?q?=E6=96=B0=E7=AB=AF=E7=82=B9)=20+=20#5934=20=E8=BD=A6=E5=8A=A1?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=E6=BC=82=E7=A7=BB=E8=A1=A5=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...5934_车务契约漂移补录-文档契约-管理后台.md | 49 +++++++++++++++++++ ..._排车软清司机车辆选中-新增接口-管理后台.md | 49 +++++++++++++++++++ 2 files changed, 98 insertions(+) create mode 100644 changelogs-v2/2026-08/15_5934_车务契约漂移补录-文档契约-管理后台.md create mode 100644 changelogs-v2/2026-08/15_5936_排车软清司机车辆选中-新增接口-管理后台.md diff --git a/changelogs-v2/2026-08/15_5934_车务契约漂移补录-文档契约-管理后台.md b/changelogs-v2/2026-08/15_5934_车务契约漂移补录-文档契约-管理后台.md new file mode 100644 index 0000000..e72d3b7 --- /dev/null +++ b/changelogs-v2/2026-08/15_5934_车务契约漂移补录-文档契约-管理后台.md @@ -0,0 +1,49 @@ +--- +schema: "hl-changelog/v2" +ticket: "5934" +title: "车务契约漂移补录：taskType/status 枚举可筛 + 状态色标口径 + 模板域 VO 分包" +consumer: "admin" +author: "wx" +change_type: "文档/契约补录" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端完成：PR #5980 已合并 dev-v3 并部署 TEST。属契约文档对齐 + 代码分包重构，零行为变更。补录 5 项既有实现的契约口径，前端需按补录口径对齐筛选项与状态色标。" +updated_at: "2026-08-15" +base: "dev-v3" +generated: "2026-08-15T23:56:00+08:00" +--- + +# 车务契约漂移补录（#5934） + +## 背景 + +车务部分已上线实现与 API-SPEC-FLEET 文档存在漂移（实现已具备但文档未补录 / 分包不规范）。本次把 5 项**既有实现**的契约口径补录进文档，并将模板域 VO 下沉到规范子包。**零行为变更**，前端按补录口径对齐即可。 + +## 补录项（前端相关） + +| 项 | 补录内容 | 前端动作 | +| --- | --- | --- | +| §3.8a.2 任务枚举 | `taskType=REFUND_CHECK`、`taskStatus=CANCELLED` 已在代码支持，可筛 | 筛选下拉补这两个枚举项 | +| §3.8a.2 状态色标 | 任务列表按钮/色标**按 `taskStatus`** 着色（非 taskType） | 按 taskStatus 做色标/按钮可用性判断 | +| §8.10 | 列表项补 `processingStatus` 字段说明 | 信息性，按需展示 | +| §8.11 | 补 `HOLD` status + retry 口径 | 信息性 | +| §11.4a | 补 render-batch 端点说明 | 信息性 | + +## 纯后端（前端零感知） + +- 模板域 11 个 VO 下沉 `messagetemplate.vo.admin` 子包（分包规范化，类名/字段/wire JSON 不变）。 + +## 前端动作 + +- 任务列表筛选项补 `taskType=REFUND_CHECK`、`taskStatus=CANCELLED`。 +- 任务行色标/按钮口径**改用 `taskStatus`**（若之前按 taskType 判断请修正）。 + +## 验证证据 + +- 范围套件 196/196 全绿（含 FleetRedLineArchTest 13/13），spotless 通过；旧 `vo/` 包 0 残留、旧包引用 grep=0。 +- #5928 §3.8a.1 `driver-policies/page` 主链完好，无回归。 diff --git a/changelogs-v2/2026-08/15_5936_排车软清司机车辆选中-新增接口-管理后台.md b/changelogs-v2/2026-08/15_5936_排车软清司机车辆选中-新增接口-管理后台.md new file mode 100644 index 0000000..4617e91 --- /dev/null +++ b/changelogs-v2/2026-08/15_5936_排车软清司机车辆选中-新增接口-管理后台.md @@ -0,0 +1,49 @@ +--- +schema: "hl-changelog/v2" +ticket: "5936" +title: "排车新增「清空司机/车辆选中(软清·保留行)」轻动作" +consumer: "admin" +author: "wx" +change_type: "新增接口" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端完成：PR #5981 已合并 dev-v3 并部署 TEST（hl-fleet-service 双实例 UP）。网关真 token 实测软清端点：软清后行保留/vehicle+driver 置空/状态回 unassigned/无取消历史/占用释放可重派；已出发 605043、已结束 605047 门禁拦截。" +updated_at: "2026-08-15" +base: "dev-v3" +generated: "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 拦截。