From 69fe46f55c7166e7b92f7041f08ba6fb2f2c575e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 28 Jul 2026 02:25:56 +0800
Subject: [PATCH] docs(changelog): hand off fleet daily plan invariant fix
 (#5305)

---
 ...–¹æ¡ˆé‡�æ��与完æˆ�闭环ä¸�å�˜é‡�-修改接å�£-管ç�†å�Žå�°.md | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 changelogs-v2/2026-07/28_5305_�日方案��与完�闭环���-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/28_5305_�日方案��与完�闭环���-修改接�-管���.md b/changelogs-v2/2026-07/28_5305_�日方案��与完�闭环���-修改接�-管���.md
new file mode 100644
index 0000000..762b153
--- /dev/null
+++ b/changelogs-v2/2026-07/28_5305_�日方案��与完�闭环���-修改接�-管���.md
@@ -0,0 +1,79 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5305"
+title: "�日方案��与完�闭环���"
+consumer: "admin"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "仅修正既有�日派车�存与需求完�事务语义；接�路径�方法�请求�应字段和�端交互���"
+updated_at: "2026-07-28"
+base: "dev-v3"
+---
+
+# Fleet：�日方案��与完�闭环���
+
+> **�务**：`hl-fleet-service`
+> **Issue**：#5305
+> **影�页�**：管���车务管� → �日�车派车方案�存
+> **兼容性**：接�路径�方法�请求/�应字段�错误�和数�库结构��，仅修正既有事务语义
+
+## 问题与目标
+
+�日派车支����交最终方案。旧实现存在五类边界：全程�用车或没有实际创建命令时会绕过最终订�基线；留车/直派模��化�能被误判为无�化；混�方案中的历�已完结切片�能因旧冻结标记缺失阻断需求完�；仅修改�日价格原因�会�库；�槽索引的旧�消版本�能抢�当�稳定槽�。
+
+本次�端统一修�上述���冻结和完�闭环，�新增�端�数或返回字段。
+
+## �更接�（既有语义修正）
+
+### `POST /admin/fleet/assignments/batch`
+
+请求和�应形状��：
+
+1. 包� `dailyPlan` 的�存会在资��内完�写入��冻结最终方案和生�需求完� Outbox �，�次读�当�订�详情�行程和 active 用车需求；日期�人数�行程或需求版本漂移时整批事务回滚。
+2. �使全部 `dailyPlan[].used=false`，或本次没有实际创建车辆/�机派�，也执行�一最终基线门�。
+3. ��时�时比较目标 `holdMode`�派�状��车辆��机�接机�与��日价格和�日价格调整原因：
+   - `holding → direct` 会按直派目标�新�地；
+   - `assigned → hold` 会按留车目标�新�地；
+   - 原因新增�修改和在���离日历价时清空��被忽略；�离日历价时原因必填规则����。
+4. 历� `completed` �日切片�使�自旧数��没有 `dispatchPlanFinalized=1`，在�一矩阵已有显�冻结切片时也按���的已完���日处�；�修改其业务状�，也�会把纯旧版未冻结拓扑误认�新最终方案。
+5. �一 `fleetItemIndex` �时存在旧 `canceled` 版本和当�在途/��消版本时，稳定槽�优先沿用当�版本，���写命中历�槽�。
+
+所有失败�沿用现有错误�应结构；事务失败�产生需求完�事件。
+
+## �端处�
+
+无需修改�端代�：
+
+- 继续�交现有 `dailyPlan`�`holdMode` 和�日价格原因；
+- 基线漂移时继续展示�端现有失败�示并刷新��试；
+- �需�新增字段�状�分支或页�组件。
+
+因此 `frontend_status=not_required`。
+
+## �影�范围
+
+- �修改 Controller�VO/DTO/BO�Feign 或 shared Java 契约。
+- �修改数�库字段��移�Long ID 字符串和手机�脱�规则。
+- �改�已完�/已�消业务状�，�放宽历��完结或关账�读门�。
+- �修改 `hl-ui` 仓库。
+
+## 验���
+
+- �端 PR `[wx/HL#5306](https://git.1814.love:8443/wx/HL/pulls/5306)` 已 squash �并至 `dev-v3`，�并�交 ``594d932db``。
+- `hl-fleet-service` 已滚动部署测试环境，8087/8187 �实例�康。
+- 定� `AssignmentServiceTest,FleetAssignmentMapperTest`：328 tests，0 failures，0 errors，0 skipped。
+- Fleet reactor verify：2480 tests，0 failures，0 errors，1 skipped；Spotless 628 Java files clean。
+- 独立 Reviewer 无未解决 P0–P1。
+- 真实测试网关通过登录和车务矩阵�读查询确认部署�网关�认�� Fleet �务链路正常；本次内部事务修正没有�安全构造的写侧正例，核心五类边界由定�测试覆盖，探针�产生业务写入。
+- 网关��：`D:/work2/HL-v3/.tmp/5305-gateway.json`，SHA-256 ``4698b3b8b1765715f6dc823664b3d24df2e977d26e6e19da08b5e298c6b6b0f6``。
+- 契约审查：`not_required`；当� diff 无 Controller�请求�应模型�Feign 或 shared Java �化。
+
+当�状�：�端已部署�网关兼容探针已通过，�端无需改造。
+
+关�：#5305。
-- 
2.43.0