汉秋
1970572edd
新增 CooperationOrder 模块（双 Tab 列表、获客员绑定、主 Tab 扫码）、订单来源/带客单绑定及配套 API 测试；同步引入 roleCode 权限匹配与相关单元测试。 Co-authored-by: Cursor <cursoragent@cursor.com>
27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# Statistics 模块业务逻辑
|
||
|
||
## 模块职责
|
||
|
||
Statistics 模块负责登录后的数据 Tab，展示当前景区下的订单统计看板。
|
||
|
||
当前同步旧工程数据页的主要能力：时间段切换、统计汇总卡、每日明细、分页加载和下拉刷新。
|
||
|
||
## 核心对象
|
||
|
||
- `StatisticsView`：数据 Tab 根视图，读取当前景区、当前角色和统计 API。
|
||
- `StatisticsViewModel`：管理时间段、汇总数据、每日明细、分页状态和加载状态。
|
||
- `StatisticsAPI`：封装摄影师和景区管理员两套统计接口。
|
||
- `StatisticsPeriod`：表示今日、昨日、7日、本月四个快捷时间段。
|
||
|
||
## 数据流程
|
||
|
||
页面从 `AccountContext.currentScenic` 获取当前景区 ID。缺少景区时显示空状态，不请求接口。
|
||
|
||
切换时间段时同时请求汇总接口和第一页日数据接口。汇总接口使用 `range` 参数，日数据接口使用 `start_time`、`end_time`、`page` 和 `page_size`。
|
||
|
||
`currentAppRole.isScenicAdmin == true` 时使用景区管理员接口，其他角色使用摄影师接口。日数据响应使用 `DataListPayload` 解码，兼容后端返回 `data` 或 `list` 字段。
|
||
|
||
## 分页规则
|
||
|
||
每日明细第一页随刷新或时间段切换加载。列表滚动到底部后，如果当前数量小于 total，则继续加载下一页。加载更多失败时保留已有数据和当前页状态。
|