feat(api): 添加热门卡片与榜单接口及实现

- 新增热门帖子、热门作者、榜单接口及实现
- 新增api-documentation,更好的ai协作
- 修复types没有导出的问题

BREAKING CHANGES: 1.0.0->1.1.0(latest)
This commit is contained in:
tobegold574
2025-11-18 22:29:40 +08:00
parent c3a8a525cb
commit a0c907beed
28 changed files with 1074 additions and 15 deletions

View File

@@ -26,8 +26,18 @@ API模块负责处理所有与后端通信相关的逻辑提供统一的HTTP
#### 核心功能
- **请求工厂**使用工厂模式创建API实例统一配置请求参数
- **拦截器系统**:支持请求/响应拦截器,实现统一的错误处理、日志记录和认证
- **模块化API服务**按功能域划分API服务如用户API、内容API等
- **模块化API服务**按功能域划分API服务如用户API、帖子API等
- **响应标准化**统一处理API响应格式提供一致的错误处理机制
- **内容发现**:提供热门帖子、帖子榜单和热门作者功能,支持多种排序和统计周期
#### 新增功能
##### 帖子相关
- **热门帖子**:通过`getHotPosts()`获取指定时间内的热门帖子
- **帖子榜单**:通过`getPostRanking()`获取不同周期(日/周/月)的帖子排行榜,支持按浏览量、点赞数、评论数排序
##### 用户相关
- **热门作者**:通过`getHotAuthors()`获取指定时间内的热门作者
- **作者榜单**:通过`getAuthorRanking()`获取不同周期(日/周/月)的作者排行榜,支持按发帖量、浏览量、点赞数排序
#### 架构特点
- 基于axios构建支持请求/响应转换
@@ -113,4 +123,14 @@ knowai-core/
### 2025-11-11
- 因服务器性能原因去除CI pipeline
- 重新整理所有逻辑模块架构完成对应README撰写
- 重新整理所有逻辑模块架构完成对应README撰写
### 2025-11-12
- 实现帖子相关新功能:热门帖子、帖子榜单
- 实现用户相关新功能:热门作者、作者榜单
- 更新README文档添加新功能说明
### 2025-11-18
- 添加热门帖子、榜单、热门作者接口
- 完成api-documentation.md文档详细描述所有接口的功能、参数、响应格式等
- 修复类型未导出问题