From 69c0b76bb94f044a29b4b3a0c608d1d31f4f89fb Mon Sep 17 00:00:00 2001
From: lc <liuchang@1814.love>
Date: Wed, 30 Sep 2026 16:21:51 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8579=20=E6=8E=A5=E9=80=81?=
 =?UTF-8?q?=E6=9C=BA=E9=85=8D=E7=BD=AE=E8=A1=A5=E5=8F=91=E6=9D=A1=E4=BB=B6?=
 =?UTF-8?q?=E6=94=BE=E5=AE=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Refs wx/HL#8579
---
 ...Ž¥é€�机é…�置补å�‘æ�¡ä»¶æ”¾å®½-修改接å�£-管ç�†å�Žå�°.md | 266 ++++++++++++++++++
 1 file changed, 266 insertions(+)
 create mode 100644 changelogs-v2/2026-09/30_8579_接�机�置补��件放宽-修改接�-管���.md

diff --git a/changelogs-v2/2026-09/30_8579_接�机�置补��件放宽-修改接�-管���.md b/changelogs-v2/2026-09/30_8579_接�机�置补��件放宽-修改接�-管���.md
new file mode 100644
index 00000000..c7706fc1
--- /dev/null
+++ b/changelogs-v2/2026-09/30_8579_接�机�置补��件放宽-修改接�-管���.md
@@ -0,0 +1,266 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8579"
+title: "接�机�置接�补��件放宽：门�已满足且订�有接�机声明时�存也会补�最终方案，NO_GATE_TRANSITION 出现频率下�"
+consumer: "admin"
+author: "lc(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "PR #8595 已�并 dev-v3（0f19f383f），hl-fleet-service 已部署 TEST（8e00cc98b）并� Gateway 实测。�应结构未�，�端无需改代�。"
+updated_at: "2026-09-30"
+base: "dev-v3"
+---
+
+# hl-fleet-service: 接�机�置接�补��件放宽
+
+> **存放目录**: `changelogs-v2/2026-09/`
+> **�务**: hl-fleet-service (端� 8089)
+> **PR**: #8595
+> **Issue**: #8579
+> **日期**: 2026-09-30
+> **影�范围**: 车务四步�导第③步「接�机�置��存�的最终方案补�
+
+---
+
+## ⚠� 关键�化
+
+- **以�**：�有「本次�存�门��满足��存�满足��补�最终方案；门�本�就满足时��存一次，一律回 `NO_GATE_TRANSITION`��补�。
+- **现在**：�存�门�满足，并且（�存��满足，**或**订�大交通有接�机声明）就�试补�。门�本�就满足�订�有接�机声明时�存，也会补�。
+- **补���过全部守�**：�版�留下旧定稿（`STALE_FINALIZED_PLAN`）�方案代际�一致�没派满，照样��，并如实回原因。�版�的订��须车务�新确认执行，本次没有绕开这�守�。
+- **�端无需改代�**：请求体��应结构�错误�都没�；�是 `finalPlanPublished=true` 出现得更多�`NO_GATE_TRANSITION` 出现得更少。
+
+---
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | 接�机�置（按派车行整批幂等覆盖） | PUT | `/admin/fleet/assignments/pickup-dropoff-config` | 补�时机放宽 | 请求��应结构�� |
+
+---
+
+## 三�接�详情
+
+### 1. 接�机�置 `PUT /admin/fleet/assignments/pickup-dropoff-config`
+
+**VO**: `PickupDropoffConfigReqVO → PickupDropoffConfigRespVO`
+
+#### 使用场景
+
+车务四步�导第③步�存接�机勾选。排车（`POST /admin/fleet/assignments/batch`）时大交通�求接/�机的日期还没�车，最终方案被压�（batch 回 `GATE_UNSATISFIED`）；在本接����，�务端当场补�。
+
+#### 入�（未�）
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| `orderId` | Body | Long | ✅ | - | 订� ID |
+| `requirementId` | Body | Long | ✅ | - | 当�生效用车需求 ID |
+| `kind` | Body | String | - | `TRAVEL`（默认）/ `TRANSFER` | 需求类别 |
+| `requestId` | Body | String | ✅ | �空 | 幂等请求标识 |
+| `items[]` | Body | Array | ✅ | �列�与接�的行 | 两个标志都为 false 的行��放进�（�则 400）；未列入的行�务端置 0 |
+| `items[].assignmentId` | Body | Long | ✅ | 当�需求下生效派车行 | 派车行 ID |
+| `items[].pickupParticipant` | Body | Boolean | ✅ | - | 当天是��与接机 |
+| `items[].dropoffParticipant` | Body | Boolean | ✅ | - | 当天是��与�机 |
+
+#### 出� `Result<PickupDropoffConfigRespVO>`（结构未�）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `finalPlanPublished` | Boolean | 本次是�补�了最终方案 |
+| `finalPlanNotPublishedReason` | String | 未补�原因，补�时为 `null`；�值�六.5 |
+| `requirementReopened` | Boolean | 是�把已完�订�拉回处�中（未�） |
+| `reopenBlockedReason` | String | 本该拉回�没拉回的原因（未�） |
+| `pickupDropoffGate` | Object | 写入�的门�状�：`arrivalRequiredDates` / `departureRequiredDates` / `missingPickupDates` / `missingDropoffDates` / `declared` / `satisfied` |
+
+#### 请求示例
+
+```json
+{
+  "orderId": "2105196047255126017",
+  "requirementId": "2105197351138410497",
+  "kind": "TRAVEL",
+  "requestId": "pd-2105196047255126017-20260930-02",
+  "items": [
+    { "assignmentId": "2105197584132046850", "pickupParticipant": true, "dropoffParticipant": false },
+    { "assignmentId": "2105197584157212674", "pickupParticipant": false, "dropoffParticipant": true }
+  ]
+}
+```
+
+#### �应示例（���补�）
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "finalPlanPublished": true,
+    "finalPlanNotPublishedReason": null,
+    "requirementReopened": false,
+    "reopenBlockedReason": null,
+    "pickupDropoffGate": {
+      "arrivalRequiredDates": ["2026-10-12"],
+      "departureRequiredDates": ["2026-10-14"],
+      "missingPickupDates": [],
+      "missingDropoffDates": [],
+      "declared": true,
+      "satisfied": true
+    }
+  }
+}
+```
+
+#### �应示例（�版���，�被陈旧定稿拦下）
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "success": true,
+  "data": {
+    "finalPlanPublished": false,
+    "finalPlanNotPublishedReason": "STALE_FINALIZED_PLAN",
+    "requirementReopened": false,
+    "reopenBlockedReason": null,
+    "pickupDropoffGate": { "declared": true, "satisfied": true, "missingPickupDates": [], "missingDropoffDates": [] }
+  }
+}
+```
+
+#### 空数� / �级�应
+
+订�大交通没有接�机声明时 `pickupDropoffGate` �日期数组为空�`declared=false`�`satisfied=true`；此时�存�补�：
+
+```json
+{ "code": 200, "success": true, "data": { "finalPlanPublished": false, "finalPlanNotPublishedReason": "NO_GATE_TRANSITION", "pickupDropoffGate": { "declared": false, "satisfied": true, "missingPickupDates": [], "missingDropoffDates": [] } } }
+```
+
+#### 错误�应
+
+```json
+{
+  "code": 400,
+  "message": "�一行接�机标志�能全为 false；��与的行��出现在�置列表中",
+  "success": false,
+  "data": null
+}
+```
+
+#### 业务边界
+
+- 补�时机：�存�门�满足，且�存��满足或订�有接�机声明。订�大交通没有接�机声明时，�存�会补�（回 `NO_GATE_TRANSITION`），���存一次都�一版没有�化的最终方案。
+- 补���次过陈旧定稿�方案代际�满派拓扑�接�机门�四�判�，�回第一个没通过的原因。
+- �一需求多次补�，order-v3 的�车记录按最新一版整体替�，�会��累加。
+
+---
+
+## 四�契约约�与正确调用方�
+
+- `finalPlanPublished=false` �是错误，按 `finalPlanNotPublishedReason` �示车务下一步：`GATE_UNSATISFIED`/`NO_GATE_TRANSITION` 看 `pickupDropoffGate.missing*Dates` 补�；`STALE_FINALIZED_PLAN` �示车务�新确认执行；`PLAN_INCOMPLETE` �示补派。
+- ��按 `NO_GATE_TRANSITION` 判断「这次�存没生效�：勾选照常�库，它�表示本次没有�试补�。
+
+---
+
+## 五�数�库行为
+
+- 补�时写 fleet `fleet_vehicle_assignment_snapshot_state`（修订� +1）和 `fleet_vehicle_assignment_snapshot_outbox`，�异步写 order-v3 `order_vehicle_assignment`（旧行软删�按新一版�建）。
+- �补�时�更新派车行的接�标志。
+
+---
+
+## 六�边界行为
+
+- 未登录 → 401（网关拦截）
+- `items` �两个标志都为 false 的行 → 400「�一行接�机标志�能全为 false�
+- �版�未�车务�新确认 → �补�，回 `STALE_FINALIZED_PLAN`
+
+---
+
+## 六.5�枚举 / 数�字典
+
+### finalPlanNotPublishedReason（`FinalPlanNotPublishedReasons`）
+
+| �值 | �义 |
+|------|------|
+| `STALE_FINALIZED_PLAN` | 存在按旧需求定稿的陈旧行，需车务�新确认 |
+| `INVALID_PLAN_GENERATION` | 方案代际�一致 |
+| `PLAN_INCOMPLETE` | 满派拓扑�完整（缺车 / 缺�机 / 在途行越窗等） |
+| `CAPACITY_INSUFFICIENT` | 未定稿方案载客��足 |
+| `GATE_UNSATISFIED` | 大交通�求的接/�机日未�车 |
+| `NO_GATE_TRANSITION` | **�径�化**：本次没有�试补�——�存�门���满足，或门�满足但订�没有接�机声明且�存�已满足 |
+| `PICKUP_DROPOFF_GATE_DISABLED` | 接�机门�开关关闭 |
+
+---
+
+## 六.6�修改��对比
+
+### 行为级对比
+
+| 场景 | 修改� | 修改� |
+|------|--------|--------|
+| �存�缺���存��� | 补� | 补�（��） |
+| 门�本已满足�订�有接�机声明，��存 | `NO_GATE_TRANSITION`，�补� | �试补�（过全部守�） |
+| 门�本已满足�订�无接�机声明，��存 | `NO_GATE_TRANSITION` | `NO_GATE_TRANSITION`（��） |
+| �存��缺� | `NO_GATE_TRANSITION` | `NO_GATE_TRANSITION`（��） |
+| �版��� | `NO_GATE_TRANSITION` 或 `STALE_FINALIZED_PLAN` | `STALE_FINALIZED_PLAN` |
+
+---
+
+## 六.7�影�评估
+
+- **是�破���兼容**: �
+- **�端是�必须�步上线**: �
+- **�端 workaround 清�点**: 无
+
+---
+
+## 七��影�范围
+
+- **仅影�**: `PUT /admin/fleet/assignments/pickup-dropoff-config` 的补�时机
+- **零影�**: 请求体与�应结构；`POST /admin/fleet/assignments/batch`；确认执行接�（缺失日期字段的删除� #8603 changelog）
+
+---
+
+## 八�测试环境已验�
+
+2026-09-30 TEST（hl-fleet-service @ 8e00cc98b）� Gateway 实测，夹具订�验收�已行��消：
+
+| 场景 | 结果 |
+|------|------|
+| batch 排满三天�首日接机末日�机未� | `finalPlanPublished=false` + `GATE_UNSATISFIED`，缺 `2026-10-12` / `2026-10-14` |
+| ��接机 | `NO_GATE_TRANSITION`，门��缺 `2026-10-14` |
+| ��接机 + �机 | `finalPlanPublished=true`，outbox 1 行，order-v3 �车记录 3 行 |
+| �版��� | `finalPlanPublished=false` + `STALE_FINALIZED_PLAN`，门� `satisfied=true`，无快照�出 |
+
+---
+
+## ��相关历� PR
+
+- #8429：统一 batch / 接�机�置 / 确认三处的最终方案�布判�，引入 `finalPlanNotPublishedReason`。
+- #8603（PR #8608）：确认执行�应删除�为空的缺失日期字段，缺失日期改由 605914/605915 错误消�承载。
+
+---
+
+## ��相关文档
+
+- 关� Issue: [wx/HL#8579](https://git.1814.love/wx/HL/issues/8579)
+- 关� PR: [wx/HL#8595](https://git.1814.love/wx/HL/pulls/8595)
+
+## 关� / �系人
+
+### 链接
+
+- **Issue**: [#8579](https://git.1814.love/wx/HL/issues/8579)
+- **PR**: [#8595](https://git.1814.love/wx/HL/pulls/8595)
+- **Merge commit**: [0f19f383f](https://git.1814.love/wx/HL/commit/0f19f383faf3f0df9489b342c15afb42addf09f5)
+
+### �系人
+
+- �端：@lc