# Adnc **Repository Path**: oldyangsir/Adnc ## Basic Information - **Project Name**: Adnc - **Description**: .NET5微服务框架，同样适用于单体架构系统的开发。框架基于JWT认证授权、集成了一系列微服务配套组件、实现了读写分离、包含基础的后台管理模块。前端基于Vue，也是一个前后端分离的框架。 - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: https://aspdotnetcore.net - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 18 - **Created**: 2021-09-18 - **Last Updated**: 2021-12-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
GitHub license GitHub stars GitHub forks
#
![Adnc是一个微服务开发框架 代码改变世界 开源活跃社区](https://aspdotnetcore.net/wp-content/uploads/2020/12/adnc-homepage-logo-3.webp)
    Adnc是一个轻量级的.Net 5.0微服务开发框架，同时也适用于单体架构系统的开发。支持经典三层与DDD架构开发模式、集成了一系列主流稳定的微服务配套技术栈。一个前后端分离的框架，前端基于Vue、后端基于.Net 5.0构建。Webapi遵循RESTful设计规范、基于JWT认证授权、基于Maxscale实现了读写分离、部署灵活、代码简洁、开箱即用、容器化微服务的最佳实践。 - 用户中心：系统支撑服务，实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理 - 运维中心：系统支撑服务，实现了登录日志、审计日志、异常日志、字典管理、配置参数管理 - 客户中心：经典三层开发模式demo - 订单中心：DDD开发模式demo - 仓储中心：DDD开发模式demo ## 文档 #### 如何快速跑起来 - 详细介绍如何使用docker安装redis、mysql、rabbitmq、mongodb，以及如何在本地配置ClientApp、ServerApi。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/%E5%A6%82%E4%BD%95%E5%BF%AB%E9%80%9F%E8%B7%91%E8%B5%B7%E6%9D%A5) #### 如何手动部署到服务器 - 详细介绍如何使用docker安装配置consul集群、Skywalking系列组件、相关项目的dockerfile文件编写与配置以及如何将多个服务部署到服务器。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/Adnc%E5%A6%82%E4%BD%95%E6%89%8B%E5%8A%A8%E9%83%A8%E7%BD%B2(docker,consul,skywalking,nginx)) #### 如何实现读写分离 - 详细介绍为什么要通过中间件实现读写分离以及EFCore基于中间件如何写代码。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/%E5%A6%82%E4%BD%95%E5%AE%9E%E7%8E%B0%E8%AF%BB%E5%86%99%E5%88%86%E7%A6%BB) #### 如何使用Cache Redis 分布式锁 布隆过滤器 - 详细介绍如何使用Cache、Redis、分布式锁以及布隆过滤器。如何配置Cache防止雪崩、击穿、穿透以及缓存同步。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8Cache-Redis-%E5%88%86%E5%B8%83%E5%BC%8F%E9%94%81-%E5%B8%83%E9%9A%86%E8%BF%87%E6%BB%A4%E5%99%A8) #### 如何动态分配雪花算法的WorkerId - 详细介绍Yitter雪花算法的特点、配置以及如何动态获取WorkerId。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/%E5%A6%82%E4%BD%95%E5%8A%A8%E6%80%81%E5%88%86%E9%85%8D%E9%9B%AA%E8%8A%B1%E7%AE%97%E6%B3%95%E7%9A%84WorkerId) #### 如何使用EFCore仓储 - 详细介绍EFCore仓储基础功能、工作单元、CodeFirst，提供了丰富的演示代码以及演示代码对应的Sql语句。
[请点击链接，查看详细介绍](https://github.com/AlphaYu/Adnc/wiki/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E4%BB%93%E5%82%A8(%E4%B8%80)-%E5%9F%BA%E7%A1%80%E5%8A%9F%E8%83%BD) ## 总体结构设计 - 经典三层 ![.NET微服务开源框架-总体设计](https://aspdotnetcore.net/adnc-traditional/) - DDD三层 ![.NET微服务开源框架-总体设计](https://aspdotnetcore.net/adnc-ddd/) - 总体结构 ![.NET微服务开源框架-总体设计](https://aspdotnetcore.net/adnc-rpc-eventbus/) ## Jmeter测试 - ECS服务器配置：2核4G，带宽1M。服务器上装了很多东西，剩余大约40%的CPU资源，40%的内存资源。 - 由于带宽有限，吞吐率约200/s左右。 - 模拟并发线程1200/s - 读写比率7:3 > 6个测试用例覆盖了网关、服务发现、配置中心、服务间同步调用、数据库CURD、本地事务、分布式事务、缓存、布隆过滤器、SkyApm链路、Nlog日志记录、操作日志记录。 ![.NET微服务开源框架-Jmeter](https://aspdotnetcore.net/jmeter_result/) ## 演示 - http://adnc.aspdotnetcore.net ## 问题交流 - 780634162(QQ群) ## GitHub - https://github.com/alphayu/adnc - 开源不易，如果您喜欢这个项目, 请给个星星⭐️。 ## Roadmap - 开发微服务项目生成工具 - 集成Dapr - 集成Quartz.Net实现框架计划调度功能。 ## 目录结构 - src - clientApp 前端项目(`Vue`) - serverApi 后端项目(`.NET 5.0`) - doc 项目相关文档(sql脚本、docker脚本、docker-compose.yaml文件) - tools 工具软件 - test 测试工程 #### ClientApp - clientApp基于Vue-Element-Admin以及Web-Flash搭建，感谢两位作者。 - 前端主要技术栈 Vue + Vue-Router + Vuex + Axios - 构建步骤 ```bash # Install dependencies npm install --registry=https://registry.npm.taobao.org # Serve with hot reload at localhost:5001 npm run dev # Build for production with minification npm run build:prod ``` - 界面 ![.NET微服务开源框架-异常日志界面](https://aspdotnetcore.net/wp-content/uploads/2020/11/adnc-dashboard-nlog.webp) ![.NET微服务开源框架-角色管理界面](https://aspdotnetcore.net/wp-content/uploads/2020/11/adnc-dashboard-role.webp) #### ServerApi - ServerApi基于`.NET 5.0`搭建。 - 后端主要技术栈 | 名称 | 描述 | | ---- | -----| | Ocelot | 基于 `.NET 5.0` 编写的开源网关 | | Consul | 配置中心、注册中心组件| | Refit | 一个声明式自动类型安全的RESTful服务调用组件，用于同步调用其他微服务| | SkyAPM.Agent.AspNetCore | Skywalking `.NET 5.0`探针，性能链路监测组件 | | AspNetCore.HealthChecks | 健康监测组件,搭配consul的健康监测 | | Autofac | IOC容器组件 | | Autofac.Extras.DynamicProxy | Autfac AOP扩展 | | Pomelo.EntityFrameworkCore.MySql | EFCore ORM组件 | | Dapper | 轻量级ORM组件 | | Z.EntityFramework.Plus.EFCore | 第三方高性能的EfCore组件 | | NLog | 日志记录组件 | | AutoMapper | 模型映射组件 | | Swashbuckle.AspNetCore | APIs文档生成工具(swagger) | | StackExchange.Redis | 开源的Redis客户端SDK | | CAP | 实现事件总线及最终一致性（分布式事务）的一个开源的组件 | | RabbitMq | 异步消息队列组件 | | Polly | 一个 .NET 弹性和瞬态故障处理库，允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略 | | FluentValidation | 一个 .NET 验证框架，支持链式操作，易于理解，功能完善，组件内提供十几种常用验证器，可扩展性好，支持自定义验证器，支持本地化多语言 | | Maxscale | Mariadb开发的一款成熟、高性能、免费开源的数据库中间件 | ## 后端解决方案 #### 整体架构图 - `Infrastructures` 基础架构相关工程 - `Services` 微服务相关工程 - `Tests` 框架测试相关工程 ![.NET微服务开源框架-整体架构图](https://aspdotnetcore.net/adnc_solution) #### Infrastructures 基础架构相关工程 ##### :white_check_mark: Adnc.Infra.Core 该工程是Adnc所有工程的最顶层，任何工程都会者直接或间接依赖该层。该工程提供了大量的`C#`基础类型的扩展方法以及Configuration、DependencyInjection、ContainerBuilder的扩展方法，还定义了一些异常类。 ##### :white_check_mark: Adnc.Infra.Caching 该工程集成了StackExchange.Redis，提供缓存的管理、Redis常用类型操作、分布式锁、布隆过滤器功能。 ##### :white_check_mark: Adnc.Infra.Consul 该工程集成了Consul，提供服务的自动注册、发现以及系统配置读写操作。 ##### :white_check_mark: Adnc.Infra.EfCore.MySQL 该工程负责Adnc.Infra.Repository仓储接口以及IUintofWork接口的EfCore的实现，提供mysql数据库的CURD操作，同时也集成了Dapper部分接口，用来处理复杂查询。 ##### :white_check_mark: Adnc.Infra.EventBus 该工程简单封装了CAP，同时集成了RabbitMq，封装了发布者与订阅者等公共类，方便更加便捷的调用Rabbitmq。 ##### :white_check_mark: Adnc.Infra.Gateway 该工程是一个Web项目，基于Ocelot实现的Api网关，如果项目采用整体结构开发，该项目可以直接删除。ocelot网关包含路由、服务聚合、服务发现、认证、鉴权、限流、熔断、缓存、Header头传递等功能。市面上主流网关还有Kong，Traefik，Ambassador，Tyk等。 ##### :white_check_mark: Adnc.Infra.HealthCheckUI 该工程是一个Web项目， AspNetCore.HealthChecks组件的Dashboard，直接配置需要监测的服务地址就可以了，没有代码，关键的代码参考webapi层的AddHealthChecks()方法。 ##### :white_check_mark: Adnc.Infra.Helper 该工程提供一些通用帮助类，如IdGeneraterHelper,HashHelper,SecurityHelper等等。 ##### :white_check_mark: Adnc.Infra.Mongo 该工程负责Adnc.Infra.Repository仓储接口的Mongodb实现，提供mongodb数据库的CURD操作。 ##### :white_check_mark: Adnc.Infra.Mapper 该工程定义了IObjectMapper接口，并且提供了AutoMapper的实现。 ##### :white_check_mark: Adnc.Infra.Repository 该工程定义了Entity对象的基类、UnitOfWork接口、仓储接口。 #### Services 微服务相关工程 该目录都是具体微服务业务的实现。 ##### :white_check_mark: Shared 微服务公用工程 - `Adnc.Shared` 该层目前有三个目录Consts存放常量定义文件、Events存放事件定义文件、RPCServices存放RPC服务接口声明文件，任何层都可以依赖该层。 - `Adnc.Application.Shared` 该层定义了DTO对象的基类、应用服务类基类、缓存相关服务基类以及操作日志拦截器、UnitOfWork拦截器。所有微服务Application/Application.Contracts层的共享层，并且都需要依赖该层。 - `Adnc.WebApi.Shared` 该层实现了认证、鉴权、异常捕获、服务组件注册等公共类和中间件。所有微服务WebApi层的共享层，并且都需要依赖该层。 ##### :white_check_mark: Adnc.Usr 用户中心微服务，系统支撑服务，实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理。 ##### :white_check_mark: Adnc.Maint 运维中心微服务，系统支撑服务，实现了登录日志、审计日志、异常日志、字典管理、配置参数管理。 ##### :white_check_mark: Adnc.Cus 客户中心微服务，经典三层开发模式demo。 ##### :white_check_mark: Adnc.Ord 订单中心微服务，DDD开发模式demo。 ##### :white_check_mark: Adnc.Whse 仓储中心微服务，DDD开发模式demo。 > 每个微服务的Migrations层是Efcore用来做数据迁移的，迁移的日志文件存放在各自Migrations目录中。 ### 代码片段 ```csharp namespace Adnc.Usr.WebApi { public class Startup { private readonly IHostEnvironment _environment; private IServiceCollection _services; public Startup(IHostEnvironment environment) { _environment = environment; } public void ConfigureServices(IServiceCollection services) { _services = services; services.AddAdncServices(); } public void ConfigureContainer(ContainerBuilder builder) { builder.RegisterAdncModules(_services); } public void Configure(IApplicationBuilder app) { app.UseAdncMiddlewares(); if (_environment.IsProduction() || _environment.IsStaging()) { app.RegisterToConsul(); } } } } ``` ## 问题交流 - 企 鹅 群：780634162 - 项目官网：https://aspdotnetcore.net - 博    客：https://www.cnblogs.com/alphayu - GitHub ：https://github.com/alphayu/adnc ## 贡献者 ## License **MIT** **Free Software, Hell Yeah!**