fix: 通知模板变量名修正 + 小程序订单详情新增字段

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
这个提交包含在:
API Changelog Bot 2026-03-20 19:23:26 +08:00
父节点 89792aba18
当前提交 9b480063bb

查看文件

@ -0,0 +1,83 @@
# 通知模板修正 + 订单详情字段补全
> **类型**: fix
> **日期**: 2026-03-20
> **涉及服务**: hl-order-service、hl-mp-service
> **后端状态**: ✅ 已完成并部署
---
## 一、小程序订单详情接口新增字段
### GET `/mp/order/{orderId}` 订单详情
响应新增以下字段:
| 字段 | 类型 | 说明 |
|------|------|------|
| surchargeAmount | BigDecimal | 费用增加总额(如升级房型补差价) |
| surcharges | List | 费用增加项列表(同优惠项 discounts 结构对称) |
| displayStatus | String | 展示状态(前端主要使用此字段展示订单状态) |
| displayStatusLabel | String | 展示状态中文标签 |
| transportSegments | List | 交通段列表(大交通信息) |
| sharerOpenid | String | 分享者openid |
### displayStatus 枚举值
| 值 | 标签 | 说明 |
|----|------|------|
| PENDING_PAY | 待支付 | 订单创建未支付 |
| DEPOSIT_PAID | 已付定金 | 定金已支付 |
| PAID | 已支付 | 全款已支付 |
| CONFIRMED | 已确认 | 订单已确认 |
| PENDING_BALANCE | 待付尾款 | 等待用户支付尾款 |
| PENDING_DEPARTURE | 待出发 | 内部流程完成,等待出发 |
| TRAVELLING | 出行中 | 行程进行中 |
| COMPLETED | 已完成 | 行程结束 |
| CANCELLED | 已取消 | 订单已取消 |
| REFUNDING | 退款中 | 退款处理中 |
| REFUNDED | 已退款 | 退款完成 |
### surcharges 列表项结构
| 字段 | 类型 | 说明 |
|------|------|------|
| surchargeId | String | 费用增加项ID |
| orderId | String | 订单ID |
| surchargeName | String | 费用增加项名称(如"升级房型补差价" |
| surchargeAmount | BigDecimal | 金额 |
| createTime | DateTime | 创建时间 |
### 前端使用建议
- **订单状态展示**:优先使用 `displayStatus` + `displayStatusLabel`,而非 `status`
- **金额汇总区域**:新增"费用增加"行
```
总价: ¥3000.00
优惠: -¥100.00
增加: +¥200.00 ← 新增surchargeAmount > 0 时显示)
定金: ¥1000.00
尾款: ¥2100.00
```
- **费用增加项列表**:在优惠项列表下方展示 surcharges 列表
---
## 二、通知消息内容修正
所有通知模板(站内信/短信/订阅消息/公众号)内容已优化,**前端无需改动**,后端自动生效。
以下是修正的内容汇总(仅供参考,前端不需要处理模板内容):
| 事件 | 修正前问题 | 修正后 |
|------|-----------|--------|
| 定金支付成功 | 缺出发日期 | 补充出发日期 + 尾款提示 |
| 全款支付成功 | 缺出发日期 | 补充出发日期 |
| 订单已取消 | 变量名不匹配,reason显示为空 | 修正变量名,正确显示取消原因 |
| 退款已申请 | 缺退款金额 | 补充退款金额 |
| 退款被驳回 | 变量名不匹配,原因显示为空 | 修正变量名,正确显示驳回原因 |
| 行程已修改 | 变量名不匹配 | 修正变量名 |
| 房型/车型已变更 | 变量名不匹配 | 修正变量名 |
| 修改已确认 | 模板内容为空 | 补全模板 |
| 级联失效通知 | 变量名不匹配 | 修正变量名 |
| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |