1.5 KiB
1.5 KiB
钱包模块
模块职责
Features/Wallet 承接首页 wallet 权限入口，负责个人钱包首页、收益明细、提现记录、提现申请、银行卡设置和积分兑换。
代码结构
WalletAPI：封装钱包、提现、银行卡、地区、积分相关接口。WalletViewModel：管理钱包汇总、收益明细分页、提现记录分页和提现资格判断。WithdrawApplyViewModel：管理提现信息、金额校验、短信验证码和提现提交。WithdrawalSettingsViewModel：管理银行卡资料、图片上传和银行卡更新提交。PointsRedemptionViewModel：管理积分概览、兑换记录和兑换申请。WalletView：钱包首页和钱包内部二级路由入口。
提现资格流
点击提现后先查询实名认证：
- 未提交或驳回：进入已迁移的
RealNameAuthView。 - 审核中：提示等待实名认证审核通过。
- 实名认证通过：查询银行卡资料。
- 无银行卡或银行卡驳回：进入
WithdrawalSettingsView。 - 银行卡审核中：提示等待审核。
- 银行卡通过：进入
WithdrawApplyView。
上传与缓存边界
银行卡正反面照片使用 PhotosPicker 选择后，通过 OSSUploadService.uploadBankCardImage 上传到 bank_card/yyyyMMdd/scenicId/... 路径，再把最终 URL 提交给服务端。
钱包数据只保存在各 ViewModel 内存中。短信验证码、OSS STS、提现表单、银行卡图片 Data 和积分兑换表单均不落盘。