From 4271a7a5ddd1d8288a95ea5313d1329bb1fb9e61 Mon Sep 17 00:00:00 2001
From: jqtmviyu <jqtmviyu@gmail.com>
Date: Thu, 24 Apr 2025 11:36:39 +0800
Subject: [PATCH] =?UTF-8?q?style:=20:art:=20aPI=20=E6=8E=A5=E5=8F=A3?=
 =?UTF-8?q?=E7=BB=9F=E4=B8=80=E6=B7=BB=E5=8A=A0=E5=90=8E=E7=BC=80API,=20?=
 =?UTF-8?q?=E6=96=B9=E4=BE=BF=E8=AF=86=E5=88=AB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/JbcGuess.vue |  4 ++--
 src/pages/hot/hot.vue       |  6 +++---
 src/pages/index/index.vue   | 14 +++++++-------
 src/services/home.ts        |  8 ++++----
 src/services/hot.ts         |  2 +-
 src/types/category.d.ts     | 27 +++++++++++++++++++++++++++
 6 files changed, 44 insertions(+), 17 deletions(-)
 create mode 100644 src/types/category.d.ts

diff --git a/src/components/JbcGuess.vue b/src/components/JbcGuess.vue
index 127769a..3877a74 100644
--- a/src/components/JbcGuess.vue
+++ b/src/components/JbcGuess.vue
@@ -25,7 +25,7 @@
 
 <script setup lang="ts">
 import type { GuessItem } from '@/types/home'
-import { getGuessLike } from '@/services/home'
+import { getGuessLikeAPI } from '@/services/home'
 import { onBeforeMount, ref } from 'vue'
 import type { PageParams } from '@/types/global'
 
