Dashboard 仪表盘 模块 API 文档

基础信息

• Base URL: /api/admin
• 认证方式: JWT Bearer Token（需 admin / developer 角色）

数据库表

• users — 用户表
• bills — 账单表
• transactions — 交易表
• payments — 支付订单表
• audit_logs — 审计日志表

接口列表

1. 获取仪表盘统计数据

GET /api/admin/dashboard/stats

说明: 获取用户、账单、交易、支付等核心计数

响应:

{
  "users": 123,
  "registeredUsers": 118,
  "bills": 45,
  "transactions": 890,
  "payments": 67
}

2. 获取收支统计

GET /api/admin/dashboard/tx-stats

说明: 获取总收入和总支出

响应:

{
  "income": 50000.00,
  "expense": 32000.00
}

3. 获取最近活动

GET /api/admin/dashboard/recent-activity

说明: 获取最近10条审计日志

响应:

[{
  "action": "string",
  "time": "2024-01-01 12:00:00",
  "user_id": "string"
}]

4. 获取月度统计

GET /api/admin/dashboard/monthly-stats

说明: 获取最近12个月每月收支数据

响应:

[{
  "month": "2024-01",
  "income": 5000.00,
  "expense": 3200.00
}]

5. 获取分类统计

GET /api/admin/dashboard/category-stats

说明: 获取交易量前10的分类

响应:

[{
  "category": "餐饮",
  "count": 120
}]

6. 获取数据库大小

GET /api/admin/dashboard/db-size

说明: 获取 SQLite 数据库文件大小

响应:

{"dbSize": "2.45 MB"}

{ dbSize: "X.XX MB" }