# 尾款凭证上传按钮显示条件修正

**日期**: 2026-03-23
**页面**: 订单详情 → 尾款凭证上传按钮
**类型**: 前端修正

---

## 问题

当前前端尾款凭证上传按钮的显示条件不准确，需要与后端逻辑对齐。

## 正确的显示条件

```js
// 尾款凭证上传按钮显示条件
const showBalanceProofBtn =
  order.paymentType === 'DEPOSIT'
  && (
    (order.status === 'CONFIRMED' && order.processStatus === 'READY')
    || order.status === 'PENDING_DEPARTURE'
  );
```

### 条件说明

| 条件 | 说明 |
|------|------|
| `paymentType === 'DEPOSIT'` | 必须是定金模式（定金+尾款） |
| `status === 'CONFIRMED' && processStatus === 'READY'` | 已确认 + 内部流程全部完成（清单确认后进入就绪） |
| `status === 'PENDING_DEPARTURE'` | 待出行状态（允许补传凭证） |

### 注意

- **不需要判断 `PENDING_BALANCE` 状态** — 后端不校验此状态
- `CONFIRMED` 状态必须同时判断 `processStatus === 'READY'`，确保清单确认已完成后才能上传
- 上传成功后，如果原状态是 `CONFIRMED`，后端会自动将订单状态转为 `PENDING_DEPARTURE`（待出行）

## 涉及接口

**上传尾款凭证**: `POST /admin/order/{orderId}/balance`

请求体 (`RecordBalanceRequest`):
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| proofUrl | String | 否 | 尾款凭证图片URL（OSS地址） |
| remark | String | 否 | 备注 |