# 通知模板修正 + 订单详情字段补全

> **类型**: 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显示为空 | 修正变量名，正确显示取消原因 |
| 退款已申请 | 缺退款金额 | 补充退款金额 |
| 退款被驳回 | 变量名不匹配，原因显示为空 | 修正变量名，正确显示驳回原因 |
| 行程已修改 | 变量名不匹配 | 修正变量名 |
| 房型/车型已变更 | 变量名不匹配 | 修正变量名 |
| 修改已确认 | 模板内容为空 | 补全模板 |
| 级联失效通知 | 变量名不匹配 | 修正变量名 |
| 所有金额 | 缺 ¥ 符号 | 统一加 ¥ 前缀 |
