2.2 KiB
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_CHECK、taskStatus=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_CHECK、taskStatus=CANCELLED。 - 任务行色标/按钮口径改用
taskStatus(若之前按 taskType 判断请修正)。
验证证据
- 范围套件 196/196 全绿(含 FleetRedLineArchTest 13/13),spotless 通过;旧
vo/包 0 残留、旧包引用 grep=0。 - #5928 §3.8a.1
driver-policies/page主链完好,无回归。