fix: 通知模板变量名修正 + 小程序订单详情新增字段
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
这个提交包含在:
父节点
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显示为空 | 修正变量名,正确显示取消原因 |
|
||||||
|
| 退款已申请 | 缺退款金额 | 补充退款金额 |
|
||||||
|
| 退款被驳回 | 变量名不匹配,原因显示为空 | 修正变量名,正确显示驳回原因 |
|
||||||
|
| 行程已修改 | 变量名不匹配 | 修正变量名 |
|
||||||
|
| 房型/车型已变更 | 变量名不匹配 | 修正变量名 |
|
||||||
|
| 修改已确认 | 模板内容为空 | 补全模板 |
|
||||||
|
| 级联失效通知 | 变量名不匹配 | 修正变量名 |
|
||||||
|
| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户