成就等界面接口调整

schoolNewsWeb/src/apis/resource/resourceRecommend.ts

@@ -0,0 +1,155 @@
+/**
+ * @description 资源推荐管理API接口
+ * @filename resourceRecommend.ts
+ * @author yslg
+ * @copyright xyzh
+ * @since 2025-10-31
+ */
+
+import { api } from '@/apis';
+import type { ResultDomain, ResourceRecommendVO, PageParam } from '@/types';
+
+/**
+ * 推荐类型枚举
+ */
+export enum RecommendType {
+  /** 热门资源推荐 */
+  HOT = 1,
+  /** 思政资源推荐 */
+  IDEOLOGICAL = 2
+}
+
+/**
+ * 资源推荐API服务
+ */
+export const resourceRecommendApi = {
+  /**
+   * 获取推荐列表
+   * @returns Promise<ResultDomain<ResourceRecommendVO>>
+   */
+  async getRecommendList(): Promise<ResultDomain<ResourceRecommendVO>> {
+    const response = await api.get<ResourceRecommendVO>('/news/recommends/list');
+    return response.data;
+  },
+
+  /**
+   * 根据推荐类型获取推荐资源列表
+   * @param recommendType 推荐类型（1-热门资源，2-思政资源）
+   * @param limit 限制数量
+   * @returns Promise<ResultDomain<ResourceRecommendVO>>
+   */
+  async getRecommendsByType(recommendType: number, limit?: number): Promise<ResultDomain<ResourceRecommendVO>> {
+    const params = limit ? { limit } : null;
+    const response = await api.get<ResourceRecommendVO>(`/news/recommends/type/${recommendType}`, params);
+    return response.data;
+  },
+
+  /**
+   * 分页查询推荐资源列表
+   * @param filter 筛选条件
+   * @param pageParam 分页参数
+   * @returns Promise<ResultDomain<ResourceRecommendVO>>
+   */
+  async getRecommendPage(pageParam: PageParam, filter?: any): Promise<ResultDomain<ResourceRecommendVO>> {
+    const response = await api.post<ResourceRecommendVO>('/news/recommends/page', {
+      pageParam,
+      filter,
+    });
+    return response.data;
+  },
+
+  /**
+   * 根据ID获取推荐详情
+   * @param recommendID 推荐ID
+   * @returns Promise<ResultDomain<ResourceRecommendVO>>
+   */
+  async getRecommendById(recommendID: string): Promise<ResultDomain<ResourceRecommendVO>> {
+    const response = await api.get<ResourceRecommendVO>(`/news/recommends/recommend/${recommendID}`);
+    return response.data;
+  },
+
+  /**
+   * 创建推荐
+   * @param recommend 推荐信息
+   * @returns Promise<ResultDomain<any>>
+   */
+  async createRecommend(recommend: any): Promise<ResultDomain<any>> {
+    const response = await api.post<any>('/news/recommends/recommend', recommend);
+    return response.data;
+  },
+
+  /**
+   * 批量添加推荐资源
+   * @param resourceIDs 资源ID列表
+   * @param recommendType 推荐类型
+   * @param reason 推荐理由（可选）
+   * @returns Promise<ResultDomain<any>>
+   */
+  async batchAddRecommends(resourceIDs: string[], recommendType: number, reason?: string): Promise<ResultDomain<any>> {
+    const response = await api.post<any>('/news/recommends/recommend/batch', {
+      resourceIDs,
+      recommendType,
+      reason
+    });
+    return response.data;
+  },
+
+  /**
+   * 更新推荐
+   * @param recommend 推荐信息
+   * @returns Promise<ResultDomain<any>>
+   */
+  async updateRecommend(recommend: any): Promise<ResultDomain<any>> {
+    const response = await api.put<any>('/news/recommends/recommend', recommend);
+    return response.data;
+  },
+
+  /**
+   * 删除推荐
+   * @param recommendID 推荐ID
+   * @returns Promise<ResultDomain<boolean>>
+   */
+  async deleteRecommend(recommendID: string): Promise<ResultDomain<boolean>> {
+    const response = await api.delete<boolean>(`/news/recommends/recommend/${recommendID}`);
+    return response.data;
+  },
+
+  /**
+   * 更新推荐排序
+   * @param recommendID 推荐ID
+   * @param orderNum 排序号
+   * @returns Promise<ResultDomain<any>>
+   */
+  async updateRecommendOrder(recommendID: string, orderNum: number): Promise<ResultDomain<any>> {
+    const response = await api.put<any>(`/news/recommends/recommend/${recommendID}/order`, null, {
+      params: { orderNum }
+    });
+    return response.data;
+  },
+
+  /**
+   * 检查资源是否已推荐（按类型）
+   * @param resourceID 资源ID
+   * @param recommendType 推荐类型
+   * @returns Promise<ResultDomain<boolean>>
+   */
+  async isResourceRecommendedByType(resourceID: string, recommendType: number): Promise<ResultDomain<boolean>> {
+    const response = await api.get<boolean>(`/news/recommends/check/${resourceID}`, {
+      recommendType
+    });
+    return response.data;
+  },
+
+  /**
+   * 统计推荐资源总数
+   * @param filter 筛选条件
+   * @returns Promise<ResultDomain<number>>
+   */
+  async countRecommends(filter?: any): Promise<ResultDomain<number>> {
+    const response = await api.post<number>('/news/recommends/count', filter);
+    return response.data;
+  }
+};
+
+export default resourceRecommendApi;
+