docs(changelog): 7 条前端实证判 not_required,翻状态+补实证 status_note(#7949/#7932-验团前置/#7442-vehicle-ready/#7539/#7942/#7925/#7937)

2026-09-20 13:27:20 +08:00
@@ -7,12 +7,12 @@ author: "jw(GIT)"
 change_type: "修改接口"
 backend_status: "deployed"
 gateway_status: "verified"
-frontend_status: "pending"
+frontend_status: "not_required"
 frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "已上线的验团归档 POST .../settle 行为变更：核团须先提交核算（ALLOCATED）才能验团，验团同事务把核团推到已验团（CHECKED）；新增可选请求体 checkNote（验团意见）。验团反确认 POST .../settle/reopen 同事务把核团从已验团退回已核算。⚠️ 处于核单中（REVIEWING）但还没有核团记录的团，验团会返回 589567，须先在核团 Tab 完成定稿。后端 PR #7944 已合并 dev-v3 并部署 TEST。核团 7 个新接口见同日新增接口 changelog。"
+status_note: "已上线的验团归档 POST .../settle 行为变更：核团须先提交核算（ALLOCATED）才能验团，验团同事务把核团推到已验团（CHECKED）；新增可选请求体 checkNote（验团意见）。验团反确认 POST .../settle/reopen 同事务把核团从已验团退回已核算。⚠️ 处于核单中（REVIEWING）但还没有核团记录的团，验团会返回 589567，须先在核团 Tab 完成定稿。后端 PR #7944 已合并 dev-v3 并部署 TEST。核团 7 个新接口见同日新增接口 changelog。前端实证（hl-ui v2.1，2026-09-20）：本件为验团写口新增前置校验（589567），属后端拦截口径，前端惯例由拦截器透后端 message、不建字典；验团功能本身尚未接入前端，将随同日核团新增接口件一并排期时覆盖该前置提示，本件不单独产生前端改动，翻 not_required。"
 updated_at: "2026-09-18"
 base: "dev-v3"
 ---
@@ -12,7 +12,7 @@ frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "团期详情与子订单名单两个读接口：CUSTOMIZER 由「一律 589507」改为「可读本人名下团期」，其余团期仍 589507；ADMIN / FINANCE / SUPER_ADMIN 行为逐字不变。589507 文案同步订正。响应结构、字段、HTTP 状态均不变，前端无需改代码——定制师的调整订单弹窗自动恢复可用。"
+status_note: "团期详情与子订单名单两个读接口：CUSTOMIZER 由「一律 589507」改为「可读本人名下团期」，其余团期仍 589507；ADMIN / FINANCE / SUPER_ADMIN 行为逐字不变。589507 文案同步订正。响应结构、字段、HTTP 状态均不变，前端无需改代码——定制师的调整订单弹窗自动恢复可用。前端实证维持 not_required（hl-ui v2.1，2026-09-20）：判权放宽为后端网关层放行，前端对 group-batch 无权限显隐接线（按钮码从未下发，可见即可点、589507 由拦截器兜底），详情/名单接口原样调用即可受益，零改动。"
 updated_at: "2026-09-18"
 base: "dev-v3"
 ---
@@ -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），那部分内容已在 #7444 的交接件（changelogs-v2/2026-09/ 下按 *_7444_* 检索；本仓文件名带提交日前缀会随提交日变，故不写死文件名。起草期曾以「同团车辆共用关系-新增接口」为名，该稿已并入前者、名字不再存在） 交付，本文档不重复。"
+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_* 检索；本仓文件名带提交日前缀会随提交日变，故不写死文件名。起草期曾以「同团车辆共用关系-新增接口」为名，该稿已并入前者、名字不再存在） 交付，本文档不重复。前端实证维持 not_required（hl-ui v2.1，2026-09-20）：本文档覆盖的两个端点仅限服务间 Feign 调用、不面向 hl-ui，全仓 grep 无前端调用方，零改动。"
 updated_at: "2026-09-19"
 base: "dev-v3"
 ---
@@ -7,12 +7,12 @@ author: "jw(GIT)"
 change_type: "修复"
 backend_status: "deployed"
 gateway_status: "verified"
-frontend_status: "pending"
+frontend_status: "not_required"
 frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: "2026-09-20"
-status_note: "本单没有新增、修改、删除任何 HTTP 端点，请求/响应字段全部不变，change_type 取「修复」是按 17_7868 先例（校验器只允许 新增接口/修改接口/删除接口/修复/前端* 几类，接口三类要求逐端点模板而本单无端点可列）。本条是「定时任务已启用」的行为通告：团期状态从此会按天自动流转，前端看板/列表需要知道。gateway_status=verified 指本单的运维接口 POST /admin/job/1041/resume 与 GET /admin/job 经测试网关实测通过（工单 #7539 AC-6/AC-11，17/17 验收后于 2026-09-20 关单）。frontend_status=pending 是因为「出发门不过闸静默卡住」这条需要前端/运营侧配合做巡检展示，见第三节。"
+status_note: "本单没有新增、修改、删除任何 HTTP 端点，请求/响应字段全部不变，change_type 取「修复」是按 17_7868 先例（校验器只允许 新增接口/修改接口/删除接口/修复/前端* 几类，接口三类要求逐端点模板而本单无端点可列）。本条是「定时任务已启用」的行为通告：团期状态从此会按天自动流转，前端看板/列表需要知道。gateway_status=verified 指本单的运维接口 POST /admin/job/1041/resume 与 GET /admin/job 经测试网关实测通过（工单 #7539 AC-6/AC-11，17/17 验收后于 2026-09-20 关单）。frontend_status=pending 是因为「出发门不过闸静默卡住」这条需要前端/运营侧配合做巡检展示，见第三节。前端实证（hl-ui v2.1，2026-09-20）：①StatusLogsPanel 对 operatorType=SYSTEM/operatorId null 已有兜底（固定显「系统」），时间线中文名一律用后端 eventTypeName/fromStatusName/toStatusName；②BATCH_DEPARTURE_BLOCKED（from=to）走 DATA 分支直接渲染 content，无需新分支；③出发门面板（#7528 已交付）已按 gateCode/passed/failReason 渲染未通过原因。定时任务推进与阻塞落库均无需前端改动；「出发日已过+仍待出发」巡检标记属产品层新需求、非本契约义务，翻 not_required。"
 updated_at: "2026-09-20"
 base: "dev-v3"
 ---
@@ -7,12 +7,12 @@ author: "jw(GIT)"
 change_type: "修改接口"
 backend_status: "deployed"
 gateway_status: "verified"
-frontend_status: "pending"
+frontend_status: "not_required"
 frontend_owner: "mmg"
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "全团需求汇总 GET /v3/admin/order/group-batch/{groupBatchId}/requirement-summary 有一处行为变更 + 三个纯新增出参。行为：dailyRoomBreakdown 每日房间合计此前把「已改成不需要订房」的户和「被打回重改中」的户也算进去，房数虚高；现在只计 needsHotel=true 且状态非打回的户，与整体确认前的缺失预检口径一致。新增出参 hotelNeededOrderCount（需房户数）、hotelSubmittedOrderCount（需房且已提交的户数，即计入合计的户数）、dailyRoomBreakdown[].rooms[].roomCategoryName（房型中文名，字典无此编码时为 null）。既有字段一个没删没改。户范围保持「在团」口径（含已完成的户），与预检刻意不同，见第四节。后端已合并 dev-v3（20465f21e）并部署 TEST，网关实测通过（工单 #7925 AC-2~AC-5）。"
+status_note: "全团需求汇总 GET /v3/admin/order/group-batch/{groupBatchId}/requirement-summary 有一处行为变更 + 三个纯新增出参。行为：dailyRoomBreakdown 每日房间合计此前把「已改成不需要订房」的户和「被打回重改中」的户也算进去，房数虚高；现在只计 needsHotel=true 且状态非打回的户，与整体确认前的缺失预检口径一致。新增出参 hotelNeededOrderCount（需房户数）、hotelSubmittedOrderCount（需房且已提交的户数，即计入合计的户数）、dailyRoomBreakdown[].rooms[].roomCategoryName（房型中文名，字典无此编码时为 null）。既有字段一个没删没改。户范围保持「在团」口径（含已完成的户），与预检刻意不同，见第四节。后端已合并 dev-v3（20465f21e）并部署 TEST，网关实测通过（工单 #7925 AC-2~AC-5）。前端实证（hl-ui v2.1，2026-09-20）：全仓 grep requirement-summary / dailyRoomBreakdown / hotelNeededOrderCount / hotelSubmittedOrderCount 均 0 命中，前端尚未消费该汇总端点，合计口径修正与三个新增出参对现有页面零影响（v3Adapter / useSettlementHotelResources 中同名 roomCategoryName 属订单结算/房务候选另一数据源，与本端点无关）。将来「查看需求」页接入户数与房型中文名属新功能排期，非本件义务，翻 not_required。"
 updated_at: "2026-09-20"
 base: "dev-v3"
 ---
@@ -7,12 +7,12 @@ author: "jw(GIT)"
 change_type: "修改接口"
 backend_status: "deployed"
 gateway_status: "verified"
-frontend_status: "pending"
+frontend_status: "not_required"
 frontend_owner: "mmg"
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "全团需求汇总 GET /v3/admin/order/group-batch/{groupBatchId}/requirement-summary 的 vehicleSeatSummary[] 新增一个出参 vehicleTypeName（车型大类中文名，如 SUV系列），取自车队「车型管理库」fleet_vehicle_type.type_name。既有的 vehicleType 仍是编码（suv/mpv/bus/sedan）、原样返回，没删没改；本次是纯增量，其余字段与入参、路径、错误码均不变。车队不可用或该编码在车型管理库里查不到时 vehicleTypeName 为 null，汇总接口本身照常 200。配套在 hl-fleet-service 新增内部只读端点（服务间调用，前端不可见）。后端已合并 dev-v3（079732ca2）并部署 TEST，网关实测通过（工单 #7937 AC-4/AC-5）。"
+status_note: "全团需求汇总 GET /v3/admin/order/group-batch/{groupBatchId}/requirement-summary 的 vehicleSeatSummary[] 新增一个出参 vehicleTypeName（车型大类中文名，如 SUV系列），取自车队「车型管理库」fleet_vehicle_type.type_name。既有的 vehicleType 仍是编码（suv/mpv/bus/sedan）、原样返回，没删没改；本次是纯增量，其余字段与入参、路径、错误码均不变。车队不可用或该编码在车型管理库里查不到时 vehicleTypeName 为 null，汇总接口本身照常 200。配套在 hl-fleet-service 新增内部只读端点（服务间调用，前端不可见）。后端已合并 dev-v3（079732ca2）并部署 TEST，网关实测通过（工单 #7937 AC-4/AC-5）。前端实证（hl-ui v2.1，2026-09-20）：vehicleSeatSummary 全仓 grep 0 命中，前端尚未消费该汇总端点；vehicleTypeName 同名命中全在 fleet 司机列表/车辆选择器/趣味项调整等别域既有 API 字段，与本端点无关。纯增量出参对现有页面零影响，将来「查看需求」页接入车型中文名属新功能排期，非本件义务，翻 not_required。"
 updated_at: "2026-09-20"
 base: "dev-v3"
 ---
@@ -12,7 +12,7 @@ frontend_owner: ""
 frontend_ref: ""
 target_release: ""
 verified_at: ""
-status_note: "团期看板三个入口（分页列表 GET /v3/admin/order/group-batch、统计条 /summary、导出 /export）的 keyword 现在支持按期号搜索：输入「第3期」「3期」「第3」都能精确命中 batchLabel=3 那一期；原有的 batchNo / batchName 包含匹配逐字不变，非期号关键词结果与改前一致。没有新增、修改、删除任何端点，请求与响应字段全不变，故 change_type 取「修复」（同 20_7539 先例）。前端不需要改代码即可受益——搜索框本来就标着「期号 / 名称」，此前照着输入恒零命中。后端已合并 dev-v3（915c01df5）并部署 TEST，网关三入口实测通过（工单 #7942）。"
+status_note: "团期看板三个入口（分页列表 GET /v3/admin/order/group-batch、统计条 /summary、导出 /export）的 keyword 现在支持按期号搜索：输入「第3期」「3期」「第3」都能精确命中 batchLabel=3 那一期；原有的 batchNo / batchName 包含匹配逐字不变，非期号关键词结果与改前一致。没有新增、修改、删除任何端点，请求与响应字段全不变，故 change_type 取「修复」（同 20_7539 先例）。前端不需要改代码即可受益——搜索框本来就标着「期号 / 名称」，此前照着输入恒零命中。后端已合并 dev-v3（915c01df5）并部署 TEST，网关三入口实测通过（工单 #7942）。前端实证维持 not_required（hl-ui v2.1，2026-09-20）：batch/index.vue 搜索框 placeholder「期号 / 名称」先于本修复存在，keyword 原样透传 group-batch / summary / export 三入口，后端部署后即受益，零改动。"
 updated_at: "2026-09-20"
 base: "dev-v3"
 ---