曦寒框架

　　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：机器学习与智能分析能力

如何使用？

1. 创建项目

　　dotnet new webapi -n MyApicd MyApi

2. 安装框架（最小配置）

　　# 元数据包（必需）dotnet add package XiHan.Framework# Web API 核心包dotnet add package XiHan.Framework.Web.Apidotnet add package XiHan.Framework.Web.Docsdotnet add package XiHan.Framework.Logging

3. 基础配置

　　// Program.csusing 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();

4. 添加业务功能（可选）

　　# 添加认证和数据访问dotnet add package XiHan.Framework.Authenticationdotnet add package XiHan.Framework.Datadotnet add package XiHan.Framework.Validation/ 更新 Program.csbuilder.Services.AddXiHanAuthentication();builder.Services.AddXiHanData(options =>{ options.UseInMemoryDatabase("MyDb"); // 或使用 SQL Server});builder.Services.AddXiHanValidation();app.UseXiHanAuthentication();

　　https://github.com/XiHanFun/XiHan.Framework