框架说明
该框架是本人学习过程中本着只有自己动手操作一遍才能真正理解,和遇到对应问题并解决问题的思路。和为了能在开发相应系统时能快速搭建出相关框架而做出的基于NetCore3.1+Vue的RBAC通用权限框架。
只有在敲的过程中才能遇见细节上的问题,成长无非就是发现问题、思考问题、解决问题、总结沉淀,后面才能去规避和提高代码质量。
如有发现什么错误,请联系我,将第一时间改正。互相学习,共同进步。
不要只光看,最终要的是要自己敲,不自己敲的话,当遇到了还是不会、一脸懵的!
前端测试地址 lion.levy.net.cn , 可以自己注册,也可使用已有账号密码登录。请不要用已有账号修改或删除系统已有数据,谢谢配合
前端代码地址 Gitee GitHub
后端接口地址 lion.levy.net.cn
后端代码地址 Gitee GitHub
** 如果您觉得对您有帮助的话,可以给个start,谢谢 **
项目框架图
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) | |
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 |
效果图
当用户注册使用,便是一个租户,租户也就代表是一个公司群体,可以以该账号创建子账号,给子账号分配页面及按钮权限。
接口文档
用户界面
角色管理界面
系统管理菜单界面
调度任务界面
调度-接口及cron界面
调度-程序集反射方式创建界面
调度日志界面
后端拉取运行
-
需配置
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 看到人家都是这样解决的,为啥我就不行
不禁陷入了沉思,突然想到可能是代码的问题,换了生成验证码的方式, 惊奇的发现可以了。有的时候得换一种思考的方式。