OnboardXAdmin/SimpleAdmin.Application/Services/Onboarding/Employee/Dto/OnboardingEmployeeInput.cs

using System.ComponentModel.DataAnnotations;

namespace SimpleAdmin.Application;

/// <summary>
/// 正式员工档案分页查询参数。
/// </summary>
public class OnboardingEmployeePageInput : BasePageInput
{
    /// <summary>
    /// 员工姓名。
    /// </summary>
    public string EmployeeName { get; set; }

    /// <summary>
    /// 手机号码。
    /// </summary>
    public string Phone { get; set; }

    /// <summary>
    /// 入职业务公司 Id。
    /// </summary>
    public long? CompanyId { get; set; }

    /// <summary>
    /// 入职业务部门 Id。
    /// </summary>
    public long? DepartmentId { get; set; }

    /// <summary>
    /// 岗位 Id。
    /// </summary>
    public long? PositionId { get; set; }

    /// <summary>
    /// 用工类型。
    /// </summary>
    public string EmploymentType { get; set; }

    /// <summary>
    /// 转正状态。
    /// </summary>
    public string RegularizationStatus { get; set; }

    /// <summary>
    /// 社保状态。
    /// </summary>
    public string SocialInsuranceStatus { get; set; }

    /// <summary>
    /// 合同即将到期筛选（30天内到期或已到期）。
    /// </summary>
    public bool? ContractExpiringSoon { get; set; }
}

/// <summary>
/// 正式员工档案分页数据及当前查询条件下的维度统计。
/// </summary>
public class OnboardingEmployeePageOutput : SqlSugarPagedList<ObEmployee>
{
    /// <summary>
    /// 不受快捷维度筛选影响的员工维度统计。
    /// </summary>
    public OnboardingEmployeeStatisticsOutput Statistics { get; set; } = new();
}

/// <summary>
/// 正式员工档案维度统计。
/// </summary>
public class OnboardingEmployeeStatisticsOutput
{
    /// <summary>
    /// 在册总数。
    /// </summary>
    public int Total { get; set; }

    /// <summary>
    /// 正式员工数量。
    /// </summary>
    public int FullTime { get; set; }

    /// <summary>
    /// 兼职员工数量。
    /// </summary>
    public int PartTime { get; set; }

    /// <summary>
    /// 试用期待转正数量。
    /// </summary>
    public int Probation { get; set; }

    /// <summary>
    /// 社保已缴纳数量。
    /// </summary>
    public int SocialPurchased { get; set; }

    /// <summary>
    /// 合同即将到期数量（30天内到期或已到期）。
    /// </summary>
    public int ExpiringContract { get; set; }
}

/// <summary>
/// 编辑员工人事信息。
/// </summary>
public class OnboardingEmployeeHrUpdateInput
{
    [IdNotNull(ErrorMessage = "员工Id不能为空")]
    public long Id { get; set; }

    [Required(ErrorMessage = "请选择用工类型")]
    public string EmploymentType { get; set; }

    public string ContractNature { get; set; }

    [Required(ErrorMessage = "请选择社保状态")]
    public string SocialInsuranceStatus { get; set; }

    public string SocialInsuranceCompany { get; set; }
}

/// <summary>
/// 员工转正办理参数。
/// </summary>
public class OnboardingEmployeeRegularizeInput
{
    [IdNotNull(ErrorMessage = "员工Id不能为空")]
    public long Id { get; set; }

    [Required(ErrorMessage = "请选择转正日期")]
    public DateTime? RegularizationDate { get; set; }

    public string Remark { get; set; }

    public List<long> FileIds { get; set; } = new();
}

/// <summary>
/// 撤销员工转正参数。
/// </summary>
public class OnboardingEmployeeRegularizationRevokeInput
{
    [IdNotNull(ErrorMessage = "员工Id不能为空")]
    public long Id { get; set; }

    [Required(ErrorMessage = "请填写撤销原因")]
    public string Remark { get; set; }
}

/// <summary>
/// 正式员工档案导出结果。
/// </summary>
public class OnboardingEmployeeExportFile
{
    /// <summary>
    /// Excel 文件字节。
    /// </summary>
    public byte[] FileBytes { get; set; }

    /// <summary>
    /// 下载文件名。
    /// </summary>
    public string FileName { get; set; }
}

/// <summary>
/// 正式员工档案详情输出。
/// </summary>
public class OnboardingEmployeeDetailOutput
{
    /// <summary>
    /// 正式员工档案。
    /// </summary>
    public ObEmployee Employee { get; set; }

    /// <summary>
    /// 审核通过时对应的完整入职登记表。
    /// </summary>
    public ObTaskEmployeeInfo EmployeeInfo { get; set; }

    /// <summary>
    /// 入职任务主数据。
    /// </summary>
    public ObOnboardingTask Task { get; set; }

    /// <summary>
    /// 任务合同列表。
    /// </summary>
    public List<ObTaskContract> Contracts { get; set; } = new List<ObTaskContract>();

    /// <summary>
    /// 审核建档时冻结的员工合同业务快照，包含常用字段及全部自定义变量。
    /// </summary>
    public List<ObEmployeeContractSnapshot> ContractSnapshots { get; set; }
        = new List<ObEmployeeContractSnapshot>();

    /// <summary>
    /// 员工入职时上传的身份证、学历证明、体检报告等资料。
    /// </summary>
    public List<OnboardingTaskMaterialDetailOutput> Materials { get; set; }
        = new List<OnboardingTaskMaterialDetailOutput>();

    /// <summary>
    /// 契约锁签署文件与签署日志组成的完整归档 ZIP 文件 Id。
    /// </summary>
    public long? ElectronicSignArchiveFileId { get; set; }

    /// <summary>
    /// 提交与审核记录列表。
    /// </summary>
    public List<ObTaskAudit> Audits { get; set; } = new List<ObTaskAudit>();

    /// <summary>
    /// 员工转正及人事维护历史。
    /// </summary>
    public List<ObEmployeeChangeRecord> ChangeRecords { get; set; }
        = new List<ObEmployeeChangeRecord>();
}