Bitzsoft.Integrations 是一套面向 .NET 的第三方服务集成 NuGet 包集合，覆盖企业系统集成、协同办公、财税、通信、AI、电子签章、文件存储、云盘、快递、法库和 SSO 等场景。所有包共享统一的三层架构约定——抽象层定义契约，厂商实现各自适配，聚合层提供一键注册。
按目标进入
- 第一次使用：从认识 Bitzsoft.Integrations和快速开始入手。
- 理解架构：阅读架构总览和三层包模式。
- 学习约定：从编码约定了解推荐模式与遗留差异。
- 新增连接器：参照新增厂商 Provider 指南。
- 查看功能域：浏览功能域手册。
- 基础设施深入：阅读核心基础设施。
- 打包发布：执行打包与发布流程。
文档怎样表达成熟度
| 标记 | 含义 |
|---|---|
| sourceVerified | 已对照当前源码路径和符号验证 |
| 设计 / 目标 | 方向说明，不代表已交付的稳定 API |
| Stability.Stable | 已通过厂商契约验证，可在生产使用 |
| Stability.Preview | 基本流程走通，边界场景可能未覆盖 |
| Stability.Experimental | 探索性实现，接口和配置可能调整 |
如果文档与源码冲突，以源码为准。
一次请求怎样运行
Provider 接收调用后通过 IHttpClientFactory 获取命名 HttpClient，请求经过 RequestLogHandler 做审计脱敏后发往第三方。错误被捕获并转换为 Result<T>，成功返回数据。
快速开始
安装、配置和使用 Bitzsoft.Integrations 连接器包的入口指引。
架构总览
三层包模式、依赖链、结构变体和 Provider 目录——建立连接器库的整体架构心智模型。
架构决策
Bitzsoft.Integrations 的架构决策记录索引。
核心基础设施
Compatibility、Core、RequestLogging、Rest、Webhooks 五个跨域共享基础设施包的职责与依赖链。
编码约定
凭据管理、集成上下文、取消令牌传播和 XML 文档注释等横切关注点。
安全
密钥管理、Webhook 签名验证和请求日志脱敏等安全关注点。
测试
连接器库的测试策略——单元测试、Provider 路由测试和多 TFM 兼容性测试。
打包与发布
NuGet 包打包、发布、SBOM 和安全审计的完整流程。
开发指南
面向贡献者与消费者的开发指南集合，覆盖新增厂商、新建功能域与单/多厂商消费四类核心场景。
功能域手册
按 22 个功能域浏览 Bitzsoft.Integrations 的完整能力地图，三级文档结构——功能域手册、封装抽象参考和供应商实现详解。
Payment 支付
支付域 5 家供应商的完整参考——IPaymentProvider 5 个统一方法、鉴权方式对比、Options 配置与 DI 注册。
ElectronicSignature 电子签章
电子签章域 10 家供应商的完整参考——IElectronicSignatureProvider 11 个统一方法、鉴权方式对比、Options 配置与 DI 注册。
VideoConference 视频会议
视频会议域 6 家供应商的完整参考——IVideoConferenceService 9 个统一方法、鉴权方式对比、Options 配置与 DI 注册。
TeamWork 协同办公
协同办公域 6 家供应商的 NuGet 包参考——钉钉、飞书、企业微信、泛微、致远、蓝凌的 Options 配置、DI 注册与能力接口清单。
EnterpriseMail 企业邮箱
企业邮箱域 5 家供应商的 NuGet 包参考——阿里、飞书、Microsoft 365、网易、腾讯的配置与 IEnterpriseMailProvider 11 方法。
OutboundCall 外呼
外呼域 7 家供应商的 NuGet 包参考——腾讯云、阿里云、火山引擎、容联云、华为云、Twilio、Vonage 的配置与 IOutboundCallService 9 方法。
InstantMessaging 即时通讯
即时通讯域 4 家供应商的完整参考——IInstantMessagingService 8 个统一方法、鉴权方式对比、Options 配置与 DI 注册。
FileStorage 文件存储
文件存储域 11 家供应商的 NuGet 包参考——阿里云 OSS、腾讯云 COS、华为云 OBS、AWS S3、Azure Blob、GCS、MinIO 等的配置与 IFileStore 胖接口。
CloudDrive 云盘
云盘域 6 家供应商的 NuGet 包参考——阿里云网盘、百度网盘、坚果云、Microsoft 365、够快云库、爱数 AnyShare 的配置与 ICloudDriveProvider 18 方法。
IdentityProvider 身份提供者
身份提供者域 3 家供应商的完整参考——IIdentityProviderService 13 个统一方法、鉴权方式对比、Options 配置与 DI 注册。
CRM 客户关系管理
ICrmService 统一抽象与 5 家 CRM 供应商（HubSpot、Dynamics 365、Salesforce、Zoho、销售易）的包参考。
ProjectManagement 项目管理
IProjectManagementService 统一抽象与 7 家项目管理供应商的包参考。
Ticketing 工单系统
ITicketService 统一抽象与 4 家工单系统供应商（Zendesk、禅道、Freshdesk、ServiceNow）的包参考。
ContractLifecycle 电子合同
IContractService 统一抽象与 2 家电子合同供应商（法大大、契约锁）的包参考。
Calendar 日历
ICalendarService 统一抽象与 2 家日历供应商（Google、Microsoft 365）的包参考。
HumanResources 人力资源
IHumanResourcesService 统一抽象与 2 家人力资源供应商（Moka、薪人薪事）的包参考。
EnterpriseInfo 企业信息
企业信息域 3 家供应商的 NuGet 包参考——企查查、启信宝、天眼查的配置与 IEnterpriseInfoProvider 8 方法。
Express 快递物流
快递域 7 家供应商的 NuGet 包参考——菜鸟、快递鸟、快递100、中通、中国邮政、万维易源、顺丰函证通的配置与 IExpressProvider 8 方法。
LegalDatabase 法律数据库
法律数据库域 12 家供应商的 NuGet 包参考——适配器模式统一接口，各家仅 base URL 和鉴权方式不同。
Captcha 验证码
验证码域 3 家供应商的 NuGet 包参考——阿里云验证码 2.0、腾讯天御、极验 v4 的配置与 ICaptchaProvider 接口。
Sms 短信
短信单体包概述——阿里云、腾讯云、华为云、Twilio、Vonage、云片 6 家供应商在一个 NuGet 包内，ISMS 接口与配置。