From 2b0b922da340a7aeadea9e899712f4010e928af9 Mon Sep 17 00:00:00 2001 From: jw Date: Wed, 16 Sep 2026 15:37:43 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E5=9B=A2=E6=9C=9F=E5=88=97?= =?UTF-8?q?=E8=A1=A8=E4=B8=8E=E6=95=B4=E5=9B=A2=E5=90=8D=E5=8D=95=E6=8C=89?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=E5=8F=8D=E9=A6=88=E7=9A=84=E5=89=8D=E5=8F=B0?= =?UTF-8?q?=E8=B0=83=E6=95=B4=EF=BC=88=E4=B8=A4=E6=9D=A1=E7=BA=AF=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E6=9D=A1=E7=9B=AE=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 16_frontend 列表页：删子订单房型·间数列、已订房文案改「户」、补户/人两行汇总、删班期范围下拉 - 16_frontend 整团名单：RosterTable 补「状态」与「需求审核」两列，并订正已过时的组件注释 两条均为已返回字段的展示形态调整，后端零改动。 需求审核列的中文名翻译缺陷已另开后端工单 #7816；档位中文名口径统一见 #7817。 Co-Authored-By: Claude Opus 5 (1M context) --- ...试反馈调整户人汇总与冗余元素-前端优化-管理后台.md | 96 +++++++++++++++++++ ...单速览补状态与需求审核列-前端优化-管理后台.md | 96 +++++++++++++++++++ 2 files changed, 192 insertions(+) create mode 100644 changelogs-v2/2026-09/16_frontend_前台团期列表按测试反馈调整户人汇总与冗余元素-前端优化-管理后台.md create mode 100644 changelogs-v2/2026-09/16_frontend_前台整团名单速览补状态与需求审核列-前端优化-管理后台.md diff --git a/changelogs-v2/2026-09/16_frontend_前台团期列表按测试反馈调整户人汇总与冗余元素-前端优化-管理后台.md b/changelogs-v2/2026-09/16_frontend_前台团期列表按测试反馈调整户人汇总与冗余元素-前端优化-管理后台.md new file mode 100644 index 00000000..14d964a0 --- /dev/null +++ b/changelogs-v2/2026-09/16_frontend_前台团期列表按测试反馈调整户人汇总与冗余元素-前端优化-管理后台.md @@ -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` 现有表头 `房型 · 间数`，渲染 `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 diff --git a/changelogs-v2/2026-09/16_frontend_前台整团名单速览补状态与需求审核列-前端优化-管理后台.md b/changelogs-v2/2026-09/16_frontend_前台整团名单速览补状态与需求审核列-前端优化-管理后台.md new file mode 100644 index 00000000..82d7f7fb --- /dev/null +++ b/changelogs-v2/2026-09/16_frontend_前台整团名单速览补状态与需求审核列-前端优化-管理后台.md @@ -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