TeamWork 协同办公

Bitzsoft.Integrations.TeamWork                ← 抽象层（接口 + 异常 + 模型 + 枚举）
├── Bitzsoft.Integrations.TeamWork.DingTalk   ← 钉钉（最完整，6 个能力接口）
├── Bitzsoft.Integrations.TeamWork.WeCom      ← 企业微信（含客户联系人）
├── Bitzsoft.Integrations.TeamWork.Feishu     ← 飞书（含日历 + 文档）
├── Bitzsoft.Integrations.TeamWork.Weaver     ← 泛微（工作流 + 健康检查）
├── Bitzsoft.Integrations.TeamWork.Seeyon     ← 致远（目录占位）
├── Bitzsoft.Integrations.TeamWork.Landray    ← 蓝凌（目录占位）
└── Bitzsoft.Integrations.TeamWork.All        ← 聚合包

public class CalendarSync(ITeamWorkOrgProvider org)
{
    public async Task SyncCalendarIfSupportedAsync(CalendarEventRequest evt)
    {
        // ① 用 is 判断当前 provider 是否还实现了日历能力
        if (org is ITeamWorkCalendarProvider calendar)
        {
            var eventId = await calendar.CreateEventAsync(evt);
            return;
        }

        // ② 不具备则降级
        Log.LogWarning("当前平台 {Provider} 不支持日历，跳过同步", org.ProviderName);
    }
}

public sealed class TeamWorkException : IntegrationException
{
    public string ProviderName => Provider ?? string.Empty;     // 供应商名
    public new string? ErrorCode => base.ErrorCode;             // 供应商错误码
    public new string? ProviderMessage => base.ProviderMessage; // 供应商原始消息

    public TeamWorkException(
        string providerName, string message,
        string? errorCode = null, string? providerMessage = null,
        Exception? innerException = null)
        : base(domain: "TeamWork",
               message: $"[{providerName}] {message}",
               provider: providerName,
               errorCode: errorCode,
               providerMessage: providerMessage,
               innerException: innerException) { }
}

// ① 钉钉（配置节绑定式）
builder.Services.AddBitzsoftDingTalkTeamWork(builder.Configuration.GetSection("TeamWork:DingTalk"));

// ② 飞书
builder.Services.AddBitzsoftFeishuTeamWork(builder.Configuration.GetSection("TeamWork:Feishu"));

builder.Services.AddBitzsoftTeamWorkAll(builder.Configuration, "TeamWork");

{
  "TeamWork": {
    "DingTalk": { "AppKey": "...", "AppSecret": "...", "AgentId": 123456 },
    "Feishu":   { "AppId": "...", "AppSecret": "..." }
  }
}

services.TryAddTransient(sp => new DingTalkTeamWorkProvider(...));
var descriptor = DingTalkProviderDescriptor.Instance;
services.AddIntegrationProviderCapability<ITeamWorkOrgProvider, DingTalkTeamWorkProvider>(descriptor);
services.AddIntegrationProviderCapability<ITeamWorkMessageProvider, DingTalkTeamWorkProvider>(descriptor);
services.AddIntegrationProviderCapability<ITeamWorkTodoProvider, DingTalkTeamWorkProvider>(descriptor);
services.AddIntegrationProviderCapability<ITeamWorkApprovalProvider, DingTalkTeamWorkProvider>(descriptor);
services.AddIntegrationProviderCapability<ITeamWorkSsoProvider, DingTalkTeamWorkProvider>(descriptor);
services.AddIntegrationProviderCapability<ITeamWorkHealthProvider, DingTalkTeamWorkProvider>(descriptor);

// ① 注入需要的能力接口
public class NotificationService(ITeamWorkMessageProvider message)
{
    public async Task PushAsync(string userId, string content)
    {
        var result = await message.SendWorkNotificationAsync(new WorkNotificationRequest
        {
            ToUser = userId,
            Content = content,
        });
        // 失败时会抛 TeamWorkException，不会返回失败 Result
    }
}

// ② 能力探测：飞书有日历，钉钉没有
public class CalendarService(ITeamWorkOrgProvider org)
{
    public async Task<string?> CreateEventIfSupportedAsync(CalendarEventRequest evt)
    {
        if (org is ITeamWorkCalendarProvider calendar)
            return await calendar.CreateEventAsync(evt);
        return null;  // 当前平台不支持日历
    }
}

// ③ 多厂商：按 Provider ID 解析
public class OrgRouter(IIntegrationProviderResolver<ITeamWorkOrgProvider> orgs)
{
    public async Task<IReadOnlyList<DepartmentInfo>> GetDepartmentsAsync(string platform)
    {
        var org = orgs.GetRequired(platform);  // "dingtalk" / "wecom" / "feishu"
        return await org.GetDepartmentsAsync();
    }
}