Skip to content

仪表盘模块 ​

仪表盘模块(dashboard)提供管理后台的统计数据概览,包括租户、用户、角色计数及 30 天增长率、今日活跃用户数。

架构特点 ​

该模块采用轻量级设计,仅有 interfaces 层,直接通过 *gorm.DB 查询数据库,不经过 domain/application/infrastructure 分层。

modules/dashboard/
└── interfaces/      # Handler(直接查询 DB)、路由注册

统计数据 ​

StatsResponse ​

字段类型说明
TenantCountint64租户总数
UserCountint64用户总数
RoleCountint64角色总数
OnlineCountint64在线人数
TenantGrowthfloat64租户 30 天增长率(%)
UserGrowthfloat64用户 30 天增长率(%)
RoleGrowthfloat64角色 30 天增长率(%)
TodayActiveUsersint64今日活跃用户数

API 接口 ​

方法路径权限说明
GET/api/v1/dashboard/statsdashboard.read获取统计数据

响应示例 ​

json
// GET /api/v1/dashboard/stats
// Response 200
{
  "tenantCount": 0,
  "userCount": 156,
  "roleCount": 12,
  "onlineCount": 0,
  "tenantGrowth": 0,
  "userGrowth": 15.5,
  "roleGrowth": 0,
  "todayActiveUsers": 23
}

查询逻辑 ​

  • UserCount: SELECT COUNT(*) FROM users WHERE tenant_id = ?
  • RoleCount: SELECT COUNT(*) FROM roles WHERE tenant_id = ?
  • UserGrowth / RoleGrowth: 对比当前数量与 30 天前的数量,计算增长率百分比
  • TodayActiveUsers: SELECT COUNT(*) FROM users WHERE tenant_id = ? AND last_login >= 今日零点
  • TenantCount / OnlineCount / TenantGrowth: 当前硬编码为 0(预留扩展)

增长率计算 ​

go
func calcGrowth(current, previous int64) float64
  • previous == 0 && current > 0 → 返回 100.0
  • previous == 0 && current == 0 → 返回 0
  • 其他 → (current - previous) / previous * 100

依赖注入 ​

go
fx.Module("dashboard",
    fx.Provide(
        func(db *gorm.DB) *Handler {
            return NewHandler(db)
        },
    ),
)

直接注入 *gorm.DB,无中间层。

Released under the Apache 2.0 License.