补充注释

SimpleAdmin.Application/Services/Onboarding/Employee/Dto/OnboardingEmployeeInput.cs

@@ -1,17 +1,53 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 正式员工档案分页查询参数。
+/// </summary>
 public class OnboardingEmployeePageInput : BasePageInput
 {
+    /// <summary>
+    /// 员工姓名。
+    /// </summary>
     public string EmployeeName { get; set; }
+
+    /// <summary>
+    /// 手机号码。
+    /// </summary>
     public string Phone { get; set; }
+
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     public long? CompanyId { get; set; }
+
+    /// <summary>
+    /// 岗位 Id；为空时表示公司级配置。
+    /// </summary>
     public long? PositionId { get; set; }
 }
 
+/// <summary>
+/// 正式员工档案详情输出。
+/// </summary>
 public class OnboardingEmployeeDetailOutput
 {
+    /// <summary>
+    /// 正式员工档案。
+    /// </summary>
     public ObEmployee Employee { get; set; }
+
+    /// <summary>
+    /// 入职任务主数据。
+    /// </summary>
     public ObOnboardingTask Task { get; set; }
+
+    /// <summary>
+    /// 任务合同列表。
+    /// </summary>
     public List<ObTaskContract> Contracts { get; set; } = new List<ObTaskContract>();
+
+    /// <summary>
+    /// 提交与审核记录列表。
+    /// </summary>
     public List<ObTaskAudit> Audits { get; set; } = new List<ObTaskAudit>();
-}
+}

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

@@ -1,7 +1,16 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 定义正式员工档案查询业务能力。
+/// </summary>
 public interface IOnboardingEmployeeService : ITransient
 {
+    /// <summary>
+    /// 分页查询审核通过后生成的正式员工档案。
+    /// </summary>
     Task<SqlSugarPagedList<ObEmployee>> Page(OnboardingEmployeePageInput input);
+    /// <summary>
+    /// 查询正式员工及其来源任务、合同和审核记录。
+    /// </summary>
     Task<OnboardingEmployeeDetailOutput> Detail(BaseIdInput input);
-}
+}

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 };
     }
 }
-