VerEasy.Core
介绍
这是一个基于 .NET Core 的易开发的框架,附 vue3前端框架。提供了一个高效可扩展的API程序。
支持 JWT 认证、数据库操作、日志记录、异步处理等特性,能够满足大多数业务需求。
该项目可以与前端应用、移动应用和其他服务进行无缝集成,为开发者提供灵活、高效的解决方案。
功能与进度
框架模块
- ⭐框架整体采用
仓储+服务+接口
; - ⭐接口主要采用异步形式
async/await
- ⭐采用国产开源ORM框架
SqlSugar
- ⭐支持多库使用,可支持多种数据库(sqlsugar官网)
- ⭐项目内置数据种子文件,项目启动初始化基础表和数据
- ⭐Serilog日志记录功能
LogAop
全局自动记录,支持输出到 本地文件,数据库,控制台 - ⭐支持代码生成
1.实体生成表
2.表生成实体
3.表生成业务文件(仓储、服务、控制器)
4.由数据库生成种子数据
...... - ⭐使用 SwaggerAPI 文档
- ⭐使用 Automapper 做实体间映射
- ⭐使用 AutoFac 做依赖注入容器,并支持批量注入(如多个AOP)
- ⭐支持 Cors 跨域处理
- ⭐支持 JWT 授权鉴权处理
- ⭐封装
GlobalException
全局异常过滤器 - ⭐封装
Quartz
支持定时任务处理 - ⭐整体采用
SnowflakeId
雪花ID - ⭐实现了用户角色菜单权限分配
框架结构
整个框架追求的是易于扩展和使用,附有Vue3的前端项目,但整体不会牵连太深,方便和已有的前端项目进行集成。
若是要删除其中代码,也需要调整对应的引用等,无法避免。
txt
├── VerEasy.Common/ 公共方法类(用于全局的通用方法)
│ ├── FastCode/ 代码生成相关文件夹
│ ├── Helper/ 辅助方法文件夹
│ ├── LogHelper/ 用于输出控制台日志的拓展方法
│ ├── Utils/ 工具类(类似配置文件读取,雪花Id生成等)
├── VerEasy.Core.Api/ 接口层
│ ├── Controllers/ 控制器文件夹
│ ├── Filter/ 过滤器文件夹
│ ├── wwwroot/ 静态文件夹
├── VerEasy.Core.IRepository/ 仓储接口层
│ ├── Base/ 基础增删改接口
│ ├── IRepository/ 基础方法满足不了,可扩展的仓储接口层
│ │ ├── IDepartmentRepository.cs
├── VerEasy.Core.IService/ 服务接口层(同上)
│ ├── Base/
│ │ ├── IBaseService.cs
│ ├── IService/
│ │ ├── IDepartmentService.cs
├── VerEasy.Core.Models/ Model层
│ ├── Base/ 统一的字段基础类(如Id,修改人,修改时间等)
│ │ ├── BaseModel.cs
│ ├── Dtos/ Dto层,用于封装返回统一的返回格式等
│ ├── Enums/ 枚举类文件夹(业务需要定义枚举,或者全局都会使用到的枚举)
│ ├── ViewModels/ 实体文件夹(表结构对应的实体文件夹)
├── VerEasy.Core.Repository/ 仓储实现层(继承仓储接口层,并实现定义的接口,结构同上)
│ ├── Base/
│ ├── Repository/
├── VerEasy.Core.Service/ 服务实现层(继承服务接口层,并实现定义的接口,结构同上)
│ ├── Base/
│ ├── Service/
├── VerEasy.Core.Tasks/ Task定时任务类(封装了Quartz)
│ ├── Quartz.Net/ Quartz相关文件夹(闲了扩展其他的)
│ │ ├── IScheduleCenter.cs 调度器接口(启用调度器相关,例如执行job停止job)
│ │ ├── JobFactory.cs Job工厂,继承官方的IJobFactory
│ │ ├── JobListener Quartz监听器,监听定时任务的执行情况
│ │ ├── ScheduleCenter 调度器接口的实现
│ │ ├── Jobs/ 具体的定时任务文件夹
├── VerEasy.Extensions/ 扩展类库(主要注入其他的服务)
│ ├── Aop/ AOP文件夹
│ ├── Authorization/ 身份认证相关(Jwt)
│ ├── HostedService/ 管理需要项目启动就执行的服务(如持久化Quartz)
│ ├── ServiceExtensions/ 服务扩展文件夹(各种服务的注入配置)
│ │ ├── HttpContext/ 防止开发不更新修改人修改时间等信息引入的自动获取登录信息
│ │ ├── Module/ 其他服务(如:mapper的映射关系配置)
│ │ │ ├── MappingProfileModule.cs
│ ├── ServiceMiddlewares/ 中间件管道文件夹
├── VerEasy.Serilog/ 日志类库
│ ├── LoggerConfigurationExtensions.cs 日志的输出配置(输出到数据库或本地等,整体规范化一些)
🚀 持续开发中
本项目仍在积极开发和维护中,未来会持续添加新功能和优化现有模块。
欢迎关注项目,了解最新动态!你的支持是我们前进的动力!✨
如果你喜欢这个项目
如果你喜欢这个项目,请不要忘记为它点亮 ⭐Star!
你的支持是我们持续改进的最大动力!🎉
参与贡献
如果你对这个项目有建议或改进的想法,欢迎提交 Issue 或 [Pull Request](#Pull Request)!😊
我们非常期待你的加入,共同让这个项目更加强大!