From 98ca7cc7d469f1d477760314bbf67a33ac12ffb5 Mon Sep 17 00:00:00 2001
From: wx <2636507191@qq.com>
Date: Fri, 23 Oct 2026 12:45:01 +0800
Subject: [PATCH] =?UTF-8?q?changelog(9209):=20=E5=8D=95=E5=9B=A2=E6=8E=92?=
 =?UTF-8?q?=E8=BD=A6=E9=A1=B9=E4=B8=8A=E9=99=90=204000->500=EF=BC=88?=
 =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=8E=A5=E5=8F=A3/=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E5=90=8E=E5=8F=B0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...’车项上é™�ç”±4000收紧到500-修改接å�£-管ç�†å�Žå�°.md | 201 ++++++++++++++++++
 1 file changed, 201 insertions(+)
 create mode 100644 changelogs-v2/2026-10/23_9209_�团排车项上�由4000收紧到500-修改接�-管���.md

diff --git a/changelogs-v2/2026-10/23_9209_�团排车项上�由4000收紧到500-修改接�-管���.md b/changelogs-v2/2026-10/23_9209_�团排车项上�由4000收紧到500-修改接�-管���.md
new file mode 100644
index 00000000..4e9ffc5e
--- /dev/null
+++ b/changelogs-v2/2026-10/23_9209_�团排车项上�由4000收紧到500-修改接�-管���.md
@@ -0,0 +1,201 @@
+---
+schema: "hl-changelog/v2"
+ticket: "9209"
+title: "�团排车项上�由 4000 收紧到 500：超过 500 项在�交阶段�被拒，文案改为「请�少�车项��新�交�"
+consumer: "admin"
+author: "chewu5(GIT)"
+change_type: "修改接�"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "已�并 dev-v3（PR #9218，squash 5f1d456c4），已部署测试�（deploy-backend hl-fleet-service --branch dev-v3，11:47:04）：deploy-status 显示 dev-v3 / 5f1d456c4 / 0/N / ok；�实例 8087�8187 health � 200，部署日志 Started 之� ERROR 0。契约�化�有一处上�：POST /admin/fleet/assignments/batch 的 dailyPlan 由最多 4000 项收紧到 500 项（@Size(max=500)），501 项起返回 400 + �执行文案；入�字段�/类型�出�结构�其余错误��未�。确认侧上� 500 与 #9193 的计数守�原样�留，常�统一到 FleetLimits.MAX_DISPATCH_ITEMS_PER_GROUP。hl-ui �改也�会错；若�端曾按 4000 �本地上�，建议�步到 500，�得用户填到 501~4000 项�在�交时被拒。"
+updated_at: "2026-10-23"
+base: "dev-v3"
+---
+# hl-fleet-service: �团排车项上�由 4000 收紧到 500
+
+> **�务**: hl-fleet-service（管���）
+> **PR**: #9218（已�入 dev-v3，�并�交 5f1d456c4）
+> **Issue**: #9209
+> **日期**: 2026-10-23
+> **影�范围**: 管���「车务最终实派方案�批��交（`dailyPlan` 项数上�）
+
+---
+
+## ⚠� 关键�化
+
+🟢 `POST /admin/fleet/assignments/batch` 的 `dailyPlan` 上�：**4000 项 → 500 项**。
+
+🟢 超过上�的拒�文案改为�执行�示：
+
+```text
+�次�日派车�置�能超过500项，请�少�车项��新�交
+```
+
+🔴 请求体字段�/类型��应结构�错误�集�都没�；500 项整�然�功�交，501 项起�被拒。
+
+---
+
+## 一�背景
+
+确认侧（`POST /admin/fleet/group-dispatch/batches/{groupBatchId}/confirm`）自 #9179 起�团��许 500 行存活�车行，而�交侧 `batchCreate` 的 `dailyPlan` 一直�许 4000 项（该数值�自 #5292，无容���）。两者�一致的结果是：**501～4000 项的团能建得���永远确认�了**——25 天 × 21 车的常规团就是 525 项，直接命中。
+
+wx 2026-10-23 ��：500 够用，�交侧收紧到 500。本��时把「500�这个数字收敛到唯一出处 `FleetLimits.MAX_DISPATCH_ITEMS_PER_GROUP`：�交侧的 Bean Validation 注解与确认侧的行数守�引用�一个常�，��将�改一处�一处。
+
+## 二��更接�清�
+
+| # | 接� | 方法 | 路径 | �更类型 | 说明 |
+|---|------|------|------|----------|------|
+| 1 | 车务最终实派方案原��交 | POST | `/admin/fleet/assignments/batch` | 入�上�收紧 + 文案 | `dailyPlan` 最多 500 项（原 4000）；其余字段与出��� |
+
+## 三�接�详情
+
+### 1. 车务最终实派方案原��交 `POST /admin/fleet/assignments/batch`
+
+**VO**: `BatchCreateAssignmentReqVO` / `Result<BatchAssignmentWriteRespVO>`
+
+#### 使用场景
+
+管���在团期 / 订�的车务�车页点「�交最终方案�时调用：一次�交该需求在完整日期窗内的�日�车清�（�务日期 × 车辆 × �机），�务端原��库并回写订�。
+
+#### 入�
+
+| 字段 | �置 | 类型 | 必填 | 约� | 说明 |
+|------|------|------|------|------|------|
+| orderId | Body | Long | ✅ | - | 订� ID |
+| requirementId | Body | Long | ✅ | - | 当�生效用车需求 ID |
+| kind | Body | String | � | TRAVEL / TRANSFER | 需求类别，�传按 TRAVEL |
+| startDate / endDate | Body | Date | ✅ | - | 用车起止日期 |
+| requestId | Body | String | ✅ | ≤ 64 字符 | 批次级幂等标识 |
+| **dailyPlan** | Body | Array | ✅ | **≤ 500 项（原 4000）** | 按行程日的完整�车列表，�项为 �务日期×车辆×�机；�一�务日�许多� |
+| 其余字段 | Body | - | � | - | 与改动�一致（headcount / pickupAt / dropoffAt / sendItinerarySms 等） |
+
+#### 出� `Result<BatchAssignmentWriteRespVO>`
+
+结构与字段��未�：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| assignments | Array | 本次�交�库的�车行列表 |
+| finalPlanPublished | Boolean | 最终方案是�已�布 |
+| finalPlanNotPublishedReason | String | 未�布时的第一个原因；�布时为 null |
+| pickupDropoffGate | Object | 接�机第③步门�信� |
+| failedFleetItemIndex | Integer | 失败的�车项下标（仅失败时） |
+| dailyDifferences | Array | 整批 diff 明细（按日） |
+| fleetItemIndex | Integer | 当�处�到的�车项下标 |
+| assignment | Object | �行写入结果（`AssignmentWriteRespVO`） |
+
+#### 请求示例
+
+```json
+{
+  "orderId": "2112275846201069569",
+  "requirementId": "2112275846201070000",
+  "startDate": "2026-10-25",
+  "endDate": "2026-10-30",
+  "requestId": "batch-20261023-0001",
+  "dailyPlan": [
+    { "serviceDate": "2026-10-25", "vehicleId": "2112275846201088001", "driverId": "2112275846201099001" }
+  ]
+}
+```
+
+#### �应示例
+
+```json
+{ "code": 200, "message": "�功", "data": { "finalPlanPublished": true, "finalPlanNotPublishedReason": null }, "success": true }
+```
+
+#### 空数� / �级�应
+
+`dailyPlan` 为空或缺失�属于�级场景：`@NotNull` 直接拒�，返回 400「�日派车计划�能为空�。
+
+#### 错误�应
+
+超过 500 项时（HTTP 200 + 业务�，网关统一语义）：
+
+```json
+{ "code": 400, "message": "�次�日派车�置�能超过500项，请�少�车项��新�交", "data": null, "success": false }
+```
+
+其余错误�（605062 �务日期越窗�605912 派车快照缺车型等）语义与文案�未�。
+
+#### 业务边界
+
+- `dailyPlan` �好 500 项：**�功**，与改动�一样走完整�交�程。
+- `dailyPlan` 501 项起：`@Size` 拒�，**零写入**，�产生�车行��触�订�回写。
+- 确认侧上��是 500 行存活�车行（#9179 / #9193），且 #9193 的「先计数拒���读明细�守�原样�留；�交侧与确认侧现在共用�一常�。
+- 本��动读�路径��动表结构��订正存�数�。
+
+## 四�契约约�与正确调用方�
+
+| 场景 | 调用 |
+|------|------|
+| ✅ �团 ≤ 500 项 | 正常�交 |
+| � 501～4000 项 | 会被 400 拒�；应按�示�少�车项��新�交，���试�一请求 |
+| � 把 400 当���试的并�错误 | �是并�错误，�试�会改�项数 |
+
+�端若��交�校验，上�请用 **500**；已�按 4000 �本地上�的页�在 501～4000 项时会拿到上述 400 与文案（功能�会错，�是�示出现在�交时刻）。
+
+## 五�数�库行为
+
+无表结构�更�无 Flyway�无数�订正。仅�交侧入�校验收紧。
+
+## 六�边界行为
+
+- 边界严格按 `> 500`：500 �功�501 拒�，两侧都有�元用例（`BatchCreateAssignmentReqVOTest#validate_dailyPlanAtLimit_passes` / `#validate_dailyPlanOverLimit_violatesSize`）。
+- 校验�生在 Controller 入�绑定阶段（`@Valid`），早于任何业务写入与�获�。
+- 确认侧文案：「拆团�措辞已清�，现为「请�少�车项��试�（该动作没有接�，�该出现在�示里）。
+
+## 六.6�修改��对比
+
+### 行为级对比
+
+| 场景 | 改� | 改� |
+|------|------|------|
+| dailyPlan = 500 项 | �功 | �功（��） |
+| dailyPlan = 501 项 | �功�交（��永远确认�了） | 400 拒�，零写入 |
+| dailyPlan = 1000 / 4000 项 | �功�交（死团） | 400 拒� |
+| 确认侧 > 500 存活行 | 602010（#9193：先计数拒�） | �� |
+
+### 字段级对比
+
+无字段�化：字段��类型�必填性�枚举�错误�数值�未改；�有 `dailyPlan` 的 `@Size(max)` 由 4000 �为 500，以�超�文案改为�执行�示。
+
+## 六.7�影�评估
+
+- **是�破���兼容**: 是「收紧�而�「破��——�法调用（≤ 500 项）行为与出�完全��；原本能�交的 501～4000 项现在被��拒�，而这批数�原本也无法确认（确认侧上� 500）。
+- **�端是�必须�步上线**: �。�端��任何改动也能正常�交 ≤ 500 项；若�端自己按 4000 �本地上�，建议�步到 500（�是把�示��到用户编辑时）。
+- **�端 workaround 清�点**: 若有页�按 4000 �客户端�数校验，把常�改为 500。
+- **存�数�**: 测试� > 500 行的团 0 个，无需订正；生产如有存�死团，应��处置（本���数�订正）。
+
+## 七��影�范围
+
+- 其它 `hl-fleet-service` 接�：`PickupDropoffConfigReqVO` 的 4000 上�属接�机�置，写的是�一张表���与 `fleet_group_dispatch`，本�未改。
+- 确认侧守�逻辑（#9193）零改动。
+- `hl-mini` / `about-h5` �消费 `/admin/fleet/**`。
+
+## 八�测试环境已验�
+
+| 项 | 读数 |
+|---|---|
+| 部署 | `deploy-backend hl-fleet-service --branch dev-v3` 11:47:04；deploy-status：dev-v3 / 5f1d456c4 / 0/N / ok |
+| �实例 | 8087�8187 `is UP`，`/actuator/health` � 200 |
+| 部署日志 | 两实例 `Started` 之� ` ERROR ` 计数� 0 |
+| 定�测试 | `BatchCreateAssignmentReqVOTest` 13 / `AssignmentControllerTest` 49 / `GroupDispatchConfirmTest` 32 / `FleetRedLineArchTest` 31+2，SUM tests=127 failures=0 errors=0 skipped=0 |
+| 编译 | 清 classes ��新编译：Compiling 1195 main + 532 test，EXIT=0 |
+| 存�数��读核对 | 测试� `fleet_group_dispatch` 存活行：>500 行的团 0 个（最多 7 行，4 团共 23 行）⇒ 无死团需�处置 |
+
+## ��相关文档
+
+- `docs/fleet-workbench/1-2接�文档.md`（�交接�的 dailyPlan 上�说明如与本��一致，以本�为准）
+- 上游�：#9179（确认侧 500 行上�）�#9193（先计数�拒�）�#5292（4000 的��，已判定无��）
+
+## 关� / �系人
+
+- �端：车务5（本�实现与验�）
+- 工�：wx/HL#9209；PR：wx/HL#9218
\ No newline at end of file