docs(7442): 修 5 处指向「从未存在过的文件名」的悬空引用,改为单号+glob
changelog-filename-gate / validate (push) Failing after 2s

#7442 的两份交接件里有 5 处引用
`19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md`。
该文件名在全历史零命中(阳性对照:同一条命令能找到确知已提交的
`*7442*reconfigure补登*`,所以零命中是真空不是 glob 写错)——它是起草期的
一份草稿名,该稿已并入现存的 `*_7444_*` 交接件、名字不再存在。

不改成「现存的那个文件名」,因为那会埋一次必然的再次失效:
① 那份文件还没提交(门禁按设计拦着 backend_status=pending);
② 本仓文件名带提交日前缀,它哪天被推名字就是哪天;
③ 「指向文件名」本身就是错的抽象层——文件名会变,单号不会。

改成「#7444 的交接件(按 `*_7444_*` 检索)」,这个形态不需要第二次维护。
旧名在括号里保留一句接住 grep。

Refs #7444

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot
2026-09-20 12:05:46 +08:00
共同撰写人 Claude Opus 5
父节点 ae069b00a9
当前提交 25e77cf72e
共修改 2 个文件,包含 5 行新增和 5 行删除
@@ -256,7 +256,7 @@ POST /admin/fleet/group-dispatch/batches/1934567890123456800/reconfigure
#### 业务边界
- **鉴权**: `X-Admin-Role` 须为 `VEHICLE_MANAGER` 或 `SUPER_ADMIN`(`FleetAdminRoleGuardInterceptor` 角色门禁,**不是权限点**——工单原文与部分源码 javadoc 写的"权限点 `fleet:group-dispatch:write`"在数据库层从未注册,全仓 `*.sql` 搜不到这个字符串,见 `19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md`「关键变化」第 2 条的详细核实过程)
- **鉴权**: `X-Admin-Role` 须为 `VEHICLE_MANAGER` 或 `SUPER_ADMIN`(`FleetAdminRoleGuardInterceptor` 角色门禁,**不是权限点**——工单原文与部分源码 javadoc 写的"权限点 `fleet:group-dispatch:write`"在数据库层从未注册,全仓 `*.sql` 搜不到这个字符串,见 #7444 的交接件(`changelogs-v2/2026-09/` 下按 `*_7444_*` 检索;本仓文件名带**提交日前缀**,会随提交日变,所以这里不写死文件名。⚠️ 起草期曾以 `…同团车辆共用关系-新增接口…` 为名,该稿已并入前者、名字不再存在) 的「关键变化」第 2 条详细核实过程)
- **防重与幂等是两件事,不要混读**:①10 秒内对同一份计划重复提交会被 `@Idempotent` 防重窗口**拒绝**
(返 100502「团期配车重配处理中,请勿重复提交」),前端按"稍后重试"处理;②窗口**之外**重复提交同一份
计划会正常受理并返回 `idempotentShortCircuit=true`——**那是成功**(计划未变、未落库、未产生新意图),
@@ -353,7 +353,7 @@ POST /admin/fleet/group-dispatch/batches/1934567890123456800/reconfigure
- **零影响**:
- 确认整团配车 `POST .../confirm`(见 `17_7442_团级确认态-需求已发车务回写-新增接口-管理后台.md`)
- 受控重开/计划刷新流程的其余 4 个端点(见 `19_7442_团期配车受控重开窗口计划刷新状态收口-新增接口-管理后台.md`)
- 团期配车就绪判定、同团车辆共用关系(见 `19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md`)
- 团期配车就绪判定、车辆共用关系(见 #7444 的交接件(`changelogs-v2/2026-09/` 下按 `*_7444_*` 检索;本仓文件名带**提交日前缀**,会随提交日变,所以这里不写死文件名。⚠️ 起草期曾以 `…同团车辆共用关系-新增接口…` 为名,该稿已并入前者、名字不再存在))
---
@@ -12,7 +12,7 @@ frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "本文档是补登。PR-C1(#7923,merge commit 6f5b1b679f6b534081ca7b136e338cd3fffc1155,2026-09-18 合入 dev-v3)首次交付本次改动时同样漏写了交接件——这是排查 #7442 交接件缺口时顺带发现的第二处(第一处是 PR-A 的 reconfigure 端点,见 19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md)。backend_status=deployed 依据:6f5b1b679 已在 dev-v3,测试服 2026-09-19 01:15 已滚动部署到 4cbccc26b(晚于本提交,链上包含)。gateway_status=verified 依据:2026-09-19 已对本文档覆盖的两个端点各做真实调用并做数据库交叉核实,见第八节;⚠️ 本文档此前 gateway_status 字段写着 verified 而 status_note 与第八节都写着 pending,头身不一致,那时的 verified 是假状态。⚠️ 同轮实测还查出并订正了一处契约错误:batchStatus 在 applied=true 时恒为 null,而本文档原先的两个成功响应示例给的是非 null 值,照旧稿写的前端会读到一个永远为空的字段——已在第三节两处订正。frontend_status 记 not_required:本文档涉及的两个端点都是仅限内部 Feign 调用的接口,不面向 hl-ui,前端无需改动。⚠️ 本文档只覆盖 PR-C1(#7442)原始交付的两级判定部分;#7444 PR-1 随后在 vehicle-ready 端点同一事务内又追加了一步(团级正式需求 DISPATCHED→DONE),那部分内容已在 19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md 交付,本文档不重复。"
status_note: "本文档是补登。PR-C1(#7923,merge commit 6f5b1b679f6b534081ca7b136e338cd3fffc1155,2026-09-18 合入 dev-v3)首次交付本次改动时同样漏写了交接件——这是排查 #7442 交接件缺口时顺带发现的第二处(第一处是 PR-A 的 reconfigure 端点,见 19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md)。backend_status=deployed 依据:6f5b1b679 已在 dev-v3,测试服 2026-09-19 01:15 已滚动部署到 4cbccc26b(晚于本提交,链上包含)。gateway_status=verified 依据:2026-09-19 已对本文档覆盖的两个端点各做真实调用并做数据库交叉核实,见第八节;⚠️ 本文档此前 gateway_status 字段写着 verified 而 status_note 与第八节都写着 pending,头身不一致,那时的 verified 是假状态。⚠️ 同轮实测还查出并订正了一处契约错误:batchStatus 在 applied=true 时恒为 null,而本文档原先的两个成功响应示例给的是非 null 值,照旧稿写的前端会读到一个永远为空的字段——已在第三节两处订正。frontend_status 记 not_required:本文档涉及的两个端点都是仅限内部 Feign 调用的接口,不面向 hl-ui,前端无需改动。⚠️ 本文档只覆盖 PR-C1(#7442)原始交付的两级判定部分;#7444 PR-1 随后在 vehicle-ready 端点同一事务内又追加了一步(团级正式需求 DISPATCHED→DONE),那部分内容已在 #7444 的交接件(changelogs-v2/2026-09/ 下按 *_7444_* 检索;本仓文件名带提交日前缀会随提交日变,故不写死文件名。起草期曾以「同团车辆共用关系-新增接口」为名,该稿已并入前者、名字不再存在) 交付,本文档不重复。"
updated_at: "2026-09-19"
base: "dev-v3"
---
@@ -467,7 +467,7 @@ hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/fleet/GroupBatchVeh
- #7442 PR-A 的 `reconfigure` 写口(见 `19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md`)
- #7442 PR-B 的确认/回写链路(见 `17_7442_团级确认态-需求已发车务回写-新增接口-管理后台.md`)
- #7442 PR-C2 的受控重开窗口流程(见 `19_7442_团期配车受控重开窗口计划刷新状态收口-新增接口-管理后台.md`)
- #7444 PR-1 在本端点追加的 DISPATCHED→DONE 推进(见 `19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md`,本文档不重复该部分)
- #7444 PR-1 在本端点追加的 DISPATCHED→DONE 推进(见 #7444 的交接件(`changelogs-v2/2026-09/` 下按 `*_7444_*` 检索;本仓文件名带**提交日前缀**,会随提交日变,所以这里不写死文件名。⚠️ 起草期曾以 `…同团车辆共用关系-新增接口…` 为名,该稿已并入前者、名字不再存在),本文档不重复该部分)
---
@@ -538,7 +538,7 @@ hl-common/hl-common-core/src/main/java/com/hulalv/common/dto/fleet/GroupBatchVeh
- 关联 PR: [wx/HL#7923](https://git.1814.love:8443/wx/HL/pulls/7923)
- 相关文档:
- `changelogs-v2/2026-09/19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md`
- `changelogs-v2/2026-09/19_7444_团期配车就绪门禁与同团车辆共用关系-新增接口-管理后台.md`(本端点后续被追加 DISPATCHED→DONE 推进的部分)
- #7444 的交接件(`changelogs-v2/2026-09/` 下按 `*_7444_*` 检索;本仓文件名带**提交日前缀**,会随提交日变,所以这里不写死文件名。⚠️ 起草期曾以 `…同团车辆共用关系-新增接口…` 为名,该稿已并入前者、名字不再存在)(本端点后续被追加 DISPATCHED→DONE 推进的部分)
## 关联 / 联系人