adnc: A C# repository from antgogogo

代码改变世界，开源推动社区

概述

ADNC是什么？

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

微服务是一种分布式架构模式，通过将应用程序拆分成一组小型、松耦合的服务，可以提高应用程序的可伸缩性、可靠性和灵活性。

ADNC有什么优点?

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

架构设计

目录结构

adnc 
├── .github
│   └── workflows CICD脚本目录(github-action)
├── doc 技术文档目录
├── src 源代码目录
│   ├── ServerApi 后端代码目录
│   │   ├── Infrastructures 基础架构层代码目录
│   │   ├── ServiceShared 服务通用层代码目录
│   │   ├── Gateways ocelot网关代码目录
│   │   └── Demo 示例代码目录
│   └── ClientApp 前端代码目录
├── test 测试相关目录
├── .gitignore
├── README.MD
└── LICENSE

重要文件

路径	描述
`src/ServerApi/Adnc.sln`	该解决方案包含`adnc`所有工程
`src/ServerApi/Infrastructures/Adnc.Infra.sln`	该解决方案仅包含基础架构层相关工程
`src/ServerApi/ServiceShared/Adnc.Shared.sln`	该解决方案仅包含服务通用层相关工程
`src/ServerApi/Demo/Adnc.Demo.sln`	该解决方案仅包含`demo`相关工程
`scr/ServerApi/common.props`	工程文件`*.csproj`公用配置
`scr/ServerApi/version_infra.props`	基础架构层版本号
`scr/ServerApi/version_shared.props`	服务通用层版本号
`scr/ServerApi/nuget.props`	`Nuget`发布信息配置

总体架构图

Adnc.Infra.*

NuGet Gallery | Packages matching adnc.infra

Adnc.Shared.*

NuGet Gallery | Packages matching adnc.shared

解决方案截图

技术栈

名称	描述
Ocelot	基于 `.NET6 编写的开源网关
Consul	配置中心、注册中心组件
Refit	一个声明式自动类型安全的RESTful服务调用组件，用于同步调用其他微服务
Grpc.Net.ClientFactory Grpc.Tools	Grpc通讯框架
SkyAPM.Agent.AspNetCore	Skywalking `.NET6探针，性能链路监测组件
Castle DynamicProxy	动态代理，AOP开源实现组件
Pomelo.EntityFrameworkCore.MySql	EFCore ORM组件
Dapper	轻量级ORM组件
Z.EntityFramework.Plus.EFCore	第三方高性能的EfCore组件
NLog Nlog.Mongdb Nlog.Loki	日志记录组件
AutoMapper	模型映射组件
Swashbuckle.AspNetCore	APIs文档生成工具(swagger)
StackExchange.Redis	开源的Redis客户端SDK
CAP	实现事件总线及最终一致性（分布式事务）的一个开源的组件
RabbitMq	异步消息队列组件
Polly	一个 .NET 弹性和瞬态故障处理库，允许开发人员以 Fluent 和线程安全的方式来实现重试、断路、超时、隔离和回退策略
FluentValidation	一个 .NET 验证框架，支持链式操作，易于理解，功能完善，组件内提供十几种常用验证器，可扩展性好，支持自定义验证器，支持本地化多语言
Maxscale	Mariadb开发的一款成熟、高性能、免费开源的数据库中间件
AspNetCore.HealthChecks	健康监测组件,搭配consul的健康监测

文档

如何快速跑起来

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

如何手动部署到容器

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

如何使用jenkins+shell脚本自动化部署

文档尚未完成

如何部署到K8S

文档尚未完成

如何实现读写分离

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

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

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

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

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

如何认证与授权

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

如何使用EFCore仓储

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

如何从零开发业务

文档尚未完成

如何调用微服务

文档尚未完成

如何配置网关

文档尚未完成

如何使用注册/配置中心

文档尚未完成

如何配置链路追踪

文档尚未完成

如何配置健康检测

文档尚未完成

Demo介绍

✅ Shared

Demo公用工程

protos grpc定义文件
resources 公用的静态文件与配置文件
Adnc.Demo.Shared.Const 常量文件
Adnc.Demo.Shared.Rpc.Event 事件文件
Adnc.Demo.Shared.Rpc.Grpc gprc客户端
Adnc.Demo.Shared.Rpc.Http http客户端

✅ Adnc.Demo.Usr

经典三层开发模式，剥离了应用服务协议定义文件到Adnc.Demo.Usr.Application.Contracts层

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

✅ Adnc.Demo.Maint

经典三层开发模式，应用服务实现与协议定义都在Adnc.Demo.Maint.Application层

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

✅ Adnc.Demo.Cus

经典三层开发模式，控制器、应用服务实现与协议定义、仓储都在同一个工程，这种结构适合细粒度服务拆分模式。

客户中心微服务。

✅ Adnc.Demo.Ord

DDD开发模式

订单中心微服务。

✅ Adnc.Demo.Whse