web-文件接口

schoolNewsWeb/src/apis/homepage/banner.ts

@@ -0,0 +1,41 @@
+/**
+ * @description 轮播图相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { Banner, Resource, ResultDomain } from '@/types';
+
+/**
+ * 轮播图API服务
+ */
+export const bannerApi = {
+  /**
+   * 获取轮播组件数据
+   * @returns Promise<ResultDomain<Banner>>
+   */
+  async getBannerList(): Promise<ResultDomain<Banner>> {
+    const response = await api.get<Banner>('/homepage/banner/list');
+    return response.data;
+  },
+
+  /**
+   * 点击轮播跳转新闻详情
+   * @param bannerID Banner ID
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getBannerNewsDetail(bannerID: string): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>(`/homepage/banner/click/${bannerID}`);
+    return response.data;
+  },
+
+  /**
+   * 获取活跃轮播列表
+   * @returns Promise<ResultDomain<Banner>>
+   */
+  async getActiveBanners(): Promise<ResultDomain<Banner>> {
+    const response = await api.get<Banner>('/homepage/banner/active');
+    return response.data;
+  }
+};

schoolNewsWeb/src/apis/homepage/index.ts

@@ -1,208 +1,13 @@
 /**
  * @description 首页相关API
- * @author system
+ * @author yslg
  * @since 2025-10-15
  */
 
-import { api } from '@/apis/index';
-import type { Resource, Banner, ResultDomain } from '@/types';
-
-/**
- * 首页API服务
- */
-export const homepageApi = {
-  /**
-   * 获取轮播组件数据
-   * @returns Promise<ResultDomain<Banner>>
-   */
-  async getBannerList(): Promise<ResultDomain<Banner>> {
-    const response = await api.get<Banner>('/homepage/banner/list');
-    return response.data;
-  },
-
-  /**
-   * 点击轮播跳转新闻详情
-   * @param bannerID Banner ID
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getBannerNewsDetail(bannerID: string): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>(`/homepage/banner/click/${bannerID}`);
-    return response.data;
-  },
-
-  /**
-   * 获取活跃轮播列表
-   * @returns Promise<ResultDomain<Banner>>
-   */
-  async getActiveBanners(): Promise<ResultDomain<Banner>> {
-    const response = await api.get<Banner>('/homepage/banner/active');
-    return response.data;
-  },
-
-  /**
-   * 获取TOP资源推荐列表
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getTopRecommendList(): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/recommend/top-list');
-    return response.data;
-  },
-
-  /**
-   * 后台调控展示顺序
-   * @param orderData 排序数据
-   * @returns Promise<ResultDomain<boolean>>
-   */
-  async updateRecommendOrder(orderData: any): Promise<ResultDomain<boolean>> {
-    const response = await api.put<boolean>('/homepage/recommend/order', orderData);
-    return response.data;
-  },
-
-  /**
-   * 获取高热度新闻
-   * @param limit 限制数量
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getHotNews(limit?: number): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/recommend/hot-news', { limit });
-    return response.data;
-  },
-
-  /**
-   * 获取思政新闻概览
-   * @param pageNum 页码
-   * @param pageSize 每页条数
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getNewsOverview(pageNum?: number, pageSize?: number): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/news/overview', {
-      pageNum,
-      pageSize
-    });
-    return response.data;
-  },
-
-  /**
-   * 点击跳转二级详情页
-   * @param newsID 新闻ID
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getNewsDetail(newsID: string): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>(`/homepage/news/detail/${newsID}`);
-    return response.data;
-  },
-
-  /**
-   * 获取最新思政新闻
-   * @param limit 限制数量
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async getLatestNews(limit?: number): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/news/latest', { limit });
-    return response.data;
-  },
-
-  /**
-   * 获取顶部菜单栏配置
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getTopMenuConfig(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/menu/top-menu');
-    return response.data;
-  },
-
-  /**
-   * 后台修改菜单名称
-   * @param menuData 菜单数据
-   * @returns Promise<ResultDomain<boolean>>
-   */
-  async updateMenuName(menuData: any): Promise<ResultDomain<boolean>> {
-    const response = await api.put<boolean>('/homepage/menu/update-name', menuData);
-    return response.data;
-  },
-
-  /**
-   * 获取菜单项列表
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getMenuList(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/menu/list');
-    return response.data;
-  },
-
-  /**
-   * 模糊检索资源
-   * @param keyword 关键词
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async searchResources(keyword: string): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/search', { keyword });
-    return response.data;
-  },
-
-  /**
-   * 实时搜索建议
-   * @param keyword 关键词
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getSearchSuggestions(keyword: string): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/search/suggestions', { keyword });
-    return response.data;
-  },
-
-  /**
-   * 获取热门搜索词
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getHotKeywords(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/search/hot-keywords');
-    return response.data;
-  },
-
-  /**
-   * 搜索新闻
-   * @param keyword 关键词
-   * @returns Promise<ResultDomain<Resource>>
-   */
-  async searchNews(keyword: string): Promise<ResultDomain<Resource>> {
-    const response = await api.get<Resource>('/homepage/search/news', { keyword });
-    return response.data;
-  },
-
-  /**
-   * 搜索课程
-   * @param keyword 关键词
-   * @returns Promise<ResultDomain<any>>
-   */
-  async searchCourses(keyword: string): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/search/courses', { keyword });
-    return response.data;
-  },
-
-  /**
-   * 获取首页统计数据
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getHomePageStatistics(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/statistics');
-    return response.data;
-  },
-
-  /**
-   * 获取今日访问量
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getTodayVisits(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/statistics/today-visits');
-    return response.data;
-  },
-
-  /**
-   * 获取资源总数
-   * @returns Promise<ResultDomain<any>>
-   */
-  async getTotalResources(): Promise<ResultDomain<any>> {
-    const response = await api.get<any>('/homepage/statistics/total-resources');
-    return response.data;
-  }
-};
+// 重新导出各个子模块
+export { bannerApi } from './banner';
+export { recommendApi } from './recommend';
+export { newsApi } from './news';
+export { menuApi } from './menu';
+export { searchApi } from './search';
+export { statisticsApi } from './statistics';

