ADNC 是一个基于 .NET 平台的分布式/微服务开源框架。微服务是一种分布式架构模式，通过将应用程序拆分成一组小型、松耦合的服务，可以提高应用程序的可伸缩性、可靠性和灵活性。ADNC 提供了一系列的工具和库，帮助开发人员快速构建和部署微服务应用程序。ADNC 采用现代化的架构设计和最佳实践，包括服务注册/发现、配置中心、链路跟踪、负载均衡、熔断、容错、分布式事务、分布式缓存、消息队列、RPC调用(http/grpc)、认证授权、读写分离、日志记录等，同时也提供了完善的文档和示例代码，方便开发人员使用和学习。如果您正在考虑使用微服务架构开发应用程序，ADNC 框架是一个值得尝试的开源框架。

具有以下优点：

• 灵活性：框架采用现代化的架构设计，支持经典三层和DDD架构开发模式，同时也适用于单体架构系统的开发。
• 易用性：框架提供了完善的文档和示例代码，同时也集成了一系列主流的微服务技术栈，使用起来比较容易上手。
• 高可靠性：框架采用容器化部署、负载均衡、服务发现等技术，可以提高应用程序的可靠性和可伸缩性。
• 开放性：框架是一个开源项目，采用 MIT 许可证发布，用户可以自由地使用、修改和分享该框架的源代码。
• 生态圈：框架的社区生态圈正在逐渐壮大，有越来越多的开发人员在使用和贡献该框架，用户可以从社区中获取到更多的资源和支持。

示例代码功能：

• 用户中心：系统支撑服务，实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理
• 运维中心：系统支撑服务，实现了登录日志、审计日志、异常日志、字典管理、配置参数管理
• 客户中心：经典三层开发模式demo
• 订单中心：DDD开发模式demo
• 仓储中心：DDD开发模式demo

Package Name	Version
Adnc.Infra.Core
Adnc.Infra.Consul
Adnc.Infra.Mapper
Adnc.Infra.Helper
Adnc.Infra.Repository
Adnc.Infra.Repository.Mongo
Adnc.Infra.Repository.Dapper
Adnc.Infra.Repository.EfCore
Adnc.Infra.Repository.EfCore.MySql
Adnc.Infra.Repository.EfCore.SqlServer
Adnc.Infra.Redis
Adnc.Infra.Redis.Caching
Adnc.Infra.IdGenerater
Adnc.Infra.EventBus
Adnc.Shared
Adnc.Shared.Application.Contracts
Adnc.Shared.Application
Adnc.Shared.Domain
Adnc.Shared.WebApi

• QQ群：780634162
• 项目官网：https://aspdotnetcore.net
• 博    客：https://www.cnblogs.com/alphayu

• 详细介绍如何使用docker安装redis、mysql、rabbitmq、mongodb，以及如何在本地配置ClientApp、ServerApi。
  请点击链接，查看详细介绍

• 详细介绍如何使用docker安装配置consul集群、Skywalking系列组件、相关项目的dockerfile文件编写与配置以及如何将多个服务部署到服务器。
  请点击链接，查看详细介绍

• 文档尚未完成

• 文档尚未完成

• 详细介绍为什么要通过中间件实现读写分离以及EFCore基于中间件如何写代码。
  请点击链接，查看详细介绍

• 详细介绍如何使用Cache、Redis、分布式锁以及布隆过滤器。如何配置Cache防止雪崩、击穿、穿透以及缓存同步。
  请点击链接，查看详细介绍

• 详细介绍Yitter雪花算法的特点、配置以及如何动态获取WorkerId。
  请点击链接，查看详细介绍

• 详细介绍为什么要采用JwtBearer+Basic混合认证模式以及它们的实现逻辑，如何灵活配置与应用。
  请点击链接，查看详细介绍

• 详细介绍EFCore仓储基础功能、工作单元、CodeFirst，执行原生SQL等提供了丰富的演示代码以及演示代码对应的Sql语句。

1. 如何使用仓储(一)-基础功能
   
2. 如何使用仓储(二)-分布式事务/本地事务
   
3. 如何使用仓储(三)-CodeFirst
   
4. 如何使用仓储(四)-撸SQL
   
5. 如何使用仓储(五)-切换数据库类型
   

• 文档尚未完成

• 文档尚未完成

• 文档尚未完成

• 文档尚未完成

• 文档尚未完成

• 文档尚未完成

• 经典三层
• DDD三层
• 总体结构

internal static class Program
{
    internal static async Task Main(string[] args)
    {
        var logger = LogManager.Setup().LoadConfigurationFromAppSettings().GetCurrentClassLogger();
        logger.Debug($"init {nameof(Program.Main)}");
        try
        {
            var webApiAssembly = System.Reflection.Assembly.GetExecutingAssembly();
            var serviceInfo = Shared.WebApi.ServiceInfo.CreateInstance(webApiAssembly);
            
            var app = WebApplication
                .CreateBuilder(args)
                .ConfigureAdncDefault(args, serviceInfo)
                .Build();

            app.UseAdncDefault(endpointRoute: endpoint =>
            {
                endpoint.MapGrpcService<Grpc.MaintGrpcServer>();
            });

            await app
                .ChangeThreadPoolSettings()
                .UseRegistrationCenter()
                .RunAsync();
        }
        catch (Exception ex)
        {
            logger.Error(ex, "Stopped program because of exception");
            throw;
        }
        finally
        {
            LogManager.Shutdown();
        }
    }
}

