docs(changelog): 团期列表与整团名单按测试反馈的前台调整(两条纯前端条目)
changelog-filename-gate / validate (push) Failing after 1s
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>
这个提交包含在:
@@ -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: "纯前端条目,后端零改动。四项均为已返回字段的展示形态调整:删子订单房间间数列、已订房文案改户、补户/人两行汇总、删班期范围下拉。接口出入参零变化。需求出处 需求分析/团期测试.md「前台问题 团期列表」。"
|
||||
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
|
||||
@@ -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
|
||||
在新工单中引用
屏蔽一个用户