41 lines
2.8 KiB
Markdown
41 lines
2.8 KiB
Markdown
# 钱包提现与银行卡开发日志
|
||
|
||
操作时间：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与全功能验收继续不通过。
|