补充注释

SimpleAdmin.Web.Core/Controllers/Application/Onboarding/OnboardingEntryConfigController.cs

@@ -1,5 +1,8 @@
 namespace SimpleAdmin.Web.Core;
 
+/// <summary>
+/// 提供入职字段与材料要求配置相关 HTTP 接口。
+/// </summary>
 [ApiDescriptionSettings("Application", Tag = "入职填写与材料配置")]
 [Route("biz/onboarding/entry-config")]
 [RolePermission]
@@ -12,75 +15,111 @@ public class OnboardingEntryConfigController
         _service = service;
     }
 
+    /// <summary>
+    /// 查询动态入职字段。
+    /// </summary>
     [HttpGet("form-field/list")]
     public async Task<dynamic> ListFormFields()
     {
         return await _service.ListFormFields();
     }
 
+    /// <summary>
+    /// 保存动态入职字段。
+    /// </summary>
     [HttpPost("form-field/save")]
     public async Task SaveFormField([FromBody] OnboardingFormFieldSaveInput input)
     {
         await _service.SaveFormField(input);
     }
 
+    /// <summary>
+    /// 删除动态入职字段。
+    /// </summary>
     [HttpPost("form-field/delete")]
     public async Task DeleteFormFields([FromBody] BaseIdListInput input)
     {
         await _service.DeleteFormFields(input);
     }
 
+    /// <summary>
+    /// 查询入职材料类型。
+    /// </summary>
     [HttpGet("material-type/list")]
     public async Task<dynamic> ListMaterialTypes()
     {
         return await _service.ListMaterialTypes();
     }
 
+    /// <summary>
+    /// 保存入职材料类型。
+    /// </summary>
     [HttpPost("material-type/save")]
     public async Task SaveMaterialType([FromBody] OnboardingMaterialTypeSaveInput input)
     {
         await _service.SaveMaterialType(input);
     }
 
+    /// <summary>
+    /// 删除入职材料类型。
+    /// </summary>
     [HttpPost("material-type/delete")]
     public async Task DeleteMaterialTypes([FromBody] BaseIdListInput input)
     {
         await _service.DeleteMaterialTypes(input);
     }
 
+    /// <summary>
+    /// 查询公司岗位动态字段要求。
+    /// </summary>
     [HttpGet("form-requirement/list")]
     public async Task<dynamic> ListFormRequirements([FromQuery] long companyId)
     {
         return await _service.ListFormRequirements(companyId);
     }
 
+    /// <summary>
+    /// 保存公司岗位动态字段要求。
+    /// </summary>
     [HttpPost("form-requirement/save")]
     public async Task SaveFormRequirement([FromBody] OnboardingFormRequirementSaveInput input)
     {
         await _service.SaveFormRequirement(input);
     }
 
+    /// <summary>
+    /// 删除动态字段要求。
+    /// </summary>
     [HttpPost("form-requirement/delete")]
     public async Task DeleteFormRequirements([FromBody] BaseIdListInput input)
     {
         await _service.DeleteFormRequirements(input);
     }
 
+    /// <summary>
+    /// 查询公司岗位材料要求。
+    /// </summary>
     [HttpGet("material-requirement/list")]
     public async Task<dynamic> ListMaterialRequirements([FromQuery] long companyId)
     {
         return await _service.ListMaterialRequirements(companyId);
     }
 
+    /// <summary>
+    /// 保存公司岗位材料要求。
+    /// </summary>
     [HttpPost("material-requirement/save")]
     public async Task SaveMaterialRequirement([FromBody] OnboardingMaterialRequirementSaveInput input)
     {
         await _service.SaveMaterialRequirement(input);
     }
 
+    /// <summary>
+    /// 删除材料要求。
+    /// </summary>
     [HttpPost("material-requirement/delete")]
     public async Task DeleteMaterialRequirements([FromBody] BaseIdListInput input)
     {
         await _service.DeleteMaterialRequirements(input);
     }
-}
+}