suixinkan_ios_new/suixinkan/Features/Profile/Profile.md

Profile 模块业务逻辑

模块职责

Profile 模块负责“我的/个人信息”页面，包括用户资料展示、昵称编辑、密码修改、实名认证状态展示和退出登录。

该模块聚焦个人资料业务：

• 拉取用户基础资料。
• 拉取实名认证信息。
• 展示头像、昵称、UID、手机号、账号状态和实名认证状态。
• 修改昵称。
• 修改密码。
• 退出登录入口。

登录态清理和缓存清理由 App 模块的 AuthSessionCoordinator 统一处理。

核心对象

• ProfileView：个人信息页 UI，负责展示资料、编辑入口、密码弹窗和退出确认。
• ProfileViewModel：维护资料加载状态、编辑状态、保存状态和展示文案。
• ProfileAPI：封装用户资料、实名认证和资料更新接口。
• UserInfoResponse：用户基础资料。
• RealNameInfoResponse / RealNameInfo：实名认证信息。
• UpdateInfoRequest：昵称、密码或头像更新请求体。

加载流程

1. ProfileView.task 进入页面时调用 reloadProfile(showToast: false)。
2. 下拉刷新时调用 reloadProfile(showToast: true)。
3. ProfileViewModel.reload 并发请求：
   • ProfileAPI.userInfo
   • ProfileAPI.realNameInfo
4. 请求成功后更新 userInfo 和 realNameInfo。
5. ProfileView 将最新 userInfo 交给 AuthSessionCoordinator.refreshCachedProfile。
6. 协调器更新 AccountContext.profile，并同步刷新账号快照。

昵称编辑流程

1. 用户点击编辑按钮。
2. ProfileViewModel.beginEditing 进入编辑状态，并把当前昵称写入编辑框。
3. 用户提交后，ProfileViewModel.saveProfile 校验昵称非空。
4. 昵称未变化时直接退出编辑状态。
5. 昵称变化时调用 ProfileAPI.updateUserInfo(nickname:)。
6. 接口成功后本地更新 userInfo.nickname。
7. ProfileView 刷新全局账号资料和账号快照。

密码修改流程

1. 用户打开 PasswordUpdateSheet。
2. 输入新密码并点击完成。
3. ProfileViewModel.updatePassword 校验密码至少 6 位。
4. 校验通过后调用 ProfileAPI.updateUserInfo(password:)。
5. 成功后关闭弹窗并展示 Toast。

密码不会写入本地缓存。

退出登录流程

1. 用户点击退出登录。
2. ProfileView 展示确认弹窗。
3. 用户确认后调用 AuthSessionCoordinator.logout。
4. 协调器清空正式 token、账号快照、账号上下文、路由栈和 Toast。
5. AppSession 切换为 loggedOut，根视图回到登录页。
6. 上次手机号和协议状态等非敏感偏好保留。

状态展示规则

• 昵称为空时展示“未设置昵称”。
• 真实姓名、手机号和账号状态为空时展示 --。
• 实名认证状态：
  • auditStatus == 2：已实名认证。
  • auditStatus == 3：审核不通过。
  • 其他状态：审核中。
  • 无实名认证信息时：点击去实名认证。