补充注释

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

@@ -1,5 +1,8 @@
 namespace SimpleAdmin.Web.Core;
 
+/// <summary>
+/// 提供入职业务岗位相关 HTTP 接口。
+/// </summary>
 [ApiDescriptionSettings("Application", Tag = "入职岗位管理")]
 [Route("biz/onboarding/position")]
 [RolePermission]
@@ -12,39 +15,57 @@ public class OnboardingPositionController
         _service = service;
     }
 
+    /// <summary>
+    /// 分页查询入职业务岗位。
+    /// </summary>
     [HttpGet("page")]
     public async Task<dynamic> Page([FromQuery] OnboardingPositionPageInput input)
     {
         return await _service.Page(input);
     }
 
+    /// <summary>
+    /// 查询指定公司的已启用岗位。
+    /// </summary>
     [HttpGet("list-enabled")]
     public async Task<dynamic> ListEnabled([FromQuery] long companyId)
     {
         return await _service.ListEnabled(companyId);
     }
 
+    /// <summary>
+    /// 查询岗位详情。
+    /// </summary>
     [HttpGet("detail")]
     public async Task<dynamic> Detail([FromQuery] BaseIdInput input)
     {
         return await _service.Detail(input);
     }
 
+    /// <summary>
+    /// 新增入职业务岗位。
+    /// </summary>
     [HttpPost("add")]
     public async Task Add([FromBody] OnboardingPositionAddInput input)
     {
         await _service.Add(input);
     }
 
+    /// <summary>
+    /// 编辑入职业务岗位。
+    /// </summary>
     [HttpPost("edit")]
     public async Task Edit([FromBody] OnboardingPositionEditInput input)
     {
         await _service.Edit(input);
     }
 
+    /// <summary>
+    /// 删除入职业务岗位。
+    /// </summary>
     [HttpPost("delete")]
     public async Task Delete([FromBody] BaseIdListInput input)
     {
         await _service.Delete(input);
     }
-}
+}