namespace SimpleAdmin.Application;

/// <summary>
/// 定义入职电子签流程管理能力。
/// </summary>
public interface IOnboardingElectronicSignService : ITransient
{
    /// <summary>查询指定入职任务的电子签详情。</summary>
    Task<OnboardingElectronicSignDetailOutput> Detail(BaseIdInput input);

    /// <summary>创建或重试电子签流程。</summary>
    Task<OnboardingElectronicSignDetailOutput> Initiate(
        OnboardingElectronicSignTaskInput input);

    /// <summary>保留旧流程并创建一次全新的电子签流程。</summary>
    Task<OnboardingElectronicSignDetailOutput> Reinitiate(
        OnboardingElectronicSignReinitiateInput input);

    /// <summary>主动同步契约锁状态并在完成后归档。</summary>
    Task<OnboardingElectronicSignDetailOutput> Sync(
        OnboardingElectronicSignTaskInput input);

    /// <summary>获取或刷新员工签署地址。</summary>
    Task<OnboardingElectronicSignDetailOutput> GetSignLink(
        OnboardingElectronicSignTaskInput input);

    /// <summary>催办当前待签员工。</summary>
    Task Notice(OnboardingElectronicSignTaskInput input);

    /// <summary>作废尚未结束的签约流程。</summary>
    Task Invalid(OnboardingElectronicSignInvalidInput input);

    /// <summary>处理契约锁服务器明文回调。</summary>
    Task HandleCallback(string payloadJson);
}