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