wx/hl-api-changelog

派生 0

文件

T

Mimingguang 89d493c7ef

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

详情

docs(changelog): 团期列表两条前端条目交付回写(联系人缺陷+11字段补渲染)

2026-09-15 18:00:16 +08:00

4.8 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	89dadf1e69fb3953389e3a34a1c402279f5a9eb8		2026-09-15	纯前端条目，后端零改动。GET /v3/admin/order/group-batch/{groupBatchId}/orders 出参未变，联系人字段一直叫 customerName，前台绑成了不存在的 contactName，导致该列恒显破折号。同时该接口已返回的已付/待付/订单状态/支付状态四个字段前台也未使用。后端经核对零缺口。前端已交付(89dadf1e):SubOrderTable 联系人改绑 customerName;金额格改「已付 paidAmount / 应收 totalPrice」复合+确有尾款时次行「待付 balanceAmount」(归一化字符串比 0.00 判零不 Number());新增状态列直显 orderStatusName/payStatusName(枚举外兜底 code,不建映射);资料标签保留。SubOrderTable.spec 夹具同步+3 新例,7/7。	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.8 KiB 原始文件 Blame 文件历史 Unescape Escape