changelog: 尾款凭证上传功能前端缺少入口

后端接口已就绪(PUT /admin/order/{id}/record-balance)，前端需添加上传凭证按钮和确认收款操作。

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

changelogs/2026-03/2026-03-22_balance_proof_upload.md

@@ -0,0 +1,66 @@
+# 尾款凭证上传功能 — 前端缺少入口
+
+**日期**: 2026-03-22
+**页面**: 订单详情
+**类型**: 前端功能缺失
+
+---
+
+## 问题
+
+订单详情页没有"上传尾款凭证"的按钮，管理员无法记录线下收取的尾款。
+
+## 后端接口（已就绪）
+
+### 记录尾款（线下收取）
+```
+PUT /admin/order/{orderId}/record-balance
+```
+
+**请求体**：
+```json
+{
+  "proofUrl": "https://xxx.oss.aliyuncs.com/proof/xxx.jpg",  // 选填：支付凭证图片URL
+  "remark": "客户微信转账"                                      // 选填：备注
+}
+```
+
+**前置条件**：订单状态为 `CONFIRMED`（已确认）或 `PENDING_DEPARTURE`（待出发）
+
+**调用后效果**：
+- 订单状态变为 `PENDING_DEPARTURE`（待出发）
+- `balance_proof_url` 保存凭证图片
+- 时间线记录"管理员确认收到尾款"
+
+### 设置尾款支付方式
+```
+PUT /admin/order/{orderId}/balance-pay-method?balancePayMethod=OFFLINE
+```
+可选值：`ONLINE`（线上支付）/ `OFFLINE`（线下收取）
+
+## 前端实现建议
+
+### 显示时机
+订单状态为 `CONFIRMED`（已确认）且 `paymentMode = DEPOSIT`（定金模式）时，在订单详情页显示"尾款"区域。
+
+### UI 布局
+```
+┌─ 尾款信息 ──────────────────────────────┐
+│ 尾款金额：¥8,950.00（总价 - 已付定金）      │
+│ 支付方式：○ 线上支付  ● 线下收取            │
+│                                         │
+│ [上传凭证]  ← 点击上传图片（调文件服务）     │
+│ 备注：[________________]                  │
+│                                         │
+│              [确认收到尾款]                │
+└─────────────────────────────────────────┘
+```
+
+### 操作流程
+1. 管理员选择"线下收取"
+2. 上传凭证图片（调 `POST /admin/file/upload-token` 获取上传凭证 → 上传到 OSS → 拿到 URL）
+3. 点击"确认收到尾款" → 调 `PUT /admin/order/{orderId}/record-balance`
+4. 刷新订单详情
+
+### 已有凭证回显
+订单详情返回的 `balanceProofUrl` 字段如果有值，显示已上传的凭证图片。