5.8 KiB
5.8 KiB
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 | 前台团期列表页漏展示 11 项接口已返回字段 | admin | wx(GIT) | 前端优化 | not_required | not_required | verified | mmg | ab5ea0f869b8d260cab0d013c37330b78bde867b | 2026-09-15 | 纯前端条目，后端零改动。GET /v3/admin/order/group-batch、/summary、/products 三个接口的出参未变，本文列出的字段现网均已返回，只是前台未渲染。按团期原型逐块比对后产出，原型出处见需求分析/2026-09-11-团期模块需求分析.md。后端确实缺的 5 项已另开工单 #7769（出参）与 #7770（入参），不在本文范围。 前端已交付(ab5ea0f8):11 项全部补渲染——行内 productName/日期区间(两端齐备才拼,禁半截)/orderCount/人维度进度(maxParticipants=0 不限整条不渲染,remainParticipants null 禁 0 兜底)/满 N 户满团(maxRooms)/batchNo 截断短号(头5…尾6,全长 title 悬浮);总览条「班期总览 · 共 N 期 · 子订单 M」;产品卡 coverImageUrl 真封面+regionText 有值才渲染。统计条成团标准副标题依赖 #7769 minToForm,按其约定未做。批次域 5 个 spec 38/38,checkpoint 全绿。 | 2026-09-15 | dev-v3 |
前台团期列表页漏展示 11 项接口已返回字段（前端优化）
服务: hl-order-service-v3（后端零改动） 页面: 管理后台
/order-v2/batch团期订单列表 组件:src/views/order-v2/batch/index.vue、components/PeriodRow.vue日期: 2026-09-15 影响范围: 仅前台渲染；无端点、无出入参、无路由、无 DDL 变化
⚠️ 关键变化
🔵 接口没变，是前台没接。 下列 11 个字段现网三个接口都已返回，页面上一个都没渲染，导致团期列表与原型差距很大。
按原型比对，列表行现在只显示「第 N 期 + 班期名 + 编号 + 出团日 + 户进度 + 状态 + 六芯片 + 应收/已收」，原型要求的产品名、日期区间、子订单数、人维度进度、成团标准、统计条子订单总数等全部缺位。
一、漏展示字段清单
1.1 GET /v3/admin/order/group-batch（团期分页列表，逐行）
| # | 原型上的元素 | 接口字段 | 现网实测值 | 前台现状 |
|---|---|---|---|---|
| 1 | 行内产品名称 | productName |
测试小蒙马-多档-固定金额 |
未渲染，产品名只在顶部页签 |
| 2 | 日期区间 6.25-6.30 |
endDate |
2026-12-21 |
departDateText() 只取 departDate，区间尾丢失 |
| 3 | 子订单数 | orderCount |
2 |
未渲染 |
| 4 | 人维度进度条「人 23/26」 | enrolledPeople / maxParticipants |
4 / 0 |
只有户（房）一条进度条 |
| 5 | 「约 N 人满 / 剩 N 人」 | remainParticipants |
null |
未渲染，依赖第 4 条 |
| 6 | 满团标准「满 9 户满团」 | maxRooms |
9 |
未渲染 |
| 7 | 短期号展示形态 | batchNo |
Q202612202096494989117677570 |
25 位原始编号整串铺出，原型是短编号 |
1.2 GET /v3/admin/order/group-batch/summary（看板统计条）
| # | 原型上的元素 | 接口字段 | 现网实测值 | 前台现状 |
|---|---|---|---|---|
| 8 | 统计条「子订单 15」 | subOrderCount |
3 |
未渲染，页签区只画了 8 桶 |
| 9 | 「班期总览 · 全年 N 期」 | total |
11 |
无总览卡片 |
1.3 GET /v3/admin/order/group-batch/products（产品选择器）
| # | 原型上的元素 | 接口字段 | 现网实测值 | 前台现状 |
|---|---|---|---|---|
| 10 | 产品卡封面 | coverImageUrl |
有值（OSS 链接） | 用产品名首字色块代替 |
| 11 | 产品卡副标题地区 | regionText |
null（该产品未回填） |
未渲染；见下方「四」 |
二、字段口径提醒
endDate是返团日，与departDate组成原型的日期区间；两者都可能为空，为空时不要拼出半截区间。remainRooms/remainParticipants在容量为空时后端直接返null，前台不要用 0 兜底，null表示「不限」而不是「已满」。maxParticipants = 0按契约表示人数维度不限容量，此时人进度条与「约 N 人满」都不应渲染（当前测试数据正是这种情况）。batchNo是产品域生成的长编号，前台自行截断或改展示规则即可，后端不会再给一个短码。subOrderCount只在 summary 返回，逐行的orderCount是该团期自己的子订单数，两者不是一回事，别互相替代。
三、不影响范围
- 三个接口的路径、入参、出参结构均未变动，无需后端配合发版。
- 不涉及网关路由、权限码、错误码、数据库。
- 团期详情页与子订单展开区不在本文范围（展开区见同日另一条
前端缺陷条目）。
四、需要另行确认的两项
regionText现网为null，是产品域没有回填地区文案，不是接口缺字段。前台先按「有值才渲染」处理，数据侧另行推动。minGroupPeople现网为0，它是人数成团门槛（0 表示不限）；原型「满 6 户成团」用的是户数门槛minToForm，该字段目前只在团期详情GET /v3/admin/order/group-batch/{groupBatchId}返回，列表接口没有，已开工单 #7769 补。在 #7769 交付前，统计条副标题的成团标准做不出来。
五、相关文档
- 差异清单：
需求分析/测试发现问题.md模块 1 - 原型出处：
需求分析/2026-09-11-团期模块需求分析.md§1.2、§2.2.4 - 后端缺口工单：#7769（出参补
daysToDepart/minToForm）、#7770（入参补日期区间筛选与排序）
关联 / 联系人
- 后端：wx
- 前端：mmg