补充注释

SimpleAdmin.Application/Services/Onboarding/EntryConfig/Dto/OnboardingEntryConfigInput.cs

@@ -1,68 +1,169 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 保存动态入职字段参数。
+/// </summary>
 public class OnboardingFormFieldSaveInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     public long? Id { get; set; }
 
+    /// <summary>
+    /// 动态字段编码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "字段编码不能为空")]
     public string FieldCode { get; set; }
 
+    /// <summary>
+    /// 动态字段名称。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "字段名称不能为空")]
     public string FieldName { get; set; }
 
+    /// <summary>
+    /// 字段或变量数据类型。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "数据类型不能为空")]
     public string DataType { get; set; }
 
+    /// <summary>
+    /// 可选项 JSON。
+    /// </summary>
     public string OptionsJson { get; set; }
+
+    /// <summary>
+    /// 字段校验规则。
+    /// </summary>
     public string ValidationRule { get; set; }
+
+    /// <summary>
+    /// 员工端输入提示。
+    /// </summary>
     public string Placeholder { get; set; }
+
+    /// <summary>
+    /// 启用状态或状态筛选条件。
+    /// </summary>
     public string Status { get; set; } = "enable";
 }
 
+/// <summary>
+/// 保存入职材料类型参数。
+/// </summary>
 public class OnboardingMaterialTypeSaveInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     public long? Id { get; set; }
 
+    /// <summary>
+    /// 材料类型编码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "资料编码不能为空")]
     public string MaterialCode { get; set; }
 
+    /// <summary>
+    /// 材料名称。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "资料名称不能为空")]
     public string MaterialName { get; set; }
 
+    /// <summary>
+    /// 允许上传的文件扩展名。
+    /// </summary>
     public string AllowedExtensions { get; set; }
+
+    /// <summary>
+    /// 允许上传的最大文件数量。
+    /// </summary>
     public int MaxFileCount { get; set; } = 1;
+
+    /// <summary>
+    /// 单个文件最大大小，单位为 MB。
+    /// </summary>
     public int? MaxFileSizeMb { get; set; }
+
+    /// <summary>
+    /// 启用状态或状态筛选条件。
+    /// </summary>
     public string Status { get; set; } = "enable";
 }
 
+/// <summary>
+/// 保存公司岗位动态字段要求参数。
+/// </summary>
 public class OnboardingFormRequirementSaveInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     public long? Id { get; set; }
 
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "公司Id不能为空")]
     public long CompanyId { get; set; }
 
+    /// <summary>
+    /// 岗位 Id；为空时表示公司级配置。
+    /// </summary>
     public long? PositionId { get; set; }
 
+    /// <summary>
+    /// 动态字段 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "字段Id不能为空")]
     public long FieldId { get; set; }
 
+    /// <summary>
+    /// 是否必填、必传或必签。
+    /// </summary>
     public bool Required { get; set; }
+
+    /// <summary>
+    /// 显示排序码。
+    /// </summary>
     public int? SortCode { get; set; }
 }
 
+/// <summary>
+/// 保存公司岗位材料要求参数。
+/// </summary>
 public class OnboardingMaterialRequirementSaveInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     public long? Id { get; set; }
 
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "公司Id不能为空")]
     public long CompanyId { get; set; }
 
+    /// <summary>
+    /// 岗位 Id；为空时表示公司级配置。
+    /// </summary>
     public long? PositionId { get; set; }
 
+    /// <summary>
+    /// 材料类型 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "资料类型Id不能为空")]
     public long MaterialTypeId { get; set; }
 
+    /// <summary>
+    /// 是否必填、必传或必签。
+    /// </summary>
     public bool Required { get; set; }
+
+    /// <summary>
+    /// 显示排序码。
+    /// </summary>
     public int? SortCode { get; set; }
 }