web-文件接口

2025-10-16 10:45:44 +08:00
parent 6858899c4c
commit 40ef609ea3
191 changed files with 2379 additions and 1593 deletions
--- a/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/achievement/UserAchievementService.java
+++ b/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/achievement/UserAchievementService.java
@@ -9,7 +9,7 @@ import java.util.List;
 /**
 * @description 用户成就服务接口
 * @filename UserAchievementService.java
- * @author system
+ * @author yslg
 * @copyright xyzh
 * @since 2025-10-15
 */
@@ -20,7 +20,7 @@ public interface UserAchievementService {
     * @param type 成就类型（可选）
     * @param level 成就等级（可选）
     * @return ResultDomain<TbAchievement> 成就列表
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbAchievement> getAllAchievements(Integer type, Integer level);
@@ -30,7 +30,7 @@ public interface UserAchievementService {
     * @param userID 用户ID
     * @param type 成就类型（可选）
     * @return ResultDomain<TbUserAchievement> 用户成就列表
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserAchievement> getUserAchievements(String userID, Integer type);
@@ -40,7 +40,7 @@ public interface UserAchievementService {
     * @param userID 用户ID
     * @param achievementID 成就ID
     * @return ResultDomain<Boolean> 是否已获得
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> hasAchievement(String userID, String achievementID);
@@ -50,7 +50,7 @@ public interface UserAchievementService {
     * @param userID 用户ID
     * @param achievementID 成就ID
     * @return ResultDomain<TbUserAchievement> 授予结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserAchievement> grantAchievement(String userID, String achievementID);
@@ -59,7 +59,7 @@ public interface UserAchievementService {
     * @description 获取成就详情
     * @param achievementID 成就ID
     * @return ResultDomain<TbAchievement> 成就详情
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbAchievement> getAchievementDetail(String achievementID);
@@ -69,7 +69,7 @@ public interface UserAchievementService {
     * @param userID 用户ID
     * @param achievementID 成就ID
     * @return ResultDomain<Boolean> 是否满足条件
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> checkAchievementCondition(String userID, String achievementID);
--- a/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/browse/UserBrowseRecordService.java
+++ b/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/browse/UserBrowseRecordService.java
@@ -8,7 +8,7 @@ import java.util.List;
 /**
 * @description 用户浏览记录服务接口
 * @filename UserBrowseRecordService.java
- * @author system
+ * @author yslg
 * @copyright xyzh
 * @since 2025-10-15
 */
@@ -18,7 +18,7 @@ public interface UserBrowseRecordService {
     * @description 添加浏览记录
     * @param browseRecord 浏览记录
     * @return ResultDomain<TbUserBrowseRecord> 添加结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserBrowseRecord> addBrowseRecord(TbUserBrowseRecord browseRecord);
@@ -29,7 +29,7 @@ public interface UserBrowseRecordService {
     * @param browseType 浏览类型（可选）
     * @param limit 限制数量（可选）
     * @return ResultDomain<TbUserBrowseRecord> 浏览记录列表
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserBrowseRecord> getUserBrowseRecords(String userID, Integer browseType, Integer limit);
@@ -38,7 +38,7 @@ public interface UserBrowseRecordService {
     * @description 删除浏览记录
     * @param recordID 记录ID
     * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> deleteBrowseRecord(String recordID);
@@ -48,7 +48,7 @@ public interface UserBrowseRecordService {
     * @param userID 用户ID
     * @param browseType 浏览类型（可选）
     * @return ResultDomain<Boolean> 清空结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> clearUserBrowseRecords(String userID, Integer browseType);
@@ -58,7 +58,7 @@ public interface UserBrowseRecordService {
     * @param userID 用户ID
     * @param browseType 浏览类型（可选）
     * @return ResultDomain<Integer> 浏览次数
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Integer> getBrowseCount(String userID, Integer browseType);
--- a/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/collection/UserCollectionService.java
+++ b/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/collection/UserCollectionService.java
@@ -6,7 +6,7 @@ import org.xyzh.common.dto.usercenter.TbUserCollection;
 /**
 * @description 用户收藏服务接口
 * @filename UserCollectionService.java
- * @author system
+ * @author yslg
 * @copyright xyzh
 * @since 2025-10-15
 */
@@ -16,7 +16,7 @@ public interface UserCollectionService {
     * @description 添加收藏
     * @param userCollection 收藏信息
     * @return ResultDomain<TbUserCollection> 添加结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserCollection> addCollection(TbUserCollection userCollection);
@@ -27,7 +27,7 @@ public interface UserCollectionService {
     * @param collectionType 收藏类型
     * @param collectionID 收藏对象ID
     * @return ResultDomain<Boolean> 取消结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> removeCollection(String userID, Integer collectionType, String collectionID);
@@ -38,7 +38,7 @@ public interface UserCollectionService {
     * @param collectionType 收藏类型
     * @param collectionID 收藏对象ID
     * @return ResultDomain<Boolean> 是否已收藏
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Boolean> isCollected(String userID, Integer collectionType, String collectionID);
@@ -48,7 +48,7 @@ public interface UserCollectionService {
     * @param userID 用户ID
     * @param collectionType 收藏类型（可选）
     * @return ResultDomain<TbUserCollection> 收藏列表
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserCollection> getUserCollections(String userID, Integer collectionType);
@@ -59,7 +59,7 @@ public interface UserCollectionService {
     * @param collectionType 收藏类型
     * @param collectionID 收藏对象ID
     * @return ResultDomain<TbUserCollection> 收藏详情
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserCollection> getCollectionDetail(String userID, Integer collectionType, String collectionID);
@@ -71,7 +71,7 @@ public interface UserCollectionService {
     * @param collectionID 收藏对象ID
     * @param resourceID 资源ID
     * @return ResultDomain<Integer> 收藏数量
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<Integer> getCollectionCount(String userID, Integer collectionType, String collectionID);
--- a/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/points/UserPointsService.java
+++ b/schoolNewsServ/api/api-usercenter/src/main/java/org/xyzh/api/usercenter/points/UserPointsService.java
@@ -9,7 +9,7 @@ import java.util.List;
 /**
 * @description 用户积分服务接口
 * @filename UserPointsService.java
- * @author system
+ * @author yslg
 * @copyright xyzh
 * @since 2025-10-15
 */
@@ -19,7 +19,7 @@ public interface UserPointsService {
     * @description 获取用户积分信息
     * @param userID 用户ID
     * @return ResultDomain<TbUserPoints> 用户积分信息
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserPoints> getUserPoints(String userID);
@@ -28,7 +28,7 @@ public interface UserPointsService {
     * @description 更新用户积分
     * @param userPoints 用户积分信息
     * @return ResultDomain<TbUserPoints> 更新结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserPoints> updateUserPoints(TbUserPoints userPoints);
@@ -41,7 +41,7 @@ public interface UserPointsService {
     * @param sourceID 来源ID
     * @param description 说明
     * @return ResultDomain<TbUserPoints> 更新结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserPoints> addUserPoints(String userID, Integer points, Integer sourceType, String sourceID, String description);
@@ -54,7 +54,7 @@ public interface UserPointsService {
     * @param sourceID 来源ID
     * @param description 说明
     * @return ResultDomain<TbUserPoints> 更新结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbUserPoints> consumeUserPoints(String userID, Integer points, Integer sourceType, String sourceID, String description);
@@ -65,7 +65,7 @@ public interface UserPointsService {
     * @param type 类型（1获得 2消费）
     * @param sourceType 来源类型
     * @return ResultDomain<TbPointsRecord> 积分记录列表
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbPointsRecord> getPointsRecords(String userID, Integer type, Integer sourceType);
@@ -74,7 +74,7 @@ public interface UserPointsService {
     * @description 添加积分记录
     * @param pointsRecord 积分记录
     * @return ResultDomain<TbPointsRecord> 添加结果
-     * @author system
+     * @author yslg
     * @since 2025-10-15
     */
    ResultDomain<TbPointsRecord> addPointsRecord(TbPointsRecord pointsRecord);