补充注释

SimpleAdmin.Application/Services/Onboarding/TaskQuery/Dto/OnboardingTaskQueryInput.cs

@@ -1,17 +1,63 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 入职任务分页查询参数。
+/// </summary>
 public class OnboardingTaskPageInput : BasePageInput
 {
+    /// <summary>
+    /// 入职任务编号。
+    /// </summary>
     public string TaskNo { get; set; }
+
+    /// <summary>
+    /// 入职任务状态筛选条件。
+    /// </summary>
     public string TaskStatus { get; set; }
+
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     public long? CompanyId { get; set; }
 }
 
+/// <summary>
+/// 后台入职任务详情输出。
+/// </summary>
 public class OnboardingTaskDetailOutput
 {
+    /// <summary>
+    /// 入职任务主数据。
+    /// </summary>
     public ObOnboardingTask Task { get; set; }
+
+    /// <summary>
+    /// 候选人固定基础信息。
+    /// </summary>
     public ObTaskEmployeeInfo EmployeeInfo { get; set; }
+
+    /// <summary>
+    /// 任务合同列表。
+    /// </summary>
     public List<ObTaskContract> Contracts { get; set; }
+
+    /// <summary>
+    /// 候选人已上传材料列表。
+    /// </summary>
     public List<ObTaskMaterial> Materials { get; set; }
+
+    /// <summary>
+    /// 候选人动态字段值列表。
+    /// </summary>
+    public List<ObTaskFormValue> FormValues { get; set; }
+
+    /// <summary>
+    /// 任务当前有效链接信息。
+    /// </summary>
+    public ObTaskLink Link { get; set; }
+
+    /// <summary>
+    /// 提交与审核记录列表。
+    /// </summary>
     public List<ObTaskAudit> Audits { get; set; }
 }

SimpleAdmin.Application/Services/Onboarding/TaskQuery/IOnboardingTaskQueryService.cs

@@ -1,8 +1,17 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 定义入职任务查询业务能力。
+/// </summary>
 public interface IOnboardingTaskQueryService : ITransient
 {
+    /// <summary>
+    /// 分页查询后台入职任务。
+    /// </summary>
     Task<SqlSugarPagedList<ObOnboardingTask>> Page(OnboardingTaskPageInput input);
 
+    /// <summary>
+    /// 查询任务基础信息、人员资料、合同、材料、表单值、链接和审核记录。
+    /// </summary>
     Task<OnboardingTaskDetailOutput> Detail(BaseIdInput input);
-}
+}

SimpleAdmin.Application/Services/Onboarding/TaskQuery/OnboardingTaskQueryService.cs

@@ -1,5 +1,8 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 实现入职任务查询业务能力。
+/// </summary>
 public class OnboardingTaskQueryService : IOnboardingTaskQueryService
 {
     private readonly SqlSugarScope _db;
@@ -9,6 +12,9 @@ public class OnboardingTaskQueryService : IOnboardingTaskQueryService
         _db = DbContext.DB;
     }
 
+    /// <summary>
+    /// 分页查询后台入职任务。
+    /// </summary>
     public Task<SqlSugarPagedList<ObOnboardingTask>> Page(OnboardingTaskPageInput input)
     {
         return _db.Queryable<ObOnboardingTask>()
@@ -19,6 +25,9 @@ public class OnboardingTaskQueryService : IOnboardingTaskQueryService
             .ToPagedListAsync(input.PageNum, input.PageSize);
     }
 
+    /// <summary>
+    /// 查询任务基础信息、人员资料、合同、材料、表单值、链接和审核记录。
+    /// </summary>
     public async Task<OnboardingTaskDetailOutput> Detail(BaseIdInput input)
     {
         var task = await _db.Queryable<ObOnboardingTask>().InSingleAsync(input.Id)
@@ -35,6 +44,13 @@ public class OnboardingTaskQueryService : IOnboardingTaskQueryService
             Materials = await _db.Queryable<ObTaskMaterial>()
                 .Where(item => item.TaskId == task.Id)
                 .ToListAsync(),
+            FormValues = await _db.Queryable<ObTaskFormValue>()
+                .Where(item => item.TaskId == task.Id)
+                .ToListAsync(),
+            Link = await _db.Queryable<ObTaskLink>()
+                .Where(item => item.TaskId == task.Id && item.LinkStatus == "active")
+                .OrderByDescending(item => item.CreateTime)
+                .FirstAsync(),
             Audits = await _db.Queryable<ObTaskAudit>()
                 .Where(item => item.TaskId == task.Id)
                 .OrderByDescending(item => item.AuditedAt)
@@ -42,4 +58,3 @@ public class OnboardingTaskQueryService : IOnboardingTaskQueryService
         };
     }
 }
-