wx/hl-api-changelog

派生 0

文件

T

jw和Claude Opus 5 d38d8fc4bb

changelog-filename-gate / validate (push) Failing after 1s

详情

docs(changelog): 前台团期列表两条前端条目(列表漏展示 11 字段 + 子订单联系人绑错 customerName)

按团期原型逐块比对测试环境产出，后端零改动：
- 前端优化：GET /v3/admin/order/group-batch、/summary、/products 已返回的 11 个字段前台未渲染
  （productName/endDate/orderCount/enrolledPeople/maxParticipants/remainParticipants/maxRooms/
  batchNo 展示形态/subOrderCount/total/coverImageUrl+regionText），逐条附现网实测值。
- 前端缺陷：SubOrderTable.vue:25 绑 o.contactName，该接口出参只有 customerName，联系人列恒显破折号；
  同表 paidAmount/balanceAmount/orderStatusName/payStatusName 四个已返回字段也未使用。

后端确实缺的 5 项另开工单 #7769（出参 daysToDepart/minToForm）与 #7770（入参日期区间筛选与排序），不在本文范围。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-15 17:20:32 +08:00

4.3 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	pending	mmg				纯前端条目，后端零改动。GET /v3/admin/order/group-batch/{groupBatchId}/orders 出参未变，联系人字段一直叫 customerName，前台绑成了不存在的 contactName，导致该列恒显破折号。同时该接口已返回的已付/待付/订单状态/支付状态四个字段前台也未使用。后端经核对零缺口。	2026-09-15	dev-v3

前台团期列表子订单展开区联系人绑错字段恒显破折号（前端缺陷）

服务: hl-order-service-v3（后端零改动）页面: 管理后台 /order-v2/batch 团期订单列表 → 展开某一期的子订单组件: src/views/order-v2/batch/components/SubOrderTable.vue 接口: GET /v3/admin/order/group-batch/{groupBatchId}/orders 日期: 2026-09-15 影响范围: 仅前台渲染；无端点、无出入参、无路由、无 DDL 变化

⚠️ 关键变化

🔴 联系人列绑错了字段名，现网恒显破折号。

SubOrderTable.vue:25 写的是：

<b>{{ o.contactName || '—' }}</b>

而该接口的出参里没有 contactName 这个字段，联系人字段叫 customerName。所以无论数据是否齐全，这一列永远走 || '—' 兜底。

现网实测（团期 2096495107078328322 的首条子订单）：

{
  "orderId": "2096495107032190978",
  "orderNo": "HL20260906150559114",
  "customerName": "#7158验收",
  "participantCount": 2,
  "orderStatus": "PENDING_PAY",
  "orderStatusName": "待支付",
  "payStatus": "UNPAID",
  "payStatusName": "未支付",
  "paidAmount": "0.00",
  "balanceAmount": "4000.00",
  "totalPrice": "4000.00",
  "tierName": "2成人",
  "contactPhone": "138****2046"
}

customerName 有值，页面却显示破折号。

一、修复方式

把 o.contactName 改绑 o.customerName 即可，后端不需要任何改动。

说明：contactName 这个名字在团期行程接口（GB-ADM-018）里确实存在，但已标注废弃、与 customerName 同值同源；子订单列表接口从来只有 customerName，不要按行程接口的字段名去猜。

二、同一张表上另外 4 个已返回但未使用的字段

#	原型上的元素	接口字段	现网实测值	前台现状
1	已付金额（原型「¥5,000 / ¥12,300」左值）	`paidAmount`	`0.00`	只显应收 `totalPrice`，看不出欠款
2	待付尾款	`balanceAmount`	`4000.00`	未使用
3	子订单状态（原型「待出行 / 待补全信息」）	`orderStatus` / `orderStatusName`	`PENDING_PAY` / `待支付`	该位置现在放的是「资料待补」标签（对应 `travelerInfoComplete`），不是订单状态
4	支付状态标签	`payStatus` / `payStatusName`	`UNPAID` / `未支付`	未使用

三、字段口径提醒

中文名一律直显后端给的 *Name 字段，不要在前台自建枚举到中文的映射表；后端加状态时前台不需要跟着改。
totalPrice 是本户应收（orderAmount + 增项 − 优惠，下限 0，取消单返 0.00）；balanceAmount 是待付尾款（应收 − 已退 − 已付，恒非负）。两者都由后端算好，前台不要自行相减。
contactPhone 已在后端脱敏（前 3 后 4），前台直显即可。
展开区默认不含已取消子订单（includeCancelled 缺省 false），所以行上的子订单数与展开条数在有取消单时会不一致；需要一致时显式传 includeCancelled=true。

四、不影响范围

接口路径、入参、出参结构均未变动，无需后端配合发版。
不涉及网关路由、权限码、错误码、数据库。
团期列表行本身的漏展示字段见同日另一条 前端优化 条目。

五、相关文档

差异清单：需求分析/测试发现问题.md 模块 2
原型出处：需求分析/2026-09-11-团期模块需求分析.md §3.2「子订单页」

关联 / 联系人

后端：wx
前端：mmg

4.3 KiB 原始文件 Blame 文件历史 Unescape Escape