补充注释

SimpleAdmin.Application/Services/Onboarding/Employee/OnboardingEmployeeService.cs

@@ -1,11 +1,17 @@
 namespace SimpleAdmin.Application;
 
 /// <summary>仅展示审核通过后创建的正式员工档案；入职资料的来源任务可追溯。</summary>
+/// <summary>
+/// 实现正式员工档案查询业务能力。
+/// </summary>
 public class OnboardingEmployeeService : IOnboardingEmployeeService
 {
     private readonly SqlSugarScope _db;
     public OnboardingEmployeeService() => _db = DbContext.DB;
 
+    /// <summary>
+    /// 分页查询审核通过后生成的正式员工档案。
+    /// </summary>
     public Task<SqlSugarPagedList<ObEmployee>> Page(OnboardingEmployeePageInput input) => _db.Queryable<ObEmployee>()
         .WhereIF(!string.IsNullOrWhiteSpace(input.EmployeeName), x => x.EmployeeName.Contains(input.EmployeeName) || x.IdCardNumber.Contains(input.EmployeeName))
         .WhereIF(!string.IsNullOrWhiteSpace(input.Phone), x => x.Phone.Contains(input.Phone))
@@ -13,6 +19,9 @@ public class OnboardingEmployeeService : IOnboardingEmployeeService
         .WhereIF(input.PositionId.HasValue, x => x.PositionId == input.PositionId.Value)
         .OrderByDescending(x => x.CreateTime).ToPagedListAsync(input.PageNum, input.PageSize);
 
+    /// <summary>
+    /// 查询正式员工及其来源任务、合同和审核记录。
+    /// </summary>
     public async Task<OnboardingEmployeeDetailOutput> Detail(BaseIdInput input)
     {
         var employee = await _db.Queryable<ObEmployee>().InSingleAsync(input.Id) ?? throw Oops.Bah("正式员工不存在");
@@ -22,4 +31,3 @@ public class OnboardingEmployeeService : IOnboardingEmployeeService
         return new OnboardingEmployeeDetailOutput { Employee = employee, Task = task, Contracts = contracts, Audits = audits };
     }
 }
-