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

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

changelogs/2026-03/2026-03-23_balance_proof_button_condition.md

@@ -0,0 +1,47 @@
+# 尾款凭证上传按钮显示条件修正
+
+**日期**: 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 | 否 | 备注 |