SuperAPI AI 工具集

dotnet-architecture-patterns

设计与创作

查看项目

更新于 10-16 02:32

技能介绍

用途:为 .NET 应用提供现代架构模式指导,重点解决 Minimal API 在规模化时的组织方式,以及请求处理链路中的验证、缓存、错误与一致性设计。

主要能力:垂直切片架构与按功能分文件夹组织;请求管道组合与 MediatR 模式;缓存策略(内存、分布式、输出缓存、HybridCache);错误处理与 Problem Details(RFC 9457);幂等与发件箱模式;用 Result 模式表达业务逻辑错误流。

使用方式:作为技能参考,在编写或评审 ASP.NET Core 架构时按主题查阅;详细代码示例见该技能目录下的 examples.md。相关主题有交叉引用,如依赖注入、异步模式、配置 Options、SOLID 原则等。

适用场景:需要按功能而非技术分层组织代码、统一请求管道与验证、设计缓存与失效策略、实现幂等接口或可靠事件发布的 .NET 项目。

限制与注意:不覆盖 DI 容器机制、async/await、项目脚手架、测试策略与 SOLID 基础,这些由其他技能负责。资料给出若干易错点:幂等需区分未记录、进行中、已完成三态;幂等记录必须无条件完成,不能按 IResult 子类型判断;写操作后必须显式失效缓存;HybridCache 防击穿仅在 GetOrCreateAsync 下有效;发件箱消息须与领域数据同事务写入;端点过滤器顺序影响执行,验证应早于幂等;DbContext 不可跨并发请求共享。MediatR 对商业用途为商业产品,简单场景建议用内置 IEndpointFilter 与处理器模式。具体收费、价格与平台信息暂未提供。