Bitzsoft.Integrations.LegalDatabase 1.0.0-alpha.10

Bitzsoft.Integrations.LegalDatabase

法规案例库统一抽象层 — 通过 ILegalDatabaseProvider 接口屏蔽各供应商差异。

功能特性

• 统一接口 ILegalDatabaseProvider：屏蔽各法规案例库供应商的差异，一套类型覆盖 SSO 跳转、API 检索、文档详情
• SsoRedirectLegalDatabaseProvider 适配器：将大部分仅需 SSO 跳转的供应商桥接到 Bitzsoft.Integrations.SsoRedirect 配置驱动管道（URL 模板 / AES 加密 / API 重定向 / 自定义 Pipeline）
• 功能标志 LegalDatabaseCapabilities：AccessUrl、Search、DocumentDetail，运行时可查询供应商支持哪些能力
• 统一结果模型：LegalDatabaseAccessUrl（Url + ExpiresAt）、LegalSearchResult（分页 + LegalDocument 列表）、LegalDocument（标准化文档）
• LegalDatabaseResult<T> / LegalDatabaseException：统一封装成功/失败与供应商原始错误码
• 第三方请求日志：API 调用型供应商接入 Bitzsoft.Integrations.RequestLogging 出站请求记录管道

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.LegalDatabase

PackageReference

<PackageReference Include="Bitzsoft.Integrations.LegalDatabase" Version="1.0.0" />

该包为抽象层，通常无需直接引用 — 安装具体供应商包（如 Bitzsoft.Integrations.LegalDatabase.WkInfo）即会传递依赖。

架构

ILegalDatabaseProvider
    ├── SsoRedirectLegalDatabaseProvider（适配器，配置驱动）
    │       └── 委托给 Bitzsoft.Integrations.SsoRedirect 管道
    │           ├── UrlTemplate 模式（法信 / 聚法 / 无讼 / 把手 / 律商联讯）
    │           ├── AesEncryption 模式（威科先行）
    │           ├── Pipeline 模式（见微数据：RSA → API → MD5）
    │           └── 本地签名（MetaLaw SM3）
    └── 专用 Provider（各供应商包内实现，支持 API 检索）
            ├── PkulawLegalDatabaseProvider（AlphaData / AlphaGPT / REST API）
            ├── YuandianLegalDatabaseProvider（REST API）
            ├── DelilegalLegalDatabaseProvider（AI 智能检索 API）
            └── IncopatLegalDatabaseProvider（专利检索 REST API）

大部分法规案例库供应商仅需 SSO 跳转，通过 SsoRedirectLegalDatabaseProvider 适配器桥接到 SsoRedirect 的配置驱动管道，各供应商包只需十几行 DI 注册代码。少数提供开放 API 的供应商（北大法宝、元典、得理法搜、incoPat）在各自包内实现专用 Provider。

供应商矩阵

Jianwei、Pkulaw、Yuandian、Delilegal、Incopat 的 HttpClient 已接入 RequestLogging 出站请求日志。纯跳转型供应商（WkInfo、Faxin、Jufaanli、Wusong、Lawsdata、Lexisnexis、Metalaw）不涉及外部 HTTP 调用。

注册服务

AddBitzsoftSsoRedirectLegalDatabase 用于配置驱动的 SSO 跳转型供应商（UrlTemplate / AesEncryption / ApiRedirect / Pipeline）：

using Bitzsoft.Integrations.LegalDatabase;

// 委托配置
builder.Services.AddBitzsoftSsoRedirectLegalDatabase(options =>
{
    options.ProviderName = "法天使";
    options.AuthMode = SsoAuthMode.UrlTemplate;
    options.SsoUrlTemplate = "https://example.com/sso?uid={userId}&token={token}&t={timestamp}";
    options.Token = "your-sso-token";
});

// 从 IConfiguration 绑定（默认节 LegalDatabase:SsoRedirect）
builder.Services.AddBitzsoftSsoRedirectLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:SsoRedirect"));

各具体供应商通过各自的 AddBitzsoft*LegalDatabase 扩展注册（详见各供应商包 README）：

