From a7605f741432a61cbace62ebd20a7e323e19c8fb Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 23 Mar 2026 10:46:32 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=A2=E5=8D=95=E8=AF=A6=E6=83=85?= =?UTF-8?q?=E9=9C=80=E5=B1=95=E7=A4=BA=E5=B0=BE=E6=AC=BE=E5=87=AD=E8=AF=81?= =?UTF-8?q?=E5=9B=BE=E7=89=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- .../2026-03-23_balance_proof_display.md | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 changelogs/2026-03/2026-03-23_balance_proof_display.md diff --git a/changelogs/2026-03/2026-03-23_balance_proof_display.md b/changelogs/2026-03/2026-03-23_balance_proof_display.md new file mode 100644 index 0000000..334a07e --- /dev/null +++ b/changelogs/2026-03/2026-03-23_balance_proof_display.md @@ -0,0 +1,28 @@ +# 订单详情展示尾款凭证 + +**日期**: 2026-03-23 +**页面**: 订单详情页 → 金额明细区域 +**类型**: 前端新增 + +--- + +## 说明 + +上传尾款凭证后，订单详情接口已返回 `balanceProofUrl` 字段，但前端没有展示。 + +## 后端已返回的字段 + +订单详情接口 `GET /admin/order/{orderId}` 响应中： + +| 字段 | 类型 | 说明 | +|------|------|------| +| balanceProofUrl | String | 尾款凭证图片URL，null=未上传 | +| balanceAmount | BigDecimal | 尾款金额 | +| balancePayMethod | String | 尾款支付方式：ONLINE / OFFLINE | + +## 前端展示建议 + +在金额明细区域的"尾款"行： + +- **凭证未上传**（`balanceProofUrl` 为 null）：显示尾款金额 + 上传按钮（条件见之前的 changelog） +- **凭证已上传**（`balanceProofUrl` 有值）：尾款金额旁显示"凭证"链接或缩略图，点击可放大查看图片