Finance 财务（嵌套域）

Finance（公共基础）
│   └── FinanceException.cs              ← 共享领域异常（domain = "Finance"）
│
├── Finance.Invoice                      ← 发票子域
│   ├── Finance.Invoice.Baiwang             ← 百望
│   ├── Finance.Invoice.Kingdee             ← 金蝶
│   ├── Finance.Invoice.Nuonuo              ← 诺诺
│   └── Finance.Invoice.All                 ← 发票聚合（3 厂商）
│
├── Finance.Tax                          ← 税务子域
│   └── Finance.Tax.QiXiangYun              ← 企享云
│
├── Finance.Payroll                      ← 薪酬子域
│   └── Finance.Payroll.All                 ← 薪酬聚合（暂无厂商实现）
│
└── Finance.All                          ← 总聚合（拉入全部子域）

public class FinanceException : IntegrationException
{
    public string  ProviderName    => Provider ?? string.Empty;
    public new string? ErrorCode    => base.ErrorCode;
    public new string? ProviderMessage => base.ProviderMessage;

    // 消息格式: "[{providerName}] {message}"
    public FinanceException(string providerName, string message,
        string? errorCode = null, string? providerMessage = null,
        Exception? innerException = null) : base(domain: "Finance", ...) { }
}

public interface IInvoiceProvider
{
    string ProviderName { get; }

    // 开票
    Task<InvoiceIssueResult> IssueAsync(InvoiceIssueRequest request, CancellationToken ct = default);
    Task<InvoiceIssueResult> RedFlushAsync(InvoiceRedFlushRequest request, CancellationToken ct = default);
    Task CancelAsync(string? invoiceCode, string invoiceNumber, CancellationToken ct = default);

    // 查询与查验
    Task<InvoiceQueryResult>   QueryAsync(DateTime? startDate = null, DateTime? endDate = null, int pageIndex = 1, int pageSize = 20, CancellationToken ct = default);
    Task<InvoiceVerifyResult>  VerifyAsync(InvoiceVerifyRequest request, CancellationToken ct = default);
    Task<InvoiceInfo>          GetDetailAsync(string? invoiceCode, string invoiceNumber, CancellationToken ct = default);

    // 交付
    Task DeliverAsync(InvoiceDeliveryRequest request, CancellationToken ct = default);
}

// 使用前检查能力
if (invoice is IInvoiceOcrProvider ocr)
{
    var result = await ocr.RecognizeInvoiceAsync(imageBytes);
    // 处理 OCR 结果...
}

public class TaxApiResult<T>
{
    public bool   Success   { get; set; }
    public string? Code     { get; set; }
    public string? Message  { get; set; }
    public T?     Data      { get; set; }
    public long?  Timestamp { get; set; }
}

public class TaxException : Exception
{
    public string? ErrorCode    { get; }   // 错误码
    public string? ErrorDetail  { get; }   // 错误详情

    public TaxException(string message, string? errorCode = null, string? errorDetail = null) : base(message) { }
}

public interface IPayrollProvider
{
    string ProviderName { get; }

    // 薪资计算
    Task<PayrollCalculationResult> CalculateAsync(PayrollCalculationRequest request, CancellationToken ct = default);
    Task<TaxCalculationResult>     CalculateTaxAsync(TaxCalculationRequest request, CancellationToken ct = default);

    // 代发
    Task<SalaryDisbursementResult> DisburseAsync(SalaryDisbursementRequest request, CancellationToken ct = default);
    Task<SalaryDisbursementResult> GetDisbursementStatusAsync(string batchId, CancellationToken ct = default);

    // 社保
    Task<SocialInsuranceResult> EnrollAsync(SocialInsuranceRequest request, CancellationToken ct = default);   // 参保
    Task<SocialInsuranceResult> SuspendAsync(SocialInsuranceRequest request, CancellationToken ct = default);  // 停保
    Task<SocialInsuranceResult> DeclareAsync(SocialInsuranceRequest request, CancellationToken ct = default);  // 申报

    // 工资单
    Task SendPayslipAsync(string employeeId, string period, CancellationToken ct = default);  // period 格式 yyyy-MM
}

// ① 发票——百望
builder.Services.AddBitzsoftBaiwangInvoice(builder.Configuration.GetSection("Finance:Invoice:Baiwang"));

// ② 发票——金蝶
builder.Services.AddBitzsoftKingdeeInvoice(builder.Configuration.GetSection("Finance:Invoice:Kingdee"));

// ③ 发票——诺诺
builder.Services.AddBitzsoftNuonuoInvoice(builder.Configuration.GetSection("Finance:Invoice:Nuonuo"));

// 税务——企享云
builder.Services.AddBitzsoftQiXiangYunTax(builder.Configuration.GetSection("Finance:Tax:QiXiangYun"));

// ① 发票全厂商聚合（百望/金蝶/诺诺按配置注册）
builder.Services.AddBitzsoftInvoiceAll(builder.Configuration, "Finance:Invoice");

// ② 薪酬聚合（当前无厂商，仅注册抽象层）
builder.Services.AddBitzsoftPayrollAll(builder.Configuration, "Finance:Payroll");

// 拉入发票 + 税务 + 薪酬全部子域
builder.Services.AddBitzsoftFinanceAll(builder.Configuration, "Finance");

{
  "Finance": {
    "Invoice": {
      "Baiwang": { "AppKey": "...", "AppSecret": "...", "TaxNumber": "..." },
      "Nuonuo":  { "AccessToken": "...", "UserTax": "..." }
    },
    "Tax": {
      "QiXiangYun": { "ApiKey": "...", "ApiSecret": "..." }
    }
  }
}

public class InvoiceService(IInvoiceProvider invoice)
{
    public async Task<InvoiceIssueResult> IssueAsync()
    {
        return await invoice.IssueAsync(new InvoiceIssueRequest
        {
            OrderNo = "ORD-20260801-001",
            InvoiceType = InvoiceType.DigitalNormal,
            Buyer = new BuyerInfo { Name = "买方公司", TaxNumber = "91...", Email = "finance@example.com" },
            Items = [new InvoiceItem { GoodsName = "咨询服务", Price = 10000m, Quantity = 1, TaxRate = 0.06m }],
            PushMode = InvoiceDeliveryMethod.Email,
        });
    }
}

public class InvoiceOcrService(IInvoiceProvider invoice)
{
    public async Task<OCRResult?> RecognizeAsync(byte[] image)
    {
        // 使用前检查能力探针
        if (invoice is not IInvoiceOcrProvider ocr) return null;
        return await ocr.RecognizeInvoiceAsync(image);
    }
}

public class TaxRiskService(ITaxDataQueryProvider dataQuery)
{
    public async Task<TaxApiResult<object>> CheckRiskAsync(string taxNumber)
    {
        var result = await dataQuery.QueryEnterpriseRiskAsync(taxNumber);
        if (!result.Success)
            throw new TaxException(result.Message ?? "查询失败", errorCode: result.Code);
        return result;
    }
}

public class PayrollService(IPayrollProvider payroll)
{
    public async Task<PayrollCalculationResult> CalculateAsync(PayrollCalculationRequest request)
    {
        return await payroll.CalculateAsync(request);
    }
}