Files
platforms/docs/开发日志_钱包提现与银行卡_20260911.md

41 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

# 钱包提现与银行卡开发日志
操作时间2026-09-11 19:40
操作类型:扩展
影响模块用户端钱包、银行卡、提现申请、Client API、钱包数据模型
## 操作前状态
图28已有余额、账单和充值入口但提现仍弹“暂未开放”银行卡入口没有页面。服务端已有本人银行卡绑定、解绑、提现申请和提现记录接口Flutter未接入银行卡没有默认到账卡字段和切换接口。
## 具体操作
- 新增`WalletBank``WalletWithdrawal`强类型模型,金额继续使用整数分,银行卡只读取脱敏卡号。
- 新增`/wallet/withdraw``/wallet/banks`页面,接入真实余额、到账卡、提现记录、支付密码、二次确认、绑定和安全解绑。
- 图28的提现和银行卡入口改为真实导航押金、优惠券、待退款仍保留“暂未开放”入口不填写设计样例金额。
- 新增默认到账卡服务端字段与切换接口;首张新卡自动设为默认,解绑默认卡后选择下一张,待处理提现仍禁止解绑。
- 提现提交只显示服务端返回的待审核或实际状态,不把申请成功写成已到账。
## 代码变更
- `apps/user_app/lib/domain/models/wallet_account.dart`:银行卡、提现记录及金额解析。
- `apps/user_app/lib/data/repositories/client_repository.dart`:银行卡、默认卡和提现接口适配。
- `apps/user_app/lib/ui/features/wallet/wallet_page.dart`图28真实入口和视觉文案。
- `apps/user_app/lib/ui/features/wallet/withdrawal_page.dart`图39完整首期页面。
- `apps/user_app/lib/ui/features/wallet/bank_cards_page.dart`图40列表、添加、默认卡和解绑。
- `backend/api/internal/models/wallet_bank.go``internal/logic/common/client_wallet.go``internal/routers/client.go`:默认卡字段、接口和事务规则。
- `apps/user_app/test/data/wallet_account_test.dart``test/ui/withdrawal_page_test.dart``tool/a1_visual_test.dart`:契约、交互和多尺寸视觉测试。
## 验证结果
- `flutter analyze`通过Flutter全量170项测试通过Web Release构建通过。
- 图39修复窄屏银行卡下拉和到账时间溢出图39、40纳入320/360/390/430宽及1.0/1.3倍文字截图。
- `go test ./...``go vet ./...`和API构建通过新API已在12426重启继续使用既有远程数据库配置。
- 内置浏览器确认真实余额、真实可提现余额、脱敏银行卡、添加表单和押金未开放提示;没有提交提现、绑定、解绑或切换现有银行卡。
## 风险评估
银行卡渠道验证回执、短信验证码供应商和提现到账渠道仍依赖外部服务配置当前首期支持支付密码校验和平台审核状态。图28的押金、优惠券、待退款仍无真实业务接口严格1:1与全功能验收继续不通过。