---
schema: "hl-changelog/v2"
ticket: "frontend"
title: "前台整团名单速览补状态与需求审核列"
consumer: "admin"
author: "wx(GIT)"
change_type: "前端优化"
backend_status: "not_required"
gateway_status: "not_required"
frontend_status: "verified"
frontend_owner: "mmg"
frontend_ref: "55d3a040e71ae0855a2bd31b36746b836e75b5ca"
target_release: ""
verified_at: "2026-09-16"
status_note: "纯前端条目，后端零改动。RosterTable 缺「状态」与「需求审核」两列，组件注释「流程状态后端仍不返回,不展示」已过时——GB-ADM-003 现网返回 orderStatusName/hotelRequirementStatus/vehicleRequirementStatus。需求审核列的中文名翻译缺陷已另开后端工单，前端先按直显 code 兜底接入。需求出处 需求分析/团期测试.md「前台问题 团期-整团总览」。；前端 hl-admin 55d3a040 已实现:RosterTable 补状态列(orderStatusName 回落原码)+需求审核列(房/车 Name 优先原码兜底直显,不建映射),spec 5/5,checkpoint 全绿。"
updated_at: "2026-09-16"
base: "dev-v3"
---

# 前台整团名单速览补状态与需求审核列（前端优化）

> **服务**: hl-order-service-v3（后端零改动）
> **页面**: 管理后台 `/order-v2/batch` → 团期详情 → 整团总览 Tab
> **组件**: `src/views/order-v2/batch/detail/components/RosterTable.vue`
> **接口**: `GET /v3/admin/order/group-batch/{groupBatchId}/orders`（GB-ADM-003）
> **日期**: 2026-09-16
> **影响范围**: 仅前台渲染；无端点、无出入参、无路由、无 DDL 变化

---

## ⚠️ 关键变化

🔵 **组件注释已过时。** `RosterTable.vue:25` 写着「已收/定制师/**流程状态**后端仍不返回,不展示」，
但 GB-ADM-003 现网**确实返回**订单状态与房/车需求状态，该注释所依据的情况已不成立。

---

## 一、原型要求 vs 当前渲染

原型「整团名单总览」要求 7 列：联系人、订单编号、出行人、档位、房型、**状态**、**需求审核**。

| 原型列 | 接口字段 | RosterTable 现状 |
|---|---|---|
| 联系人 | `customerName` | ✅ 已渲染（第 52 行「子订单 / 联系人」） |
| 订单编号 | `orderNo` | ✅ 已渲染 |
| 出行人 | `travelers[]` | ✅ 已渲染（第 105 行「游客」列） |
| 档位 | `tierName` | ✅ 已渲染（第 64 行「套餐」列） |
| 房型 | `roomTypeName` / `roomCount` | ✅ 已渲染（第 80 行） |
| **状态** | `orderStatusName` | ❌ **缺** |
| **需求审核** | `hotelRequirementStatus` / `vehicleRequirementStatus` | ❌ **缺** |

`includeTravelers` / `includeNeeds` 两个开关**缺省均为 true**，前端无需显式传参。

---

## 二、本次调整

### 2.1 新增「状态」列

直显 `orderStatusName`，枚举外回落 `orderStatus`（与 SubOrderTable 9/15 的做法一致，不建前端映射）。

现网实测取值：`定制中`（CUSTOMIZING）、`已完成`（COMPLETED）。

### 2.2 新增「需求审核」列

展示 `hotelRequirementStatusName` / `vehicleRequirementStatusName`。

> ⚠️ **后端该字段当前有缺陷**：`DONE`、`PENDING_REVIEW` 两个取值翻译失败、原样返回英文码
> （TEST 取样 30 条子订单中 26 条房需求状态名为英文）。已另开后端工单修复。
> **前端本次按直显处理、不自建映射兜底**，待后端修复后自动恢复中文；
> 若产品要求上线前不得出现英文，则本列需等后端工单合入后再接。

### 2.3 删除注释中已过时的表述

`RosterTable.vue:25` 的「流程状态后端仍不返回,不展示」需删除或改写，避免后续误导。

---

## 三、不影响范围

- GB-ADM-003 出入参、分页、权限码、网关路由均未变化。
- 「子订单 Tab」的 RosterTable 其余 8 列保持原样。
- 列表页展开区 `SubOrderTable` 不在本单范围（见同日列表页条目）。
- 小程序端零影响。

---

## 四、相关文档

- 需求出处：`需求分析/团期测试.md`「前台问题 团期-整团总览」1~2
- 差异清单：`需求分析/测试发现问题.md` 模块 5、模块 10

## 关联 / 联系人

- 后端：wx（本单后端零改动；需求审核中文名缺陷另单跟踪）
- 前端：mmg