Admin API 总览
Admin 后端提供管理后台所需的全部 API,基于 Express + SQLite,共 14 个路由模块。
基本信息
- Base URL:
/api/admin - 认证方式: JWT Bearer Token(需 admin 或 developer 角色)
- 数据库:
finance.db(SQLite)
模块列表
| # | 模块 | 说明 | 主要接口 |
|---|---|---|---|
| 01 | 📊 dashboard | 仪表盘统计 | stats, tx-stats, monthly-stats, db-size |
| 02 | 👥 users | 用户管理 | 列表, 改角色, 改状态, 重置密码, 清除游客 |
| 03 | 💰 bills | 账单管理 | 列表, 详情, 更新成员Prompt |
| 04 | 📊 transactions | 交易流水 | 分页列表 |
| 05 | 💳 payments | 支付订单 | 列表+统计 |
| 06 | 📁 categories | 分类管理 | CRUD |
| 07 | 📈 budgets | 预算管理 | 列表(含实时 spent 计算) |
| 08 | 🔑 apis | API Keys 管理 | 列表, 创建, 撤销 |
| 09 | 🤖 ailogs | AI 调用日志 | stats, daily-stats, 分页列表 |
| 10 | 📝 auditlogs | 审计日志 | 分页列表(多条件筛选) |
| 11 | 🔔 notifications | 通知管理 | 列表, 标记已读, 删除, 清空 |
| 12 | ⚙️ systemconfig | 系统配置 | 获取全部, 更新单项, 邮件配置, SMTP连通测试, 测试邮件发送 |
| 13 | 👤 profile | 个人中心 | 修改资料, 修改密码(复用 auth 接口) |
| 14 | 🤖 assistant | AI 助手 | POST /ai/chat |
| 15 | 🔧 maintenance | 数据维护 | GET /dirty-data, POST /fix-dirty-data |
| 16 | 📋 sub-history | 订阅历史 | GET /subscription-history |
| 17 | 📊 public-ai-logs | 公开AI日志 | GET /api-logs/public |
| 18 | 📊 budget-alerts | 预算预警 | GET /budget-alerts, PUT /budget-alerts/:id |
| 19 | 🔄 recurring | 定期账单 | GET /recurring, POST/PUT/DELETE |