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

仪表盘模块

功能概述

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

页面

页面	路径	说明
数据分析	/analytics	核心指标卡片 + 营业额趋势图
工作台	/workspace	工作台快捷入口

数据分析页

指标卡片

指标	数据来源	说明
用户数	yii_user	系统注册用户总数
API 日志数	xk_api_op_log	API 调用总次数
订单数	yii_product_order	产品订单总数
门店数	yii_store	系统门店总数

营业额趋势

参数	说明
type=1	最近 24 小时（按小时统计）
type=2	最近 12 个月（按月统计）

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	服务层