补充注释

SimpleAdmin.Application/Services/Onboarding/Position/OnboardingPositionService.cs

@@ -1,7 +1,13 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 实现入职业务岗位业务能力。
+/// </summary>
 public class OnboardingPositionService : DbRepository<ObPosition>, IOnboardingPositionService
 {
+    /// <summary>
+    /// 分页查询入职业务岗位。
+    /// </summary>
     public async Task<SqlSugarPagedList<ObPosition>> Page(OnboardingPositionPageInput input)
     {
         return await Context.Queryable<ObPosition>()
@@ -15,6 +21,9 @@ public class OnboardingPositionService : DbRepository<ObPosition>, IOnboardingPo
             .ToPagedListAsync(input.PageNum, input.PageSize);
     }
 
+    /// <summary>
+    /// 查询指定公司下全部已启用岗位。
+    /// </summary>
     public Task<List<ObPosition>> ListEnabled(long companyId)
     {
         return Context.Queryable<ObPosition>()
@@ -23,11 +32,17 @@ public class OnboardingPositionService : DbRepository<ObPosition>, IOnboardingPo
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 查询岗位详情。
+    /// </summary>
     public async Task<ObPosition> Detail(BaseIdInput input)
     {
         return await GetByIdAsync(input.Id) ?? throw Oops.Bah("岗位不存在");
     }
 
+    /// <summary>
+    /// 新增入职业务岗位。
+    /// </summary>
     public async Task Add(OnboardingPositionAddInput input)
     {
         await EnsureCompanyExists(input.CompanyId);
@@ -35,6 +50,9 @@ public class OnboardingPositionService : DbRepository<ObPosition>, IOnboardingPo
         await InsertAsync(input.Adapt<ObPosition>());
     }
 
+    /// <summary>
+    /// 编辑入职业务岗位。
+    /// </summary>
     public async Task Edit(OnboardingPositionEditInput input)
     {
         await Detail(new BaseIdInput { Id = input.Id });
@@ -43,6 +61,9 @@ public class OnboardingPositionService : DbRepository<ObPosition>, IOnboardingPo
         await UpdateAsync(input.Adapt<ObPosition>());
     }
 
+    /// <summary>
+    /// 删除未被任务或正式员工引用的岗位。
+    /// </summary>
     public async Task Delete(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)