From 0f8d28ba767e987a52c778686818d3c3ea56a174 Mon Sep 17 00:00:00 2001
From: wx <2636507191@qq.com>
Date: Fri, 23 Oct 2026 10:09:55 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20#9192=20=E5=B7=B2=E5=AE=89=E6=8E=92?=
 =?UTF-8?q?=E5=9B=A2=E4=BA=BA=E6=95=B0/=E7=89=B9=E6=AE=8A=E8=AF=89?=
 =?UTF-8?q?=E6=B1=82=E5=8F=98=E6=9B=B4=E6=8B=92=E7=BB=9D=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...¢äººæ•°ç‰¹æ®Šè¯‰æ±‚å�˜æ›´æ”¹ä¸ºæ˜¾å¼�æ‹’ç»�-ä¿®å¤�-管ç�†å�Žå�°.md | 72 +++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 changelogs-v2/2026-10/23_9192_已安排团人数特殊诉求�更改为显�拒�-修�-管���.md

diff --git a/changelogs-v2/2026-10/23_9192_已安排团人数特殊诉求�更改为显�拒�-修�-管���.md b/changelogs-v2/2026-10/23_9192_已安排团人数特殊诉求�更改为显�拒�-修�-管���.md
new file mode 100644
index 00000000..670d8f88
--- /dev/null
+++ b/changelogs-v2/2026-10/23_9192_已安排团人数特殊诉求�更改为显�拒�-修�-管���.md
@@ -0,0 +1,72 @@
+---
+schema: "hl-changelog/v2"
+ticket: "9192"
+title: "已安排团人数/特殊诉求�更改为显�拒�（�步失败原因补充类别）"
+consumer: "admin"
+author: "wx(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 #9204，squash e5e6fe212），已部署测试�任务 7e46904c，�实例 8187/8087 � is UP；真账� wx �网关 GET 派车工作�列表 HTTP 200 / code 200，39 团全部返回。本次�改���步�库的拒��件与 reason 文案：内部�步接�外层错误��为 603050，管���调用的查询接�入�/出�零�化；hl-ui 无需改代�。"
+updated_at: "2026-10-23"
+base: "dev-v3"
+---
+
+# 已安排团人数/特殊诉求�更改为显�拒�（管���告知）
+
+> ��：管����端（hl-ui）
+> 日期：2026-10-23 ｜ �端：hl-fleet-service（二期 dev-v3）
+> 结论：**管���查询接�零�化��端无需改代�**；���步在「已安排团 + 人数/特殊诉求�化�时会��为显�失败，失败原因会说明是哪一类�更。
+
+## 一�背景
+
+派车工作�用「需求已��徽标�示调度�排车。该徽标�覆盖「车型�示 / 建议辆数 / 接�趟日期�三样；订�侧改人数或特殊诉求，�在标记范围内。
+
+此�的行为是：已安排过车的团收到这类�更时，�端会把新值�默�库��置任何标记，调度看�到徽标，�能按原车派出。本�把这类�更��为显�拒�，���默改数。
+
+## 二��更点
+
+| 项 | 内容 |
+|---|---|
+| 影�层 | ���步�库（内部链路，�管���查询接�） |
+| 触��化 | 已安排团 + 需求行人数 / 特殊诉求�更时，由「�默�库�改为「显�失败� |
+| 失败原因 | `团已安排过车：本版本�支�已安排团的人数�特殊诉求等内容�更，请先撤回派车行���步` |
+| 管���接� | 入���功�应�分页结构�字未�；团详情等查询接��会因此新增 500 |
+| �端动作 | �需�改代�；本告知用于让�端/支�人员知��步失败的新原因 |
+
+## 三�触��件
+
+�时满足以下�件时，���步�库失败：
+
+1. 该团已�安排过车（存在未撤下的派车行）；
+2. 订�侧�步过�的需求行，人数（headcount）或特殊诉求（specialTags）�生�化；
+3. 这两类字段�属于「需求已��徽标覆盖的车型 / 辆数 / 接�日期三样。
+
+未安排过车的团��影�：人数�特殊诉求照旧�库，�置标记。
+
+## 四�错误表现
+
+| 项 | 值 |
+|---|---|
+| 内部�步外层错误� | `603050`（DISPATCH_SOURCE_SNAPSHOT_INVALID，未�） |
+| reason / message | `团已安排过车：本版本�支�已安排团的人数�特殊诉求等内容�更，请先撤回派车行���步` |
+| 管�����性 | 团详情的顺手�步是异步执行并�异常的，�会把这� message 直接返回给页�；管����新增错误分支 |
+| 处置建议 | 调度先撤回该团派车行，��新�步；��把它当�系统故障 |
+
+内部常� `REJECT_ARRANGED` 的文案�步更新；�端�应�赖内部常��。
+
+## 五��影�范围
+
+- 管���查询接�的请求�数��功�应字段�分页结构：�字未�。
+- 车型 / 辆数 / 接�日期�更：�放行，�置「需求已��。
+- 未安排团：人数 / 特殊诉求�照常�库，�置标记。
+- �新增表��新增列��改 Flyway��涉�金�。
+
+## 六�测试环境已验�
+
+2026-10-23 已部署 dev-v3（�交 e5e6fe212）到测试�，�实例 8187/8087 � is UP；真实账� wx 登录��网关 GET 派车工作�列表 HTTP 200 / code 200，39 团全部返回。真 MySQL 事务用例覆盖：已安排团人数�更�特殊诉求�更�拒�且库中原值��；未安排团两类�更��库且�置标记。
\ No newline at end of file