# ⚠️ Breaking: 订单详情响应硬删 `pendingUpgradeAmount` 字段

**日期**: 2026-04-27
**PR**: #1320 (T+2 周收尾, 主 PR #1318)
**类型**: Breaking — 字段从响应中移除
**影响端**: 管理后台 (admin) + 微信小程序 (mp)

---

## 影响接口

- `GET /admin/orders/{id}`(订单详情 - 管理端)
- `GET /mp/orders/{id}`(订单详情 - 小程序端)

两个接口的响应顶层 `OrderDetailVO` **不再返回** `pendingUpgradeAmount` 字段。

## 字段含义(已废弃)

```
"pendingUpgradeAmount": "0.00"   // 待确认差价总额(配房/配车升级未确认)
```

主 PR #1318 (2026-04-23) 上线 V2 流程后, 差价已归并入 `OrderDiscount`(负) / `OrderSurcharge`(正), 该字段值已恒为 `0.00`(兼容字段)。今天 (T+2 周) 完成硬删。

## 前端动作

### 必须 ✅
- 移除任何对响应 `pendingUpgradeAmount` 字段的读取与渲染代码(`undefined` 不会触发渲染异常,但属于死代码)

### 建议 (如确实需要差价) ✅
- 走订单优惠/增项明细字段 — 各自带 `confirmed` 状态:
  - `discounts: [{ amount, confirmed, sourceType, ...}]`
  - `surcharges: [{ amount, confirmed, sourceType, ...}]`
- 用 `surchargeAmount` 字段(已确认增项总额)代替原"待确认差价"用途时,需注意语义已变为**已确认**

## 不受影响的字段(保留)

- `OrderDetailVO.discountAmount`(优惠总额)
- `OrderDetailVO.surchargeAmount`(增项总额)
- `OrderDetailVO.depositAmount` / `depositRatio`(订金)
- 其它金额字段全部不动

## 部署时机

- dev 已合并 (`af55ee62`), 测试服部署后立即生效
- 正式服将在测试服稳定 ≥ 24h 后部署

## 关联

- 主 PR #1318 (订单内部流程 V2, 已合并 2026-04-23)
- 后端 changelog: `hl-backend-changelog/changelogs/2026-04/2026-04-27_order-v2_t2-cleanup-pending-upgrade-amount-and-dict-hard-delete.md`
