补充注释

SimpleAdmin.Application/Services/Onboarding/PublicTask/OnboardingPublicTaskService.cs

@@ -15,6 +15,9 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
         _snapshotService = snapshotService;
     }
 
+    /// <summary>
+    /// 通过有效 Token 获取员工端任务、字段、材料和合同信息。
+    /// </summary>
     public async Task<OnboardingTaskPublicDetailOutput> Detail(OnboardingTaskPublicAccessInput input)
     {
         var link = await GetActiveLink(input.Token);
@@ -77,6 +80,9 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
         };
     }
 
+    /// <summary>
+    /// 保存候选人固定基础信息并刷新合同变量快照。
+    /// </summary>
     public async Task SaveEmployeeInfo(OnboardingTaskPublicSaveInput input)
     {
         var link = await GetActiveLink(input.Token);
@@ -103,6 +109,9 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
         await _snapshotService.Build(task.Id, entity);
     }
 
+    /// <summary>
+    /// 校验任务归属后返回合同模板源文件 Id。
+    /// </summary>
     public async Task<long> GetContractSourceFileId(OnboardingPublicContractSourceInput input)
     {
         var link = await GetActiveLink(input.Token);
@@ -121,6 +130,7 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
             .Where(x => x.CompanyId == task.CompanyId && (x.PositionId == null || x.PositionId == task.PositionId))
             .ToListAsync();
 
+        // 同一字段同时存在公司级和岗位级配置时，岗位配置覆盖公司默认配置。
         return requirements
             .GroupBy(x => x.FieldId)
             .Select(group => group.FirstOrDefault(x => x.PositionId == task.PositionId) ?? group.First())
@@ -133,6 +143,7 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
             .Where(x => x.CompanyId == task.CompanyId && (x.PositionId == null || x.PositionId == task.PositionId))
             .ToListAsync();
 
+        // 同一材料同时存在公司级和岗位级配置时，岗位配置覆盖公司默认配置。
         return requirements
             .GroupBy(x => x.MaterialTypeId)
             .Select(group => group.FirstOrDefault(x => x.PositionId == task.PositionId) ?? group.First())
@@ -153,5 +164,3 @@ public class OnboardingPublicTaskService : IOnboardingPublicTaskService
         return link;
     }
 }
-
-