From 2e0e840e24f3427723aa9ac87212d8b5f36247ad Mon Sep 17 00:00:00 2001
From: wx <wx@hulalv.com>
Date: Mon, 27 Jul 2026 16:36:46 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BA=A4=E6=8E=A5=E6=B4=BE=E8=BD=A6?=
 =?UTF-8?q?=E5=80=99=E9=80=89=E5=88=B7=E6=96=B0=E6=B8=85=E7=A9=BA=E9=97=AE?=
 =?UTF-8?q?=E9=A2=98=20(#5283)=20(#47)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¦å€™é€‰å“�应被订å�•åˆ·æ–°æ¸…空-修改接å�£-管ç�†å�Žå�°.md | 106 ++++++++++++++++++
 1 file changed, 106 insertions(+)
 create mode 100644 changelogs-v2/2026-07/27_5283_派车候选�应被订�刷新清空-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/27_5283_派车候选�应被订�刷新清空-修改接�-管���.md b/changelogs-v2/2026-07/27_5283_派车候选�应被订�刷新清空-修改接�-管���.md
new file mode 100644
index 0000000..c495b85
--- /dev/null
+++ b/changelogs-v2/2026-07/27_5283_派车候选�应被订�刷新清空-修改接�-管���.md
@@ -0,0 +1,106 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5283"
+title: "车务派车候选�应被订�刷新清空"
+consumer: "admin"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "�端候选接�契约与日期冲��径正常；�端 AssignModal 因�订�对象刷新而���始化，清空已�功返回的候选。"
+updated_at: "2026-07-27"
+base: "dev-v3"
+---
+
+# 车务派车候选�应被订�刷新清空
+
+> **�务**: `hl-fleet-service`
+>
+> **�端工�**: [wx/HL#5283](https://git.1814.love:8443/wx/HL/issues/5283)
+>
+> **�端消费端**: `mmg/hl-ui v2.1`
+>
+> **影�页�**: 车务管� → 派车看�/矩阵 → 派车弹窗 `AssignModal`
+
+## 结论
+
+本次�是�端候选过滤或 API 契约缺陷，�新增或修改接��字段�类型�必填性�错误��派�状�机：
+
+- �一真实请求�测试网关返回 `vehicleTotal=19`，其中 11 辆 `AVAILABLE`，其余车辆因真实日期冲���用；
+- 专用测试车辆在目标日期区间�返回 `AVAILABLE`，车辆�车型�车队和维�状�未造�错误排除；
+- 页�显示“共 0 辆��生在�应�功之�：看�刷新/SSE 以新对象替��一订�，`AssignModal` �次执行 `resetOptionPages()` 并递增 `requestSeq`，从而清空候选并丢弃已返回结果；
+- �得通过放宽�端车辆/车队/车型或冲�过滤�掩盖�端状��置问题。
+
+该问题也属于 [#5279 车务派�全链路 E2E �端缺陷交接](./27_5279_车务派�全链路E2E�端缺陷交接-修改接�-管���.md)“��刷新�得�置正在编辑的派车�稿�的�类消费缺陷；#5283 补充了候选 19/11 的独立网关��和稳定�始化键�求。
+
+## �更接�
+
+```http
+POST /admin/fleet/assignments/candidates
+Content-Type: application/json
+Authorization: Bearer <admin-token>
+```
+
+接�继续返回车辆��机两套独立分页候选。�端应消费 `vehicles.records/total` 与 `drivers.records/total`（兼容别� `list` ��留），并以 `available`�`availabilityReasonCode`�`conflicts[]` 和 `availabilityWindows[]` 展示�用性；本次没有�端契约�化。
+
+## �端修��径
+
+### 1. 以稳定业务身份决定是��新�始化
+
+�得仅监� `props.order` 对象身份。应使用 `initializationIdentity` 或等价稳定键，至少覆盖：
+
+- `orderId`ï¼›
+- 当� `requirementId`；
+- 目标 `assignmentSlotId/fleetItemIndex`；
+- `assign/change` 模��必�入�上下文。
+
+�有上述业务身份真正�化，或用户主动关闭��新打开弹窗时，��许执行 `resetOptionPages()` 和�建派车�稿。�一订�仅因列表刷新或 SSE 生�新对象时�得�置。
+
+### 2. �留候选与编辑�稿
+
+�一稳定业务身份下刷新订�对象时，必须�留：
+
+- 车辆/�机候选 `records/total/page/pageSize`；
+- 车队�车型�关键字和�用性筛选；
+- 已选车辆��机�日期和稳定槽�；
+- 收费�务日��日价格�调价/�费原因；
+- 跨常驻确认以� `HOLD/DIRECT` 模�。
+
+若�务端基线确实�化，继续使用现有 baseline-difference 强�示，由用户决定如何处�；�得�默清空或改写�稿。
+
+### 3. �留并��应�护，但�得误�当�请求
+
+继续�留 `requestSeq` 或等价的旧�应隔离机制。�有新业务身份或新查询真正开始时�递增��；�一订�对象替��得把已��功返回的当�候选标记为过期。快速连续刷新时，旧请求�能覆盖新请求，新请求�功结果也�能被无关�始化清空。
+
+## �端验收清�
+
+- [ ] 专用测试订� `26-4700`�`2026-08-04..2026-08-07`�SUV�3 人请求返回�，页�候选数�与接�一致，��错误显示 0。
+- [ ] 相�订��需求�槽�和模�下，列表/SSE 替�订�对象�，车辆和�机候选��留。
+- [ ] 候选分页总数�筛选�件�已选项和费用�稿�被��刷新清空。
+- [ ] 已切�的 `HOLD/DIRECT` 模��会因�订�刷新��默认值。
+- [ ] 订��需求�槽�或模�真实�化时�能正确�新�始化。
+- [ ] 快速连续刷新时，旧�应�能覆盖新�应，当��功�应也�会被误判过期。
+- [ ] Network 记录�使用现有候选接�，无新增或修改�端请求契约。
+
+## 验���
+
+- 测试网关与 Fleet �实例��径�应：`code=200`�车辆总数 19��用 11�真实冲� 8；
+- 目标测试车辆�为 `AVAILABLE`，目标日期冲�数为 0；
+- �端 worktree 零代�改动，当�候选过滤�日期闭区间冲�和 API 契约����；
+- �端 HMR 现场曾出现稳定 `initializationIdentity` 方�的修正，但尚无 `mmg/hl-ui v2.1` 远端�交与�布验收��，因此本文件�� `frontend_status: "pending"`。
+
+## 契约审查
+
+- Frontend API：现有接�消费纠错，无 Controller/DTO/VO/字段�化，OpenAPI diff 为 `not_required`；
+- Internal Feign / shared Java：无�化，Consumer Contract 为 `not_required`；
+- �端真值由已部署测试环境网关�应和现有 Fleet ��确认；changelog �布�代表�端已实现或已�布。
+
+## �影�范围
+
+- �修改 `hl-ui`，�在 `mmg/hl-ui` 创建工�；
+- �修改�端候选过滤�日期冲��车辆/�机�用�派�状�机�计费��险�通知或数�库；
+- �把�端实现��布和页�验收冒充为本次�端代�交付。