补充注释

SimpleAdmin.Application/Services/Onboarding/Task/Dto/OnboardingTaskInput.cs

@@ -1,20 +1,60 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 创建新员工入职任务参数。
+/// </summary>
 public class OnboardingTaskCreateInput
 {
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "公司Id不能为空")]
     public long CompanyId { get; set; }
+
+    /// <summary>
+    /// 入职任务所属岗位 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "岗位Id不能为空")]
     public long PositionId { get; set; }
+
+    /// <summary>
+    /// 创建任务时指定的审核人用户 Id。
+    /// </summary>
     public long? AssignedReviewerUserId { get; set; }
+
+    /// <summary>
+    /// 链接过期时间；实际有效期由系统配置计算。
+    /// </summary>
     public DateTime? LinkExpireAt { get; set; }
+
+    /// <summary>
+    /// 业务备注。
+    /// </summary>
     public string Remark { get; set; }
 }
 
+/// <summary>
+/// 入职任务创建结果。
+/// </summary>
 public class OnboardingTaskCreatedOutput
 {
+    /// <summary>
+    /// 入职任务 Id。
+    /// </summary>
     public long TaskId { get; set; }
+
+    /// <summary>
+    /// 入职任务编号。
+    /// </summary>
     public string TaskNo { get; set; }
+
+    /// <summary>
+    /// 新生成的员工填写链接 Token，仅在创建结果中返回。
+    /// </summary>
     public string LinkToken { get; set; }
+
+    /// <summary>
+    /// 员工填写链接过期时间。
+    /// </summary>
     public DateTime ExpiresAt { get; set; }
 }

SimpleAdmin.Application/Services/Onboarding/Task/Dto/OnboardingTaskPublicInput.cs

@@ -1,61 +1,169 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 员工端通过 Token 访问任务参数。
+/// </summary>
 public class OnboardingTaskPublicAccessInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 }
 
+/// <summary>
+/// 员工端获取合同源文件参数。
+/// </summary>
 public class OnboardingPublicContractSourceInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 
+    /// <summary>
+    /// 任务合同 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "任务合同Id不能为空")]
     public long TaskContractId { get; set; }
 }
 
+/// <summary>
+/// 员工端保存固定基础信息参数。
+/// </summary>
 public class OnboardingTaskPublicSaveInput : ObTaskEmployeeInfo
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 
+    /// <summary>
+    /// 员工姓名。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public new string EmployeeName { get; set; }
 
+    /// <summary>
+    /// 手机号码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public new string Phone { get; set; }
 
+    /// <summary>
+    /// 身份证号码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public new string IdCardNumber { get; set; }
 }
 
+/// <summary>
+/// 员工端动态字段展示信息。
+/// </summary>
 public class OnboardingPublicFormFieldOutput
 {
+    /// <summary>
+    /// 动态字段 Id。
+    /// </summary>
     public long FieldId { get; set; }
+
+    /// <summary>
+    /// 动态字段编码。
+    /// </summary>
     public string FieldCode { get; set; }
+
+    /// <summary>
+    /// 动态字段名称。
+    /// </summary>
     public string FieldName { get; set; }
+
+    /// <summary>
+    /// 字段或变量数据类型。
+    /// </summary>
     public string DataType { get; set; }
+
+    /// <summary>
+    /// 可选项 JSON。
+    /// </summary>
     public string OptionsJson { get; set; }
+
+    /// <summary>
+    /// 是否必填、必传或必签。
+    /// </summary>
     public bool Required { get; set; }
 }
 
+/// <summary>
+/// 员工端材料上传要求。
+/// </summary>
 public class OnboardingPublicMaterialOutput
 {
+    /// <summary>
+    /// 材料类型 Id。
+    /// </summary>
     public long MaterialTypeId { get; set; }
+
+    /// <summary>
+    /// 材料名称。
+    /// </summary>
     public string MaterialName { get; set; }
+
+    /// <summary>
+    /// 允许上传的文件扩展名。
+    /// </summary>
     public string AllowedExtensions { get; set; }
+
+    /// <summary>
+    /// 允许上传的最大文件数量。
+    /// </summary>
     public int MaxFileCount { get; set; }
+
+    /// <summary>
+    /// 是否必填、必传或必签。
+    /// </summary>
     public bool Required { get; set; }
 }
 
+/// <summary>
+/// 员工端入职任务完整详情。
+/// </summary>
 public class OnboardingTaskPublicDetailOutput
 {
+    /// <summary>
+    /// 入职任务主数据。
+    /// </summary>
     public ObOnboardingTask Task { get; set; }
+
+    /// <summary>
+    /// 候选人固定基础信息。
+    /// </summary>
     public ObTaskEmployeeInfo EmployeeInfo { get; set; }
+
+    /// <summary>
+    /// 任务合同列表。
+    /// </summary>
     public List<ObTaskContract> Contracts { get; set; }
+
+    /// <summary>
+    /// 候选人已保存的动态字段值。
+    /// </summary>
     public List<ObTaskFormValue> DynamicValues { get; set; }
+
+    /// <summary>
+    /// 员工端需要展示的动态字段。
+    /// </summary>
     public List<OnboardingPublicFormFieldOutput> FormFields { get; set; }
+
+    /// <summary>
+    /// 员工端需要展示的材料要求。
+    /// </summary>
     public List<OnboardingPublicMaterialOutput> MaterialRequirements { get; set; }
+
+    /// <summary>
+    /// 候选人已上传材料列表。
+    /// </summary>
     public List<ObTaskMaterial> Materials { get; set; }
 }