hl-api-changelog/changelogs-v2/2026-08/16_5934_车务契约漂移补录-修改接口-管理后台.md
Mimingguang fee4dcac7b
一些检查失败了
changelog-filename-gate / validate (push) Failing after 1s
docs(changelogs-v2): 回写 #5923/#5931/#5934 not_required + #5928/#5828/#5936 verified
2026-08-16 15:30:05 +08:00

2.2 KiB

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base, generated
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base generated
hl-changelog/v2 5934 车务契约漂移补录taskType/status 枚举可筛 + 状态色标口径 + 模板域 VO 分包 admin wx 修改接口 deployed verified not_required mmg 2026-08-16 后端完成PR #5980 已合并 dev-v3 并部署 TEST。属契约文档对齐 + 代码分包重构,零行为变更。补录 5 项既有实现的契约口径,前端需按补录口径对齐筛选项与状态色标。 2026-08-16 dev-v3 2026-08-15T23:56:00+08:00

车务契约漂移补录(#5934

背景

车务部分已上线实现与 API-SPEC-FLEET 文档存在漂移(实现已具备但文档未补录 / 分包不规范)。本次把 5 项既有实现的契约口径补录进文档,并将模板域 VO 下沉到规范子包。零行为变更,前端按补录口径对齐即可。

变更接口与行为变化(补录项,前端相关)

补录内容 前端动作
§3.8a.2 任务枚举 taskType=REFUND_CHECKtaskStatus=CANCELLED 已在代码支持,可筛 筛选下拉补这两个枚举项
§3.8a.2 状态色标 任务列表按钮/色标taskStatus 着色(非 taskType 按 taskStatus 做色标/按钮可用性判断
§8.10 列表项补 processingStatus 字段说明 信息性,按需展示
§8.11 HOLD status + retry 口径 信息性
§11.4a 补 render-batch 端点说明 信息性

纯后端(前端零感知)

  • 模板域 11 个 VO 下沉 messagetemplate.vo.admin 子包(分包规范化,类名/字段/wire JSON 不变)。

前端动作

  • 任务列表筛选项补 taskType=REFUND_CHECKtaskStatus=CANCELLED
  • 任务行色标/按钮口径改用 taskStatus(若之前按 taskType 判断请修正)。

验证证据

  • 范围套件 196/196 全绿(含 FleetRedLineArchTest 13/13,spotless 通过;旧 vo/ 包 0 残留、旧包引用 grep=0。
  • #5928 §3.8a.1 driver-policies/page 主链完好,无回归。