补充注释

SimpleAdmin.Application/Services/Onboarding/Position/Dto/OnboardingPositionInput.cs

@@ -1,23 +1,52 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 入职业务岗位分页查询参数。
+/// </summary>
 public class OnboardingPositionPageInput : BasePageInput
 {
+    /// <summary>
+    /// 入职业务公司 Id。
+    /// </summary>
     public long? CompanyId { get; set; }
+
+    /// <summary>
+    /// 岗位名称。
+    /// </summary>
     public virtual string PositionName { get; set; }
+
+    /// <summary>
+    /// 启用状态或状态筛选条件。
+    /// </summary>
     public string Status { get; set; }
 }
 
+/// <summary>
+/// 新增入职业务岗位参数。
+/// </summary>
 public class OnboardingPositionAddInput : ObPosition
 {
+    /// <summary>
+    /// 岗位业务编码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "岗位编码不能为空")]
     public override string PositionCode { get; set; }
 
+    /// <summary>
+    /// 岗位名称。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "岗位名称不能为空")]
     public override string PositionName { get; set; }
 }
 
+/// <summary>
+/// 编辑入职业务岗位参数。
+/// </summary>
 public class OnboardingPositionEditInput : OnboardingPositionAddInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "岗位Id不能为空")]
     public override long Id { get; set; }
 }

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

@@ -1,11 +1,32 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 定义入职业务岗位业务能力。
+/// </summary>
 public interface IOnboardingPositionService : ITransient
 {
+    /// <summary>
+    /// 分页查询入职业务岗位。
+    /// </summary>
     Task<SqlSugarPagedList<ObPosition>> Page(OnboardingPositionPageInput input);
+    /// <summary>
+    /// 查询指定公司下全部已启用岗位。
+    /// </summary>
     Task<List<ObPosition>> ListEnabled(long companyId);
+    /// <summary>
+    /// 查询岗位详情。
+    /// </summary>
     Task<ObPosition> Detail(BaseIdInput input);
+    /// <summary>
+    /// 新增入职业务岗位。
+    /// </summary>
     Task Add(OnboardingPositionAddInput input);
+    /// <summary>
+    /// 编辑入职业务岗位。
+    /// </summary>
     Task Edit(OnboardingPositionEditInput input);
+    /// <summary>
+    /// 删除未被任务或正式员工引用的岗位。
+    /// </summary>
     Task Delete(BaseIdListInput input);
 }

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)