认识 Bitzsoft.Integrations

Bitzsoft.Integrations 是一套 .NET 第三方服务集成 NuGet 包集合，用统一的架构约定把数十家厂商的 API 封装成一致的消费体验。你不再需要为每家厂商单独研究鉴权流程、签名算法、错误码格式和 HttpClient 配置——库已经做好了。

它解决什么问题

企业系统每天要对接大量外部服务：发短信、发邮件、存储文件、签署合同、查询快递轨迹、发起支付……每接一家厂商，都要重走一遍相似但不完全相同的流程：读 API 文档、实现鉴权、封装请求、解析响应、处理错误。

Bitzsoft.Integrations 把这些重复劳动沉淀为统一约定：

• 一致的接口：同域不同厂商实现同一个能力接口（如 IPaymentProvider），切换厂商只改配置不改代码。
• 统一的结果类型：PaymentResult<T>、SMSResult 等 Result 包装，错误码结构化，便于编程式处理。
• 统一的 DI 注册：AddBitzsoft{厂商}{域}() 一行注册，配置驱动聚合包自动发现。
• 统一的审计日志：所有 HTTP 请求经 RequestLogHandler 做结构化脱敏和审计记录。
• 统一的多厂商路由：IIntegrationProviderResolver<T> 按稳定 Provider ID 解析，跨 .NET 版本工作。

包生态全景

22 个功能域，约 190 个产品项目，约 90 个测试项目。每个域遵循统一的”抽象层 / 厂商实现层 / 聚合层”三层结构。

完整清单见项目地图。

三层包模式

绝大多数功能域遵循同一个结构：

Bitzsoft.Integrations.{域}            ← 抽象层：接口、DTO、异常、Result 类型
├── Bitzsoft.Integrations.{域}.{厂商}     ← 实现层：Options + Provider + HttpClient + DI
└── Bitzsoft.Integrations.{域}.All        ← 聚合层：配置驱动一键注册

第一层定义领域契约，不含厂商逻辑；第二层每家厂商一个包，各自实现签名和请求构造；第三层是”空程序集”，靠 ProjectReference 拉入全部厂商，按配置节存在性自动注册。

多目标框架

产品包统一多目标 net5.0;net8.0;net10.0。net5.0 是硬性商业兼容目标（产品线中有仍在运行的 .NET 5 老项目），net8.0 是当前 LTS 基线，net10.0 面向新项目。AI 相关包因上游 SDK 要求 net8+，是唯一例外。

跨 TFM 兼容由 Bitzsoft.Integrations.Compatibility 包提供——它在 net5.0 上自实现 BCL 缺失方法，在 net8+ 上直接委托给 BCL。

从哪里开始

1. 安装一个域的聚合包（如 Bitzsoft.Integrations.Payment.All）。
2. 在 appsettings.json 里写配置。
3. 在 Program.cs 调一行注册方法。
4. 注入接口使用。

具体步骤见快速开始。