文件
hl-api-changelog/changelogs-v2/2026-09/16_frontend_前台团期列表按测试反馈调整户人汇总与冗余元素-前端优化-管理后台.md
T
2026-09-16 16:30:54 +08:00

4.2 KiB
原始文件 Blame 文件历史

schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
schema ticket title consumer author change_type backend_status gateway_status frontend_status frontend_owner frontend_ref target_release verified_at status_note updated_at base
hl-changelog/v2 frontend 前台团期列表按测试反馈调整户人汇总与冗余元素 admin wx(GIT) 前端优化 not_required not_required verified mmg d5fa3cdac5037559954697040654e19e0a64ae18 2026-09-16 纯前端条目,后端零改动。四项均为已返回字段的展示形态调整:删子订单房间间数列、已订房文案改户、补户/人两行汇总、删班期范围下拉。接口出入参零变化。需求出处 需求分析/团期测试.md「前台问题 团期列表」。;前端 hl-admin d5fa3cda 已实现:SubOrderTable 删房型间数列,PeriodRow 户(orderCount)/人(enrolledPeople 恒显)两行,删班期范围下拉三处请求不再带 scope,spec 47/47,checkpoint 全绿。 2026-09-16 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