补充注释

SimpleAdmin.Application/Services/Onboarding/EntryConfig/OnboardingEntryConfigService.cs

@@ -12,6 +12,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         _db = DbContext.DB;
     }
 
+    /// <summary>
+    /// 查询全部动态入职字段。
+    /// </summary>
     public Task<List<ObFormField>> ListFormFields()
     {
         return _db.Queryable<ObFormField>()
@@ -19,6 +22,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 新增或编辑动态入职字段。
+    /// </summary>
     public async Task SaveFormField(OnboardingFormFieldSaveInput input)
     {
         var fieldCodeExists = await _db.Queryable<ObFormField>()
@@ -51,6 +57,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Insertable(entity).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 删除未被填写要求引用的动态字段。
+    /// </summary>
     public async Task DeleteFormFields(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)
@@ -64,6 +73,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Deleteable<ObFormField>().In(input.Ids).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 查询全部入职材料类型。
+    /// </summary>
     public Task<List<ObMaterialType>> ListMaterialTypes()
     {
         return _db.Queryable<ObMaterialType>()
@@ -71,6 +83,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 新增或编辑入职材料类型。
+    /// </summary>
     public async Task SaveMaterialType(OnboardingMaterialTypeSaveInput input)
     {
         if (input.MaxFileCount <= 0)
@@ -105,6 +120,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Insertable(entity).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 删除未被要求或上传记录引用的材料类型。
+    /// </summary>
     public async Task DeleteMaterialTypes(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)
@@ -123,6 +141,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Deleteable<ObMaterialType>().In(input.Ids).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 查询指定公司的动态字段填写要求。
+    /// </summary>
     public Task<List<ObFormRequirement>> ListFormRequirements(long companyId)
     {
         return _db.Queryable<ObFormRequirement>()
@@ -131,6 +152,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 新增或编辑公司岗位动态字段要求。
+    /// </summary>
     public async Task SaveFormRequirement(OnboardingFormRequirementSaveInput input)
     {
         await EnsureCompanyAndPosition(input.CompanyId, input.PositionId);
@@ -167,6 +191,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Insertable(entity).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 删除动态字段填写要求。
+    /// </summary>
     public Task DeleteFormRequirements(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)
@@ -175,6 +202,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         return _db.Deleteable<ObFormRequirement>().In(input.Ids).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 查询指定公司的材料上传要求。
+    /// </summary>
     public Task<List<ObMaterialRequirement>> ListMaterialRequirements(long companyId)
     {
         return _db.Queryable<ObMaterialRequirement>()
@@ -183,6 +213,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
             .ToListAsync();
     }
 
+    /// <summary>
+    /// 新增或编辑公司岗位材料要求。
+    /// </summary>
     public async Task SaveMaterialRequirement(OnboardingMaterialRequirementSaveInput input)
     {
         await EnsureCompanyAndPosition(input.CompanyId, input.PositionId);
@@ -219,6 +252,9 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
         await _db.Insertable(entity).ExecuteCommandAsync();
     }
 
+    /// <summary>
+    /// 删除材料上传要求。
+    /// </summary>
     public Task DeleteMaterialRequirements(BaseIdListInput input)
     {
         if (input.Ids.Count == 0)
@@ -243,5 +279,3 @@ public class OnboardingEntryConfigService : IOnboardingEntryConfigService
             throw Oops.Bah("岗位不存在、未启用或不属于该公司");
     }
 }
-
-