namespace SimpleAdmin.Application;

/// <summary>
/// 定义入职合同文件生成能力。
/// </summary>
public interface IOnboardingContractDocumentService : ITransient
{
    /// <summary>
    /// 创建入职任务前，根据人事当前填写的参数生成临时 DOCX 预览。
    /// </summary>
    Task<OnboardingContractPreviewOutput> PreviewBeforeCreate(
        OnboardingContractPreviewInput input);

    /// <summary>
    /// 创建入职任务前，按模板顺序生成全部合同预览并打包为 ZIP。
    /// </summary>
    Task<OnboardingContractPreviewOutput> PreviewAllBeforeCreate(
        OnboardingContractPreviewInput input);

    /// <summary>
    /// 根据已审核通过的任务合同生成并保存 DOCX 文件。
    /// </summary>
    Task<long> Generate(OnboardingGenerateContractInput input);

    /// <summary>
    /// 员工公开入口已验证一次性任务链接后，生成该链接所属的合同文件。
    /// </summary>
    Task<long> GenerateForPublicAccess(long taskContractId, long taskId);
}