ADNC 是一个基于 .NET 平台的分布式/微服务开源框架，采用现代化的架构设计和最佳实践，同时也适用于单体架构系统的开发。它提供了一系列的工具和库，帮助开发人员快速构建和部署微服务应用程序，包括服务注册/发现、配置中心、链路跟踪、负载均衡、熔断、容错、分布式事务、分布式缓存、消息队列、RPC调用(http/grpc)、认证授权、读写分离、日志记录等，所有这些组件都已预先配置，能够无缝协同工作，同时也提供了完善的文档和示例代码，方便开发人员使用和学习。如果您正在考虑使用分布式/微服务或单体架构开发应用程序，ADNC 框架是一个值得尝试的开源框架。
微服务是一种分布式架构模式，通过将应用程序拆分成一组小型、松耦合的服务，可以提高应用程序的可伸缩性、可靠性和灵活性。
- 灵活性：框架采用现代化的架构设计，支持经典三层和
DDD架构开发模式。 - 易用性：框架提供了完善的文档和示例代码，同时也集成了一系列主流的微服务技术栈，使用起来比较容易上手。
- 高可靠性：框架采用容器化部署、负载均衡、服务发现等技术，可以提高应用程序的可靠性和可伸缩性。
- 开放性：框架是一个开源项目，采用
MIT许可证发布，用户可以自由地使用、修改和分享该框架的源代码。 - 生态圈：框架的社区生态圈正在逐渐壮大，有越来越多的开发人员在使用和贡献该框架，用户可以从社区中获取到更多的资源和支持。
无论您是在构建新的微服务应用还是迁移现有系统，ADNC都提供了工具和模式，使您的开发过程更加高效。
adnc
├── .github
│ └── workflows CICD脚本目录(github-action)
├── doc 技术文档目录
├── src 源代码目录
│ ├── Infrastructures 基础架构层代码目录
│ ├── ServiceShared 服务通用层代码目录
│ ├── Gateways ocelot网关代码目录
│ └── Demo 示例代码目录
├── test 测试相关目录
├── .gitignore
├── README.MD
└── LICENSE
| 路径 | 描述 |
|---|---|
src/Adnc.sln |
该解决方案包含adnc所有工程 |
src/Infrastructures/Adnc.Infra.sln |
该解决方案仅包含基础架构层相关工程 |
src/ServiceShared/Adnc.Shared.sln |
该解决方案仅包含服务通用层相关工程 |
src/Demo/Adnc.Demo.sln |
该解决方案仅包含demo相关工程 |
Directory.Build.props |
工程文件*.csproj公用配置 |
NuGet Gallery | Packages matching adnc.infra
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组件 |
| 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文件编写与配置以及如何将多个服务部署到服务器。
请点击链接，查看详细介绍
- 文档尚未完成
- 文档尚未完成
- 详细介绍为什么要通过中间件实现读写分离以及EFCore基于中间件如何写代码。
请点击链接，查看详细介绍
- 详细介绍如何使用Cache、Redis、分布式锁以及布隆过滤器。如何配置Cache防止雪崩、击穿、穿透以及缓存同步。
请点击链接，查看详细介绍
- 详细介绍Yitter雪花算法的特点、配置以及如何动态获取WorkerId。
请点击链接，查看详细介绍
- 详细介绍为什么要采用JwtBearer+Basic混合认证模式以及它们的实现逻辑，如何灵活配置与应用。
请点击链接，查看详细介绍
- 详细介绍EFCore仓储基础功能、工作单元、CodeFirst，执行原生SQL等提供了丰富的演示代码以及演示代码对应的Sql语句。
- 文档尚未完成
- 文档尚未完成
- 文档尚未完成
- 文档尚未完成
- 文档尚未完成
- 文档尚未完成
Demo提供了五个相互关联的微服务，展示了不同的架构风格，本章节将介绍项目结构，解释每个服务的架构风格。
| 服务 | 描述 | 架构风格 |
|---|---|---|
| Admin | 系统管理（组织、用户、角色、权限、字典、配置） | 经典三层分离合约 |
| Maint | 运维管理（日志、审计） | 经典三层合并合约 |
| Cust | 客户管理 | 单项目最小结构 |
| Ord | 订单管理 | 领域驱动设计（DDD）带领域层 |
| Whse | 仓库管理 | 领域驱动设计（DDD）带领域层 |
Demo服务展示了如何在保持与整体框架兼容性的同时，以不同方式组织代码。
Demo公用工程，所有演示服务都使用了
Shared目录中的通用组件。
Shared/
├── Const/ - 用于缓存、实体、权限的常量
├── Remote.Event/ - 用于跨服务通信事件定义
├── Remote.Grpc/ - gRPC客户端定义
├── Remote.Http/ - HTTP客户端定义
├── protos/ - gRPC的协议文件定义
└── resources/ - 共享配置和资源
Admin服务遵循经典的三层模式，项目分离，这种分离提供了层之间的清晰边界，便于维护，剥离了应用服务协议定义文件到
Adnc.Demo.Admin.Application.Contracts层
Admin/
├── Admin.Api/ - 控制器和API端点
├── Admin.Application/ - 业务逻辑实现
├── Admin.Application.Contracts/ - DTO和服务接口
└── Admin.Repository/ - 数据访问层
系统管理服务是系统支撑服务，实现了用户管理、角色管理、权限管理、菜单管理、组织架构、字典管理、系统配置管理。
Maint服务使用更紧凑的三层结构，这种方法减少了项目数量，同时仍保持关注点分离，应用服务实现与协议定义都在
Adnc.Demo.Maint.Application层。
Maint/
├── Maint.Api/ - 控制器和端点
├── Maint.Application/ - 包含合约和实现
└── Maint.Repository/ - 数据访问层
运维中心服务是系统支撑服务，实现了登录日志、审计日志、异常日志。
Cust服务展示了一种超紧凑的方法，所有内容都在一个项目中，这种方法适用于小型、专注的微服务，复杂性有限，控制器、应用服务实现与协议定义、仓储都在同一个工程，这种结构适合细粒度服务拆分模式。
Cust/
└── Cust.Api/ - 包含控制器、应用逻辑和存储库
客户中心微服务。
Ord服务遵循DDD原则，带专用领域层，这种架构强调业务规则和领域逻辑，将其与应用关注点分离。
Ord/
├── Ord.Api/ - API端点
├── Ord.Application/ - 应用服务
├── Ord.Domain/ - 领域实体、聚合和领域服务
└── Ord.Migrations/ - 数据库迁移
订单中心微服务。
项目结构与Ord服务一样，带专用领域层，这种架构强调业务规则和领域逻辑，将其与应用关注点分离。
仓储中心微服务。
6个测试用例覆盖了网关、服务发现、配置中心、服务间同步调用、数据库CURD、本地事务、分布式事务、缓存、布隆过滤器、SkyApm链路、Nlog日志记录、操作日志记录。
- ECS服务器配置：4核8G，带宽8M。服务器上装了很多东西，剩余大约50%的CPU资源，50%的内存资源。
- 因为服务器带宽限制，吞吐率约1000/s左右。
- 模拟并发线程1200/s
- 读写比率7:3
-
QQ群号：780634162
-
都看到这里了，那就点个
star吧！
MIT
Free Software, Hell Yeah!