@@ -44,7 +44,7 @@ const getGuessList = async () => {
   if (finish.value === true) {
     return uni.showToast({ icon: 'none', title: '没有更多数据~' })
   }
-  const res = await getGuessLike(pageParams)
+  const res = await getGuessLikeAPI(pageParams)
   // 追加数据
   guessList.value.push(...res.result.items)
   // 更新分页参数
diff --git a/src/pages/hot/hot.vue b/src/pages/hot/hot.vue
index 1b11058..00700f4 100644
--- a/src/pages/hot/hot.vue
+++ b/src/pages/hot/hot.vue
@@ -52,7 +52,7 @@
 
 <script setup lang="ts">
 import { onLoad } from '@dcloudio/uni-app'
-import { getHotRecommend } from '@/services/hot'
+import { getHotRecommendAPI } from '@/services/hot'
 import type { SubTypeItem } from '@/types/hot'
 import { ref } from 'vue'
 
@@ -84,7 +84,7 @@ const actived = ref(0)
 
 // 获取热门商品, 不传subType, 获取所有分类第一页
 const getRecommend = async () => {
-  const res = await getHotRecommend(currHot!.url, {
+  const res = await getHotRecommendAPI(currHot!.url, {
     page: import.meta.env.DEV ? 33 : 1,
     pageSize: 10,
   })
@@ -107,7 +107,7 @@ const onScrollToLower = async () => {
   }
   const nextPage = page + 1
   // 接口被复用了, 没有传的subType, 没有返回 goodsItems 数据
-  const res = await getHotRecommend(currHot!.url, {
+  const res = await getHotRecommendAPI(currHot!.url, {
     subType: subTypeId,
     page: nextPage,
     pageSize,
diff --git a/src/pages/index/index.vue b/src/pages/index/index.vue
index c0fe018..ea7f22b 100644
--- a/src/pages/index/index.vue
+++ b/src/pages/index/index.vue
@@ -31,7 +31,7 @@
 import type { BannerItem, CategoryItem, HotItem } from '@/types/home'
 import CustomNavbar from './components/CustomNavbar.vue'
 import { ref } from 'vue'
-import { getCategory, getHomeBanner, getHomeHot } from '@/services/home'
+import { getCategoryAPI, getHomeBannerAPI, getHomeHotAPI } from '@/services/home'
 import { onLoad } from '@dcloudio/uni-app'
 import CategoryPanel from './components/CategoryPanel.vue'
 import HotPanel from './components/HotPanel.vue'
@@ -44,21 +44,21 @@ const isLoading = ref(true)
 // 获取轮播图数据
 const bannerList = ref<BannerItem[]>([])
 const getBannerList = async () => {
-  const res = await getHomeBanner()
+  const res = await getHomeBannerAPI()
   bannerList.value = res.result
 }
 
 // 获取分类数据
 const categoryList = ref<CategoryItem[]>([])
-const getCategoryList = async () => {
-  const res = await getCategory()
+const getCategoryAPIList = async () => {
+  const res = await getCategoryAPI()
   categoryList.value = res.result
 }
 
 // 获取热门商品数据
 const hotList = ref<HotItem[]>([])
 const getHotList = async () => {
-  const res = await getHomeHot()
+  const res = await getHomeHotAPI()
   hotList.value = res.result
 }
 
@@ -78,7 +78,7 @@ const onRefresh = async () => {
   guessRef.value?.resetData()
   await Promise.allSettled([
     getBannerList(),
-    getCategoryList(),
+    getCategoryAPIList(),
     getHotList(),
     guessRef.value?.getMore(),
   ])
@@ -88,7 +88,7 @@ const onRefresh = async () => {
 // 页面加载勾子
 onLoad(async () => {
   isLoading.value = true
-  await Promise.allSettled([getBannerList(), getCategoryList(), getHotList()])
+  await Promise.allSettled([getBannerList(), getCategoryAPIList(), getHotList()])
   isLoading.value = false
 })
 </script>
diff --git a/src/services/home.ts b/src/services/home.ts
index 79097bb..2486152 100644
--- a/src/services/home.ts
+++ b/src/services/home.ts
@@ -7,7 +7,7 @@ import { http } from '@/utils/http'
  * @param distributionSite - 广告区域展示位置: 1 为首页（默认值）; 2 为商品分类页
  * @returns 轮播图数据
  */
-export const getHomeBanner = (distributionSite = 1) => {
+export const getHomeBannerAPI = (distributionSite = 1) => {
   return http<BannerItem[]>({
     url: '/home/banner',
     method: 'GET',
@@ -21,7 +21,7 @@ export const getHomeBanner = (distributionSite = 1) => {
  * 获取首页分类
  * @returns 分类数据
  */
-export const getCategory = () => {
+export const getCategoryAPI = () => {
   return http<CategoryItem[]>({
     url: '/home/category/mutli',
     method: 'GET',
@@ -32,7 +32,7 @@ export const getCategory = () => {
  * 获取首页热门商品
  * @returns 热门商品数据
  */
-export const getHomeHot = () => {
+export const getHomeHotAPI = () => {
   return http<HotItem[]>({
     url: '/home/hot/mutli',
     method: 'GET',
@@ -44,7 +44,7 @@ export const getHomeHot = () => {
  * @param data - 分页参数
  * @returns 猜你喜欢数据
  */
-export const getGuessLike = (data?: PageParams) => {
+export const getGuessLikeAPI = (data?: PageParams) => {
   return http<PageResult<GuessItem>>({
     url: '/home/goods/guessLike',
     method: 'GET',
diff --git a/src/services/hot.ts b/src/services/hot.ts
index 36f44d0..1392bed 100644
--- a/src/services/hot.ts
+++ b/src/services/hot.ts
@@ -9,7 +9,7 @@ type HotParams = PageParams & {
 /**
  * 获取热门推荐
  */
-export const getHotRecommend = (url: string, data: HotParams) => {
+export const getHotRecommendAPI = (url: string, data: HotParams) => {
   return http<HotResult>({
     url,
     method: 'GET',
diff --git a/src/types/category.d.ts b/src/types/category.d.ts
new file mode 100644
index 0000000..180f2fc
--- /dev/null
+++ b/src/types/category.d.ts
@@ -0,0 +1,27 @@
+import type { GoodsItem } from './global'
+
+/** 一级分类项 */
+export type CategoryTopItem = {
+  /** 二级分类集合[ 二级分类项 ] */
+  children: CategoryChildItem[]
+  /** 一级分类id */
+  id: string
+  /** 一级分类图片集[ 一级分类图片项 ] */
+  imageBanners: string[]
+  /** 一级分类名称 */
+  name: string
+  /** 一级分类图片 */
+  picture: string
+}
+
+/** 二级分类项 */
+export type CategoryChildItem = {
+  /** 商品集合[ 商品项 ] */
+  goods: GoodsItem[]
+  /** 二级分类id */
+  id: string
+  /** 二级分类名称 */
+  name: string
+  /** 二级分类图片 */
+  picture: string
+}