NetCore3.1及Vue开发通用RBAC前后端通用框架

  • A+
所属分类:.NET技术
摘要

该框架是本人学习过程中本着只有自己动手操作一遍才能真正理解,和遇到对应问题并解决问题的思路。和为了能在开发相应系统时能快速搭建出相关框架而做出的基于NetCore3.1+Vue的RBAC通用权限框架。


框架说明

该框架是本人学习过程中本着只有自己动手操作一遍才能真正理解,和遇到对应问题并解决问题的思路。和为了能在开发相应系统时能快速搭建出相关框架而做出的基于NetCore3.1+Vue的RBAC通用权限框架。

只有在敲的过程中才能遇见细节上的问题,成长无非就是发现问题、思考问题、解决问题、总结沉淀,后面才能去规避和提高代码质量。

如有发现什么错误,请联系我,将第一时间改正。互相学习,共同进步。

不要只光看,最终要的是要自己敲,不自己敲的话,当遇到了还是不会、一脸懵的!

前端测试地址 lion.levy.net.cn , 可以自己注册,也可使用已有账号密码登录。请不要用已有账号修改或删除系统已有数据,谢谢配合
前端代码地址 Gitee GitHub
后端接口地址 lion.levy.net.cn
后端代码地址 Gitee GitHub

** 如果您觉得对您有帮助的话,可以给个start,谢谢 **

项目框架图

NetCore3.1及Vue开发通用RBAC前后端通用框架

EntityFrameworkCore CodeFirist开发 支持 MySql/SqlServer
数据迁移时自动生成种子数据,Quartz 表结构还请自行通过docs文件中对应数据库类型文件,执行添加表语句
异步 async/await 开发
采用类似仓储模式开发,封装底层常用数据库方法
Nlog日志记录,可记录请求日志/异常日志等,调试阶段打印SQL语句
支持AOP切面编程,如日志、缓存、事务处理等
权限管理系统支持多租户多权限管理,页面动态管理页面&按钮权限
采用自定义JWT身份认证,可自带参数,验证过期时间,滑动无感重新颁发Token
支持Redis 和 Memory 两种缓存
使用三方DI AutoFac,实行批量注册,支持属性注入
采用Automapper做对象映射,并支持扩展方法直接映射。
使用 Quartz.net做任务调度,支持集群调度(未测试该情况,代码中有注释说明),支持反射调用本地程序集方式,支持调用API方式
使用Swagger提供API文档,并实现接口文档中填写授权信息方便调试。
支持CORS跨域,当前使用的是全跨域模式。
支持监控心跳检查HealthChecks,可实现对其它网页或服务的检查和通知。(代码没写,如需要,可联系我获取。通知支持钉钉和企业微信等)
支持RabbitMq消息队列,实现了死信队列和延迟队列。
支持docker部署,支持docker中部署同一网段
可配合Jenkins加 Sonar 做CI/CD & 代码质量检查
Nginx可配置实现负载均衡
可配置 IpRateLimiting 做API限流处理(此前配置试过,没有起到效果,可能哪个地方冲突了),若需要,也可根据redis实现一个简易版的

多租户权限设计表

详细说明
Deleted、CreatedTime、CreatedBy、UpdatedTime、UpdatedBy 为常用表默认字段,可自行扩展增加Remark、Status、Sort等为表通用字段。特别说明,若数据量很大的表,可将非关键字段拆分出来,减小表大小,提高查询速度。

  • 数据都是按页存在,页存储空间有限,将非关键信息存另外的一个表,关键信息表所存数据页就少,查询速度就相应的提高了。 个人理解

Sys_Tenant租户表

  • 租户相当于是将系统租给某个公司使用,租户表管理公司企业信息,这里表结构只是给了一个示例。
  • 若有什么想要控制,就设计成相应的表,若数据资源固定则设计为字典表。
字段名 说明 类型 主键
TenantId 主键 bigint TRUE
TenantName 租户名称 nvarchar(50)
Remark 备注 nvarchar(32)
State 状态:1-启用;-1-禁用 int
CreatedTime 创建时间 datetime

sys_user用户表

字段名 说明 类型 主键
UserId 主键 bigint TRUE
TenantId 租户ID bigint
NickName 用户名 nvarchar(30)
PassWord 密码 nvarchar(512)
Email Email nvarchar(128)
Sex 性别:0-女;1-男 int
State 状态:1-启用;-1-禁用 int
CreatedTime 创建时间 datetime
CreatedBy 创建人 bigint
UpdatedTime 修改时间 datetime
UpdatedBy 修改人 bigint

Sys_Role角色表

字段名 说明 类型 主键
RoleId 主键 bigint TRUE
TenantId 租户ID bigint
RoleName 角色名称 nvarchar(25)
RoleDesc 角色描述 nvarchar(128)
Deleted 逻辑删除标志 tinyint
CreatedTime 创建时间 datetime
CreatedBy 创建人 bigint
UpdatedTime 修改时间 datetime
UpdatedBy 修改人 bigint

Sys_User_Role_Relation用户角色关系表

字段名 说明 类型 主键
UserId 用户ID bigint TRUE
RoleId 角色Id bigint TRUE
TenantId 租户ID bigint TRUE
State 状态:1-启用;-1-禁用 int
Deleted 逻辑删除标志 tinyint
CreatedTime 创建时间 datetime
CreatedBy 创建人 bigint
UpdatedTime 修改时间 datetime
UpdatedBy 修改人 bigint

Sys_Menu权限资源表

