using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using BitzOrcas.Domain.Results;

namespace BitzOrcas.Platform.LegalConnectors.Contracts;

/// <summary>
/// 外部案件进展与裁判文书抓取记录
/// </summary>
public sealed record ExternalCourtCaseRecord(
    string CaseNumber,
    string CourtName,
    string CaseStatus,
    string JudgeName,
    string HearingDateText,
    IReadOnlyList<string> Litigants
);

/// <summary>
/// 律政数据连接器统一抽象端口
/// </summary>
public interface ILegalCourtConnectorPort
{
    /// <summary>
    /// 根据案号同步法院最新审判流程状态
    /// </summary>
    Task<Result<ExternalCourtCaseRecord>> FetchCaseProgressAsync(
        string caseNumber,
        string courtCode,
        CancellationToken cancellationToken = default);

    /// <summary>
    /// 根据企业主体名称或统一社会信用代码检索历史涉诉记录
    /// </summary>
    Task<Result<IReadOnlyList<ExternalCourtCaseRecord>>> SearchLitigationHistoryAsync(
        string entityName,
        string unifiedSocialCreditCode,
        CancellationToken cancellationToken = default);
}