汉秋
1a0d1c25f4
Wire deposit orders, historical shooting, and multi-travel uploads into Orders, and replace home placeholders for queue management, message center, scenic settlement, and withdrawal audit. Co-authored-by: Cursor <cursoragent@cursor.com>
30 lines
2.3 KiB
Markdown
30 lines
2.3 KiB
Markdown
# 景区权限模块
|
|
|
|
## 模块职责
|
|
|
|
`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 模块只提供景区列表、景区申请记录和权限申请记录等可复用接口。
|