namespace SimpleAdmin.Application;

/// <summary>
/// 定义合同模板、DOCX 版本和自动识别变量的管理能力。
/// </summary>
public interface IOnboardingContractTemplateService : ITransient
{
    /// <summary>
    /// 分页查询合同模板主档案。
    /// </summary>
    Task<SqlSugarPagedList<ObContractTemplate>> Page(OnboardingContractTemplatePageInput input);

    /// <summary>
    /// 查询合同模板详情。
    /// </summary>
    Task<ObContractTemplate> Detail(BaseIdInput input);

    /// <summary>
    /// 查询同时适用于指定公司、部门和全部已选岗位的启用合同模板。
    /// </summary>
    Task<List<ObContractTemplate>> ListAvailable(OnboardingContractTemplateAvailableInput input);

    /// <summary>
    /// 新增合同模板主档案。
    /// </summary>
    Task Add(OnboardingContractTemplateAddInput input);

    /// <summary>
    /// 编辑合同模板主档案。
    /// </summary>
    Task Edit(OnboardingContractTemplateEditInput input);

    /// <summary>
    /// 删除未被版本、入职模板或任务合同引用的模板。
    /// </summary>
    Task Delete(BaseIdListInput input);

    /// <summary>
    /// 分页查询指定合同模板的版本。
    /// </summary>
    Task<SqlSugarPagedList<ObContractTemplateVersion>> VersionPage(OnboardingContractVersionPageInput input);

    /// <summary>
    /// 新增合同模板 DOCX 版本并自动识别变量。
    /// </summary>
    Task AddVersion(OnboardingContractVersionAddInput input);

    /// <summary>
    /// 启用或停用合同模板版本。
    /// </summary>
    Task SetVersionStatus(OnboardingContractVersionStatusInput input);

    /// <summary>
    /// 修改合同模板版本的盖章配置，仅影响后续新建任务。
    /// </summary>
    Task SetVersionSeals(OnboardingContractVersionSealInput input);

    /// <summary>
    /// 删除未被入职模板或任务使用的合同版本。
    /// </summary>
    Task DeleteVersion(BaseIdInput input);

    /// <summary>
    /// 分页查询指定模板版本自动识别出的变量。
    /// </summary>
    Task<SqlSugarPagedList<ObTemplateVariable>> VariablePage(OnboardingTemplateVariablePageInput input);

    /// <summary>
    /// 编辑并确认模板版本中的变量定义。
    /// </summary>
    Task EditVariable(OnboardingTemplateVariableEditInput input);
}