5.2 KiB
5.2 KiB
Profile 模块业务逻辑
模块职责
Profile 模块负责“我的/个人信息”页面及其二级页面，包括用户资料展示、昵称编辑、账号切换、密码修改、实名认证、系统设置、协议页和退出登录。
该模块聚焦个人资料业务：
- 拉取用户基础资料。
- 拉取实名认证信息。
- 展示头像、昵称、UID、手机号、账号状态和实名认证状态。
- 修改昵称。
- 修改密码。
- 切换当前景区/门店业务账号。
- 提交实名认证基础资料。
- 展示系统设置、版本号、下载链接和协议 H5 页面。
- 退出登录入口。
登录态清理和缓存清理由 App 模块的 AuthSessionCoordinator 统一处理。
核心对象
ProfileView：个人信息页 UI，负责展示资料、编辑入口、密码弹窗和退出确认。ProfileViewModel：维护资料加载状态、编辑状态、保存状态和展示文案。ProfileRoute：个人中心二级页面路由。AccountSwitchView/AccountSwitchViewModel：账号切换页面和状态逻辑。RealNameAuthView/RealNameAuthViewModel：实名认证页面和表单逻辑。SettingsCenterView/AgreementView：设置中心和协议 H5 页面。ProfileAPI：封装用户资料、实名认证和资料更新接口。UserInfoResponse：用户基础资料。RealNameInfoResponse/RealNameInfo：实名认证信息。UpdateInfoRequest：昵称、密码或头像更新请求体。RealNameAuthRequest：实名认证提交请求体。
加载流程
ProfileView.task进入页面时调用reloadProfile(showToast: false)。- 下拉刷新时调用
reloadProfile(showToast: true)。 ProfileViewModel.reload并发请求：ProfileAPI.userInfoProfileAPI.realNameInfo
- 请求成功后更新
userInfo和realNameInfo。 ProfileView将最新userInfo交给AuthSessionCoordinator.refreshCachedProfile。- 协调器更新
AccountContext.profile，并同步刷新账号快照。
昵称编辑流程
- 用户点击编辑按钮。
ProfileViewModel.beginEditing进入编辑状态，并把当前昵称写入编辑框。- 用户提交后，
ProfileViewModel.saveProfile校验昵称非空。 - 昵称未变化时直接退出编辑状态。
- 昵称变化时调用
ProfileAPI.updateUserInfo(nickname:)。 - 接口成功后本地更新
userInfo.nickname。 ProfileView刷新全局账号资料和账号快照。
密码修改流程
- 用户打开
PasswordUpdateSheet。 - 输入新密码并点击完成。
ProfileViewModel.updatePassword校验密码至少 6 位。- 校验通过后调用
ProfileAPI.updateUserInfo(password:)。 - 成功后关闭弹窗并展示 Toast。
密码不会写入本地缓存。
账号切换流程
- 用户点击“当前账号”进入
AccountSwitchView。 AccountSwitchViewModel.load调用ProfileAPI.switchableAccounts，读取/api/app/v9/accounts。- 页面展示景区账号和门店账号，优先选中后端标记的当前账号，否则选中第一项。
- 用户确认后调用
AuthAPI.setUser，使用AccountSwitchAccount.toSetUserRequest()生成请求体。 - 切换成功后调用
AuthSessionCoordinator.completeLogin，重新写入正式 token、账号快照、权限、景区和门店上下文。 AppRouter.reset()清空旧路由栈并回到首页。
实名认证流程
- 用户点击“认证状态”进入
RealNameAuthView。 RealNameAuthViewModel.load调用ProfileAPI.realNameInfo并回填姓名、身份证号、证件有效期、图片 URL 和审核状态。- 用户可发送短信验证码，接口为
/api/yf-handset-app/photog/real-name/sms-verify-code。 - 提交前校验姓名、身份证号、短信验证码、证件图片 URL 和有效期。
- 校验通过后调用
/api/yf-handset-app/photog/real-name/submit。 - 提交成功后重新加载实名认证信息。
本轮证件图片先保留 URL 输入和网络预览，阿里云 OSS 图片选择上传后续接入时替换该输入区。
设置和协议流程
- 用户点击“系统设置”进入
SettingsCenterView。 - 设置中心展示关于我们、系统版本、App 下载链接、用户协议和隐私政策。
- App 下载点击后复制
/h5/app/download链接到剪贴板。 - 协议页使用
AgreementView加载APIEnvironment.current.baseURL下的 H5 页面。
退出登录流程
- 用户点击退出登录。
ProfileView展示确认弹窗。- 用户确认后调用
AuthSessionCoordinator.logout。 - 协调器清空正式 token、账号快照、账号上下文、路由栈和 Toast。
AppSession切换为loggedOut，根视图回到登录页。- 上次手机号和协议状态等非敏感偏好保留。
状态展示规则
- 昵称为空时展示“未设置昵称”。
- 真实姓名、手机号和账号状态为空时展示
--。 - 实名认证状态：
auditStatus == 2：已实名认证。auditStatus == 3：审核不通过。- 其他状态：审核中。
- 无实名认证信息时：点击去实名认证。
- 账号切换失败只展示 Toast，不清空登录态。
- 实名认证失败只影响实名认证页面，不影响登录态和账号上下文。