diff --git a/changelogs-v2/2026-09/19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md b/changelogs-v2/2026-09/19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md index 77f8cd44..1c6fa065 100644 --- a/changelogs-v2/2026-09/19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md +++ b/changelogs-v2/2026-09/19_7442_团期配车分组写口reconfigure补登-新增接口-管理后台.md @@ -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_*` 检索；本仓文件名带**提交日前缀**，会随提交日变，所以这里不写死文件名。⚠️ 起草期曾以 `…同团车辆共用关系-新增接口…` 为名，该稿已并入前者、名字不再存在）） --- diff --git a/changelogs-v2/2026-09/19_7442_团期配车就绪回写带身份两级判定补登-修改接口-管理后台.md b/changelogs-v2/2026-09/19_7442_团期配车就绪回写带身份两级判定补登-修改接口-管理后台.md index dd014e5e..1a74a6ac 100644 --- a/changelogs-v2/2026-09/19_7442_团期配车就绪回写带身份两级判定补登-修改接口-管理后台.md +++ b/changelogs-v2/2026-09/19_7442_团期配车就绪回写带身份两级判定补登-修改接口-管理后台.md @@ -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 推进的部分） ## 关联 / 联系人