schoolNewsWeb/src/apis/homepage/menu.ts

@@ -0,0 +1,41 @@
+/**
+ * @description 菜单相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { ResultDomain } from '@/types';
+
+/**
+ * 菜单API服务
+ */
+export const menuApi = {
+  /**
+   * 获取顶部菜单栏配置
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getTopMenuConfig(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/menu/top-menu');
+    return response.data;
+  },
+
+  /**
+   * 后台修改菜单名称
+   * @param menuData 菜单数据
+   * @returns Promise<ResultDomain<boolean>>
+   */
+  async updateMenuName(menuData: any): Promise<ResultDomain<boolean>> {
+    const response = await api.put<boolean>('/homepage/menu/update-name', menuData);
+    return response.data;
+  },
+
+  /**
+   * 获取菜单项列表
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getMenuList(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/menu/list');
+    return response.data;
+  }
+};

schoolNewsWeb/src/apis/homepage/news.ts

@@ -0,0 +1,47 @@
+/**
+ * @description 新闻相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { Resource, ResultDomain } from '@/types';
+
+/**
+ * 新闻API服务
+ */
+export const newsApi = {
+  /**
+   * 获取思政新闻概览
+   * @param pageNum 页码
+   * @param pageSize 每页条数
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getNewsOverview(pageNum?: number, pageSize?: number): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/news/overview', {
+      pageNum,
+      pageSize
+    });
+    return response.data;
+  },
+
+  /**
+   * 点击跳转二级详情页
+   * @param newsID 新闻ID
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getNewsDetail(newsID: string): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>(`/homepage/news/detail/${newsID}`);
+    return response.data;
+  },
+
+  /**
+   * 获取最新思政新闻
+   * @param limit 限制数量
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getLatestNews(limit?: number): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/news/latest', { limit });
+    return response.data;
+  }
+};

schoolNewsWeb/src/apis/homepage/recommend.ts

@@ -0,0 +1,42 @@
+/**
+ * @description 推荐相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { Resource, ResultDomain } from '@/types';
+
+/**
+ * 推荐API服务
+ */
+export const recommendApi = {
+  /**
+   * 获取TOP资源推荐列表
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getTopRecommendList(): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/recommend/top-list');
+    return response.data;
+  },
+
+  /**
+   * 后台调控展示顺序
+   * @param orderData 排序数据
+   * @returns Promise<ResultDomain<boolean>>
+   */
+  async updateRecommendOrder(orderData: any): Promise<ResultDomain<boolean>> {
+    const response = await api.put<boolean>('/homepage/recommend/order', orderData);
+    return response.data;
+  },
+
+  /**
+   * 获取高热度新闻
+   * @param limit 限制数量
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async getHotNews(limit?: number): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/recommend/hot-news', { limit });
+    return response.data;
+  }
+};

schoolNewsWeb/src/apis/homepage/search.ts

@@ -0,0 +1,62 @@
+/**
+ * @description 搜索相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { Resource, ResultDomain } from '@/types';
+
+/**
+ * 搜索API服务
+ */
+export const searchApi = {
+  /**
+   * 模糊检索资源
+   * @param keyword 关键词
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async searchResources(keyword: string): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/search', { keyword });
+    return response.data;
+  },
+
+  /**
+   * 实时搜索建议
+   * @param keyword 关键词
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getSearchSuggestions(keyword: string): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/search/suggestions', { keyword });
+    return response.data;
+  },
+
+  /**
+   * 获取热门搜索词
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getHotKeywords(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/search/hot-keywords');
+    return response.data;
+  },
+
+  /**
+   * 搜索新闻
+   * @param keyword 关键词
+   * @returns Promise<ResultDomain<Resource>>
+   */
+  async searchNews(keyword: string): Promise<ResultDomain<Resource>> {
+    const response = await api.get<Resource>('/homepage/search/news', { keyword });
+    return response.data;
+  },
+
+  /**
+   * 搜索课程
+   * @param keyword 关键词
+   * @returns Promise<ResultDomain<any>>
+   */
+  async searchCourses(keyword: string): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/search/courses', { keyword });
+    return response.data;
+  }
+};

schoolNewsWeb/src/apis/homepage/statistics.ts

@@ -0,0 +1,40 @@
+/**
+ * @description 统计相关API
+ * @author yslg
+ * @since 2025-10-15
+ */
+
+import { api } from '@/apis/index';
+import type { ResultDomain } from '@/types';
+
+/**
+ * 统计API服务
+ */
+export const statisticsApi = {
+  /**
+   * 获取首页统计数据
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getHomePageStatistics(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/statistics');
+    return response.data;
+  },
+
+  /**
+   * 获取今日访问量
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getTodayVisits(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/statistics/today-visits');
+    return response.data;
+  },
+
+  /**
+   * 获取资源总数
+   * @returns Promise<ResultDomain<any>>
+   */
+  async getTotalResources(): Promise<ResultDomain<any>> {
+    const response = await api.get<any>('/homepage/statistics/total-resources');
+    return response.data;
+  }
+};