- 1、项目前端采用
react
开发的,预览地址。前端项目地址github
地址- 码云地址
- 如果你不会
react
,你可以参考前端vue基础项目模板来完成
- 2、采用
angular
模块化开发方式来构建项目,如果你想用java
的mvc
方式来开发nestjs
项目你可以查看v1
分支。 - 3、项目是基于
mysql
数据库,项目中全部采用typeorm
来操作数据库,弱化了原生sql
,避免前端的小伙伴没有sql
基础。 - 4、实现用户名、手机号码、邮箱任一的方式实现登录。
- 5、使用自定义
token
的方式进行登录鉴权,采用自定义装饰器结合守卫来实现对接口鉴权拦截访问。 - 6、实现单点登录功能,同一时间只能一个地方登录
- 7、如果你要演示菜单权限和接口权限,请自己创建账号、角色、分配菜单和接口权限。
- 8、使用
winston
做日志管理,并且根据小时来拆分日志 - 9、自定义装饰器实现对接口权限收集,如果这个接口要给角色分配权限的时候就直接加上装饰器,会自动在数据库生成数据
-
1、本项目仅仅是实现了
rbac
的权限系统,对于其他的功能需要自己基于这个基础上去扩展 -
2、先在本地创建数据库
-
3、在项目的根目录的
.env
文件修改为你自己的数据库基本配置(地址、用户名、密码、数据库)DB_HOST=localhost DB_USERNAME=root DB_PASSWORD=123456 DB_DATABASE=nestjs-mysql
-
4、安装依赖包
-
5、启动项目
npm run start:dev
-
5、运行项目会自动初始化菜单数据和用户数据(账号:
admin
,密码:123456) -
6、如果你想初始化别的数据,可以在
src/services/init-db
中写上你要初始化的数据
-
实现用户的登录、登录鉴权、单点登录、菜单权限、接口权限
-
基于
RBAC
实现权限控制 -
集成
swagger
文档 -
ecosystem.config.js
是采用PM2
的配置文件,项目开发完后直接运行命令一键部署npm run build # 开发环境 npm run pm2:dev # 生产环境 npm run pm2:prod
-
winston
日志系统根据小时来划分日志管理,如果要实时查看日志,直接使用PM2
查看日志pm2 log
-
自定义装饰器,被装饰器装饰的接口会自动进行入库操作
本项目还在持续集成新功能进来,最后会加上前端做一个
cms
系统的api
,后期会拉分支使用graphql
提供api