# Dashboard 仪表盘

Dashboard 是管理后台的首页,实时展示系统核心数据和运营状况。

## 页面概览

Dashboard 主要包含三大区域:

1. **关键指标卡片** - 6个核心业务指标
2. **数据统计图表** - 收入、用户、流量三大统计图
3. **赞助商展示** - 显示支持 PPanel 的赞助商

## 关键指标卡片

顶部展示 6 个关键业务指标卡片:

### 在线用户数
- **显示内容**: 当前系统在线用户数量
- **副标题**: "Currently Online"
- **点击跳转**: `/dashboard/user` 用户管理页面
- **图标**: 蓝色用户图标

### 今日流量
- **显示内容**: 今日上传+下载总流量
- **副标题**: 显示上传/下载流量明细
  - ↑ 上传流量
  - ↓ 下载流量
- **图标**: 紫色交换图标
- **格式**: 自动转换为合适单位 (KB/MB/GB/TB)

### 本月流量
- **显示内容**: 本月上传+下载总流量
- **副标题**: 显示本月上传/下载流量明细
- **图标**: 橙色云数据图标
- **格式**: 自动转换为合适单位

### 服务器总数
- **显示内容**: 在线服务器数 + 离线服务器数
- **副标题**: 显示在线/离线服务器数量明细
  - "在线 X 离线 Y"
- **点击跳转**: `/dashboard/servers` 服务器管理页面
- **图标**: 绿色服务器图标

### 待回复工单
- **显示内容**: 等待管理员回复的工单数量
- **副标题**: "Pending"
- **点击跳转**: `/dashboard/ticket` 工单管理页面
- **图标**: 红色工单图标

### 系统版本信息
- **显示内容**:
  - 后端服务版本号
  - Web 管理端版本号
  - 版本更新状态
- **操作功能**:
  - 检查更新
  - 一键更新(如有新版本)
  - 重启系统
  - 查看更新日志

::: tip 提示
点击有链接的卡片可以快速跳转到对应的管理页面。
:::

## 数据统计图表

### 收入统计图表 (Revenue Statistics)

展示系统收入数据,支持三个时间维度切换:

**时间维度**:
- **今日 (Today)**: 今日收入数据
- **本月 (Month)**: 本月每日收入趋势
- **累计 (Total)**: 历史累计收入数据

**今日数据** - 饼图展示:
- **新购收入**: 新用户购买订单金额
- **续费收入**: 老用户续费订单金额
- **中心数字**: 今日总收入

**本月数据** - 柱状图展示:
- X轴: 每日日期
- Y轴: 收入金额
- 显示本月每日收入柱状图
- 支持鼠标悬停查看详细数据

**累计数据** - 面积图展示:
- **新购订单数**: 累计新购订单数量
- **续费订单数**: 累计续费订单数量
- **订单总数**: 累计订单总数
- 趋势面积图展示长期变化

**底部汇总**:
- 新购金额 / 订单数
- 续费金额 / 订单数
- 总金额 / 总订单数

### 用户统计图表 (User Statistics)

展示用户相关数据,支持三个时间维度切换:

**时间维度**:
- **今日 (Today)**: 今日用户数据
- **本月 (Month)**: 本月每日用户趋势
- **累计 (Total)**: 历史累计用户数据

**今日数据** - 饼图展示:
- **注册用户**: 今日新注册用户数
- **新购用户**: 今日首次购买用户数
- **续费用户**: 今日续费用户数
- **中心数字**: 今日总用户数(注册+新购+续费)

**本月数据** - 柱状图展示:
- X轴: 每日日期
- Y轴: 用户数量
- 三种颜色柱状图:
  - 注册用户 (蓝色)
  - 新购用户 (绿色)
  - 续费用户 (橙色)

**累计数据** - 面积图展示:
- **注册用户**: 累计注册用户趋势
- **新购用户**: 累计新购用户趋势
- **续费用户**: 累计续费用户趋势
- 三条面积曲线展示长期变化

**底部汇总**:
- 注册用户总数
- 新购用户总数
- 续费用户总数

### 流量排名图表 (Traffic Rank)

展示节点或用户的流量使用排名:

**时间切换** (右上角标签):
- **今日 (Today)**: 今日流量排名
- **昨日 (Yesterday)**: 昨日流量排名

**类型切换** (下拉选择):
- **节点流量 (Nodes)**: 显示各服务器节点的流量消耗排名
- **用户流量 (Users)**: 显示用户流量使用排名

**图表展示** - 横向柱状图:
- Y轴: 排名序号(1, 2, 3...)
- X轴: 流量大小(自动转换单位)
- 柱状图: 流量大小可视化
- 柱内标签: 显示节点名称或用户ID

**交互功能**:
- 鼠标悬停: 显示详细流量数据
- 节点模式: 显示节点名称和流量
- 用户模式: 显示用户订阅详情(ID、套餐、到期时间等)

**空数据处理**:
- 无数据时显示空状态提示

::: tip 流量计算
流量 = 上传流量 + 下载流量,自动换算为 KB/MB/GB/TB 单位。
:::

## 赞助商展示

页面底部显示支持 PPanel 项目的赞助商:

**显示内容**:
- 赞助商 Logo
- 赞助商名称
- 简要描述

**数据来源**:
- 从 GitHub 仓库获取最新赞助商列表
- CDN 加速访问
- 自动过滤已过期的赞助

**交互**:
- 点击卡片跳转到赞助商网站
- 新窗口打开,不影响当前页面

::: tip 支持 PPanel
赞助帮助 PPanel 持续发布更新! 点击赞助商卡片可访问他们的服务。
:::

## 数据刷新

- **自动刷新**: 页面数据根据查询配置自动更新
- **手动刷新**: 刷新浏览器页面可立即更新所有数据
- **实时性**: 关键指标实时获取最新数据

## 使用建议

1. **每日查看**: 建议每天查看 Dashboard 了解运营状况
2. **关注指标**: 重点关注在线用户、待回复工单等实时指标
3. **趋势分析**: 定期查看图表趋势,分析业务变化
4. **异常处理**: 发现数据异常及时点击卡片跳转处理
5. **版本更新**: 有新版本提示时及时更新系统

## 常见问题

### 数据不准确怎么办?

1. 刷新浏览器页面重新获取数据
2. 检查服务器时间是否正确
3. 查看系统日志是否有错误

### 图表显示为空?

可能原因:
- 时间段内确实没有数据
- 数据统计服务异常
- 刷新页面重试

### 赞助商不显示?

可能原因:
- 网络连接问题,无法访问 CDN
- 当前没有有效期内的赞助商
- 浏览器拦截了外部资源

## 下一步

- [用户管理](/zh/admin/users-support/users) - 查看用户详情和流量使用
- [工单管理](/zh/admin/users-support/tickets) - 处理待回复工单
- [服务器管理](/zh/admin/maintenance/servers) - 管理服务器节点
- [订单管理](/zh/admin/commerce/orders) - 查看收入和订单详情
