wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动

docs(changelog): #7987 订正被 mmg 实证推翻的「前端必须新增渲染分支」，并清空 not_required 上的认领字段
changelog-filename-gate / validate (push) Failing after 1s
详情

浏览代码 
正文第 38 行说「前端必须新增这两个 event_type 的渲染分支」，而 mmg 在
frontmatter 里已用实证翻成 not_required（StatusLogsPanel 渲染
eventTypeName || eventType || '事件'，后端直供中文名+原码兜底，前端无自建
映射表，零改动）。订正了状态位却没回头改正文，那句话会让下一个读的人以为
前端还有活。原句划掉保留接 grep，并注明这条结论依赖「后端继续直供
eventTypeName」——该字段哪天返 null，渲染缺口会重新成立。

frontend_owner/frontend_ref 清空：交付指南写死 not_required 条目任何人
（含前端）不得回写这 4 个认领字段，填了会被 E_FRONTEND 残留校验拦下
（2026-08-19 #6077 先例）。本文件能推上去是因为门禁只扫新增路径，
不是因为合规。mmg 的实证本身原样保留。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在：
API Changelog Bot
2026-09-21 09:02:10 +08:00
共同撰写人 Claude Opus 5
父节点 9d4b4387f0
当前提交 ba87a9b611
共修改 1 个文件，包含 7 行新增和 4 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
changelogs-v2/2026-09/20_7987_团期时间线新增开窗与重配两类事件-修改接口-管理后台.md
+7 -4
查看文件
@@ -8,11 +8,11 @@ change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "not_required"
frontend_owner: "mmg"
frontend_ref: "hl-ui"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "gateway_status=verified 的依据：2026-09-20 18:22-18:46 经网关 https://api.test.1814.love:9443 实测（账号 cw_test_7444）。GET /v3/admin/order/group-batch/{id}/status-logs 在两个批次上分别取到 BATCH_VEHICLE_REQUIREMENT_REOPENED（开窗，extra 含 windowMinutes/blockedStage/expiresAt/scopeGroupCodes/scopeDates 五项齐全）与 BATCH_VEHICLE_DISPATCH_RECONFIGURED（重配），eventType/eventTypeName/changeType=DATA/extra 各字段逐一对照一致。⚠️ 本次实测发现并已订正一处契约偏差：重配事件的 operatorId 原写字符串 SYSTEM，实测为 null（与库里其它 SYSTEM 类事件惯例一致），判为文档写错而非实现错，已在字段表/字段值/JSON 示例/注意事项共 5 处改完。前端若按原文档判空会得到相反预期，故这条订正与发布同一批。 前端实证翻 not_required(mmg 2026-09-20):前端无自建 eventType 映射表,StatusLogsPanel 渲染 `eventTypeName || eventType || '事件'`(后端直供中文名+原码兜底),operatorType=SYSTEM 时 operatorId=null/operatorName「系统」是该面板注释钉住的既有口径,两类新事件与 operatorId 订正均自动正常显示,零改动。 【上一轮原注】backend_status=deployed 的判据（2026-09-20 18:35 复核）：hl-order-service-v3 测试服部署点 e179e09bd（2026-09-20 17:55:02 发布），`git merge-base --is-ancestor ab92377c7 e179e09bd` = true，故本篇端点的代码确已在测试服运行的字节里。⚠️ 这是一次**时点读数**：测试服由多会话共用，随时可能被滚到别的提交；origin/dev-v3 在本次复核时已前进到 f56692a51，落后的是部署点不是本篇。 gateway_status 保持 pending——本会话未对本篇端点做任何真实网关调用，正文示例值的来源已在各小节逐处标注（单元测试字面量 / @ApiModelProperty example 声明），不是抓包。待网关复验后再置 verified，**不得为了让门禁变绿改这个位**。"
status_note: "⚠️ 2026-09-21 清空 frontend_owner/frontend_ref：按 BACKEND_CHANGELOG_DELIVERY_GUIDE，not_required 条目**任何人（含前端）不得回写** frontend_owner / frontend_ref / target_release / verified_at——这 4 个是「前端需要动作」的认领标记，填了会被发布门禁 E_FRONTEND 残留校验拦下（2026-08-19 #6077 就是这么被拦的）。前端表达「已知悉」用评论/口头即可，不动 frontmatter。本文件能推上去是因为门禁**只扫新增路径**，不是因为合规。mmg 的实证本身保留在下文。 gateway_status=verified 的依据：2026-09-20 18:22-18:46 经网关 https://api.test.1814.love:9443 实测（账号 cw_test_7444）。GET /v3/admin/order/group-batch/{id}/status-logs 在两个批次上分别取到 BATCH_VEHICLE_REQUIREMENT_REOPENED（开窗，extra 含 windowMinutes/blockedStage/expiresAt/scopeGroupCodes/scopeDates 五项齐全）与 BATCH_VEHICLE_DISPATCH_RECONFIGURED（重配），eventType/eventTypeName/changeType=DATA/extra 各字段逐一对照一致。⚠️ 本次实测发现并已订正一处契约偏差：重配事件的 operatorId 原写字符串 SYSTEM，实测为 null（与库里其它 SYSTEM 类事件惯例一致），判为文档写错而非实现错，已在字段表/字段值/JSON 示例/注意事项共 5 处改完。前端若按原文档判空会得到相反预期，故这条订正与发布同一批。 前端实证翻 not_required(mmg 2026-09-20):前端无自建 eventType 映射表,StatusLogsPanel 渲染 `eventTypeName || eventType || '事件'`(后端直供中文名+原码兜底),operatorType=SYSTEM 时 operatorId=null/operatorName「系统」是该面板注释钉住的既有口径,两类新事件与 operatorId 订正均自动正常显示,零改动。 【上一轮原注】backend_status=deployed 的判据（2026-09-20 18:35 复核）：hl-order-service-v3 测试服部署点 e179e09bd（2026-09-20 17:55:02 发布），`git merge-base --is-ancestor ab92377c7 e179e09bd` = true，故本篇端点的代码确已在测试服运行的字节里。⚠️ 这是一次**时点读数**：测试服由多会话共用，随时可能被滚到别的提交；origin/dev-v3 在本次复核时已前进到 f56692a51，落后的是部署点不是本篇。 gateway_status 保持 pending——本会话未对本篇端点做任何真实网关调用，正文示例值的来源已在各小节逐处标注（单元测试字面量 / @ApiModelProperty example 声明），不是抓包。待网关复验后再置 verified，**不得为了让门禁变绿改这个位**。"
updated_at: "2026-09-20"
base: "dev-v3"
---
@@ -35,7 +35,10 @@ base: "dev-v3"
- **BATCH_VEHICLE_REQUIREMENT_REOPENED**（开窗事件）—— 管理员显式开启受控重配窗口时写入
- **BATCH_VEHICLE_DISPATCH_RECONFIGURED**（重配事件）—— fleet 回调确认重配生效时写入
**前端必须新增这两个 event_type 值的渲染分支**，否则这两类事件在管理后台团期时间线上将无法正常显示其标签名（见下文「③ 前端渲染缺口」）。
~~**前端必须新增这两个 event_type 值的渲染分支**，否则这两类事件在管理后台团期时间线上将无法正常显示其标签名（见下文「③ 前端渲染缺口」）。~~
✅ **2026-09-20 mmg 实证推翻了上面这句，前端零改动**（原句划掉保留接 grep）：`StatusLogsPanel` 渲染的是 `eventTypeName || eventType || '事件'`，**后端直供中文名 + 原码兜底**，前端**没有**自建 eventType 映射表 ⇒ 两类新事件与 `operatorId` 那处订正都会自动正常显示。
📌 下文「③ 前端渲染缺口」一节同样按这条实证作废——**它描述的缺口在当前前端实现里不存在**。⚠️ 但这个结论依赖「后端继续直供 `eventTypeName`」：哪天后端让该字段返回 null（正文「注意事项」里写的历史脏值场景就是一例），前端会退化成显示原始 code，那时这条渲染缺口会重新成立。
---