# 仪表盘模块

## 功能概述

管理后台首页仪表盘，展示系统核心指标和营业趋势。

## 页面

| 页面 | 路径 | 说明 |
|------|------|------|
| 数据分析 | `/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` | 服务层 |