---
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: "d5fa3cdac5037559954697040654e19e0a64ae18"
target_release: ""
verified_at: "2026-09-16"
status_note: "纯前端条目，后端零改动。四项均为已返回字段的展示形态调整：删子订单房间间数列、已订房文案改户、补户/人两行汇总、删班期范围下拉。接口出入参零变化。需求出处 需求分析/团期测试.md「前台问题 团期列表」。；前端 hl-admin d5fa3cda 已实现:SubOrderTable 删房型间数列,PeriodRow 户(orderCount)/人(enrolledPeople 恒显)两行,删班期范围下拉三处请求不再带 scope,spec 47/47,checkpoint 全绿。"
updated_at: "2026-09-16"
base: "dev-v3"
---

# 前台团期列表按测试反馈调整户人汇总与冗余元素（前端优化）

> **服务**: hl-order-service-v3（后端零改动）
> **页面**: 管理后台 `/order-v2/batch` 团期订单列表
> **组件**: `src/views/order-v2/batch/index.vue`、`components/PeriodRow.vue`、`components/SubOrderTable.vue`
> **日期**: 2026-09-16
> **影响范围**: 仅前台渲染；无端点、无出入参、无路由、无 DDL 变化

---

## ⚠️ 关键变化

🔵 **接口一个字段都没改**，四项全是展示形态调整，字段现网均已返回。

本文是 9/15 两份前台条目（`15_frontend_前台团期列表页漏展示已返回字段`、
`15_frontend_前台子订单展开区联系人绑错字段`）之后的**增量**，不重复其已交付内容。

---

## 一、调整清单

### 1.1 删除子订单展开区的「房型 · 间数」列

`SubOrderTable.vue:13` 现有表头 `<span>房型 · 间数</span>`，渲染 `roomCount` / `roomTypeName`。
按原型该列不在列表展开区出现（房型信息在详情页）。

- **做法**：删除该列，8 列减为 7 列（`SubOrderTable.vue:148` 的列宽注释同步更新）。
- **接口无需变化**：`roomCount` / `roomTypeName` 仍由 GB-ADM-003 返回，仅前台不渲染。

### 1.2 「已订房」文案改为「户」

列表行的房间维度进度条标题现为「已订房」，原型口径是「户」。

- **字段**：`orderCount`（子订单数）与 `enrolledRooms`（已用房间数）。
- **实测**：93 个团期中两字段**零处不等**，当前完全等价，改文案不改取值。
- **口径提醒**：算「户」请用 `orderCount`，**不要**对子订单的 `roomCount` 求和——
  实测 14 个团期中有 1 个 Σ`roomCount`(4) 与 `enrolledRooms`(3) 不等，两者口径不同。

### 1.3 已订房下方补「人」汇总，户在上、人在下

原型要求两行并列：户（订单数）在上，人（订单总人数）在下。

| 行 | 字段 | 说明 |
|---|---|---|
| 户 | `orderCount` | 9/15 已补渲染，本次改为上行并配「户」文案 |
| 人 | `enrolledPeople` | **本次新增下行** |

- **口径已验证**：14 个团期实测 `enrolledPeople` 与 Σ`participantCount`（子订单出行人数之和）
  **零处不等**，直接用 `enrolledPeople` 即可，无需前端累加。
- 字段注释写的是「已报名人数（含线下占位）」，实测与订单总人数一致。

### 1.4 删除搜索栏的「班期范围」下拉

筛选区现有 `scope`（未结束/已结束/全部）下拉，原型筛选区只有月份 + 搜索框。

- **做法**：移除该下拉，请求不再携带 `scope` 参数。
- **接口无需变化**：`scope` 仍是 GB-ADM-001 的合法可选入参，缺省行为由后端决定。

---

## 二、不影响范围

- GB-ADM-001 / GB-ADM-003 的出入参、分页语义、权限码、网关路由均未变化。
- 9/15 已交付的 11 项字段渲染与子订单联系人/金额/状态渲染保持原样。
- 小程序端零影响。

---

## 三、相关文档

- 需求出处：`需求分析/团期测试.md`「前台问题 团期列表」1~4
- 差异清单：`需求分析/测试发现问题.md` 模块 1、模块 2、模块 10.3

## 关联 / 联系人

- 后端：wx（本单后端零改动）
- 前端：mmg