功能模块
当前项目已经具备一套完整的后台管理基础模块。
基础模块列表
| 模块 | 说明 |
|---|---|
| 用户管理 | 用户 CRUD、状态管理、角色分配 |
| 菜单管理 | 树形菜单、目录/菜单/按钮三种类型 |
| 角色管理 | 角色 CRUD、菜单权限分配 |
| 部门管理 | 树形组织层级维护 |
| 岗位管理 | 岗位信息维护、关联使用、批量删除 |
| 数据字典 | 字典主表与字典项管理 |
| 系统配置 | 系统运行相关配置项维护 |
| 文件管理 | 文件上传、列表查看、本地/OSS 双存储 |
| 存储配置 | 管理本地存储或阿里云 OSS 配置 |
| 会话管理 | 登录会话与会话状态控制 |
| 登录日志 | 登录行为记录与审计 |
| 操作日志 | 后台操作轨迹记录 |
| 通知公告 | 富文本通知编辑与发布、已读状态管理、批量删除、WebSocket 实时推送 |
| 定时任务 | 定时任务与监控相关能力 |
| 系统监控 | 运行状态信息查看 |
| Swagger UI | 内置 Swagger UI 与 OpenAPI JSON Spec，支持在线调试与导入 Postman / Apifox |
模块特性
权限体系
- JWT 鉴权（Access Token + Refresh Token 自动续期）
- 路由访问控制
- 角色与菜单权限关联
- 动态菜单路由：根据用户角色自动注册可访问页面
实时通信
- WebSocket 支持实时通知推送与会话下线消息
- 健康检查：
/api/health接口，用于服务探活
数据规范
- 列表接口统一返回分页结构
- 参数使用
schema.safeParse()校验 - 统一响应格式
{ code, message, data }
文件存储
local：本地文件系统oss：阿里云 OSS
可通过 file_storage_configs 表中的 is_default 切换默认存储。