补充注释

SimpleAdmin.Application/Services/Onboarding/PublicSubmission/OnboardingPublicSubmissionService.cs

@@ -1,5 +1,8 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 实现员工端入职资料提交业务能力。
+/// </summary>
 public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionService
 {
     private readonly SqlSugarScope _db;
@@ -12,6 +15,9 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         _snapshotService = snapshotService;
     }
 
+    /// <summary>
+    /// 保存候选人填写的动态字段值。
+    /// </summary>
     public async Task SaveDynamicValues(OnboardingSaveDynamicValuesInput input)
     {
         var task = await GetEditableTask(input.Token);
@@ -52,6 +58,9 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         }
     }
 
+    /// <summary>
+    /// 关联候选人已经上传的系统文件与材料类型。
+    /// </summary>
     public async Task SaveMaterial(OnboardingSaveMaterialInput input)
     {
         var task = await GetEditableTask(input.Token);
@@ -84,6 +93,9 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         }).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 记录候选人已阅读并确认指定任务合同。
+    /// </summary>
     public async Task ConfirmContract(OnboardingConfirmContractInput input)
     {
         var task = await GetEditableTask(input.Token);
@@ -97,6 +109,9 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         await _db.Updateable(contract).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 校验全部必填资料后提交入职任务进入审核。
+    /// </summary>
     public async Task Submit(OnboardingSubmitInput input)
     {
         var task = await GetEditableTask(input.Token);
@@ -111,6 +126,7 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
 
         await _snapshotService.Build(task.Id, info);
 
+        // 提交时统一完成动态字段、材料、合同变量和合同确认校验，保存阶段只负责暂存。
         var requiredFields = (await GetEffectiveFormRequirements(task))
             .Where(item => item.Required)
             .Select(item => item.FieldId)
@@ -160,6 +176,9 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         }).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 在保存文件前校验材料适用范围、扩展名、大小和数量。
+    /// </summary>
     public async Task ValidateMaterialUpload(OnboardingMaterialUploadValidationInput input)
     {
         var task = await GetEditableTask(input.Token);
@@ -262,5 +281,3 @@ public class OnboardingPublicSubmissionService : IOnboardingPublicSubmissionServ
         return task;
     }
 }
-
-