汉秋
c5374666de
Integrate scenic selection and permission flows into home routing, add AMap SDK for device builds while keeping arm64 simulators compilable via Podfile post_install hooks. Co-authored-by: Cursor <cursoragent@cursor.com>
2.2 KiB
景区权限模块
模块职责
Features/ScenicPermission 承接首页 scenicselection、permission_apply、permission_apply_status、scenicapplication 权限入口，负责景区选择、角色景区权限申请、新增景区申请和申请状态展示。
代码结构
ScenicPermissionAPI：封装景区列表、地区树、角色权限申请和景区申请接口。ScenicSelectionViewModel：管理景区搜索、定位距离、最近景区标记和切换景区持久化。PermissionApplyViewModel：管理申请角色、申请景区、多选状态、已有权限禁用和提交审核。ScenicApplicationViewModel：管理新增景区申请表单、图片上传、待审核记录回填和提交。PermissionApplyStatusViewModel：管理权限申请状态读取和驳回记录回填入口。
业务流程
景区选择页读取 AccountContext.scenicScopes，展示当前角色可访问景区。用户切换景区后调用 AccountContext.selectScenic(id:)，并通过 AccountSnapshotStore.saveCurrentSelection 保存当前景区、门店和角色 ID。RootView 会继续按当前景区 ID 懒加载景点/打卡点数据。
定位只用于计算景区距离和标记“距离最近”。定位结果不上传、不缓存；定位失败时页面保留景区列表并显示提示。
权限申请页读取 PermissionContext.rolePermissions 生成角色选项和已有权限展示。选择角色后请求景区列表，当前角色已拥有的景区禁用且不可提交。提交成功后等待后台审核。
新增景区申请页先加载地区树，再读取待审核、驳回或取消的景区申请记录。审核中的记录只读；驳回记录可编辑后重新提交。提交时先使用 OSSUploadService.uploadScenicApplicationImage 上传本地图片，再提交最终图片 URL 和表单数据。
缓存边界
当前景区、当前门店、角色 ID 和景区作用域属于账号快照，可保存到 UserDefaults。定位结果、景区申请图片临时数据、OSS STS token、上传进度和表单输入不落盘。
scenic_settlement 和 scenic_settlement_review 是首页独立结算业务入口，不属于本模块迁移范围，目前仍保持占位。