字段名 说明 类型 主键
MenuId 主键,自定义 nvarchar(40) TRUE
MenuName 资源名称 nvarchar(64)
ParentMenuId 父级Id--无限级菜单(长度加大) nvarchar(40)
Level 菜单层级 int
Url 资源地址 nvarchar(256)
Type 资源类型:1:菜单 2:按钮 int
Icon 图标 nvarchar(128)
OrderIndex 顺序 int
Deleted 逻辑删除标志 tinyint
CreatedTime 创建时间 datetime
CreatedBy 创建人 bigint
UpdatedTime 修改时间 datetime
UpdatedBy 修改人 bigint

Sys_Role_Menu_Relation角色资源关系表

字段名 说明 类型 主键
MenuId 资源ID nvarchar(40) TRUE
RoleId 角色Id bigint TRUE
TenantId 租户ID bigint TRUE
State 状态:1-启用;-1-禁用 int
Deleted 逻辑删除标志 tinyint
CreatedTime 创建时间 datetime
CreatedBy 创建人 bigint
UpdatedTime 修改时间 datetime
UpdatedBy 修改人 bigint
  • 调度相关-额外创建的管理表

Sys_Quartz调度任务综合表

字段名 说明 类型 主键
JobGroup 任务分组 nvarchar(200) TRUE
JobName 任务名称 nvarchar(200) TRUE
JobType 任务类型:0-无,1-api,2-程序集 int
BeginTime 开始时间 datetime
EndTime 结束时间 datetime
Cron Cron表达式 nvarchar(40)
RunTimes 执行次数 int
IntervalSecond 循环次数 int
TriggerType 任务类型:0-无,1-cron,2-简单类型 int
RequestPath API地址或请求类程序集名称 nvarchar(56)
RequestMethod API请求类型或请求类地址 nvarchar(40)
RequestParameters 请求Body参数 nvarchar(512)
Headers 请求头参数 nvarchar(256)
Priority 执行优先级,等级越高,相同时间先执行 int
Description 任务描述 nvarchar(256)
NotifyEmail 通知邮箱 nvarchar(128)
MailMessage 邮件通知类型:0-不通知,1-错误通知,2-全量通知 int
TriggerState 暂停 错误 阻塞 完成 等 int
PreviousFireTime 上次执行时间 datetime
NextFireTime 下次执行时间 datetime
CreatedTime 创建时间 datetime

效果图

当用户注册使用,便是一个租户,租户也就代表是一个公司群体,可以以该账号创建子账号,给子账号分配页面及按钮权限。

接口文档

NetCore3.1及Vue开发通用RBAC前后端通用框架

用户界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

角色管理界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

系统管理菜单界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

调度任务界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

调度-接口及cron界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

调度-程序集反射方式创建界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

调度日志界面

NetCore3.1及Vue开发通用RBAC前后端通用框架

后端拉取运行

  • 需配置appsettings.json中的相关信息 配置邮箱发送人信息,本项目配置的是QQ邮箱,请根据需要配置,用以注册和找回密码的短信发送

  • 需配置appsettings.json中的相关信息 配置数据库链接信息,执行数据库迁移命令(查看第7点),执行完成后,根据doc文件中选择Quartz对应数据库脚本语言创建相关表。

  • 配置NLog.config文件数据库相关信息,用于记录日志,根据使用数据库选择相应链接,并配置数据库链接

  • 需配置appsettings.json中的相关信息 Redis链接信息

  • 需配置appsettings.json中的相关信息 RabbitMQ链接信息

  • 需配置appsettings.json中的相关信息 Redis链接信息

  • LionFrame.Data项目中有个种子数据文件夹,在数据迁移时会添加相关信息

前端项目请参考 前端系列

在博客中之前已经写过前端系列,可参考下,有不清楚的地方可在个人简介中找到我的联系方式。若有什么错误的地方也欢迎指正~

发布到docker中

可参考项目中的docs文件夹下的 同一网络部署到Docker中 文件。因为我这边redis和mysql已经在之前就已经创建过了,所以此次只做了 MQ和项目发布到同一网段中,其它的可如法炮制。喜欢玩的也可以使用docker-compose来进行编写第一次的发布脚本,因为多环境的问题,建议使用docker-compose,可快速的进行部署,也可避免命令敲错等情况。

只有初次发布时配置可能比较麻烦,后面基本就只有项目需要多次发布,可引入jenkins 做 CI/CD,基本支持中小企业使用

若项目做的比较大可升级K8S,做弹性伸缩,nginx做负载均衡等等、

前端项目这里由于是腾讯云的学生服务器,比较卡顿,故申请了一个腾讯云的免费6个月的存储桶COS进行发布前端项目。

netcore3.1 发布到docker中所遇到的坑及解决

由于docker中没有图片的依赖组件,在我们生成二维码的时候的时候需要使用到System.Drawing.Common 来使用 Image、Bitmap 等类型,通过docker logs 可查看到如下异常

System.TypeInitializationException: The type initializer for 'Gdip' threw an exception. ---> System.DllNotFoundException: Unable to load DLL 'libgdiplus': The specified module could not be found. 

解决方法,在dockerfile中加上如下语句RUN apt-get update && apt-get install -y libgdiplus

由于国内网络原因,此处可能需要下载数十分钟,为了提高数据,可在dockerfile中加上RUN cp sources.list /etc/apt/一句话,使用镜像源,来提高下载速度,sources.list文件在docs文件夹中有提供。

这样就能解决图片的问题

ps:小插曲,其实最开始我在这样处理后还是不能生成图片、日志中也看不到错误,只知道容器在调用二维码生成接口时就会退出,起先还以为是dockerfile引入有问题,
在各大网站查找相关讯息,博客园/csdn/stackoverflow/github等网站上查找。
在这个网址上 https://github.com/dotnet/dotnet-docker/issues/618 看到人家都是这样解决的,为啥我就不行
不禁陷入了沉思,突然想到可能是代码的问题,换了生成验证码的方式, 惊奇的发现可以了。有的时候得换一种思考的方式。

原文地址