serv-模块、权限、成就

This commit is contained in:
2025-10-25 17:45:39 +08:00
parent 42f8a0a136
commit f7057a0cc9
15 changed files with 682 additions and 394 deletions

View File

@@ -2,13 +2,12 @@ package org.xyzh.api.achievement;
import org.xyzh.common.core.domain.ResultDomain;
import org.xyzh.common.core.event.AchievementEvent;
import org.xyzh.common.core.page.PageDomain;
import org.xyzh.common.core.page.PageParam;
import org.xyzh.common.dto.usercenter.TbAchievement;
import org.xyzh.common.dto.usercenter.TbUserAchievement;
import org.xyzh.common.dto.usercenter.TbUserAchievementProgress;
import org.xyzh.common.vo.AchievementVO;
import java.util.List;
import java.util.Map;
/**
@@ -49,7 +48,7 @@ public interface AchievementService {
* @param level 成就等级(可选)
* @return ResultDomain<TbAchievement> 成就列表
*/
ResultDomain<TbAchievement> getAllAchievements(Integer type, Integer level);
ResultDomain<TbAchievement> getAllAchievements(TbAchievement filter);
/**
* @description 分页查询成就
@@ -83,6 +82,16 @@ public interface AchievementService {
*/
ResultDomain<TbUserAchievement> getMyAchievements(Integer type);
/**
* @description 获取当前用户的成就列表(带进度信息)
* 返回所有成就的详细信息,包括:
* - 已获得的成就:显示获得时间
* - 未获得的成就:显示当前进度
* @param type 成就类型(可选)
* @return ResultDomain<AchievementVO> 成就视图对象列表
*/
ResultDomain<AchievementVO> getMyAchievementsWithProgress(Integer type);
/**
* @description 检查用户是否已获得成就
* @param userID 用户ID
@@ -179,6 +188,6 @@ public interface AchievementService {
* @param limit 查询条数
* @return ResultDomain<TbUserAchievement> 用户成就列表在dataList中
*/
ResultDomain<TbUserAchievement> getRecentAchievers(String achievementID, Integer limit);
ResultDomain<TbUserAchievement> getRecentAchievers(TbUserAchievement filter, PageParam pageParam);
}