feat: 实现API文档支持与系统优化

refactor(ArticleRepository): 修正@Param注解导入错误并优化查询方法
fix(ArticleService): 解决事务回滚问题并优化日志配置
feat(SecurityConfig): 添加Spring Security配置禁用默认认证
docs: 添加详细API文档README_API.md
feat(HelpController): 实现Markdown文档渲染API
style: 清理无用注释和导入
build: 更新pom.xml依赖和插件配置
chore: 优化application.properties配置

src/main/java/com/qf/myafterprojecy/controller/ArticleController.java

@@ -12,30 +12,56 @@ import org.springframework.web.bind.annotation.*;
 import javax.validation.Valid;
 import java.util.List;
 
+/**
+ * 文章控制器类，处理文章相关的HTTP请求
+ * 提供文章的增删改查功能，以及按作者、分类和浏览量获取文章的接口
+ */
 @RestController
 @RequestMapping("/api/articles")
 @Validated
 public class ArticleController {
 
     @Autowired
-    private IArticleService articleService;
+    private IArticleService articleService; // 注入文章服务接口
 
+    /**
+     * 根据ID获取单个文章
+     * @param id 文章ID
+     * @return 返回包含文章信息的ResponseMessage对象
+     */
     @GetMapping("/{id}")
     public ResponseMessage<Article> getArticle(@PathVariable Integer id) {
         return articleService.getArticleById(id);
     }
 
+    /**
+     * 获取所有文章列表
+     * @return 返回包含文章列表的ResponseMessage对象
+     */
     @GetMapping
     public ResponseMessage<List<Article>> getAllArticles() {
         return articleService.getAllArticles();
     }
 
+    /**
+     * 创建新文章
+     * 仅限AUTHOR角色用户访问
+     * @param articleDto 包含文章数据的DTO对象
+     * @return 返回包含新创建文章信息的ResponseMessage对象
+     */
     @PostMapping
     @PreAuthorize("hasRole('AUTHOR')")
     public ResponseMessage<Article> createArticle(@Valid @RequestBody ArticleDto articleDto) {
         return articleService.saveArticle(articleDto);
     }
 
+    /**
+     * 更新现有文章
+     * 仅限AUTHOR或ADMIN角色用户访问
+     * @param id 要更新的文章ID
+     * @param articleDto 包含更新后文章数据的DTO对象
+     * @return 返回包含更新后文章信息的ResponseMessage对象
+     */
     @PutMapping("/{id}")
     @PreAuthorize("hasRole('AUTHOR') or hasRole('ADMIN')")
     public ResponseMessage<Article> updateArticle(
@@ -44,22 +70,42 @@ public class ArticleController {
         return articleService.updateArticle(id, articleDto);
     }
 
+    /**
+     * 删除文章
+     * 仅限AUTHOR或ADMIN角色用户访问
+     * @param id 要删除的文章ID
+     * @return 返回包含被删除文章信息的ResponseMessage对象
+     */
     @DeleteMapping("/{id}")
     @PreAuthorize("hasRole('AUTHOR') or hasRole('ADMIN')")
     public ResponseMessage<Article> deleteArticle(@PathVariable Integer id) {
         return articleService.deleteArticle(id);
     }
 
+    /**
+     * 根据作者ID获取其所有文章
+     * @param authorId 作者ID
+     * @return 返回包含文章列表的ResponseMessage对象
+     */
     @GetMapping("/author/{authorId}")
     public ResponseMessage<List<Article>> getArticlesByAuthor(@PathVariable Integer authorId) {
         return articleService.getArticlesByAuthor(authorId);
     }
 
+    /**
+     * 根据分类ID获取该分类下的所有文章
+     * @param categoryId 分类ID
+     * @return 返回包含文章列表的ResponseMessage对象
+     */
     @GetMapping("/category/{categoryId}")
     public ResponseMessage<List<Article>> getArticlesByCategory(@PathVariable Integer categoryId) {
         return articleService.getArticlesByCategory(categoryId);
     }
 
+    /**
+     * 获取浏览量最高的文章列表
+     * @return 返回包含热门文章列表的ResponseMessage对象
+     */
     @GetMapping("/popular")
     public ResponseMessage<List<Article>> getMostViewedArticles() {
         return articleService.getMostViewedArticles();