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。
  请点击链接，查看详细介绍

如何手动部署到服务器

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

如何实现读写分离

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

如何使用Cache Redis 分布式锁 布隆过滤器

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

如何动态分配雪花算法的WorkerId

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

如何使用EFCore仓储

• 详细介绍EFCore仓储基础功能、工作单元、CodeFirst，提供了丰富的演示代码以及演示代码对应的Sql语句。
  请点击链接，查看详细介绍

总体结构设计

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

Jmeter测试

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

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

演示

• 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
• 构建步骤

  # 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

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

后端解决方案

整体架构图

• Infrastructures 基础架构相关工程
• Services 微服务相关工程
• Tests 框架测试相关工程

Infrastructures 基础架构相关工程

✅ Adnc.Infra.Core

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

✅ Adnc.Infra.Caching

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

✅ Adnc.Infra.Consul

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

✅ Adnc.Infra.EfCore.MySQL

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

✅ Adnc.Infra.EventBus

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

✅ Adnc.Infra.Gateway

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

✅ Adnc.Infra.HealthCheckUI

该工程是一个Web项目， AspNetCore.HealthChecks组件的Dashboard，直接配置需要监测的服务地址就可以了，没有代码，关键的代码参考webapi层的AddHealthChecks()方法。

✅ Adnc.Infra.Helper

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

✅ Adnc.Infra.Mongo

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

✅ Adnc.Infra.Mapper

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

✅ Adnc.Infra.Repository

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

Services 微服务相关工程

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

✅ Shared

微服务公用工程

• Adnc.Shared 该层目前有三个目录Consts存放常量定义文件、Events存放事件定义文件、RPCServices存放RPC服务接口声明文件，任何层都可以依赖该层。
• Adnc.Application.Shared 该层定义了DTO对象的基类、应用服务类基类、缓存相关服务基类以及操作日志拦截器、UnitOfWork拦截器。所有微服务Application/Application.Contracts层的共享层，并且都需要依赖该层。
• Adnc.WebApi.Shared 该层实现了认证、鉴权、异常捕获、服务组件注册等公共类和中间件。所有微服务WebApi层的共享层，并且都需要依赖该层。

✅ Adnc.Usr

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

✅ Adnc.Maint

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

✅ Adnc.Cus

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

✅ Adnc.Ord

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

✅ Adnc.Whse

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

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

代码片段

    [Route("usr/session")]
    [ApiController]
    public class AccountController : ControllerBase
    {
        private readonly JWTConfig _jwtConfig;
        private readonly IAccountAppService _accountService;
        private readonly ILogger<AccountController> _logger;

        public AccountController(IOptionsSnapshot<JWTConfig> jwtConfig
            , IAccountAppService accountService
            , ILogger<AccountController> logger)
        {
            _jwtConfig = jwtConfig.Value;
            _accountService = accountService;
            _logger = logger;
        }

        /// <summary>
        /// 登录/验证
        /// </summary>
        /// <param name="userDto"><see cref="UserValidateInputDto"/></param>
        /// <returns></returns>
        [AllowAnonymous]
        [HttpPost()]
        public async Task<UserTokenInfoDto> Login([FromBody]UserValidateInputDto userDto)
        {
            var userValidateDto = await _accountService.Login(userDto);

            return new UserTokenInfoDto
            {
                Token = JwtTokenHelper.CreateAccessToken(_jwtConfig, userValidateDto),
                RefreshToken = JwtTokenHelper.CreateRefreshToken(_jwtConfig, userValidateDto)
            };
        }
    }

问题交流

• 企 鹅 群：780634162
• 项目官网：https://aspdotnetcore.net
• 博    客：https://www.cnblogs.com/alphayu
• GitHub ：https://github.com/alphayu/adnc

贡献者

License

MIT
Free Software, Hell Yeah!