曦寒框架
XiHan.Framework 是一套基于 .NET 9 构建的现代化、模块化企业级开发框架，面向前后端分离的 ASP.NET Core 应用场景。
框架优先采用 .NET 9 原生能力，尽量减少对第三方组件的依赖，在保证系统稳定性的同时，兼顾模块化设计、良好的扩展性以及上手友好度。
核心特性
模块化架构
采用高度可扩展的模块化设计，支持按需启用，灵活组合业务能力。
快速启动
项目开箱即用，下载即可运行，快速体验完整的 Web API 架构。
.NET 9 优先
深度利用 .NET 9 原生能力，包括依赖注入、日志体系、序列化及 AOT 支持，减少第三方依赖。
DDD 架构支持
内置完整的领域驱动设计（DDD）架构支持，适合复杂业务场景。
企业级安全机制
提供完善的认证、授权与安全控制方案，满足企业级应用需求。
前后端分离设计
面向现代 Web 应用的前后端分离架构，接口清晰、职责明确。
监控与日志体系
内置完善的监控、日志记录与性能分析能力，便于运维与问题排查。
分层架构
技术栈
基础框架
.NET 9：核心运行时，支持 AOT 编译
ASP.NET Core：高性能 Web 应用框架
System.Text.Json：高性能 JSON 序列化
Entity Framework Core：ORM 数据访问框架
Swagger / Scalar：API 文档与接口调试
认证与授权
JWT：Token 身份认证机制
OAuth 2.0：开放授权协议
OpenID Connect：统一身份认证标准
ASP.NET Core Identity：用户与身份管理体系
扩展与基础设施
Redis：分布式缓存
SignalR：实时通信能力
Hangfire / Quartz.NET：后台任务与定时调度
RabbitMQ / Kafka：消息队列与异步解耦
Elasticsearch：全文搜索与日志分析
可靠性与智能化
Retry / Resilience：重试与容错机制
ML.NET：机器学习与智能分析能力
如何使用？
创建项目
dotnet new webapi -n MyApi
cd MyApi
安装框架（最小配置）
# 元数据包（必需）
dotnet add package XiHan.Framework
# Web API 核心包
dotnet add package XiHan.Framework.Web.Api
dotnet add package XiHan.Framework.Web.Docs
dotnet add package XiHan.Framework.Logging
基础配置
// Program.cs
using XiHan.Framework.Web.Api;
var builder = WebApplication.CreateBuilder(args);
// 添加框架服务
builder.Services.AddXiHanWebApi();
builder.Services.AddXiHanDocs();
builder.Services.AddXiHanLogging();
var app = builder.Build();
// 配置中间件
app.UseXiHanWebApi();
app.UseXiHanDocs(); // 自动生成 Swagger 文档
app.Run();
添加业务功能（可选）
# 添加认证和数据访问
dotnet add package XiHan.Framework.Authentication
dotnet add package XiHan.Framework.Data
dotnet add package XiHan.Framework.Validation
/ 更新 Program.cs
builder.Services.AddXiHanAuthentication();
builder.Services.AddXiHanData(options =>
{
options.UseInMemoryDatabase("MyDb"); // 或使用 SQL Server
});
builder.Services.AddXiHanValidation();
app.UseXiHanAuthentication();
项目地址：https://github.com/XiHanFun/XiHan.Framework
