初始化

docs/projects/xk-admin/modules/dashboard.md

@@ -0,0 +1,52 @@
+# 仪表盘模块
+
+## 功能概述
+
+管理后台首页仪表盘，展示系统核心指标和营业趋势。
+
+## 页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 数据分析 | `/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` | 服务层 |