NetCore开源项目,适合新手学习

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的前端项目,但整体不会牵连太深,方便和已有的前端项目进行集成。

若是要删除其中代码,也需要调整对应的引用等,无法避免。

├── 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！

我们非常期待你的加入，共同让这个项目更加强大！