为各服务接口补 /// 中文注释：swagger 恢复中文说明（admin 203 / user 93 / customer 12 / fishgame 4）

AdminSrc/AdminApi/Faq/FaqController.cs

@@ -20,6 +20,9 @@ namespace AdminApi.Faq
         }
 
 
+        /// <summary>
+        /// 获取所有板块
+        /// </summary>
         [HttpGet("Categories")]
         public async Task<BaseCommonResponse> GetCategories()
         {
@@ -35,6 +38,9 @@ namespace AdminApi.Faq
             };
         }
 
+        /// <summary>
+        /// 获取板块树形结构
+        /// </summary>
         [HttpGet("CategoryTree")]
         public async Task<BaseCommonResponse> GetCategoryTree()
         {
@@ -48,6 +54,9 @@ namespace AdminApi.Faq
             };
         }
 
+        /// <summary>
+        /// 获取板块详情
+        /// </summary>
         [HttpGet("CategoryDetail")]
         public async Task<BaseResponse<FaqCategoryDto>> GetCategoryDetail(string id)
         {
@@ -58,6 +67,9 @@ namespace AdminApi.Faq
             return this.ToResult(MapToCategoryDto(category));
         }
 
+        /// <summary>
+        /// 添加板块
+        /// </summary>
         [HttpPost("AddCategory")]
         public async Task<BaseResponse<string>> AddCategory([FromBody] FaqCategory category)
         {
@@ -68,6 +80,9 @@ namespace AdminApi.Faq
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 更新板块
+        /// </summary>
         [HttpPost("UpdateCategory")]
         public async Task<BaseResponse<string>> UpdateCategory([FromBody] FaqCategory category)
         {
@@ -78,6 +93,9 @@ namespace AdminApi.Faq
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 删除板块
+        /// </summary>
         [HttpPost("DeleteCategory")]
         public async Task<BaseResponse<string>> DeleteCategory(string id)
         {
@@ -89,6 +107,9 @@ namespace AdminApi.Faq
         }
 
 
+        /// <summary>
+        /// 获取板块下的问题列表
+        /// </summary>
         [HttpGet("Questions")]
         public async Task<BaseCommonResponse> GetQuestions(string categoryId)
         {
@@ -104,6 +125,9 @@ namespace AdminApi.Faq
             };
         }
 
+        /// <summary>
+        /// 分页查询问题
+        /// </summary>
         [HttpPost("QuestionList")]
         public async Task<BaseCommonResponse> GetQuestionList([FromBody] FaqQueryParam param)
         {
@@ -118,6 +142,9 @@ namespace AdminApi.Faq
             };
         }
 
+        /// <summary>
+        /// 获取问题详情
+        /// </summary>
         [HttpGet("QuestionDetail")]
         public async Task<BaseResponse<FaqQuestionDto>> GetQuestionDetail(string id)
         {
@@ -128,6 +155,9 @@ namespace AdminApi.Faq
             return this.ToResult(MapToQuestionDto(question));
         }
 
+        /// <summary>
+        /// 添加问题
+        /// </summary>
         [HttpPost("AddQuestion")]
         public async Task<BaseResponse<string>> AddQuestion([FromBody] FaqQuestion question)
         {
@@ -138,6 +168,9 @@ namespace AdminApi.Faq
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 更新问题
+        /// </summary>
         [HttpPost("UpdateQuestion")]
         public async Task<BaseResponse<string>> UpdateQuestion([FromBody] FaqQuestion question)
         {
@@ -148,6 +181,9 @@ namespace AdminApi.Faq
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 删除问题
+        /// </summary>
         [HttpPost("DeleteQuestion")]
         public async Task<BaseResponse<string>> DeleteQuestion(string id)
         {