diff --git a/changelogs/2026-03/2026-03-20_notification_template_fix.md b/changelogs/2026-03/2026-03-20_notification_template_fix.md new file mode 100644 index 0000000..8dd9d06 --- /dev/null +++ b/changelogs/2026-03/2026-03-20_notification_template_fix.md @@ -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显示为空 | 修正变量名,正确显示取消原因 | +| 退款已申请 | 缺退款金额 | 补充退款金额 | +| 退款被驳回 | 变量名不匹配,原因显示为空 | 修正变量名,正确显示驳回原因 | +| 行程已修改 | 变量名不匹配 | 修正变量名 | +| 房型/车型已变更 | 变量名不匹配 | 修正变量名 | +| 修改已确认 | 模板内容为空 | 补全模板 | +| 级联失效通知 | 变量名不匹配 | 修正变量名 | +| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |