namespace SimpleAdmin.Application;

/// <summary>
/// 定义员工端入职任务访问业务能力。
/// </summary>
public interface IOnboardingPublicTaskService : ITransient
{
    /// <summary>
    /// 通过有效 Token 获取员工端任务、字段、材料和合同信息。
    /// </summary>
    Task<OnboardingTaskPublicDetailOutput> Detail(OnboardingTaskPublicAccessInput input);
    /// <summary>
    /// 保存候选人固定基础信息并刷新合同变量快照。
    /// </summary>
    Task SaveEmployeeInfo(OnboardingTaskPublicSaveInput input);
    /// <summary>
    /// 校验合同变量并提前生成候选人的合同 DOCX。
    /// </summary>
    Task<OnboardingPublicContractPrepareOutput> PrepareContract(
        OnboardingPublicContractSourceInput input);

    /// <summary>
    /// 校验任务归属后返回已经准备完成的合同文件 Id。
    /// </summary>
    Task<long> GetContractSourceFileId(OnboardingPublicContractSourceInput input);

    /// <summary>
    /// 校验 Token 和任务归属后返回已上传材料的文件信息。
    /// </summary>
    Task<OnboardingPublicTaskMaterialOutput> GetMaterialSource(
        OnboardingPublicMaterialSourceInput input);
}