From 6cfed6863a20f682c5bc305ec6de98580d01d458 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 10 Aug 2026 13:24:44 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#5784=20=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E6=8D=A2=E7=89=88=E4=BF=9D=E7=95=99=E6=97=A7=E6=B4=BE=E8=BD=A6?= =?UTF-8?q?=E5=BE=85=E4=BA=BA=E5=B7=A5=E6=A0=B8=E5=AF=B9=EF=BC=88=E7=9C=8B?= =?UTF-8?q?=E6=9D=BF=E8=AF=A6=E6=83=85=E6=96=B0=E5=A2=9E=E5=BE=BD=E7=AB=A0?= =?UTF-8?q?=E5=AD=97=E6=AE=B5=EF=BC=8C=E5=89=8D=E7=AB=AF=E5=BE=85=E6=8E=A5?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 (1M context) --- ...版保留旧派车待人工核对-修改接口-管理后台.md | 69 +++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 changelogs-v2/2026-08/10_5784_需求换版保留旧派车待人工核对-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/10_5784_需求换版保留旧派车待人工核对-修改接口-管理后台.md b/changelogs-v2/2026-08/10_5784_需求换版保留旧派车待人工核对-修改接口-管理后台.md new file mode 100644 index 0000000..c170af1 --- /dev/null +++ b/changelogs-v2/2026-08/10_5784_需求换版保留旧派车待人工核对-修改接口-管理后台.md @@ -0,0 +1,69 @@ +--- +schema: "hl-changelog/v2" +ticket: "5784" +title: "用车需求换版不再自动清除已派车：保留待人工核对 + 看板详情新增徽章字段" +consumer: "admin" +author: "wx(GIT)" +change_type: "修改接口" +backend_status: "pending" +gateway_status: "not_required" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端 PR 待合并部署；前端需接看板详情两个新字段挂「需求已改版」徽章与人工核对列表。" +updated_at: "2026-08-10" +base: "dev-v3" +--- + +# 车务/订单: 用车需求换版不再自动清除已派车，保留待人工核对（#5784） + +> **服务**: hl-fleet-service (8087/8187) + hl-order-service-v3 (8086/8186) +> **PR**: 待填 +> **Issue**: #5784 +> **日期**: 2026-08-10 +> **影响范围**: 派单看板订单详情（新增 2 字段）；换版/改期/改天数后的派车与订单配车摘要行为 + +--- + +## ⚠️ 关键变化（行为纠偏） + +此前：改用车需求（车型/座位）、改出发日期、改行程天数会**自动取消**未沿用的已派车（含已确认 assigned）并软删订单侧配车摘要。 +现在：**只自动取消未派车的 unassigned 占位；holding/assigned 一律保留**（状态、日期、资源占用都不动），盖「已被新版需求取代」标记，由车管人工核对后改派或取消。订单侧旧配车摘要也不再软删。增加出行人数行为不变（全部沿用）。 + +依据：SRS FLEET §9.18 #2 拍板（派单确认后是独立资产）+ 房务同款口径（既有配房不自动清理）。 + +## 接口变化（管理后台） + +`GET /admin/fleet/board/orders/{orderId}`（看板订单详情）**新增 2 个响应字段**： + +| 字段 | 类型 | 说明 | +|---|---|---| +| `requirementChangePendingCount` | int | 需求已改版待人工核对的保留派单数；**>0 时前端应挂「需求已改版，请人工核对」徽章** | +| `supersededAssignments` | array | 保留派单明细：`assignmentId`/`assignmentGroupId`/`assignmentSlotId`/`requirementId`(旧版)/`supersededByRequirementId`(新版)/`requirementSupersededAt`/`assignmentStatus`(holding\|assigned)/`vehiclePlate`/`vehicleModel`/`driverName`/`startDate`/`endDate`/`serviceDate`；ID 均字符串序列化 | + +其余接口路径/入参无变化。`PUT /v3/admin/order/{id}/vehicle-requirement` 响应中 `assignmentDeletedCount` 字段保留但**恒为 0**（不再软删）。 + +## 对前端的要求（mmg） + +1. 派单看板**详情/派单弹窗**：`requirementChangePendingCount > 0` 时挂「需求已改版，请人工核对」徽章，用 `supersededAssignments` 渲染人工核对列表（含车/司机/日期/状态）。 +2. 处置动作复用现有能力：改派（一键释放重派 #5592 已有）或取消（普通取消派单）；被取消/改派后字段自动归零。 +3. 注意：保留行**不出现**在 `activeAssignments`/`dailyVehiclePlan`（那是当前需求的方案）；也不产生看板列表卡片，徽章只在详情级。 +4. 订单详情（定制师侧）无字段变化；换版后旧配车在新方案回配前的展示口径不变。 + +## 联动语义（供前端理解，无需实现） + +- 保留行继续占用车辆/司机（同日期同资源不可重复派），人工取消后释放；改期后新日期不受旧占用影响。 +- 换版自动化只作用于 unassigned：减槽取消未派占位、增槽补新 unassigned。 + +## 关联 / 联系人 + +### 链接 + +- **Issue**: [#5784](https://git.1814.love:8443/wx/HL/issues/5784) + +### 联系人 + +- **后端负责人**: @wx +- **前端负责人**: @mmg