📄️ 快速开始
用 .NET 8 + Aegis 3.x 在业务项目中快速跑通宿主、数据库、Swagger 和日志的最短路径。
📄️ 初始系统验证清单
检查一个 .NET 8 + Aegis 3.x 业务项目是否已经完成宿主、数据库、Swagger 和日志的最小闭环。
📄️ 层次介绍
说明业务项目接入 Aegis 时常见的 WebApi、Contract、Services、Dto、Repository 分层,以及它们各自负责什么。
📄️ Startup
说明 Aegis 中 ICustomStartup 的职责,以及哪些东西适合放在 Startup 里处理。
📄️ 配置
说明 Aegis 中本地配置和配置中心各自解决什么问题,以及项目里通常怎么读取配置。
📄️ 日志
说明 Aegis 项目里日志怎么接、日志写到哪里,以及第一版通常怎么验证它已经生效。
📄️ Services 与 Contract
说明 Contract 和 Services 各自负责什么,以及业务项目里这一层通常怎么组织。
📄️ Dto 数据传输层
说明业务项目里 Request 和 Dto 应该怎么放,以及哪些内容不应该混进这一层。
📄️ Repository 层
说明 Repository、Entity、IDbSource 这些数据访问相关代码在项目里通常怎么组织。
📄️ Controller
说明 Aegis 业务项目中 Controller 的职责、入参组织方式和与 ApiControllerBase 的配合关系。
📄️ ApiControllerBase
说明 Aegis 当前 ApiControllerBase 提供的标准响应类型与常用返回方法。
📄️ Swagger
说明 Aegis 3.x 业务项目中 Swagger 的最小接入方式和验证步骤。
📄️ 入门
面向新业务项目的 Aegis 3.x 入门页,说明阅读顺序、项目分层和基线范围。
📄️ AuditLogger
3.0.0 页面说明
📄️ Encryption
3.0.0 页面说明
📄️ FluentValidation验证器
使用FluentValidation只需要引入Aegis.Transfer包即可,该包里包含了FluentValidation的包。
📄️ HTTP请求组件
这页只讨论 Broker 的 HTTP / REST 调用方式,不再混入 WebService 说明。如果你当前要对接的是普通 HTTP 接口、内部 Web API 或第三方 REST 服务,这页就是直接可用的接入手册。
📄️ ID生成器
这页对应 3.x 里的 ID 生成使用方式,核心组件是 ID 生成器(Aegis.IdGenerator)。如果模板编号需要在多实例间共享流水号,还要继续接 Redis ID 生成提供程序(Aegis.IdGenerator.Provider.Redis)。
📄️ 自定义组件
基本依赖注入
📄️ OpenTelemetry
这页对应 3.x 里的链路追踪接入方式,核心组件是 OpenTelemetry 链路追踪(Aegis.Trace.OpenTelemetry)。
📄️ 文档处理
这页对应 3.x 里的文档处理与文件服务体系。标准入口是 文档处理(Aegis.Documents),如果还涉及文件上传、下载和落盘,再配合 文件管理(Aegis.FileManager) 或 NAS 文件存储(Aegis.FileManager.Nas)。
📄️ Polly
这页对应 3.x 里的容错与重试使用方式。Polly 在当前文档里按“开发指南”维护,而不是按核心组件维护,因为它更像调用侧按需引入的策略库,而不是通过 Component.deps.json 统一装配的框架组件。
📄️ Prometheus
这页对应 3.x 里的指标监控接入方式,核心组件是 Prometheus 指标监控(Aegis.Prometheus)。
📄️ Redis
这页对应 3.x 里的 Redis 使用方式,核心组件是 Redis 缓存(Aegis.Caching.Redis)。其他和 Redis 相关的能力,如 Redis 会话、Redis ID 容器、Redis 事件总线,都是建立在这层基础能力之上的。
📄️ SignalR
3.0.0 页面说明
📄️ WebService调用
这页只讨论 Broker 的 WebService 调用方式,也就是 .svc、.asmx 这类 SOAP 服务的接入。如果你当前面对的是医院存量系统、遗留平台接口,或者对方提供的是 ServiceContract 风格契约,这页就是直接可用的接入手册。
📄️ 上下文
这页对应的是 3.x 里的运行时请求上下文能力,核心组件是 上下文(Aegis.Context)。
📄️ 事件总线
3.0.0 页面说明
📄️ 事务
3.0.0 页面说明
📄️ 分页数据
Repository下的分页
📄️ 多级缓存
这页对应 3.x 里基于 Aegis.Caching.Redis 的多级缓存能力。它的核心思路是把本地内存缓存作为 L1,把 Redis 作为 L2,把数据库或真实业务方法作为 L3,并通过缓存拦截器把读写删除动作统一接起来。
📄️ 延迟任务队列
3.0.0 页面说明
📄️ 组件导航
3.0.0 的组件文档已经迁移到新的 组件总览。
📄️ 认证和鉴权体系
这页不是某一个组件的详细说明,而是 Aegis 3.x 中认证与鉴权能力的总入口。如果你正在判断“我该接哪一组组件”“组件之间是什么关系”“先看哪篇文档最合适”,先看这里会更省时间。