53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
|
# 仪表盘模块
|
||
|
|
|
||
|
|
## 功能概述
|
||
|
|
|
||
|
|
管理后台首页仪表盘，展示系统核心指标和营业趋势。
|
||
|
|
|
||
|
|
## 页面
|
||
|
|
|
||
|
|
| 页面 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| 数据分析 | `/analytics` | 核心指标卡片 + 营业额趋势图 |
|
||
|
|
| 工作台 | `/workspace` | 工作台快捷入口 |
|
||
|
|
|
||
|
|
## 数据分析页
|
||
|
|
|
||
|
|
### 指标卡片
|
||
|
|
|
||
|
|
| 指标 | 数据来源 | 说明 |
|
||
|
|
|------|----------|------|
|
||
|
|
| 用户数 | `yii_user` | 系统注册用户总数 |
|
||
|
|
| API 日志数 | `xk_api_op_log` | API 调用总次数 |
|
||
|
|
| 订单数 | `yii_product_order` | 产品订单总数 |
|
||
|
|
| 门店数 | `yii_store` | 系统门店总数 |
|
||
|
|
|
||
|
|
### 营业额趋势
|
||
|
|
|
||
|
|
| 参数 | 说明 |
|
||
|
|
|------|------|
|
||
|
|
| `type=1` | 最近 24 小时（按小时统计） |
|
||
|
|
| `type=2` | 最近 12 个月（按月统计） |
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
graph LR
|
||
|
|
A[AnalyticsService] --> B[UserModel<br/>用户总数]
|
||
|
|
A --> C[ApiOpLogModel<br/>API日志数]
|
||
|
|
A --> D[ProductOrderModel<br/>订单数 + 营业额]
|
||
|
|
A --> E[StoreModel<br/>门店数]
|
||
|
|
```
|
||
|
|
|
||
|
|
## 对应 API
|
||
|
|
|
||
|
|
| 方法 | 路径 | 说明 |
|
||
|
|
|------|------|------|
|
||
|
|
| GET | `api/admin/home/analytics` | 指标卡片统计数据 |
|
||
|
|
| GET | `api/admin/home/turnover` | 营业额趋势数据 |
|
||
|
|
|
||
|
|
## 关联类
|
||
|
|
|
||
|
|
| 类 | 路径 | 说明 |
|
||
|
|
|----|------|------|
|
||
|
|
| `AnalyticsController` | `app/Service/admin/home/AnalyticsController.php` | 控制器 |
|
||
|
|
| `AnalyticsService` | `app/Service/admin/home/AnalyticsService.php` | 服务层 |
|