Mimingguang
87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
处置明细(mmg 2026-09-18): - 68 条机械核验通过批量翻 verified:frontend_ref 均可达且为 v2.1 祖先、 交付文件 HEAD 均在、关联 spec 批量 58 文件 891 例全绿。 - 11 条带演进史的例外逐条核后翻 verified:3 条交付自删文件(06_5610/ 07_5655/11_5810,删除即交付内容且终态保持);8 条被后续 changelog 预期 演进(10_5784→#5810、07_5664/08_5592→#5827、07_5665→去槽位化 U1、 01_5380/05_5356/06_5567/06_5581→settlement 族A扁平化与 mock 清理), status_note 均如实记录演进链。 - 05_5552 改判 not_required:frontend_ref 自述前端无需改动,grep 实证 vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing。 - 11_5827 frontend_ref 原空,经核交付即 753503c8(向导 4 步改 3 步提交 即派定),补登全哈希 753503c87cc635e5646b4368a8ed506746c79cf1。 另:保险域 2 条相邻条目(05_5530/06_5593)同标准复核翻 verified。 2026-07 历史月 45 条按规则不回扫,保持原状。
75 行
4.7 KiB
Markdown
75 行
4.7 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5784"
|
||
title: "用车需求换版不再自动清除已派车：保留待人工核对 + 看板详情新增徽章字段"
|
||
consumer: "admin"
|
||
author: "wx(GIT)"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "not_required"
|
||
frontend_status: "verified"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: "188e0d64"
|
||
target_release: ""
|
||
verified_at: "2026-09-18"
|
||
status_note: "前端已实现：新建 utils/requirementSuperseded.js 归一化保留派单明细(ID 字符串透传,count 以后端字段为权威、缺省回退明细长度)+ RequirementSupersededCard.vue 子组件(count>0 挂「需求已改版,请人工核对」徽章并渲染核对列表 车/司机/日期/状态,日期逐日 serviceDate 优先回退 startDate~endDate,状态复用 resolveAssignmentStatusLabel/ORDER_STATUS_META);OrderDrawer 详情抽屉与 AssignModal 派单弹窗各引入一次。保留行不进 activeAssignments/dailyVehiclePlan、不产生看板卡片,徽章只在详情/派单弹窗级。util 5/5、组件 4/4、看板关联 287/287、checkpoint 全过。[mmg 2026-09-18 复核翻 verified] ref 188e0d64 可达且为 v2.1 祖先；RequirementSuperseded 渲染系列后被 #5810（b6f9c44a）按换版槽位人工制新契约移除（彼交付自删），属预期演进；关联 spec 批量 891 例全绿。"
|
||
updated_at: "2026-09-18"
|
||
base: "dev-v3"
|
||
---
|
||
|
||
# 车务/订单: 用车需求换版不再自动清除已派车，保留待人工核对（#5784）
|
||
|
||
> **服务**: hl-fleet-service (8087/8187) + hl-order-service-v3 (8086/8186)
|
||
> **PR**: #5785（主）+ #5787/#5789（连带）
|
||
> **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。
|
||
|
||
## 验证证据
|
||
|
||
- 后端 PR #5785(主)+ #5787/#5789(连带)已合并 dev-v3 并部署测试服(backend_status=deployed 于 2026-08-10 回填,测试服 hl-order-service-v3 运行 2026-08-10 构建版本)。
|
||
- 详情接口新增 2 字段随该版本在测试服生效;前端实现自测 util 5/5、组件 4/4、看板关联 287/287、checkpoint 全过(见 status_note)。
|
||
|
||
## 关联 / 联系人
|
||
|
||
### 链接
|
||
|
||
- **Issue**: [#5784](https://git.1814.love:8443/wx/HL/issues/5784)
|
||
|
||
### 联系人
|
||
|
||
- **后端负责人**: @wx
|
||
- **前端负责人**: @mmg
|