docs(changelog): #7442 PR-C2 受控重开窗口 + 三份补部署清单与 dispatch-baseline 条目
changelog-filename-gate / validate (push) Failing after 2s

新增 PR-C2 那份(受控重开窗口 + 计划刷新状态收口),并给三份都补了此前缺的
「部署清单」一节 —— AC-19 ③ 逐字要求部署约束写进 PR 正文与 changelog,
实测 PR 正文有、三份 changelog 全文零命中。

滚动顺序逐 PR 分别分析,没有照抄同一份危险描述:
- PR-C2:🔴 逆序会静默退化 —— order-v3 先滚,旧 fleet 收到 dispatchable=true
  直接放行重配,而它不读 reconfigureWindow、不校验令牌与范围,两端日志都正常、
  没有任何报错。所以 fleet 必须先于 order-v3。
- PR-A / PR-C1:两个方向都不静默出错(fleet 先滚会整体报 602009,是明确错误码
  不是静默放行),如实写清与 PR-C2 的区别。

同时补记 GET /v3/internal/group-batch/{id}/dispatch-baseline —— 对 origin/dev-v3
查证,该端点响应体被 #7442 改过两次(8eb8e13cd 加四字段、c6aa1224f 加
reconfigureWindow),三份 changelog 此前都漏记。

三份都带上了「别按直接 pom 依赖查消费方」的警告:grep -rl 'hl-common-core' */pom.xml
只命中 gateway 与 hl-finance,其余六个服务经 hl-common-web / hl-starter-* 传递引入,
照那份清单部署漏掉的恰恰是本单真正改了的 order-v3 与 fleet。

Refs #7442

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-19 02:42:19 +08:00
共同撰写人 Claude Opus 5
父节点 00a6f15b91
当前提交 1c0439c44a
共修改 3 个文件,包含 862 行新增和 0 行删除
@@ -284,6 +284,36 @@ POST /admin/fleet/group-dispatch/batches/1934567890123456800/reconfigure
---
## 部署清单(本单改了 hl-common-core,CODE_RULES §16.6)
本单在 `hl-common-core` 的 `GroupBatchDispatchBaselineDTO`(团期配车权威基线)新增 `requirementId`/
`requirementVersion`/`requirementStatus`/`groups` 四个字段,并新增 `GroupBatchVehicleGroupBaselineDTO`
(乘车分组基线)全新类;order-v3 是这份基线的提供方,fleet 是消费方。
### 滚动顺序分析:本单与 #7957(PR-C2)的"fleet 必须先滚"不同——本单两个方向都不会静默出错
- **order-v3 先滚**:order-v3 开始下发新字段(`groups[]` 等),此时 fleet 还是旧版——**旧版 fleet 压根没有
本单新增的 `POST /admin/fleet/group-dispatch/batches/{groupBatchId}/reconfigure` 端点**(该端点是本单
才新增的),不存在任何消费方读取这些新字段,**零风险**。
- **fleet 先滚**:fleet 的新端点已经存在,但调用旧版 order-v3 的基线接口时**拿不到 `groups` 字段**
(Jackson 反序列化为 `null`)——fleet 侧的按组覆盖校验属于**失败关闭**设计(602009「无法取得本团的权威
乘车分组清单」),**这是本单与 PR-C2 最大的不同**:PR-C2 的 `dispatchable` 放宽会被旧 fleet 静默忽略、
放行了本不该放行的请求;本单缺 `groups[]` 则是**整个新端点在这段时间内全部请求都报 602009**——响应是
**明确的错误码,不是静默放行**,运营/车务会立刻发现"这功能用不了"而不是"这功能用了但结果不对"。
- **结论**:两个方向都不会产生数据错乱,区别只是"功能完全不可用一段时间"(fleet 先滚)还是"零影响"
(order-v3 先滚)。**仍然建议同批滚**(消除过渡期报错),但万一要分批,**order-v3 先滚风险更低**。
### 消费方清单不能按 `pom.xml` 直接依赖关系查
理由与判据同 `19_7442_团期配车受控重开窗口计划刷新状态收口-新增接口-管理后台.md`「部署清单」节——
`grep -rl 'hl-common-core' */pom.xml` 只命中 `hl-gateway`/`hl-finance`,order-v3 与 fleet 都经
`hl-common-web` 传递引入,不在直接依赖清单里,但正是本单真正改了代码的两个服务。
⇒ **实际部署单位共 7 个**:gateway / user / resource / product-v2 / order-v3 / mp / fleet;
本单不强制要求特定先后顺序,但**同批滚**仍是最稳妥的做法。
---
## 七、不影响范围
- **仅影响**: 团期配车页的整团逐日提交动作