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

钱包提现与银行卡开发日志

操作时间：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与全功能验收继续不通过。