✨ NestAdmin 是一个企业级后台管理系统，基于 NestJS、Prisma、MySQL 和 RESTful API 架构设计，适用于中后台权限管理、用户系统与通用业务开发。
- 🎯 TypeScript - 严格的类型检查，提供完整的类型定义
- 🏗️ 模块化架构 - 基于 NestJS 模块化设计，支持按需加载
- 🔐 RBAC 权限 - 基于角色的访问控制，灵活的权限管理
- 📝 Swagger - 自动生成 OpenAPI 规范的接口文档
- 🎨 代码规范 - 遵循 TypeScript 最佳实践，统一的代码风格
- 🔄 数据迁移 - 基于 Prisma 的数据库版本控制和迁移
- 🛡️ 安全防护 - JWT 认证，请求加密，CORS 配置等
- 🔑 灵活登录 - 支持用户名或邮箱登录
- 🏢 组织架构 - 完整的部门和岗位管理体系
- NestJS - 渐进式 Node.js 框架，支持完整的依赖注入
- Prisma - 下一代 ORM，类型安全且高性能
- MySQL - 企业级关系型数据库
- TypeScript - JavaScript 的超集，提供类型系统
- JWT - JSON Web Token 认证机制
- Swagger - API 文档生成与测试工具
- ESLint - 代码质量检查
- Prettier - 代码格式化
- Jest - 单元测试框架
- Docker - 容器化部署支持
- 完整的注册登录流程
- JWT 令牌认证机制
- 支持用户名或邮箱登录
- 权限验证守卫
- 角色权限管理
- 刷新令牌机制（Access Token + Refresh Token）
- 登录日志记录与分析
- 单点登录（SSO）集成
- OAuth2 第三方登录（GitHub、Google）
- 双因素认证（2FA）
- 登录失败限制与封禁
- 用户基础管理（CRUD）
- 灵活的角色分配
- 部门岗位关联
- 批量用户操作
- 用户数据导入导出（Excel、CSV）
- 用户状态管理（在线、离线、禁用）
- 头像上传管理（本地/云存储）
- 用户操作日志
- 用户登录设备管理
- 角色基础管理（CRUD）
- 角色权限管理
- RBAC 权限控制
- 权限代码管理
- 权限分配机制
- 25个基础权限预设
- 批量角色操作
- 数据权限控制（行级、列级）
- 菜单权限管理
- 权限缓存优化（Redis）
- 权限树形结构
- 动态权限加载
- 临时权限分配
- 权限继承机制
- 部门管理（CRUD）
- 岗位管理（CRUD）
- 部门岗位关联
- 组织架构树形展示
- 多级部门支持
- 部门权限继承
- 岗位权限模板
- 系统参数配置（环境变量）
- 数据字典维护（权限、角色、部门、岗位）
- 菜单动态管理
- 系统通知公告
- 综合日志管理
- 操作行为日志（审计日志）
- 登录记录日志
- 系统运行日志
- 系统备份还原
- 敏感数据加密
- Swagger 接口文档（OpenAPI 3.0）
- 详细的API描述和示例
- Bearer Token 认证支持
- 接口版本管理
- 接口访问控制（限流、黑白名单）
- 接口性能监控
- 接口调试工具
- Mock 数据支持
- 在线用户监控（实时统计）
- 服务器状态监控（CPU、内存、磁盘）
- 数据库性能监控
- 缓存系统监控
- 定时任务管理（任务调度）
- 服务健康检查
- 性能分析工具
- 告警通知机制
- 数据库迁移工具（Prisma Migrate）
- 数据填充脚本（Seed）
- 完整的种子数据（管理员、角色、权限、部门、岗位）
- 代码自动生成（CRUD）
- 表单在线构建
- 开发技术文档
- 单元测试覆盖
- API 自动化测试
- 持续集成/持续部署（CI/CD）
- Node.js >= 16
- MySQL >= 8.0
- pnpm >= 8.0
# 克隆项目
git clone https://github.com/gvray/nest-admin.git
# 进入项目目录
cd nest-admin
# 安装依赖
pnpm install
# 配置环境变量
cp .env.example .env
# 执行数据库迁移
pnpm prisma migrate dev
# 初始化基础数据
pnpm prisma db seed
# 启动开发服务
pnpm start:dev# 构建项目
pnpm build
# 启动服务
pnpm start:prod- 管理员账号：[email protected] 或 admin
- 初始密码：admin123
# 用户名登录
curl -X POST http://localhost:8001/auth/login \
-H "Content-Type: application/json" \
-d '{"account": "admin", "password": "admin123"}'
# 邮箱登录
curl -X POST http://localhost:8001/auth/login \
-H "Content-Type: application/json" \
-d '{"account": "[email protected]", "password": "admin123"}'# 使用登录返回的 token
curl -X GET http://localhost:8001/users \
-H "Authorization: Bearer YOUR_TOKEN_HERE"src
├── config # 配置文件目录
│ ├── app.config.ts # 应用配置
│ ├── auth.config.ts # 认证配置
│ └── database.config.ts# 数据库配置
├── core # 核心功能模块
│ ├── decorators # 自定义装饰器
│ │ ├── permissions.decorator.ts # 权限装饰器
│ │ └── roles.decorator.ts # 角色装饰器
│ ├── guards # 权限守卫
│ │ ├── jwt-auth.guard.ts # JWT认证守卫
│ │ ├── permissions.guard.ts # 权限守卫
│ │ └── roles.guard.ts # 角色守卫
│ ├── interceptors # 拦截器
│ ├── filters # 异常过滤器
│ └── strategies # 认证策略
│ └── jwt.strategy.ts # JWT策略
├── modules # 业务功能模块
│ ├── auth # 认证授权模块
│ │ ├── auth.controller.ts # 认证控制器
│ │ ├── auth.service.ts # 认证服务
│ │ └── dto # 数据传输对象
│ │ ├── login.dto.ts # 登录DTO
│ │ └── register.dto.ts # 注册DTO
│ ├── users # 用户管理模块
│ │ ├── users.controller.ts # 用户控制器
│ │ ├── users.service.ts # 用户服务
│ │ └── dto # 数据传输对象
│ ├── roles # 角色管理模块
│ │ ├── roles.controller.ts # 角色控制器
│ │ ├── roles.service.ts # 角色服务
│ │ └── dto # 数据传输对象
│ ├── permissions # 权限管理模块
│ │ ├── permissions.controller.ts # 权限控制器
│ │ ├── permissions.service.ts # 权限服务
│ │ └── dto # 数据传输对象
│ ├── departments # 部门管理模块
│ │ ├── departments.controller.ts # 部门控制器
│ │ └── departments.service.ts # 部门服务
│ ├── positions # 岗位管理模块
│ │ ├── positions.controller.ts # 岗位控制器
│ │ └── positions.service.ts # 岗位服务
│ └── auth # 认证授权模块
│ └── dto # 数据传输对象
├── shared # 共享模块
│ ├── constants # 常量定义
│ ├── dto # 数据传输对象
│ └── utils # 工具函数
└── prisma # Prisma 配置
├── migrations # 数据库迁移
├── seeds # 数据填充
│ └── permissions.ts # 权限种子数据
└── seed.ts # 主种子脚本
本项目采用 MIT 许可证 开源。
欢迎提交 Issue 或 Pull Request 贡献代码。详情请参阅 贡献指南。
- ✅ 支持用户名或邮箱登录
- ✅ 完善权限管理系统（25个基础权限）
- ✅ 优化数据库种子脚本
- ✅ 完善Swagger API文档
- ✅ 修复403权限问题
- ✅ 添加部门和岗位管理
- ✅ 完善项目结构和代码规范