成就等界面接口调整

This commit is contained in:
2025-10-31 19:13:21 +08:00
parent 9ad9507a72
commit 16754b527e
61 changed files with 4748 additions and 592 deletions

View File

@@ -1,7 +1,9 @@
package org.xyzh.api.news.recommend;
import org.xyzh.common.core.domain.ResultDomain;
import org.xyzh.common.core.page.PageParam;
import org.xyzh.common.dto.resource.TbResourceRecommend;
import org.xyzh.common.vo.ResourceRecommendVO;
import java.util.List;
@@ -15,12 +17,12 @@ import java.util.List;
public interface ResourceRecommendService {
/**
* @description 获取推荐资源列表
* @return ResultDomain<TbResourceRecommend> 推荐资源列表
* @description 获取推荐资源列表(包含资源详情和权限信息)
* @return ResultDomain<ResourceRecommendVO> 推荐资源列表
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> getRecommendList();
ResultDomain<ResourceRecommendVO> getRecommendList();
/**
* @description 添加推荐资源
@@ -89,12 +91,13 @@ public interface ResourceRecommendService {
/**
* @description 批量添加推荐资源
* @param resourceIDs 资源ID列表
* @param recommendType 推荐类型
* @param reason 推荐理由
* @return ResultDomain<TbResourceRecommend> 添加结果
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> batchAddRecommends(List<String> resourceIDs, String reason);
ResultDomain<TbResourceRecommend> batchAddRecommends(List<String> resourceIDs, Integer recommendType, String reason);
/**
* @description 批量移除推荐资源
@@ -113,4 +116,43 @@ public interface ResourceRecommendService {
* @since 2025-10-15
*/
ResultDomain<TbResourceRecommend> getRecommendDetail(String recommendID);
/**
* @description 分页查询推荐资源列表(包含资源详情)
* @param filter 过滤条件
* @param pageParam 分页参数
* @return ResultDomain<ResourceRecommendVO> 推荐资源分页列表
* @author yslg
* @since 2025-01-XX
*/
ResultDomain<ResourceRecommendVO> getRecommendPage(TbResourceRecommend filter, PageParam pageParam);
/**
* @description 统计推荐资源总数
* @param filter 过滤条件
* @return ResultDomain<Long> 总数
* @author yslg
* @since 2025-01-XX
*/
ResultDomain<Long> countRecommends(TbResourceRecommend filter);
/**
* @description 根据推荐类型获取推荐资源列表(包含资源详情)
* @param recommendType 推荐类型1-热门资源2-思政资源)
* @param limit 限制数量
* @return ResultDomain<ResourceRecommendVO> 推荐资源列表
* @author yslg
* @since 2025-01-XX
*/
ResultDomain<ResourceRecommendVO> getRecommendsByType(Integer recommendType, Integer limit);
/**
* @description 根据推荐类型和资源ID检查是否已推荐
* @param resourceID 资源ID
* @param recommendType 推荐类型
* @return ResultDomain<Boolean> 是否已推荐
* @author yslg
* @since 2025-01-XX
*/
ResultDomain<Boolean> isResourceRecommendedByType(String resourceID, Integer recommendType);
}

View File

@@ -35,6 +35,15 @@ public interface ResourceService {
*/
ResultDomain<TbResource> getResourcePage(TbResource filter, PageParam pageParam);
/**
* @description 获取资源分页(按浏览次数排序)
* @param filter 过滤条件
* @param pageParam 分页参数
* @return ResultDomain<TbResource> 资源分页
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbResource> getResourcePageOrderByViewCount(TbResource filter, PageParam pageParam);
/**
* @description 根据ID获取资源详情
* @param resourceID 资源ID

View File

@@ -21,7 +21,7 @@ public interface TagService {
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTag> getAllTags();
ResultDomain<TbTag> getTagList(TbTag filter);
/**
* @description 根据ID获取标签详情