补充注释

SimpleAdmin.Application/Services/Onboarding/Company/Dto/OnboardingCompanyInput.cs

@@ -1,25 +1,53 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 入职业务公司分页查询参数。
+/// </summary>
 public class OnboardingCompanyPageInput : BasePageInput
 {
+    /// <summary>
+    /// 公司名称。
+    /// </summary>
     public virtual string CompanyName { get; set; }
+
+    /// <summary>
+    /// 启用状态或状态筛选条件。
+    /// </summary>
     public string Status { get; set; }
 }
 
+/// <summary>
+/// 新增入职业务公司参数。
+/// </summary>
 public class OnboardingCompanyAddInput : ObCompany
 {
+    /// <summary>
+    /// 公司业务编码。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "公司编码不能为空")]
     public override string CompanyCode { get; set; }
 
+    /// <summary>
+    /// 公司名称。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "公司名称不能为空")]
     public override string CompanyName { get; set; }
 
+    /// <summary>
+    /// 合同甲方完整法定名称。
+    /// </summary>
     [global::System.ComponentModel.DataAnnotations.Required(ErrorMessage = "合同甲方全称不能为空")]
     public override string LegalName { get; set; }
 }
 
+/// <summary>
+/// 编辑入职业务公司参数。
+/// </summary>
 public class OnboardingCompanyEditInput : OnboardingCompanyAddInput
 {
+    /// <summary>
+    /// 业务数据 Id。
+    /// </summary>
     [IdNotNull(ErrorMessage = "公司Id不能为空")]
     public override long Id { get; set; }
 }

SimpleAdmin.Application/Services/Onboarding/Company/IOnboardingCompanyService.cs

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

SimpleAdmin.Application/Services/Onboarding/Company/OnboardingCompanyService.cs

@@ -1,7 +1,13 @@
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 实现入职业务公司业务能力。
+/// </summary>
 public class OnboardingCompanyService : DbRepository<ObCompany>, IOnboardingCompanyService
 {
+    /// <summary>
+    /// 分页查询入职业务公司。
+    /// </summary>
     public async Task<SqlSugarPagedList<ObCompany>> Page(OnboardingCompanyPageInput input)
     {
         return await Context.Queryable<ObCompany>()
@@ -14,6 +20,9 @@ public class OnboardingCompanyService : DbRepository<ObCompany>, IOnboardingComp
             .ToPagedListAsync(input.PageNum, input.PageSize);
     }
 
+    /// <summary>
+    /// 查询全部已启用的入职业务公司。
+    /// </summary>
     public Task<List<ObCompany>> ListEnabled()
     {
         return Context.Queryable<ObCompany>()
@@ -22,17 +31,26 @@ public class OnboardingCompanyService : DbRepository<ObCompany>, IOnboardingComp
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 查询公司详情。
+    /// </summary>
     public async Task<ObCompany> Detail(BaseIdInput input)
     {
         return await GetByIdAsync(input.Id) ?? throw Oops.Bah("公司不存在");
     }
 
+    /// <summary>
+    /// 新增入职业务公司。
+    /// </summary>
     public async Task Add(OnboardingCompanyAddInput input)
     {
         await EnsureCodeUnique(input.CompanyCode, 0);
         await InsertAsync(input.Adapt<ObCompany>());
     }
 
+    /// <summary>
+    /// 编辑入职业务公司。
+    /// </summary>
     public async Task Edit(OnboardingCompanyEditInput input)
     {
         await Detail(new BaseIdInput { Id = input.Id });
@@ -40,6 +58,9 @@ public class OnboardingCompanyService : DbRepository<ObCompany>, IOnboardingComp
         await UpdateAsync(input.Adapt<ObCompany>());
     }
 
+    /// <summary>
+    /// 删除未被岗位、任务或员工引用的公司。
+    /// </summary>
     public async Task Delete(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)