docs(changelog): 团期列表与整团名单按测试反馈的前台调整(两条纯前端条目)
changelog-filename-gate / validate (push) Failing after 1s

- 16_frontend 列表页:删子订单房型·间数列、已订房文案改「户」、补户/人两行汇总、删班期范围下拉
- 16_frontend 整团名单:RosterTable 补「状态」与「需求审核」两列,并订正已过时的组件注释

两条均为已返回字段的展示形态调整,后端零改动。
需求审核列的中文名翻译缺陷已另开后端工单 #7816;档位中文名口径统一见 #7817。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
这个提交包含在:
jw
2026-09-16 15:37:43 +08:00
共同撰写人 Claude Opus 5
父节点 83cd836ab3
当前提交 2b0b922da3
共修改 2 个文件,包含 192 行新增和 0 行删除
@@ -0,0 +1,96 @@
---
schema: "hl-changelog/v2"
ticket: "frontend"
title: "前台整团名单速览补状态与需求审核列"
consumer: "admin"
author: "wx(GIT)"
change_type: "前端优化"
backend_status: "not_required"
gateway_status: "not_required"
frontend_status: "pending"
frontend_owner: "mmg"
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "纯前端条目,后端零改动。RosterTable 缺「状态」与「需求审核」两列,组件注释「流程状态后端仍不返回,不展示」已过时——GB-ADM-003 现网返回 orderStatusName/hotelRequirementStatus/vehicleRequirementStatus。需求审核列的中文名翻译缺陷已另开后端工单,前端先按直显 code 兜底接入。需求出处 需求分析/团期测试.md「前台问题 团期-整团总览」。"
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