• ECS服务器配置：4核8G，带宽8M。服务器上装了很多东西，剩余大约50%的CPU资源，50%的内存资源。
• 因为服务器带宽限制，吞吐率约1000/s左右。
• 模拟并发线程1200/s
• 读写比率7:3

6个测试用例覆盖了网关、服务发现、配置中心、服务间同步调用、数据库CURD、本地事务、分布式事务、缓存、布隆过滤器、SkyApm链路、Nlog日志记录、操作日志记录。

• http://adnc.aspdotnetcore.net

• https://github.com/alphayu/adnc
• 开源不易，如果您喜欢这个项目, 请给个星星⭐️。

• 计划完善与新增的模块

• src
  • serverApi 后端项目(.NET6.0)
  • test 单元测试工程
  • clientApp 前端项目 Adnc.Vue2: ADNC's Vue2 front-end
• doc 项目相关文档(sql脚本、docker脚本、docker-compose.yaml文件)
• tools 工具软件
• test 测试工程

• clientApp基于Vue-Element-Admin以及Web-Flash搭建，感谢两位作者。
• 前端主要技术栈 Vue + Vue-Router + Vuex + Axios
• 构建步骤

  # 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

• 界面

• ServerApi基于.NET 5.0搭建。
• 后端主要技术栈

• Gateways 网关相关工程

• Infrastructures 基础架构相关工程

• Services 微服务相关工程

• Tests 框架测试相关工程

基于Ocelot实现的Api网关，如果项目采用整体结构开发，该项目可以直接删除。Ocelot网关包含路由、服务聚合、服务发现、认证、鉴权、限流、熔断、缓存、Header头传递等功能。市面上主流网关还有Kong，Traefik，Ambassador，Tyk等等。网关和实际业务有没有关联，可以自由选择。

该工程是Adnc所有工程的最顶层，任何工程都会者直接或间接依赖该层。该工程提供了大量的C#基础类型的扩展方法以及Configuration、DependencyInjection、ContainerBuilder的扩展方法，还定义了一些异常类。

该工程集成了StackExchange.Redis，提供缓存的管理、Redis常用类型操作、分布式锁、布隆过滤器功能。

该工程集成了Consul，提供服务的自动注册、发现以及系统配置读写操作。

该工程简单封装了CAP，同时集成了RabbitMq，封装了发布者与订阅者等公共类，能让开发人员更加便捷的调用。

该工程负责Id的生成。

该工程提供一些通用帮助类，如HashHelper,SecurityHelper等等。

该工程定义了IObjectMapper接口，并且提供了AutoMapper的实现。

该工程定义了Entity对象的基类、UnitOfWork接口、仓储接口。

该工程负责Adnc.Infra.Repository仓储接口IAdoExecuterWithQuerierRepository的实现，提供mysql数据库的CURD操作。

该工程负责Adnc.Infra.Repository仓储接口以及IUintofWork接口的EfCore的实现，提供mysql数据库的CURD操作，同时也集成了Dapper部分接口，用来处理复杂查询。

该工程负责Adnc.Infra.Repository仓储接口的Mongodb实现，提供mongodb数据库的CURD操作。

该目录都是具体微服务业务的实现。

微服务公用工程

• Adnc.Shared 该层目前只有两个目录Consts存放常量定义文件、Events存放事件定义文件。
• Adnc.Shared.Rpc该层负责proto文件的定义、refit接口定义以及DelegatingHandler实现。微服务同步通讯主要由该层处理，adnc支持Grpc与RestAPI两种通讯方式混用。
• Adnc.Application.Shared 该层定义了DTO对象的基类、应用服务类基类、缓存相关服务基类以及操作日志拦截器、UnitOfWork拦截器。所有微服务Application层的共享层，并且都需要依赖该层。
• Adnc.WebApi.Shared 该层实现了认证、鉴权、异常捕获、服务组件注册等公共类和中间件。所有微服务WebApi层的共享层，并且都需要依赖该层。

用户中心微服务，系统支撑服务，实现了用户管理、角色管理、权限管理、菜单管理、组织架构管理。

运维中心微服务，系统支撑服务，实现了登录日志、审计日志、异常日志、字典管理、配置参数管理。

客户中心微服务，经典三层开发模式demo。

订单中心微服务，DDD开发模式demo。

仓储中心微服务，DDD开发模式demo。

每个微服务的Migrations层是Efcore用来做数据迁移的，迁移的日志文件存放在各自Migrations目录中。

MIT
Free Software, Hell Yeah!