代码优化

SimpleAdmin.Application/Services/Onboarding/VariableDefinition/OnboardingVariableDefinitionInput.cs

@@ -2,32 +2,79 @@
 
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 合同变量字典分页查询参数。
+/// </summary>
 public class OnboardingVariableDefinitionPageInput : BasePageInput
 {
+    /// <summary>
+    /// 变量编码或名称关键字。
+    /// </summary>
     public string Keyword { get; set; }
+
+    /// <summary>
+    /// 变量分类：employee、hr、company 或 system。
+    /// </summary>
     public string VariableCategory { get; set; }
 }
 
+/// <summary>
+/// 新增合同变量定义参数。
+/// </summary>
 public class OnboardingVariableDefinitionAddInput
 {
+    /// <summary>
+    /// 完整变量编码，例如 employee.EmployeeName 或 hr.BaseSalary。
+    /// </summary>
     [Required(ErrorMessage = "变量编码不能为空")]
     public string VariableCode { get; set; }
 
+    /// <summary>
+    /// 后台展示的变量名称。
+    /// </summary>
     [Required(ErrorMessage = "变量名称不能为空")]
     public string VariableName { get; set; }
 
+    /// <summary>
+    /// 变量分类：employee、hr、company 或 system。
+    /// </summary>
     [Required(ErrorMessage = "变量分类不能为空")]
     public string VariableCategory { get; set; }
 
+    /// <summary>
+    /// 数据类型：string、number 或 date。
+    /// </summary>
     public string DataType { get; set; } = "string";
+
+    /// <summary>
+    /// 未提供变量值时使用的默认值。
+    /// </summary>
     public string DefaultValue { get; set; }
+
+    /// <summary>
+    /// 是否必须填写。
+    /// </summary>
     public bool Required { get; set; }
+
+    /// <summary>
+    /// 展示排序值。
+    /// </summary>
     public int SortCode { get; set; } = 100;
+
+    /// <summary>
+    /// 变量用途说明。
+    /// </summary>
     public string Remark { get; set; }
 }
 
+/// <summary>
+/// 编辑合同变量定义参数。
+/// </summary>
 public class OnboardingVariableDefinitionEditInput : OnboardingVariableDefinitionAddInput
 {
+    /// <summary>
+    /// 变量定义主键。
+    /// </summary>
     [IdNotNull(ErrorMessage = "Id不能为空")]
     public long Id { get; set; }
-}
+}