// 单个供应商（委托配置）
builder.Services.AddBitzsoftWkInfoLegalDatabase(options =>
{
    options.AppId = "your-app-id";
    options.AppSecret = "your-app-secret";
});

// 单个供应商（从 IConfiguration 绑定）
builder.Services.AddBitzsoftPkulawLegalDatabase(
    builder.Configuration.GetSection("LegalDatabase:Pkulaw"));

// 一键注册全部 12 家供应商
builder.Services.AddBitzsoftLegalDatabase(builder.Configuration);

使用示例

生成 SSO 访问链接

using Bitzsoft.Integrations.LegalDatabase;

public class LoginService
{
    private readonly ILegalDatabaseProvider _provider;

    public LoginService(ILegalDatabaseProvider provider) => _provider = provider;

    public async Task<string> GetAccessUrlAsync(string userId)
    {
        var access = await _provider.GenerateAccessUrlAsync(userId);
        return access.Url;        // 带 SSO 参数的访问链接
        // access.ExpiresAt;      // 链接过期时间
    }

    // 跳转到指定页面
    public async Task<string> GetAccessUrlAsync(string userId, string targetPage)
    {
        var access = await _provider.GenerateAccessUrlAsync(userId, targetPage);
        return access.Url;
    }
}

API 检索（仅 Search 能力供应商可用）

using Bitzsoft.Integrations.LegalDatabase.Enums;

// 运行时判断供应商是否支持检索
if ((_provider.Capabilities & LegalDatabaseCapabilities.Search) != 0)
{
    var result = await _provider.SearchAsync(
        "合同纠纷", LegalSearchType.Case, pageIndex: 1, pageSize: 20);

    Console.WriteLine($"共 {result.TotalCount} 条");
    foreach (var doc in result.Items)
    {
        Console.WriteLine($"{doc.Id}  {doc.Title}  ({doc.DocumentType})");
    }
}

获取文档详情（仅 DocumentDetail 能力供应商可用）

var doc = await _provider.GetDocumentAsync("DOC-123456");
Console.WriteLine(doc.Title);
Console.WriteLine(doc.Summary);
Console.WriteLine(doc.SourceUrl);

纯跳转型供应商调用 SearchAsync / GetDocumentAsync 会抛出 NotSupportedException。

请求审计

API 调用型供应商（Jianwei、Pkulaw、Yuandian、Delilegal、Incopat）的命名 HttpClient 已接入 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认使用 NullRequestLogStore 不持久化。宿主注册 IRequestLogStore 实现后，所有出站请求自动落库。

// 持久化：注册 IRequestLogStore 实现后，出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("AppSecret");
});

核心类型一览

依赖

相关包

• Bitzsoft.Integrations.LegalDatabase.All -- 全部 12 家供应商聚合包（一键注册）
• Bitzsoft.Integrations.LegalDatabase.WkInfo -- 威科先行（AES-ECB 加密 SSO）
• Bitzsoft.Integrations.LegalDatabase.Faxin -- 法信（UrlTemplate SSO）
• Bitzsoft.Integrations.LegalDatabase.Jufaanli -- 聚法案例（UrlTemplate SSO）
• Bitzsoft.Integrations.LegalDatabase.Wusong -- 无讼（UrlTemplate SSO）
• Bitzsoft.Integrations.LegalDatabase.Lawsdata -- 把手案例（UrlTemplate SSO）
• Bitzsoft.Integrations.LegalDatabase.Lexisnexis -- 律商联讯（UrlTemplate SSO）
• Bitzsoft.Integrations.LegalDatabase.Metalaw -- MetaLaw（SM3 签名 SSO）
• Bitzsoft.Integrations.LegalDatabase.Jianwei -- 见微数据（RSA → API → MD5 Pipeline）
• Bitzsoft.Integrations.LegalDatabase.Pkulaw -- 北大法宝（SSO + AlphaData/AlphaGPT + REST API）
• Bitzsoft.Integrations.LegalDatabase.Yuandian -- 元典（REST API 检索）
• Bitzsoft.Integrations.LegalDatabase.Delilegal -- 得理法搜（AI 智能检索 API）
• Bitzsoft.Integrations.LegalDatabase.Incopat -- incoPat（专利检索 REST API）