50 行
2.1 KiB
Markdown
50 行
2.1 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5934"
|
||
title: "车务契约漂移补录：taskType/status 枚举可筛 + 状态色标口径 + 模板域 VO 分包"
|
||
consumer: "admin"
|
||
author: "wx"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "pending"
|
||
frontend_owner: ""
|
||
frontend_ref: ""
|
||
target_release: ""
|
||
verified_at: ""
|
||
status_note: "后端完成：PR #5980 已合并 dev-v3 并部署 TEST。属契约文档对齐 + 代码分包重构，零行为变更。补录 5 项既有实现的契约口径，前端需按补录口径对齐筛选项与状态色标。"
|
||
updated_at: "2026-08-15"
|
||
base: "dev-v3"
|
||
generated: "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` 主链完好，无回归。
|