docs: design payment detail transfer cards as white amount-first layout

Capture approved option A demo and implementation outline for schedule/transfer hierarchy in payment detail.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
zlwuandCursor committed 2026-10-14 15:17:21 +08:00
1 parent f045841f1a
commit 5ce18e56a0
2 files changed
+654

No files matched your search

@@ -0,0 +1,77 @@
# 缴费明细 · 应缴批次转账展示(方案 A)
**日期:** 2026-10-14
**状态:** 方案 A 已确认(Demo),待实现
**Demo:** `docs/demos/2026-10-14-payment-detail-transfer-display-demo.html`
## 1. 背景
市场【缴费信息】→【缴费明细】中,「应缴批次」把期次与转账都渲染成同一套浅绿 `nested-card`,标题为「转账笔 N」,字段全是左右堆叠,层级与金额扫读都不清晰。
## 2. 已确认决策
| 项 | 决策 |
|----|------|
| 视觉方案 | **方案 A**:期次浅绿头 + 两列指标;转账为白底独立卡,金额突出 |
| 备选 | 方案 B(时间线折叠)不采用 |
| 范围 | `mobile-oa-h5` 缴费明细「应缴批次」;通过卡片 `variant` 落地,协议详情中同类转账子卡可一并受益 |
| 非范围 | 不改后端字段;不改登记/编辑转账表单;不做方案 B 折叠 |
## 3. 目标视觉
### 3.1 期次卡(schedule)
- 顶栏:`第 N 期` + 状态 Tag(已缴清 / 待缴清等)
- 指标区两列:应缴金额、应缴日、已缴金额、欠缴金额(金额用 money 色)
- 下方「转账记录(n)」分区
### 3.2 转账卡(transfer)
- 白底、描边、圆角,与期次浅绿底形成层级差
- 头行:序号角标 · **转账金额(大字)** · 状态 Tag
- 副文案一行:`转账方式 · 转账时间`
- 备注 / 财务备注两列
- 有凭证时单独一块展示(复用现有附件只读组件)
## 4. 实现要点
### 4.1 数据(`modules/payment.js`)
`transferCard` 增加展示元数据,例如:
```js
{
key, title, // title 可保留但 UI 优先用金额
variant: 'transfer',
statusText, statusTone,
amount: money(transfer.transferAmount),
meta: `${方式} · ${时间}`,
fields: [
{ label: '备注', ... },
{ label: '财务备注', ... },
{ label: '转账凭证', type: 'attachments', ... } // 有则展示
]
}
```
`scheduleCard` 增加 `variant: 'schedule'`(可选,便于样式区分)。
### 4.2 UI(`MarketDetailNestedCard.vue` + `market.css`)
- 按 `card.variant === 'transfer'` 走方案 A 转账模板;否则保持兼容(或 `schedule` 走期次头+指标网格)。
- 递归子卡仍用同一组件;转账不再复用浅绿满底样式。
- 触控与字号对齐现有详情区(13–14px,金额醒目)。
### 4.3 协议详情
`protocol.js` 中样本缴费下的 schedule→transfer 子卡若结构相同,同步打上 `variant: 'transfer'`,避免一端新一端旧。
## 5. 测试
- 更新 / 新增 parity:transfer 卡片含 `variant: 'transfer'`、样式类(如 `market-detail-section__transfer-card`)、金额头不依赖「转账笔 N」作为主视觉。
- 现有详情嵌套递归测试仍通过。
## 6. 非目标
- 不引入方案 B 的展开/收起。
- 不改列表页缴费卡片。