补充注释

SimpleAdmin.Application/Services/Onboarding/PublicSubmission/Dto/OnboardingMaterialUploadValidationInput.cs

@@ -1,9 +1,27 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 员工端材料上传前校验参数。
+/// </summary>
 public class OnboardingMaterialUploadValidationInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     public string Token { get; set; }
+
+    /// <summary>
+    /// 材料类型 Id。
+    /// </summary>
     public long MaterialTypeId { get; set; }
+
+    /// <summary>
+    /// 待上传文件名称。
+    /// </summary>
     public string FileName { get; set; }
+
+    /// <summary>
+    /// 待上传文件大小，单位为字节。
+    /// </summary>
     public long FileLength { get; set; }
 }

SimpleAdmin.Application/Services/Onboarding/PublicSubmission/Dto/OnboardingPublicSubmissionInput.cs

@@ -1,38 +1,85 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 单个动态字段填写值。
+/// </summary>
 public class OnboardingDynamicValueInput
 {
+    /// <summary>
+    /// 动态字段 Id。
+    /// </summary>
     public long FieldId { get; set; }
+
+    /// <summary>
+    /// 动态字段填写值。
+    /// </summary>
     public string FieldValue { get; set; }
 }
 
+/// <summary>
+/// 批量保存员工动态字段参数。
+/// </summary>
 public class OnboardingSaveDynamicValuesInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 
+    /// <summary>
+    /// 待保存的字段或变量值集合。
+    /// </summary>
     public List<OnboardingDynamicValueInput> Values { get; set; } = new();
 }
 
+/// <summary>
+/// 保存员工已上传材料参数。
+/// </summary>
 public class OnboardingSaveMaterialInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 
+    /// <summary>
+    /// 材料类型 Id。
+    /// </summary>
     public long MaterialTypeId { get; set; }
+
+    /// <summary>
+    /// 系统文件 Id。
+    /// </summary>
     public long FileId { get; set; }
 }
 
+/// <summary>
+/// 员工确认阅读合同参数。
+/// </summary>
 public class OnboardingConfirmContractInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 
+    /// <summary>
+    /// 任务合同 Id。
+    /// </summary>
     public long TaskContractId { get; set; }
 }
 
+/// <summary>
+/// 员工提交入职资料参数。
+/// </summary>
 public class OnboardingSubmitInput
 {
+    /// <summary>
+    /// 员工填写链接中的明文 Token。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required]
     public string Token { get; set; }
 }