汉秋
c39c3d3c75
将定金订单、历史拍摄与多行程上传接入 Orders，并以真实页面替换首页排队管理、消息中心、景区结算与提现审核占位入口。 Co-authored-by: Cursor <cursoragent@cursor.com>
2.3 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 是首页独立结算业务入口，已由 Features/ScenicSettlement 接管。ScenicPermission 模块只提供景区列表、景区申请记录和权限申请记录等可复用接口。