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` 有值):尾款金额旁显示"凭证"链接或缩略图,点击可放大查看图片