fix: 修正面包屑导航的显示逻辑

- 竖屏下不显示面包屑导航

app/components/pages/products/ProductHeader.vue

@@ -38,6 +38,10 @@
     <div class="product-info">
       <h1>{{ product.name }}</h1>
       <p class="summary">{{ product.summary }}</p>
+      <p v-if="product.status === 'discontinued'" class="discontinued-warning">
+        <el-icon><ElIconWarning /></el-icon>
+        {{ $t('product-discontinued-warning') }}
+      </p>
     </div>
   </div>
 </template>
@@ -105,6 +109,10 @@
     margin-bottom: 2rem;
   }
 
+  .discontinued-warning {
+    color: var(--el-color-error);
+  }
+
   @media (max-width: 768px) {
     .product-header {
       grid-template-columns: 1fr;

app/components/pages/search/SearchResultCard.vue

@@ -0,0 +1,75 @@
+<template>
+  <el-card class="result-card">
+    <el-row>
+      <el-col :span="12">
+        <h3 class="result-title">{{ item.title }}</h3>
+        <p v-if="item.summary" class="result-summary">
+          {{ item.summary }}
+        </p>
+        <p v-if="item.sectionType" class="result-type">
+          <span>{{ $t('search.section') }}: </span>
+          <span class="result-type-name">{{ typeLabel }}</span>
+          <span v-if="item.type" class="result-type-name"
+            >({{ item.type }})</span
+          >
+        </p>
+      </el-col>
+      <el-col :span="12" class="image-col">
+        <el-image
+          v-if="item.thumbnail"
+          :src="item.thumbnail"
+          :alt="item.title"
+          style="width: 150px"
+        />
+      </el-col>
+    </el-row>
+  </el-card>
+</template>
+
+<script setup lang="ts">
+  defineProps<{
+    item: SearchItemView;
+    typeLabel: string;
+  }>();
+</script>
+
+<style scoped>
+  .result-card {
+    border-radius: 12px;
+    transition: box-shadow 0.2s ease;
+  }
+
+  .result-card:hover {
+    box-shadow: 0 12px 24px rgba(0, 0, 0, 0.06);
+  }
+
+  .result-title {
+    font-size: 1.2rem;
+    font-weight: 600;
+    color: var(--el-color-primary);
+    display: inline-block;
+  }
+
+  .result-summary {
+    font-size: 0.95rem;
+    color: var(--el-text-color-regular);
+    margin-bottom: 0.5rem;
+    line-height: 1.6;
+  }
+
+  .result-type {
+    font-size: 0.8rem;
+    color: var(--el-text-color-secondary);
+  }
+
+  .result-type-name {
+    margin-left: 4px;
+    color: var(--el-color-primary);
+  }
+
+  .image-col {
+    display: flex;
+    justify-content: end;
+    align-items: center;
+  }
+</style>

app/components/pages/search/SearchResults.vue

@@ -3,19 +3,13 @@
     <div class="search-results">
       <NuxtLink
         v-for="hit in paginatedHits"
-        :key="`${hit.type}-${hit.id}`"
+        :key="`${hit.sectionType}-${hit.id}`"
         :to="localePath(resolveHitLink(hit))"
       >
-        <el-card class="result-card">
+        <search-result-card
-          <h3 class="result-title">{{ hit.title }}</h3>
+          :item="hit"
-          <p v-if="hit.summary" class="result-summary">
+          :type-label="getIndexLabel(hit.sectionType)"
-            {{ hit.summary }}
+        />
-          </p>
-          <p v-if="hit.type" class="result-type">
-            <span>{{ $t('search.section') }}: </span>
-            <span class="result-type-name">{{ getIndexLabel(hit.type) }}</span>
-          </p>
-        </el-card>
       </NuxtLink>
     </div>
 
@@ -72,7 +66,7 @@
   const items = props.searchItems;
   const filteredHits = computed(() => {
     if (props.category) {
-      return items.filter((item) => item.type === props.category);
+      return items.filter((item) => item.sectionType === props.category);
     } else {
       return items;
     }
@@ -116,19 +110,19 @@
 
     const slug = String(slugCandidate);
 
-    if (item.type === 'product') {
+    if (item.sectionType === 'product') {
       return localePath({ path: `/products/${slug}` });
     }
 
-    if (item.type === 'solution') {
+    if (item.sectionType === 'solution') {
       return localePath({ path: `/solutions/${slug}` });
     }
 
-    if (item.type === 'document') {
+    if (item.sectionType === 'document') {
       return localePath({ path: `/download/${slug}` });
     }
 
-    if (item.type === 'question') {
+    if (item.sectionType === 'question') {
       return localePath({ path: `/support/faq`, query: { focus: slug } });
     }
 

app/components/pages/search/SearchTabs.vue

@@ -32,7 +32,7 @@
   const resultCount = computed(() => {
     const map: Record<string, number> = { all: props.searchItems.length };
     for (const item of props.searchItems) {
-      map[item.type] = (map[item.type] ?? 0) + 1;
+      map[item.sectionType] = (map[item.sectionType] ?? 0) + 1;
     }
     return map;
   });
@@ -47,3 +47,9 @@
     currentPage.value = 1; // 重置页码
   });
 </script>
+
+<style scoped>
+  .el-tabs {
+    width: 100%;
+  }
+</style>

app/components/pages/support/DocumentFilter.vue

@@ -0,0 +1,113 @@
+<template>
+  <div class="document-category">
+    <el-row :gutter="12">
+      <el-col :span="12" :xs="12">
+        <span class="select-label">{{
+          $t('product-filter.product-type')
+        }}</span>
+        <el-select
+          v-model="model.selectedProductType"
+          :placeholder="$t('product-filter.select-product-type')"
+          clearable
+        >
+          <el-option
+            v-for="type in productTypeOptions"
+            :key="type.id"
+            :label="type.name"
+            :value="type.id"
+          />
+        </el-select>
+      </el-col>
+
+      <el-col :span="12" :xs="12">
+        <span class="select-label">{{
+          $t('product-filter.product-model')
+        }}</span>
+        <el-select
+          v-model="model.selectedProduct"
+          :placeholder="$t('product-filter.select-product-model')"
+          clearable
+        >
+          <el-option
+            v-for="product in productOptions"
+            :key="product.id"
+            :label="product.name"
+            :value="product.id"
+          />
+        </el-select>
+      </el-col>
+
+      <el-col :span="12" :xs="24">
+        <span class="select-label">
+          {{ $t('product-filter.document-type') }}
+        </span>
+        <el-select
+          v-model="model.selectedDocumentType"
+          :placeholder="$t('product-filter.select-document-type')"
+          clearable
+        >
+          <el-option
+            v-for="questionType in documentTypeOptions"
+            :key="questionType.id"
+            :label="questionType.name"
+            :value="questionType.id"
+          />
+        </el-select>
+      </el-col>
+
+      <el-col :span="12" :xs="24">
+        <span class="select-label">{{ $t('product-filter.keyword') }}</span>
+        <el-input
+          v-model="model.keyword"
+          :placeholder="$t('product-filter.enter-keyword')"
+          clearable
+          :prefix-icon="Search"
+        />
+      </el-col>
+    </el-row>
+  </div>
+</template>
+
+<script setup lang="ts">
+  import { Search } from '@element-plus/icons-vue';
+
+  defineProps({
+    productTypeOptions: {
+      type: Array as () => Array<DocumentListProductType>,
+      default: () => [],
+    },
+    productOptions: {
+      type: Array as () => Array<DocumentListProduct>,
+      default: () => [],
+    },
+    documentTypeOptions: {
+      type: Array as () => Array<DocumentTypeView>,
+      default: () => [],
+    },
+  });
+
+  const model = defineModel<{
+    selectedProduct: string | null;
+    selectedProductType: string | null;
+    selectedDocumentType: string | null;
+    keyword: string;
+  }>();
+</script>
+
+<style scoped>
+  .document-category {
+    margin-bottom: 1rem;
+    padding: 0 0;
+  }
+
+  .select-label {
+    color: var(--el-text-color-secondary);
+    font-size: 0.9rem;
+  }
+
+  :deep(.el-select__wrapper),
+  :deep(.el-input__wrapper) {
+    height: 40px;
+    font-size: 0.9rem;
+  }
+</style>

app/components/pages/support/QuestionFilter.vue

@@ -1,12 +1,12 @@
 <template>
   <div class="question-category">
-    <el-row class="hide-on-mobile" :gutter="12">
+    <el-row :gutter="12">
-      <el-col :span="8">
+      <el-col :span="12" :xs="12">
         <span class="select-label">{{
           $t('product-filter.product-type')
         }}</span>
         <el-select
-          v-model="model.selectedType"
+          v-model="model.selectedProductType"
           :placeholder="$t('product-filter.select-product-type')"
           clearable
         >
@@ -19,7 +19,7 @@
         </el-select>
       </el-col>
 
-      <el-col :span="8">
+      <el-col :span="12" :xs="12">
         <span class="select-label">{{
           $t('product-filter.product-model')
         }}</span>
@@ -37,7 +37,25 @@
         </el-select>
       </el-col>
 
-      <el-col :span="8">
+      <el-col :span="12" :xs="24">
+        <span class="select-label">
+          {{ $t('product-filter.question-type') }}
+        </span>
+        <el-select
+          v-model="model.selectedQuestionType"
+          :placeholder="$t('product-filter.select-question-type')"
+          clearable
+        >
+          <el-option
+            v-for="questionType in questionTypeOptions"
+            :key="questionType.id"
+            :label="questionType.name"
+            :value="questionType.id"
+          />
+        </el-select>
+      </el-col>
+
+      <el-col :span="12" :xs="24">
         <span class="select-label">{{ $t('product-filter.keyword') }}</span>
         <el-input
           v-model="model.keyword"
@@ -47,52 +65,6 @@
         />
       </el-col>
     </el-row>
-    <el-row class="display-on-mobile" :gutter="12">
-      <el-col :span="12">
-        <span class="select-label">{{
-          $t('product-filter.product-type')
-        }}</span>
-        <el-select
-          v-model="model.selectedType"
-          :placeholder="$t('product-filter.select-product-type')"
-          clearable
-        >
-          <el-option
-            v-for="type in productTypeOptions"
-            :key="type.id"
-            :label="type.name"
-            :value="type.id"
-          />
-        </el-select>
-      </el-col>
-
-      <el-col :span="12">
-        <span class="select-label">{{
-          $t('product-filter.product-model')
-        }}</span>
-        <el-select
-          v-model="model.selectedProduct"
-          :placeholder="$t('product-filter.select-product-model')"
-          clearable
-        >
-          <el-option
-            v-for="product in productOptions"
-            :key="product.id"
-            :label="product.name"
-            :value="product.id"
-          />
-        </el-select>
-      </el-col>
-    </el-row>
-    <el-row class="display-on-mobile">
-      <span class="select-label">{{ $t('product-filter.keyword') }}</span>
-      <el-input
-        v-model="model.keyword"
-        :placeholder="$t('product-filter.enter-keyword')"
-        clearable
-        :prefix-icon="Search"
-      />
-    </el-row>
   </div>
 </template>
 
@@ -101,19 +73,24 @@
 
   defineProps({
     productTypeOptions: {
-      type: Array as () => Array<{ id: number; name: string }>,
+      type: Array as () => Array<QuestionListProductType>,
       default: () => [],
     },
     productOptions: {
-      type: Array as () => Array<{ id: number; name: string }>,
+      type: Array as () => Array<QuestionListProduct>,
+      default: () => [],
+    },
+    questionTypeOptions: {
+      type: Array as () => Array<QuestionTypeView>,
       default: () => [],
     },
   });
 
   const model = defineModel<{
+    selectedProduct: string | null;
+    selectedProductType: string | null;
+    selectedQuestionType: string | null;
     keyword: string;
-    selectedType: number | null;
-    selectedProduct: number | null;
   }>();
 </script>
 
@@ -132,18 +109,4 @@
     height: 40px;
     font-size: 0.9rem;
   }
-
-  .display-on-mobile {
-    display: none;
-  }
-
-  @media (max-width: 768px) {
-    .hide-on-mobile {
-      display: none;
-    }
-    .display-on-mobile {
-      display: flex;
-      margin-bottom: 1rem;
-    }
-  }
 </style>

app/components/shared/DocumentList.vue

@@ -7,7 +7,17 @@
       @click="handleClick(doc.fileId)"
     >
       <div class="document-info">
-        <h3>{{ doc.title }}</h3>
+        <div class="document-title">
+          <h3>
+            {{ doc.title }}
+            <span v-if="showCategory && doc.type" class="document-category">
+              |
+            </span>
+            <span v-if="showCategory && doc.type" class="document-category">
+              {{ doc.type.name }}
+            </span>
+          </h3>
+        </div>
         <div class="document-content">
           <span v-if="doc.size" class="document-meta"
             >{{ $t('document-meta.size') }}: {{ formatFileSize(doc.size) }}
@@ -28,6 +38,10 @@
       type: Array as () => Array<ProductDocumentView>,
       default: () => [],
     },
+    showCategory: {
+      type: Boolean,
+      default: true,
+    },
   });
 
   const localePath = useLocalePath();
@@ -63,6 +77,15 @@
     color: var(--el-text-color-secondary);
   }
 
+  .document-title {
+    margin-bottom: 0.5rem;
+  }
+
+  .document-category {
+    font-size: 0.75rem;
+    color: var(--el-text-color-secondary);
+  }
+
   .download-button {
     margin-left: auto;
   }

app/components/shared/JinshenFooter.vue

@@ -84,7 +84,12 @@
             © {{ currentYear }} {{ $t('company-name') }}.
             {{ $t('all-rights-reserved') }}
           </p>
-          <p>备案号: 浙ICP备12003709号-5</p>
+          <p>
+            备案号:
+            <a href="https://beian.miit.gov.cn/" target="_blank"
+              >浙ICP备12003709号-5</a
+            >
+          </p>
         </div>
         <!-- <div class="footer-links-bottom"> -->
         <!--   <NuxtLink :to="$localePath('/privacy')">{{ -->

app/components/shared/QuestionList.vue

@@ -51,9 +51,19 @@
       // 展开目标项
       activeNames.value = [target.id];
 
+      await nextTick();
+      await new Promise((resolve) => setTimeout(resolve, 100)); // 等待动画完成
+
       // 平滑滚动到对应位置
-      const el = document.querySelector(`#q-${target.id}`);
+      // const el = document.querySelector(`#q-${target.id}`);
-      el?.scrollIntoView({ behavior: 'smooth', block: 'start' });
+      // el?.scrollIntoView({ behavior: 'smooth', block: 'start' });
+      setTimeout(() => {
+        const el = document.querySelector(`#q-${target.id}`);
+        el?.scrollIntoView({
+          behavior: 'smooth',
+          block: 'start',
+        });
+      }, 200); // 与 el-collapse 的 transition 时间匹配
     },
     { immediate: true }
   );

app/pages/about/index.vue

@@ -1,36 +1,37 @@
 <template>
   <div class="page-container">
-    <div v-if="!pending">
+    <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
-      <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
 
-      <div class="content">
+    <div class="content">
-        <!-- eslint-disable-next-line vue/no-v-html -->
+      <el-skeleton :loading="pending" :rows="10" animated>
-        <div class="html-typography" v-html="companyProfile.content || ''" />
+        <template #default>
-        <!-- <div v-if="!hydrated" v-html="companyProfile.content || ''" /> -->
+          <!-- eslint-disable-next-line vue/no-v-html -->
-        <!-- <div v-else> -->
+          <div class="html-typography" v-html="companyProfile?.content || ''" />
-        <!--   <html-renderer -->
+          <!-- <div v-if="!hydrated" v-html="companyProfile.content || ''" /> -->
-        <!--     class="html-typography" -->
+          <!-- <div v-else> -->
-        <!--     :html="companyProfile.content || ''" -->
+          <!--   <html-renderer -->
-        <!--   /> -->
+          <!--     class="html-typography" -->
-        <!-- </div> -->
+          <!--     :html="companyProfile.content || ''" -->
-      </div>
+          <!--   /> -->
+          <!-- </div> -->
 
-      <el-divider content-position="left">{{ $t('learn-more') }}</el-divider>
+          <el-divider content-position="left">{{
-      <div class="button-group">
+            $t('learn-more')
-        <learn-more-card
+          }}</el-divider>
-          :title="$t('navigation.contact-info')"
+          <div class="button-group">
-          :icon="ElIconService"
+            <learn-more-card
-          :to="$localePath('/support/contact-us')"
+              :title="$t('navigation.contact-info')"
-        />
+              :icon="ElIconService"
-        <learn-more-card
+              :to="$localePath('/support/contact-us')"
-          :title="$t('navigation.address')"
+            />
-          :icon="ElIconMapLocation"
+            <learn-more-card
-          @click="openMap"
+              :title="$t('navigation.address')"
-        />
+              :icon="ElIconMapLocation"
-      </div>
+              @click="openMap"
-    </div>
+            />
-    <div v-else class="loading">
+          </div>
-      <el-skeleton :rows="5" animated />
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -42,7 +43,9 @@
     { label: $t('navigation.home'), to: localePath('/') },
     { label: $t('navigation.about-us') },
   ];
-  const { data: companyProfile, pending, error } = await useCompanyProfile();
+  const { data, pending, error } = useCompanyProfile();
+
+  const companyProfile = computed(() => data.value ?? null);
 
   const openMap = () => {
     window.open(localePath('/locate'));
@@ -106,5 +109,9 @@
       margin-left: 0;
       gap: 0.5rem;
     }
+
+    .breadcrumb {
+      display: none;
+    }
   }
 </style>

app/pages/download/[id].vue

@@ -4,11 +4,17 @@
       <h1 class="page-title">{{ $t('navigation.downloads') }}</h1>
       <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
     </div>
-    <div v-if="!pending" class="page-content">
+    <div class="page-content">
-      <file-card :file-id="id" :file="file" />
+      <el-skeleton
-    </div>
+        :loading="pending"
-    <div v-else>
+        :rows="6"
-      <el-skeleton :rows="6" animated />
+        animated
+        :throttle="{ leading: 500, trailing: 500 }"
+      >
+        <template #default>
+          <file-card :file-id="id" :file="file" />
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -66,4 +72,10 @@
   .breadcrumb {
     margin-left: auto;
   }
+
+  @media (max-width: 768px) {
+    .breadcrumb {
+      display: none;
+    }
+  }
 </style>

app/pages/locate.vue

@@ -1,5 +1,7 @@
 <template>
-  <div>redirecting...</div>
+  <div class="page-container">
+    <h1>{{ $t('redirecting') }}</h1>
+  </div>
 </template>
 
 <script setup lang="ts">
@@ -10,3 +12,17 @@
     window.location.href = platform;
   });
 </script>
+
+<style scoped>
+  .page-container {
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: 80vh;
+  }
+
+  h1 {
+    font-size: 1.5rem;
+    font-weight: bold;
+  }
+</style>

app/pages/products/[slug].vue

@@ -1,31 +1,21 @@
 <template>
   <div class="page-container">
-    <div v-if="!pending">
+    <div v-if="product">
-      <div v-if="product">
+      <!-- 面包屑导航 -->
-        <!-- 面包屑导航 -->
+      <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
-        <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
+      <!-- 产品详情内容 -->
-        <!-- 产品详情内容 -->
+      <product-header :product="product" />
-        <product-header :product="product" />
+      <!-- 产品详细描述 -->
-        <!-- 产品详细描述 -->
+      <product-detail :product="product" />
-        <product-detail :product="product" />
-      </div>
-      <!-- 未找到产品 -->
-      <div v-else class="not-found">
-        <not-found-result
-          :title="$t('product-not-found')"
-          :sub-title="$t('product-not-found-desc')"
-          :back-text="$t('back-to-products')"
-          :on-back="() => $router.push($localePath('/products'))"
-        />
-      </div>
     </div>
-    <div v-else class="loading">
+    <!-- 未找到产品 -->
-      <el-skeleton style="--el-skeleton-circle-size: 400px">
+    <div v-else class="not-found">
-        <template #template>
+      <not-found-result
-          <el-skeleton-item variant="circle" />
+        :title="$t('product-not-found')"
-        </template>
+        :sub-title="$t('product-not-found-desc')"
-      </el-skeleton>
+        :back-text="$t('back-to-products')"
-      <el-skeleton :rows="5" animated />
+        :on-back="() => $router.push($localePath('/products'))"
+      />
     </div>
   </div>
 </template>
@@ -37,7 +27,7 @@
   // 获取路由参数
   const id = route.params.slug as string;
 
-  const { data: product, pending, error } = await useProduct(id);
+  const { data: product, error } = await useProduct(id);
 
   const breadcrumbItems = computed(() => [
     { label: $t('navigation.home'), to: localePath('/') },
@@ -53,8 +43,8 @@
 
   // SEO
   usePageSeo({
-    title: product.value.name || $t('page-title.products'),
+    title: product.value?.name || $t('page-title.products'),
-    description: product.value.summary || '',
+    description: product.value?.summary || '',
   });
 </script>
 

app/pages/products/index.vue

@@ -1,34 +1,58 @@
 <template>
   <div class="page-container">
     <div class="page-header">
-      <h1 class="page-title">{{ $t('our-products') }}</h1>
+      <div>
+        <h1 class="page-title">{{ $t('our-products') }}</h1>
+        <p class="page-subtitle">
+          {{ $t('products-desc') }}{{ $t('find-discontinued-products') }}
+        </p>
+      </div>
+
       <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
     </div>
-    <div v-if="!pending" class="page-content">
+    <div>
-      <div class="products-container">
+      <el-skeleton
-        <el-collapse v-model="activeNames" class="product-collapse">
+        animated
-          <el-collapse-item
+        :loading="pending"
-            v-for="[key, value] in Object.entries(groupedProducts)"
+        :throttle="{ leading: 500, trailing: 500 }"
-            :key="key"
+      >
-            :title="key || '未分类'"
+        <template #template>
-            :name="key || 'no-category'"
+          <div v-for="i in 3" :key="i" class="products-container">
-          >
+            <el-skeleton-item variant="h1" class="skeleton-collapse" />
-            <div class="group-list">
+            <div class="skeleton-group-list">
-              <product-card
+              <el-skeleton-item
-                v-for="product in value.data"
+                v-for="j in 3"
-                :key="product.id"
+                :key="j"
-                :slug="product.id.toString()"
+                variant="rect"
-                :image-url="getImageUrl(product.cover.toString())"
+                class="skeleton-card"
-                :name="product.name"
-                :description="product.summary || ''"
               />
             </div>
-          </el-collapse-item>
+          </div>
-        </el-collapse>
+        </template>
-      </div>
+        <template #default>
-    </div>
+          <div class="products-container">
-    <div v-else>
+            <el-collapse v-model="activeNames" class="product-collapse">
-      <el-skeleton :rows="6" animated />
+              <el-collapse-item
+                v-for="[key, value] in Object.entries(groupedProducts)"
+                :key="key"
+                :title="key || '未分类'"
+                :name="key || 'no-category'"
+              >
+                <div class="group-list">
+                  <product-card
+                    v-for="product in value.data"
+                    :key="product.id"
+                    :slug="product.id.toString()"
+                    :image-url="getImageUrl(product.cover.toString())"
+                    :name="product.name"
+                    :description="product.summary || ''"
+                  />
+                </div>
+              </el-collapse-item>
+            </el-collapse>
+          </div>
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -102,13 +126,18 @@
 
   .page-header {
     display: flex;
+    margin-bottom: 1rem;
   }
 
   .page-title {
     font-size: 2rem;
     font-weight: bold;
     color: var(--el-color-primary);
-    margin-bottom: 1rem;
+  }
+
+  .page-subtitle {
+    font-size: 0.8rem;
+    color: var(--el-text-color-secondary);
   }
 
   .breadcrumb {
@@ -140,6 +169,50 @@
     justify-content: flex-start;
   }
 
+  .skeleton-collapse {
+    height: 50px;
+    width: 100%;
+  }
+
+  .skeleton-group-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 40px;
+    justify-content: flex-start;
+    margin-bottom: 2rem;
+  }
+
+  .skeleton-card {
+    width: 30%;
+    height: 250px;
+    margin-right: 1rem;
+  }
+
+  @media (max-width: 1200px) {
+    .skeleton-card {
+      width: 45%;
+    }
+  }
+
+  @media (max-width: 768px) {
+    .group-list {
+      justify-content: center;
+      align-items: center;
+    }
+    .skeleton-group-list {
+      justify-content: center;
+      align-items: center;
+    }
+
+    .skeleton-card {
+      width: 90%;
+    }
+
+    .breadcrumb {
+      display: none;
+    }
+  }
+
   :deep(.el-collapse-item__header) {
     padding: 30px auto;
     font-size: 1.5rem;

app/pages/search.vue

@@ -1,18 +1,33 @@
 <template>
   <div class="search-page">
     <search-header v-model="keyword" />
-    <div v-if="loading" class="search-state">
+    <div class="search-state">
-      <el-skeleton :rows="4" animated />
+      <el-skeleton
-    </div>
+        :loading="loading"
-    <search-tabs v-else-if="hasResults" :search-items="searchItems" />
+        animated
-    <div v-else class="search-state">
+        :throttle="{ leading: 500, trailing: 500 }"
-      <el-empty
+      >
-        :description="
+        <template #template>
-          route.query.query
+          <el-skeleton-item
-            ? $t('search.no-results', { query: route.query?.query })
+            v-for="i in 10"
-            : $t('search.no-query')
+            :key="i"
-        "
+            variant="rect"
-      />
+            class="skeleton-item"
+          />
+        </template>
+        <template #default>
+          <search-tabs v-if="hasResults" :search-items="searchItems" />
+          <div v-else>
+            <el-empty
+              :description="
+                route.query.query
+                  ? $t('search.no-results', { query: route.query?.query })
+                  : $t('search.no-query')
+              "
+            />
+          </div>
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -96,7 +111,11 @@
   .search-state {
     display: flex;
     justify-content: center;
-    padding: 3rem 0;
+  }
+
+  .skeleton-item {
+    height: 80px;
+    margin-bottom: 1rem;
   }
 
   @media (max-width: 640px) {

app/pages/solutions/[slug].vue

@@ -1,23 +1,18 @@
 <template>
   <div class="page-container">
-    <div v-if="!pending">
+    <div v-if="solution">
-      <div v-if="solution">
+      <div class="page-header">
-        <div class="page-header">
+        <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
-          <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
-        </div>
-        <solution-detail :solution="solution" />
-      </div>
-      <div v-else class="not-found">
-        <not-found-result
-          :title="$t('solution-not-found')"
-          :sub-title="$t('solution-not-found-desc')"
-          :back-text="$t('back-to-solutions')"
-          :on-back="() => $router.push($localePath('/solutions'))"
-        />
       </div>
+      <solution-detail :solution="solution" />
     </div>
-    <div v-else class="loading">
+    <div v-else class="not-found">
-      <el-skeleton :rows="5" animated />
+      <not-found-result
+        :title="$t('solution-not-found')"
+        :sub-title="$t('solution-not-found-desc')"
+        :back-text="$t('back-to-solutions')"
+        :on-back="() => $router.push($localePath('/solutions'))"
+      />
     </div>
   </div>
 </template>
@@ -29,7 +24,7 @@
   // 获取路由参数
   const id = route.params.slug as string;
 
-  const { data: solution, pending, error } = await useSolution(id);
+  const { data: solution, error } = await useSolution(id);
 
   const breadcrumbItems = computed(() => [
     { label: $t('navigation.home'), to: localePath('/') },
@@ -44,8 +39,8 @@
   });
 
   usePageSeo({
-    title: solution.value.title || $t('page-title.solutions'),
+    title: solution.value?.title || $t('page-title.solutions'),
-    description: solution.value.summary || '',
+    description: solution.value?.summary || '',
   });
 </script>
 

app/pages/solutions/index.vue

@@ -1,44 +1,66 @@
 <template>
   <div class="page-container">
     <div class="page-header">
-      <h1 class="page-title">{{ $t('learn-our-solutions') }}</h1>
+      <div>
+        <h1 class="page-title">{{ $t('learn-our-solutions') }}</h1>
+        <p class="page-subtitle">{{ $t('solutions-desc') }}</p>
+      </div>
+
       <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
     </div>
-    <div v-if="!pending" class="solutions-container">
+    <div class="solutions-container">
-      <el-tabs v-model="activeName" class="solutions-tabs">
+      <el-skeleton
-        <el-tab-pane :label="$t('all')" name="all">
+        :loading="pending"
-          <div class="solution-list">
+        animated
-            <solution-card
+        :throttle="{
-              v-for="solution in solutions"
+          leading: 500,
-              :key="solution.id"
+          trailing: 500,
-              :title="solution.title"
+        }"
-              :summary="solution.summary || ''"
+      >
-              :cover-url="getImageUrl(solution.cover || '')"
+        <template #template>
-              :document-id="solution.id.toString()"
+          <div class="skeleton-group-list">
+            <el-skeleton-item
+              v-for="i in 12"
+              :key="i"
+              variant="rect"
+              class="skeleton-card"
             />
           </div>
-        </el-tab-pane>
+        </template>
-        <el-tab-pane
+        <template #default>
-          v-for="[key, value] in Object.entries(groupedSolutions)"
+          <el-tabs v-model="activeName" class="solutions-tabs">
-          :key="key"
+            <el-tab-pane :label="$t('all')" name="all">
-          :label="key || '未分类'"
+              <div class="solution-list">
-          :name="key || 'no-category'"
+                <solution-card
-        >
+                  v-for="solution in solutions"
-          <div class="solution-list">
+                  :key="solution.id"
-            <solution-card
+                  :title="solution.title"
-              v-for="solution in value.data"
+                  :summary="solution.summary || ''"
-              :key="solution.id"
+                  :cover-url="getImageUrl(solution.cover || '')"
-              :document-id="solution.id.toString()"
+                  :document-id="solution.id.toString()"
-              :cover-url="getImageUrl(solution.cover || '')"
+                />
-              :title="solution.title"
+              </div>
-              :summary="solution.summary || ''"
+            </el-tab-pane>
-            />
+            <el-tab-pane
-          </div>
+              v-for="[key, value] in Object.entries(groupedSolutions)"
-        </el-tab-pane>
+              :key="key"
-      </el-tabs>
+              :label="key || '未分类'"
-    </div>
+              :name="key || 'no-category'"
-    <div v-else>
+            >
-      <el-skeleton :rows="6" animated />
+              <div class="solution-list">
+                <solution-card
+                  v-for="solution in value.data"
+                  :key="solution.id"
+                  :document-id="solution.id.toString()"
+                  :cover-url="getImageUrl(solution.cover || '')"
+                  :title="solution.title"
+                  :summary="solution.summary || ''"
+                />
+              </div>
+            </el-tab-pane>
+          </el-tabs>
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -52,7 +74,9 @@
     { label: $t('navigation.solutions') },
   ];
 
-  const { data: solutions, pending, error } = await useSolutionList();
+  const { data, pending, error } = useSolutionList();
+
+  const solutions = computed(() => data.value ?? []);
 
   const activeName = ref<string>('all');
 
@@ -94,15 +118,20 @@
 
   .page-header {
     display: flex;
+    margin-bottom: 1rem;
   }
 
   .page-title {
     font-size: 2rem;
     font-weight: bold;
-    margin-bottom: 1rem;
     color: var(--el-color-primary);
   }
 
+  .page-subtitle {
+    font-size: 0.8rem;
+    color: var(--el-text-color-secondary);
+  }
+
   .breadcrumb {
     margin-left: auto;
   }
@@ -114,4 +143,38 @@
     margin-bottom: 2rem;
     gap: 40px;
   }
+
+  .skeleton-group-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 20px;
+    justify-content: flex-start;
+    margin-bottom: 2rem;
+  }
+
+  .skeleton-card {
+    width: 30%;
+    height: 200px;
+  }
+
+  @media (max-width: 1200px) {
+    .skeleton-card {
+      width: 45%;
+    }
+  }
+
+  @media (max-width: 768px) {
+    .skeleton-group-list {
+      justify-content: center;
+      align-items: center;
+    }
+
+    .skeleton-card {
+      width: 90%;
+    }
+
+    .breadcrumb {
+      display: none;
+    }
+  }
 </style>

app/pages/support/contact-us.vue

@@ -6,19 +6,25 @@
       <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
     </div>
 
-    <div v-if="!pending" class="page-content">
+    <div class="page-content">
-      <!-- eslint-disable-next-line vue/no-v-html -->
+      <el-skeleton
-      <div class="html-typography" v-html="contactInfo?.content || ''" />
+        :rows="10"
-      <!-- <div v-if="!hydrated" v-html="contactInfo?.content || ''" /> -->
+        :loading="pending"
-      <!-- <div v-else> -->
+        animated
-      <!--   <html-renderer -->
+        :throttle="{ leading: 500, trailing: 500 }"
-      <!--     class="html-typography" -->
+      >
-      <!--     :html="contactInfo?.content || ''" -->
+        <template #default>
-      <!--   /> -->
+          <!-- eslint-disable-next-line vue/no-v-html -->
-      <!-- </div> -->
+          <div class="html-typography" v-html="contactInfo?.content || ''" />
-    </div>
+          <!-- <div v-if="!hydrated" v-html="contactInfo?.content || ''" /> -->
-    <div v-else class="loading">
+          <!-- <div v-else> -->
-      <el-skeleton :rows="5" animated />
+          <!--   <html-renderer -->
+          <!--     class="html-typography" -->
+          <!--     :html="contactInfo?.content || ''" -->
+          <!--   /> -->
+          <!-- </div> -->
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
@@ -31,7 +37,9 @@
     { label: $t('navigation.support'), to: localePath('/support') },
     { label: $t('navigation.contact-info') },
   ];
-  const { data: contactInfo, pending, error } = await useContactInfo();
+  const { data, pending, error } = useContactInfo();
+
+  const contactInfo = computed(() => data.value ?? null);
 
   watch(error, (value) => {
     if (value) {
@@ -79,4 +87,10 @@
   :deep(.markdown-body ul) {
     list-style-type: none;
   }
+
+  @media (max-width: 768px) {
+    .breadcrumb {
+      display: none;
+    }
+  }
 </style>

app/pages/support/documents.vue

@@ -1,21 +1,60 @@
 <template>
   <div class="page-container">
-    <div v-if="pending">
+    <div>
-      <el-skeleton :rows="5" animated />
-    </div>
-    <div v-else>
       <support-tabs model-value="documents" />
       <div class="page-header">
         <h1 class="page-title">{{ $t('navigation.documents') }}</h1>
         <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
       </div>
       <div class="page-content">
-        <product-filter
+        <document-filter
           v-model="filters"
           :product-type-options="productTypeOptions"
           :product-options="productOptions"
+          :document-type-options="documentTypeOptions"
         />
-        <document-list :documents="filteredDocuments" />
+
+        <el-skeleton
+          :loading="pending"
+          animated
+          :throttle="{
+            leading: 500,
+            trailing: 500,
+          }"
+        >
+          <template #template>
+            <div class="flex flex-col gap-xl">
+              <el-skeleton-item
+                variant="rect"
+                style="width: 100%; height: 100px"
+              />
+              <el-skeleton-item
+                v-for="i in 10"
+                :key="i"
+                variant="h1"
+                style="height: 60px"
+              />
+            </div>
+          </template>
+          <template #default>
+            <document-list
+              :documents="paginatedDocuments"
+              :show-category="
+                filters.selectedDocumentType === null ||
+                filters.selectedDocumentType === undefined
+              "
+            />
+
+            <el-pagination
+              v-model:current-page="page"
+              class="justify-center pagination-container"
+              layout="prev, pager, next"
+              hide-on-single-page
+              :page-size="documentsPerPage"
+              :total="filteredDocuments.length"
+            />
+          </template>
+        </el-skeleton>
       </div>
     </div>
   </div>
@@ -30,12 +69,36 @@
   ];
 
   const filters = reactive({
-    selectedType: null as number | null,
+    selectedDocumentType: null as string | null,
-    selectedProduct: null as number | null,
+    selectedProductType: null as string | null,
+    selectedProduct: null as string | null,
     keyword: '',
   });
 
-  const { data: documents, pending, error } = await useDocumentList();
+  const page = ref(1);
+  const documentsPerPage = 10;
+
+  const { data, pending, error } = useDocumentList();
+
+  const documents = computed(() => data.value ?? []);
+
+  const documentTypeOptions = computed(() => {
+    const types: DocumentTypeView[] = [];
+    documents.value.forEach((doc: DocumentListView) => {
+      if (!types.some((item) => item.id === doc.type.id)) {
+        if (doc.type.id === '-1') {
+          types.push({
+            id: '-1',
+            name: $t('product-filter.misc'),
+          });
+        } else {
+          types.push(doc.type);
+        }
+      }
+    });
+
+    return types;
+  });
 
   const productTypeOptions = computed(() => {
     const types: DocumentListProductType[] = [];
@@ -52,13 +115,13 @@
   });
 
   const productOptions = computed(() => {
-    if (!filters.selectedType) return [];
+    if (!filters.selectedProductType) return [];
     const products: DocumentListProduct[] = [];
 
     documents.value.forEach((doc: DocumentListView) => {
       doc.products?.forEach((product: DocumentListProduct) => {
         if (
-          product.type.id === filters.selectedType &&
+          product.type.id === filters.selectedProductType &&
           !products.some((item) => item.id === product.id)
         ) {
           products.push(product);
@@ -81,19 +144,30 @@
             (product: DocumentListProduct) =>
               product.id === filters.selectedProduct
           )
-        : filters.selectedType
+        : filters.selectedProductType
           ? doc.products?.some(
               (product: DocumentListProduct) =>
-                product.type?.id === filters.selectedType
+                product.type?.id === filters.selectedProductType
             )
           : true;
 
-      return matchProduct;
+      const matchDocumentType = filters.selectedDocumentType
+        ? doc.type.id === filters.selectedDocumentType
+        : true;
+
+      return matchProduct && matchDocumentType;
     });
   });
 
+  const paginatedDocuments = computed(() => {
+    return filteredDocuments.value.slice(
+      (page.value - 1) * documentsPerPage,
+      page.value * documentsPerPage
+    );
+  });
+
   watch(
-    () => filters.selectedType,
+    () => filters.selectedProductType,
     () => {
       filters.selectedProduct = null;
     }
@@ -133,12 +207,6 @@
     margin-left: auto;
   }
 
-  .document-category {
-    padding: 0rem 2rem;
-    gap: 4px;
-    margin-bottom: 0.5rem;
-  }
-
   .page-content {
     padding: 1rem 2rem 2rem;
   }
@@ -153,4 +221,41 @@
     height: 40px;
     font-size: 0.9rem;
   }
+
+  .pagination-container {
+    margin-top: 2rem;
+  }
+
+  @media (max-width: 768px) {
+    .breadcrumb {
+      display: none;
+    }
+  }
+
+  :deep(.el-pagination) {
+    .btn-prev,
+    .btn-next {
+      .el-icon {
+        font-size: 24px;
+      }
+    }
+
+    .el-pager {
+      gap: 0.5rem;
+    }
+    .el-pager li {
+      font-size: 1rem;
+      /* border: 1px solid #409eff; */
+      border-radius: 50%;
+
+      &:hover {
+        background-color: #ecf5ff;
+      }
+
+      &.is-active {
+        background-color: var(--el-color-primary);
+        color: #fff;
+      }
+    }
+  }
 </style>

app/pages/support/faq.vue

@@ -1,44 +1,95 @@
 <template>
   <div class="page-container">
-    <div v-if="pending" class="flex justify-center items-center h-64">
+    <support-tabs model-value="faq" />
-      <el-skeleton :rows="6" animated />
+    <div class="page-header">
+      <h1 class="page-title">{{ $t('navigation.faq') }}</h1>
+      <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
     </div>
-    <div v-else>
-      <support-tabs model-value="faq" />
-      <div class="page-header">
-        <h1 class="page-title">{{ $t('navigation.faq') }}</h1>
-        <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
-      </div>
 
-      <div class="page-content">
+    <div class="page-content">
-        <product-filter
+      <question-filter
-          v-model="filters"
+        v-model="filters"
-          :product-type-options="productTypeOptions"
+        :product-type-options="productTypeOptions"
-          :product-options="productOptions"
+        :product-options="productOptions"
-        />
+        :question-type-options="questionTypeOptions"
+      />
 
-        <question-list :questions="filteredQuestions" />
+      <el-skeleton
-      </div>
+        :loading="pending"
+        animated
+        :throttle="{ leading: 500, trailing: 500 }"
+      >
+        <template #template>
+          <div class="flex flex-col gap-xl">
+            <el-skeleton-item
+              v-for="i in 10"
+              :key="i"
+              variant="h1"
+              style="height: 80px"
+            />
+          </div>
+        </template>
+        <template #default>
+          <question-list :questions="paginatedQuestions" />
+
+          <el-pagination
+            v-model:current-page="page"
+            class="justify-center pagination-container"
+            layout="prev, pager, next"
+            hide-on-single-page
+            :page-size="questionsPerPage"
+            :total="filteredQuestions.length"
+          />
+        </template>
+      </el-skeleton>
     </div>
   </div>
 </template>
 
 <script setup lang="ts">
   const localePath = useLocalePath();
+  const route = useRoute();
 
   const filters = reactive({
-    selectedType: null as number | null,
+    selectedQuestionType: null as string | null,
-    selectedProduct: null as number | null,
+    selectedProduct: null as string | null,
+    selectedProductType: null as string | null,
     keyword: '',
   });
 
+  const page = ref(1);
+  const questionsPerPage = 10;
+
+  const focusQuestionId = ref<string | null>(
+    route.query.focus as string | null
+  );
+
   const breadcrumbItems = [
     { label: $t('navigation.home'), to: localePath('/') },
     { label: $t('navigation.support'), to: localePath('/support') },
     { label: $t('navigation.faq') },
   ];
 
-  const { data: questions, pending, error } = await useQuestionList();
+  const { data, pending, error } = useQuestionList();
+
+  const questions = computed(() => data.value ?? []);
+
+  const questionTypeOptions = computed(() => {
+    const types: QuestionTypeView[] = [];
+    questions.value.forEach((q: QuestionListView) => {
+      if (!types.some((t) => t.id === q.type.id)) {
+        if (q.type.id === '-1') {
+          types.push({
+            id: '-1',
+            name: $t('product-filter.misc'),
+          });
+        } else {
+          types.push(q.type);
+        }
+      }
+    });
+    return types;
+  });
 
   const productTypeOptions = computed(() => {
     const types: QuestionListProductType[] = [];
@@ -54,12 +105,12 @@
   });
 
   const productOptions = computed(() => {
-    if (!filters.selectedType) return [];
+    if (!filters.selectedProductType) return [];
     const products: QuestionListProduct[] = [];
     questions.value.forEach((q: QuestionListView) => {
       q.products.forEach((product: QuestionListProduct) => {
         if (
-          product.type.id === filters.selectedType &&
+          product.type.id === filters.selectedProductType &&
           !products.some((p) => p.id === product.id)
         ) {
           products.push(product);
@@ -81,19 +132,51 @@
             (product: QuestionListProduct) =>
               product.id === filters.selectedProduct
           )
-        : filters.selectedType
+        : filters.selectedProductType
           ? question.products?.some(
               (product: QuestionListProduct) =>
-                product.type.id === filters.selectedType
+                product.type.id === filters.selectedProductType
             )
           : true;
 
-      return matchProduct;
+      const matchQuestionType = filters.selectedQuestionType
+        ? question.type.id === filters.selectedQuestionType
+        : true;
+
+      return matchProduct && matchQuestionType;
     });
   });
 
+  const paginatedQuestions = computed(() => {
+    const start = (page.value - 1) * questionsPerPage;
+    const end = page.value * questionsPerPage;
+    return filteredQuestions.value.slice(start, end);
+  });
+
   watch(
-    () => filters.selectedType,
+    focusQuestionId,
+    async (focusId) => {
+      if (!focusId) return;
+      if (!import.meta.client) return;
+
+      await nextTick();
+
+      const question = filteredQuestions.value.find((q) => q.id === focusId);
+      if (!question) return;
+
+      const targetIndex = filteredQuestions.value.indexOf(question);
+      const targetPage = Math.floor(targetIndex / questionsPerPage) + 1;
+      onMounted(() => {
+        if (page.value !== targetPage) {
+          page.value = targetPage;
+        }
+      });
+    },
+    { immediate: true }
+  );
+
+  watch(
+    () => filters.selectedProductType,
     () => {
       filters.selectedProduct = null;
     }
@@ -136,4 +219,40 @@
   .page-content {
     padding: 1rem 2rem 2rem;
   }
+  .pagination-container {
+    margin-top: 2rem;
+  }
+
+  @media (max-width: 768px) {
+    .breadcrumb {
+      display: none;
+    }
+  }
+
+  :deep(.el-pagination) {
+    .btn-prev,
+    .btn-next {
+      .el-icon {
+        font-size: 24px;
+      }
+    }
+
+    .el-pager {
+      gap: 0.5rem;
+    }
+    .el-pager li {
+      font-size: 1rem;
+      /* border: 1px solid #409eff; */
+      border-radius: 50%;
+
+      &:hover {
+        background-color: #ecf5ff;
+      }
+
+      &.is-active {
+        background-color: var(--el-color-primary);
+        color: #fff;
+      }
+    }
+  }
 </style>

app/pages/support/index.vue

@@ -137,5 +137,9 @@
       grid-template-columns: 1fr;
       gap: 20px;
     }
+
+    .breadcrumb {
+      display: none;
+    }
   }
 </style>

i18n/locales/en.json

@@ -23,8 +23,8 @@
   "company-name": "Jinshen Machinary Manufacturing Co., Ltd.",
   "company-description": "We specialize in manufacturing a range of paper tube and can equipment, integrating design, manufacturing, sales, and service.",
   "learn-more": "Learn More",
-  "products-desc": "We provide high-quality product solutions to meet various business needs.",
+  "products-desc": "We provide the latest products an instant service support to meet various business needs of our customers.",
-  "solutions-desc": "Providing customized technology solutions for enterprises to accelerate digital transformation.",
+  "solutions-desc": "We offer diversified technical solutions for enterprises, supporting various fields such as industry and packaging.",
   "support-desc": "24/7 professional technical support to ensure stable operation of your business.",
   "quick-links": "Quick Links",
   "utilities": "Utilities",
@@ -63,7 +63,9 @@
   "back-to-home": "Back to Home",
   "no-content-available": "No detailed information available",
   "loading": "Loading...",
-  "our-products": "Our Products",
+  "our-products": "Our Latest Products",
+  "find-discontinued-products": "To find discontinued products, please use the search function.",
+  "product-discontinued-warning": "Product is discontinued and may no longer receive immediate support or updates",
   "learn-our-solutions": "Learn Our Solutions",
   "all": "All",
   "support-page-desc": "Zhejiang Jinshen Machinery Manufacturing Co., Ltd is committed to providing high-quality products and services to our customers. For products such as paper tube machines, slitting machines, and paper straw equipment, we offer comprehensive after-sales support to ensure our customers can use our products with confidence.",
@@ -79,7 +81,12 @@
     "keyword": "Keyword",
     "select-product-type": "Select product type",
     "select-product-model": "Select product model",
-    "enter-keyword": "Enter keyword"
+    "enter-keyword": "Enter keyword",
+    "question-type": "Question Type",
+    "select-question-type": "Select question type",
+    "document-type": "Document Type",
+    "select-document-type": "Select document type",
+    "misc": "Misc"
   },
   "document-meta": {
     "size": "Size",
@@ -120,5 +127,6 @@
     "specs": "Specifications",
     "faq": "FAQ",
     "documents": "Documents"
-  }
+  },
+  "redirecting": "Redirecting..."
 }

i18n/locales/es.json

@@ -23,8 +23,8 @@
   "company-name": "Jinshen Machinary Manufacturing Co., Ltd.",
   "company-description": "Especializado en la producción de una serie de equipos de tubos y latas de papel, integrando diseño, fabricación, ventas y servicio.",
   "learn-more": "Saber más",
-  "products-desc": "Ofrecemos soluciones de productos de alta calidad que satisfacen diversas necesidades empresariales.",
+  "products-desc": "Ofrecemos los últimos productos y un servicio de asistencia instantáneo para satisfacer las diversas necesidades comerciales de nuestros clientes.",
-  "solutions-desc": "Providing customized technology solutions for enterprises to accelerate digital transformation.",
+  "solutions-desc": "Ofrecemos soluciones técnicas diversificadas para empresas, prestando apoyo en diversos campos, como la industria y el embalaje.",
   "support-desc": "Soporte técnico profesional 24/7, asegurando la estabilidad de su negocio.",
   "quick-links": "Enlaces rápidos",
   "utilities": "Herramientas útiles",
@@ -63,7 +63,9 @@
   "back-to-home": "Volver al inicio",
   "no-content-available": "No hay información disponible",
   "loading": "Cargando...",
-  "our-products": "Nuestros productos",
+  "our-products": "Nuestros últimos productos",
+  "find-discontinued-products": "Para encontrar productos descatalogados, utilice la función de búsqueda.",
+  "product-discontinued-warning": "Este producto ha sido descontinuado y puede que ya no reciba soporte o actualizaciones inmediatas.",
   "learn-our-solutions": "Aprenda sobre nuestras soluciones",
   "all": "Todo",
   "support-page-desc": "Zhejiang Jinshen Machinery Manufacturing Co., Ltd se dedica a proporcionar productos y servicios de alta calidad a los clientes. Para máquinas de tubos de papel, máquinas de corte y pajitas de papel, ofrecemos un servicio postventa integral para garantizar que los clientes puedan usar nuestros productos con confianza.",
@@ -72,14 +74,18 @@
     "documents": "Proporcionamos manuales de productos, especificaciones técnicas y otros documentos para la comodidad del usuario.",
     "contact-info": "Contáctenos por teléfono o correo electrónico, y le brindaremos servicio presencial."
   },
-
   "product-filter": {
     "product-type": "Tipo de producto",
     "product-model": "Modelo del producto",
     "keyword": "Palabra clave",
     "select-product-type": "Seleccione el tipo de producto",
     "select-product-model": "Seleccione modelo de producto",
-    "enter-keyword": "Ingrese palabra clave"
+    "enter-keyword": "Ingrese palabra clave",
+    "misc": "Varios",
+    "document-type": "Tipo de documento",
+    "select-document-type": "Seleccionar tipo de documento",
+    "question-type": "Tipo de pregunta",
+    "select-question-type": "Seleccionar tipo de pregunta"
   },
   "document-meta": {
     "size": "Tamaño",
@@ -120,5 +126,6 @@
     "specs": "Especificaciones",
     "faq": "FAQ",
     "documents": "Documentos"
-  }
+  },
+  "redirecting": "Redirigiendo..."
 }

i18n/locales/ru.json

@@ -23,8 +23,8 @@
   "company-name": "Jinshen Machinary Manufacturing Co., Ltd.",
   "company-description": "Профессионально производим оборудование для бумажных трубок и канистр, услуги по проектированию, производству, продаже и сервисному обслуживанию.",
   "learn-more": "Узнать больше",
-  "products-desc": "Мы предоставляем высококачественные решения для различных бизнес-потребностей.",
+  "products-desc": "Мы предоставляем новейшие продукты и мгновенную сервисную поддержку для удовлетворения различных бизнес-потребностей наших клиентов.",
-  "solutions-desc": "Предлагаем индивидуальные технологические решения для содействия цифровой трансформации.",
+  "solutions-desc": "Мы предлагаем разнообразные технические решения для предприятий, поддерживая различные области, такие как промышленность и упаковка.",
   "support-desc": "Профессиональная техническая поддержка 24/7, обеспечивающая стабильную работу вашего бизнеса.",
   "quick-links": "Быстрые ссылки",
   "utilities": "Полезные инструменты",
@@ -63,7 +63,9 @@
   "back-to-home": "Вернуться на главную",
   "no-content-available": "Нет доступной информации",
   "loading": "Загрузка...",
-  "our-products": "Наши продукты",
+  "our-products": "Наши последние продукты",
+  "find-discontinued-products": "Чтобы найти другие продукты, используйте функцию поиска.",
+  "product-discontinued-warning": "Этот продукт снят с производства и может больше не получать мгновенную поддержку или обновления",
   "learn-our-solutions": "Узнайте о наших решениях",
   "all": "Все",
   "support-page-desc": "Zhejiang Jinshen Machinery Manufacturing Co., Ltd Стремится предоставлять клиентам высококачественные продукты и услуги. Мы предлагаем послепродажное обслуживание для таких продуктов, как машины для бумажных трубок и соломинок, обеспечивая уверенность клиентов в использовании нашей продукции.",
@@ -72,14 +74,18 @@
     "documents": "Предоставляем документацию, такую как руководства по продуктам, технические спецификации, для удобства пользователей.",
     "contact-info": "Свяжитесь с нами по телефону или электронной почте, и мы оперативно вам поможем."
   },
-
   "product-filter": {
     "product-type": "Тип продукта",
     "product-model": "Модель продукта",
     "keyword": "Ключевое слово",
     "select-product-type": "Выберите тип продукта",
     "select-product-model": "Выберите модель продукта",
-    "enter-keyword": "Введите ключевое слово"
+    "enter-keyword": "Введите ключевое слово",
+    "misc": "разное",
+    "document-type": "Тип документа",
+    "question-type": "Тип вопроса",
+    "select-document-type": "Выберите тип документа",
+    "select-question-type": "Выберите тип вопроса"
   },
   "document-meta": {
     "size": "Размер",
@@ -120,5 +126,6 @@
     "specs": "Технические спецификации",
     "faq": "Часто задаваемые вопросы",
     "documents": "Связанные документы"
-  }
+  },
+  "redirecting": "Перенаправление..."
 }

i18n/locales/zh.json

@@ -23,8 +23,8 @@
   "company-name": "金申机械制造有限公司",
   "company-description": "专业生产一系列纸管、纸罐设备，集设计、制造、销售、服务于一体。",
   "learn-more": "了解更多",
-  "products-desc": "我们提供高质量的产品解决方案，满足各种业务需求。",
+  "products-desc": "我们提供最新的产品与即时的服务支持，满足客户的各类业务需求。",
-  "solutions-desc": "为企业提供定制化的技术解决方案，助力数字化转型。",
+  "solutions-desc": "我们为企业提供多样化的技术解决方案，在工业、包装等多种领域提供支持。",
   "support-desc": "7x24小时专业技术支持，确保您的业务稳定运行。",
   "quick-links": "快速链接",
   "utilities": "实用工具",
@@ -63,7 +63,9 @@
   "back-to-home": "返回首页",
   "no-content-available": "暂无详细信息",
   "loading": "加载中...",
-  "our-products": "我们的产品",
+  "our-products": "我们的最新产品",
+  "find-discontinued-products": "如需查找其他产品，请使用搜索功能",
+  "product-discontinued-warning": "本产品已停产，可能不再提供即时的支持或更新",
   "learn-our-solutions": "了解我们的解决方案",
   "all": "全部",
   "support-page-desc": "金申机械制造有限公司致力于为客户提供优质的产品与服务。针对纸管机、分纸机、纸吸管等产品，我们提供全方位的售后服务，确保客户能够安心地使用我们的产品。",
@@ -78,7 +80,12 @@
     "keyword": "关键词",
     "select-product-type": "选择产品类型",
     "select-product-model": "选择产品系列",
-    "enter-keyword": "输入关键词"
+    "enter-keyword": "输入关键词",
+    "question-type": "问题类型",
+    "select-question-type": "选择问题类型",
+    "document-type": "文档类型",
+    "select-document-type": "选择文档类型",
+    "misc": "其他"
   },
   "document-meta": {
     "size": "大小",
@@ -119,5 +126,6 @@
     "specs": "技术规格",
     "faq": "常见问题",
     "documents": "相关文档"
-  }
+  },
+  "redirecting": "正在跳转..."
 }

nuxt.config.ts

@@ -20,7 +20,17 @@ export default defineNuxtConfig({
       htmlAttrs: {
         lang: 'zh',
       },
-      link: [{ rel: 'icon', type: 'image/x-icon', href: '/jinshen-logo.ico' }],
+      link: [
+        { rel: 'icon', type: 'image/x-icon', href: '/jinshen-logo.ico' },
+        {
+          rel: 'apple-touch-icon',
+          href: '/jinshen-logo.png',
+        },
+        {
+          rel: 'manifest',
+          href: '/manifest.json',
+        },
+      ],
     },
   },
 

public/manifest.json

@@ -0,0 +1,20 @@
+{
+  "name": "金申机械制造有限公司",
+  "short_name": "金申机械",
+  "icons": [
+    {
+      "src": "/logo196x196.png",
+      "sizes": "196x196",
+      "type": "image/png"
+    },
+    {
+      "src": "/logo512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ],
+  "start_url": ".",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#0f172a"
+}

server/api/search.get.ts

@@ -11,7 +11,7 @@ export default defineEventHandler(async (event) => {
   if (!q) return [];
 
   const meili = getMeiliService();
-  const sections = await meili.search(q, { limit: 12 }, locale);
+  const sections = await meili.search(q, { limit: 500 }, locale);
 
   // 空Section过滤
   const filteredSections = sections.filter(

server/assets/graphql/documentList.graphql

@@ -1,5 +1,5 @@
 query GetDocumentList($locale: String!) {
-  product_documents(filter: { status: { _eq: "published" } }) {
+  product_documents(filter: { status: { _eq: "published" } }, limit: 500) {
     id
     file {
       id
@@ -10,6 +10,13 @@ query GetDocumentList($locale: String!) {
       id
       title
     }
+    type {
+      id
+      translations(filter: { languages_code: { code: { _eq: $locale } } }) {
+        id
+        name
+      }
+    }
     products {
       id
       products_id {

server/assets/graphql/product.graphql

@@ -51,6 +51,13 @@ query GetProduct($id: ID!, $locale: String!) {
       id
       product_documents_id(filter: { status: { _eq: "published" } }) {
         id
+        type {
+          id
+          translations(filter: { languages_code: { code: { _eq: $locale } } }) {
+            id
+            name
+          }
+        }
         file {
           id
           filesize

server/assets/graphql/productList.graphql

@@ -1,5 +1,5 @@
 query GetProductList($locale: String!) {
-  products(filter: { status: { _eq: "in-production" } }) {
+  products(filter: { status: { _eq: "in-production" } }, limit: 200) {
     id
     status
     translations(filter: { languages_code: { code: { _eq: $locale } } }) {

server/assets/graphql/questionList.graphql

@@ -1,6 +1,13 @@
 query GetQuestionList($locale: String!) {
-  questions(filter: { status: { _eq: "published" } }) {
+  questions(filter: { status: { _eq: "published" } }, limit: 500) {
     id
+    type {
+      id
+      translations(filter: { languages_code: { code: { _eq: $locale } } }) {
+        id
+        name
+      }
+    }
     translations(filter: { languages_code: { code: { _eq: $locale } } }) {
       id
       title

server/assets/graphql/solutionList.graphql

@@ -1,5 +1,5 @@
 query GetSolutionList($locale: String!) {
-  solutions(filter: { status: { _eq: "published" } }) {
+  solutions(filter: { status: { _eq: "published" } }, limit: 200) {
     id
     cover {
       id

server/mappers/documentMapper.test.ts

@@ -1,60 +1,44 @@
 import { describe, test, expect } from 'vitest';
-import { toProductDocumentView, toDocumentListView } from './documentMapper';
+import { toDocumentListView, toDocumentTypeView } from './documentMapper';
 
 /**
- * 单元测试: toProductDocumentView
+ * 单元测试: toDocumentTypeView
  */
-describe('toProductDocumentView', () => {
+describe('toDocumentTypeView', () => {
-  const baseData: ProductDocument = {
+  const baseData: DocumentType = {
     id: 1,
-    file: {
+    translations: [{ id: 1, name: 'Type Name' }],
-      id: 'rand-om__-uuid-1234',
-      filename_download: 'document.pdf',
-      filesize: 2048,
-    },
-    translations: [{ id: 10, title: 'Document Title' }],
   };
 
-  test('convert raw data with fileMeta to ProductDocumentView correctly', () => {
+  test('convert raw data to DocumentTypeView correctly', () => {
-    const rawData: ProductDocument = { ...baseData };
+    const rawData: DocumentType = {
-    expect(toProductDocumentView(rawData)).toEqual({
-      id: '1',
-      fileId: 'rand-om__-uuid-1234',
-      filename: 'document.pdf',
-      title: 'Document Title',
-      url: '/api/assets/rand-om__-uuid-1234',
-      size: 2048,
-    });
-  });
-
-  test('convert raw data with fileId', () => {
-    const rawData: ProductDocument = {
       ...baseData,
-      file: 'rand-om__-uuid-1234',
     };
 
-    expect(toProductDocumentView(rawData)).toEqual({
+    expect(toDocumentTypeView(rawData)).toEqual({
       id: '1',
-      fileId: '',
+      name: 'Type Name',
-      filename: '',
-      title: 'Document Title',
-      url: '/api/assets/',
-      size: 0,
     });
   });
 
   test('convert raw data with missing translations', () => {
-    const rawData: ProductDocument = {
+    const rawData: DocumentType = {
       ...baseData,
       translations: [],
     };
-    expect(toProductDocumentView(rawData)).toEqual({
+
+    expect(toDocumentTypeView(rawData)).toEqual({
       id: '1',
-      fileId: 'rand-om__-uuid-1234',
+      name: '',
-      filename: 'document.pdf',
+    });
-      title: '',
+  });
-      url: '/api/assets/rand-om__-uuid-1234',
+
-      size: 2048,
+  test('convert null input to default DocumentTypeView', () => {
+    const rawData: DocumentType | null = null;
+
+    expect(toDocumentTypeView(rawData)).toEqual({
+      id: '-1',
+      name: '',
     });
   });
 });
@@ -65,6 +49,15 @@ describe('toProductDocumentView', () => {
 describe('toDocumentListView', () => {
   const baseData: ProductDocument = {
     id: 1,
+    type: {
+      id: 1,
+      translations: [
+        {
+          id: 1,
+          name: 'Type A',
+        },
+      ],
+    },
     file: {
       id: 'rand-om__-uuid-1234',
       filename_download: 'document.pdf',
@@ -94,6 +87,10 @@ describe('toDocumentListView', () => {
       title: 'Document Title',
       url: '/api/assets/rand-om__-uuid-1234',
       size: 2048,
+      type: {
+        id: '1',
+        name: 'Type A',
+      },
       products: [
         {
           id: '1',

server/mappers/documentMapper.ts

@@ -1,30 +1,28 @@
 import { isObject } from '../../server/utils/object';
 
 /**
- * 将 Directus 返回的 Document 数据转换为 ProductDocumentView 视图模型
+ * 将 Directus 返回的 DocumentType 数据转换为 DocumentTypeView 视图模型
  *
- * @param raw: 原始的 Document 数据
+ * @param raw: 原始的 DocumentType 数据
- * @returns 转换后的 ProductDocumentView 对象
+ * @returns 转换后的 DocumentTypeView 对象
  *
  * @example
- * const view = toProductDocumentView(rawDocument);
+ * const view = toDocumentTypeView(rawDocumentType);
  */
-export function toProductDocumentView(
+export function toDocumentTypeView(
-  raw: ProductDocument
+  raw: DocumentType | string | null
-): ProductDocumentView {
+): DocumentTypeView {
+  if (typeof raw === 'string' || raw === null) {
+    return {
+      id: '-1',
+      name: '',
+    } satisfies DocumentTypeView;
+  }
   const trans = raw.translations?.[0];
-  const file = isObject<DirectusFile>(raw.file) ? raw.file : undefined;
-  const fileId = file?.id ?? '';
-
-  const url = `/api/assets/${fileId}`;
 
   return {
     id: raw.id.toString(),
-    fileId: fileId,
+    name: trans?.name ?? '',
-    filename: file?.filename_download ?? '',
-    title: trans?.title ?? '',
-    url: url,
-    size: file?.filesize ?? 0,
   };
 }
 
@@ -40,6 +38,8 @@ export function toProductDocumentView(
 export function toDocumentListView(raw: ProductDocument): DocumentListView {
   const trans = raw.translations?.[0];
 
+  const type = toDocumentTypeView(raw.type ?? null);
+
   const file = isObject<DirectusFile>(raw.file) ? raw.file : undefined;
   const fileId = file?.id ?? '';
 
@@ -73,6 +73,7 @@ export function toDocumentListView(raw: ProductDocument): DocumentListView {
     title: trans?.title ?? '',
     url: url,
     size: file?.filesize ?? 0,
+    type: type,
     products: related_products,
   };
 }

server/mappers/productListMapper.test.ts

@@ -0,0 +1,125 @@
+import { describe, expect, test } from 'vitest';
+import { toProductTypeView, toProductListView } from './productListMapper';
+
+/**
+ * 单元测试: toProductTypeView
+ */
+describe('toProductTypeView', () => {
+  const baseData: ProductType = {
+    id: 1,
+    translations: [
+      {
+        id: 1,
+        name: 'Type Name',
+      },
+    ],
+    sort: 5,
+  };
+
+  test('convert raw data to ProductTypeView correctly', () => {
+    const rawData: ProductType = { ...baseData };
+
+    expect(toProductTypeView(rawData)).toEqual({
+      id: '1',
+      name: 'Type Name',
+      sort: 5,
+    });
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: ProductType = {
+      ...baseData,
+      translations: [],
+    };
+
+    expect(toProductTypeView(rawData)).toEqual({
+      id: '1',
+      name: '',
+      sort: 5,
+    });
+  });
+
+  test('convert raw data with missing sort', () => {
+    const rawData: ProductType = {
+      ...baseData,
+      sort: undefined,
+    };
+
+    expect(toProductTypeView(rawData)).toEqual({
+      id: '1',
+      name: 'Type Name',
+      sort: 999,
+    });
+  });
+
+  test('convert null input to default value', () => {
+    const rawData: ProductType | string | null = null;
+
+    expect(toProductTypeView(rawData)).toEqual({
+      id: '-1',
+      name: '',
+      sort: 999,
+    });
+  });
+});
+
+/**
+ * 单元测试: toProductListView
+ */
+describe('toProductListView', () => {
+  test('convert raw data to ProductListView correctly', () => {
+    const rawData: Product = {
+      id: 1,
+      translations: [
+        { id: 10, name: 'Product Name', summary: 'Product Summary' },
+      ],
+      cover: {
+        id: 'cover-file-uuid-1234',
+      },
+      product_type: {
+        id: 1,
+        translations: [{ id: 20, name: 'Type Name' }],
+        sort: 1,
+      },
+    };
+
+    expect(toProductListView(rawData)).toEqual({
+      id: '1',
+      name: 'Product Name',
+      summary: 'Product Summary',
+      cover: 'cover-file-uuid-1234',
+      product_type: {
+        id: '1',
+        name: 'Type Name',
+        sort: 1,
+      },
+    });
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: Product = {
+      id: 1,
+      translations: [],
+      cover: {
+        id: 'cover-file-uuid-1234',
+      },
+      product_type: {
+        id: 20,
+        translations: [],
+        sort: 1,
+      },
+    };
+
+    expect(toProductListView(rawData)).toEqual({
+      id: '1',
+      name: '',
+      summary: '',
+      cover: 'cover-file-uuid-1234',
+      product_type: {
+        id: '20',
+        name: '',
+        sort: 1,
+      },
+    });
+  });
+});

server/mappers/productListMapper.ts

@@ -0,0 +1,54 @@
+import { isObject } from '../../server/utils/object';
+
+/**
+ * 将Directus返回的ProductType数据转换为ProductTypeView视图模型
+ *
+ * @param raw: 原始的ProductType数据
+ * @returns 转换后的ProductTypeView对象
+ *
+ * @example
+ * const view = toProductTypeView(rawProductType);
+ */
+export function toProductTypeView(
+  raw: ProductType | string | null
+): ProductTypeView {
+  if (typeof raw === 'string' || raw === null) {
+    return {
+      id: '-1',
+      name: '',
+      sort: 999,
+    } satisfies ProductTypeView;
+  }
+  const trans = raw.translations?.[0] ?? { name: '' };
+
+  return {
+    id: raw.id.toString(),
+    name: trans.name,
+    sort: raw?.sort ?? 999,
+  } satisfies ProductTypeView;
+}
+
+/**
+ * 将 Directus返回的 Product 数据转换为 ProductListView 视图模型
+ *
+ * @param raw: 原始的 Product 数据
+ * @returns 转换后的 ProductListView 对象
+ *
+ * @example
+ * const view = toProductListView(rawProduct);
+ */
+export function toProductListView(raw: Product): ProductListView {
+  const trans = raw.translations?.[0];
+
+  const type = toProductTypeView(raw.product_type ?? null);
+
+  const cover = isObject<DirectusFile>(raw.cover) ? raw.cover.id : '';
+
+  return {
+    id: raw.id.toString(),
+    product_type: type,
+    name: trans?.name ?? '',
+    summary: trans?.summary ?? '',
+    cover: cover,
+  } satisfies ProductListView;
+}

server/mappers/productMapper.test.ts

@@ -1,69 +1,111 @@
 import { describe, test, expect } from 'vitest';
 import {
-  toProductListView,
+  toProductImageView,
   toProductSpecView,
   toProductSpecGroupView,
+  toProductQuestionView,
+  toProductDocumentView,
   toProductView,
 } from './productMapper';
 
 /**
- * 单元测试: toProductListView
+ * 单元测试: toProductImageView
  */
-describe('toProductListView', () => {
+describe('toProductImageView', () => {
-  test('convert raw data to ProductListView correctly', () => {
+  const baseData: Array<ProductsProductImage> = [
-    const rawData: Product = {
+    {
       id: 1,
-      translations: [
+      product_images_id: {
-        { id: 10, name: 'Product Name', summary: 'Product Summary' },
-      ],
-      cover: {
-        id: 'cover-file-uuid-1234',
-      },
-      product_type: {
         id: 1,
-        translations: [{ id: 20, name: 'Type Name' }],
+        image: {
-        sort: 1,
+          id: 'rand-om__-uuid-1234',
+        },
+        translations: [
+          {
+            id: 1,
+            caption: 'Image Caption',
+          },
+        ],
       },
-    };
+    },
+    {
+      id: 2,
+      product_images_id: {
+        id: 2,
+        image: {
+          id: 'rand-om__-uuid-5678',
+        },
+        translations: [
+          {
+            id: 2,
+            caption: 'Image Caption 2',
+          },
+        ],
+      },
+    },
+  ];
 
-    expect(toProductListView(rawData)).toEqual({
+  test('convert raw data to ProductImageView correctly', () => {
-      id: '1',
+    const rawData: Array<ProductsProductImage> = [...baseData];
-      name: 'Product Name',
+
-      summary: 'Product Summary',
+    expect(toProductImageView(rawData)).toEqual([
-      cover: 'cover-file-uuid-1234',
+      {
-      product_type: {
         id: '1',
-        name: 'Type Name',
+        image: 'rand-om__-uuid-1234',
-        sort: 1,
+        caption: 'Image Caption',
       },
-    });
+      {
+        id: '2',
+        image: 'rand-om__-uuid-5678',
+        caption: 'Image Caption 2',
+      },
+    ]);
   });
 
   test('convert raw data with missing translations', () => {
-    const rawData: Product = {
+    const rawData: Array<ProductsProductImage> = [
-      id: 1,
+      {
-      translations: [],
+        id: 1,
-      cover: {
+        product_images_id: {
-        id: 'cover-file-uuid-1234',
+          id: 1,
+          image: {
+            id: 'rand-om__-uuid-1234',
+          },
+          translations: [],
+        },
       },
-      product_type: {
+    ];
-        id: 20,
-        translations: [],
-        sort: 1,
-      },
-    };
 
-    expect(toProductListView(rawData)).toEqual({
+    expect(toProductImageView(rawData)).toEqual([
-      id: '1',
+      {
-      name: '',
+        id: '1',
-      summary: '',
+        image: 'rand-om__-uuid-1234',
-      cover: 'cover-file-uuid-1234',
+        caption: '',
-      product_type: {
-        id: '20',
-        name: '',
-        sort: 1,
       },
-    });
+    ]);
+  });
+
+  test('convert empty array to empty ProductImageView array', () => {
+    const rawData: Array<ProductsProductImage> = [];
+
+    expect(toProductImageView(rawData)).toEqual([]);
+  });
+
+  test('convert input with wrong type to default value', () => {
+    const rawData: string[] = ['1', '2'];
+
+    expect(toProductImageView(rawData)).toEqual([
+      {
+        id: '1',
+        image: '',
+        caption: '',
+      },
+      {
+        id: '2',
+        image: '',
+        caption: '',
+      },
+    ]);
   });
 });
 
@@ -71,30 +113,78 @@ describe('toProductListView', () => {
  * 单元测试: toProductSpecView
  */
 describe('toProductSpecView', () => {
-  test('convert raw data to ProductSpecView correctly', () => {
+  const baseData: ProductSpec[] = [
-    const rawData: ProductSpec = {
+    {
       id: 1,
-      translations: [{ id: 1, key: 'Key', value: 'Value' }],
+      translations: [
-    };
+        {
+          id: 1,
+          key: 'key 1',
+          value: 'value 1',
+        },
+      ],
+    },
+    {
+      id: 2,
+      translations: [
+        {
+          id: 2,
+          key: 'key 2',
+          value: 'value 2',
+        },
+      ],
+    },
+  ];
+  test('convert raw data to ProductSpecView correctly', () => {
+    const rawData: ProductSpec[] = [...baseData];
 
-    expect(toProductSpecView(rawData)).toEqual({
+    expect(toProductSpecView(rawData)).toEqual([
-      id: '1',
+      {
-      key: 'Key',
+        id: '1',
-      value: 'Value',
+        key: 'key 1',
-    });
+        value: 'value 1',
+      },
+      {
+        id: '2',
+        key: 'key 2',
+        value: 'value 2',
+      },
+    ]);
   });
 
   test('convert raw data with missing translations', () => {
-    const rawData: ProductSpec = {
+    const rawData: ProductSpec[] = [{ id: 1, translations: [] }];
-      id: 1,
-      translations: [],
-    };
 
-    expect(toProductSpecView(rawData)).toEqual({
+    expect(toProductSpecView(rawData)).toEqual([
-      id: '1',
+      {
-      key: '',
+        id: '1',
-      value: '',
+        key: '',
-    });
+        value: '',
+      },
+    ]);
+  });
+
+  test('convert empty input to empty array', () => {
+    const rawData: ProductSpec[] = [];
+
+    expect(toProductSpecView(rawData)).toEqual([]);
+  });
+
+  test('convert input with wrong type to default value', () => {
+    const rawData: string[] = ['1', '2'];
+
+    expect(toProductSpecView(rawData)).toEqual([
+      {
+        id: '1',
+        key: '',
+        value: '',
+      },
+      {
+        id: '2',
+        key: '',
+        value: '',
+      },
+    ]);
   });
 });
 
@@ -103,37 +193,262 @@ describe('toProductSpecView', () => {
  */
 describe('toProductSpecGroupView', () => {
   test('convert raw data to ProductSpecGroupView correctly', () => {
-    const rawData: ProductSpecGroup = {
+    const rawData: ProductSpecGroup[] = [
-      id: 1,
+      {
-      translations: [{ id: 1, name: 'Group Name' }],
+        id: 1,
-      specs: [
+        translations: [{ id: 1, name: 'Group Name' }],
-        { id: 1, translations: [{ id: 1, key: 'Key1', value: 'Value1' }] },
+        specs: [
-        { id: 2, translations: [{ id: 2, key: 'Key2', value: 'Value2' }] },
+          { id: 1, translations: [{ id: 1, key: 'Key1', value: 'Value1' }] },
-      ],
+          { id: 2, translations: [{ id: 2, key: 'Key2', value: 'Value2' }] },
-    };
+        ],
+      },
+    ];
 
-    expect(toProductSpecGroupView(rawData)).toEqual({
+    expect(toProductSpecGroupView(rawData)).toEqual([
-      id: '1',
+      {
-      name: 'Group Name',
+        id: '1',
-      specs: [
+        name: 'Group Name',
-        { id: '1', key: 'Key1', value: 'Value1' },
+        specs: [
-        { id: '2', key: 'Key2', value: 'Value2' },
+          { id: '1', key: 'Key1', value: 'Value1' },
-      ],
+          { id: '2', key: 'Key2', value: 'Value2' },
-    });
+        ],
+      },
+    ]);
   });
 
   test('convert raw data with missing translations', () => {
-    const rawData: ProductSpecGroup = {
+    const rawData: ProductSpecGroup[] = [
-      id: 1,
+      {
-      translations: [],
+        id: 1,
-      specs: [],
+        translations: [],
-    };
+        specs: [],
+      },
+    ];
 
-    expect(toProductSpecGroupView(rawData)).toEqual({
+    expect(toProductSpecGroupView(rawData)).toEqual([
-      id: '1',
+      {
-      name: '',
+        id: '1',
-      specs: [],
+        name: '',
-    });
+        specs: [],
+      },
+    ]);
+  });
+
+  test('convert input with wrong type to default value', () => {
+    const rawData: string[] = ['1', '2'];
+
+    expect(toProductSpecGroupView(rawData)).toEqual([
+      {
+        id: '1',
+        name: '',
+        specs: [],
+      },
+      {
+        id: '2',
+        name: '',
+        specs: [],
+      },
+    ]);
+  });
+
+  test('convert empty ar ray to empty ProductSpecGroupView array', () => {
+    const rawData: ProductSpec[] = [];
+
+    expect(toProductSpecGroupView(rawData)).toEqual([]);
+  });
+});
+
+/**
+ * 单元测试: toProductQuestionView
+ */
+describe('toProductQuestionView', () => {
+  test('convert raw data to ProductQuestionView correctly', () => {
+    const rawData: ProductsQuestion[] = [
+      {
+        id: 1,
+        questions_id: {
+          id: 1,
+          translations: [
+            {
+              id: 1,
+              title: 'Question Title',
+              content: 'Question Content',
+            },
+          ],
+        },
+      },
+    ];
+
+    expect(toProductQuestionView(rawData)).toEqual([
+      {
+        id: '1',
+        title: 'Question Title',
+        content: 'Question Content',
+      },
+    ]);
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: ProductsQuestion[] = [
+      {
+        id: 1,
+        questions_id: {
+          id: 1,
+          translations: [],
+        },
+      },
+    ];
+
+    expect(toProductQuestionView(rawData)).toEqual([
+      {
+        id: '1',
+        title: '',
+        content: '',
+      },
+    ]);
+  });
+
+  test('convert empty array to empty ProductQuestionView array', () => {
+    const rawData: ProductsQuestion[] = [];
+
+    expect(toProductQuestionView(rawData)).toEqual([]);
+  });
+
+  test('convert input with wrong type to default value', () => {
+    const rawData: string[] = ['1', '2'];
+
+    expect(toProductQuestionView(rawData)).toEqual([
+      {
+        id: '1',
+        title: '',
+        content: '',
+      },
+      {
+        id: '2',
+        title: '',
+        content: '',
+      },
+    ]);
+  });
+});
+
+/**
+ * 单元测试: toProductDocumentView
+ */
+describe('toProductDocumentView', () => {
+  test('convert raw data to ProductDocumentView correctly', () => {
+    const rawData: ProductsProductDocument[] = [
+      {
+        id: 1,
+        product_documents_id: {
+          id: 1,
+          file: {
+            id: 'rand-om__-uuid-1234',
+            filesize: 1000,
+            filename_download: 'doc1.pdf',
+          },
+          type: {
+            id: 1,
+            translations: [
+              {
+                id: 1,
+                name: 'manual',
+              },
+            ],
+          },
+          translations: [
+            {
+              id: 1,
+              title: 'Document Title 1',
+            },
+          ],
+        },
+      },
+    ];
+
+    expect(toProductDocumentView(rawData)).toEqual([
+      {
+        id: '1',
+        fileId: 'rand-om__-uuid-1234',
+        filename: 'doc1.pdf',
+        title: 'Document Title 1',
+        type: {
+          id: '1',
+          name: 'manual',
+        },
+        size: 1000,
+        url: '/api/assets/rand-om__-uuid-1234',
+      },
+    ]);
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: ProductsProductDocument[] = [
+      {
+        id: 1,
+        product_documents_id: {
+          id: 1,
+          file: {
+            id: 'rand-om__-uuid-1234',
+            filesize: 1000,
+            filename_download: 'doc1.pdf',
+          },
+          translations: [],
+        },
+      },
+    ];
+
+    expect(toProductDocumentView(rawData)).toEqual([
+      {
+        id: '1',
+        fileId: 'rand-om__-uuid-1234',
+        filename: 'doc1.pdf',
+        title: '',
+        type: {
+          id: '-1',
+          name: '',
+        },
+        size: 1000,
+        url: '/api/assets/rand-om__-uuid-1234',
+      },
+    ]);
+  });
+
+  test('convert empty array to empty ProductDocumentView array', () => {
+    const rawData: ProductsProductDocument[] = [];
+
+    expect(toProductDocumentView(rawData)).toEqual([]);
+  });
+
+  test('convert input with wrong type to default value', () => {
+    const rawData: string[] = ['1', '2'];
+
+    expect(toProductDocumentView(rawData)).toEqual([
+      {
+        id: '1',
+        fileId: '',
+        filename: '',
+        title: '',
+        size: 0,
+        type: {
+          id: '-1',
+          name: '',
+        },
+        url: '',
+      },
+      {
+        id: '2',
+        fileId: '',
+        filename: '',
+        title: '',
+        size: 0,
+        type: {
+          id: '-1',
+          name: '',
+        },
+        url: '',
+      },
+    ]);
   });
 });
 
@@ -141,25 +456,29 @@ describe('toProductSpecGroupView', () => {
  * 单元测试: toProductView
  */
 describe('toProductView', () => {
+  const baseData: Product = {
+    id: 1,
+    status: 'in-production',
+    translations: [
+      {
+        id: 1,
+        name: 'Product Name',
+        summary: 'Product Summary',
+        description: 'Product Description',
+      },
+    ],
+  };
   test('convert raw data to ProductView correctly', () => {
     const rawData: Product = {
-      id: 1,
+      ...baseData,
-      translations: [
-        {
-          id: 1,
-          name: 'Product Name',
-          summary: 'Product Summary',
-          description: 'Product Description',
-        },
-      ],
     };
 
     expect(toProductView(rawData)).toEqual({
       id: '1',
+      status: 'in-production',
       name: 'Product Name',
       summary: 'Product Summary',
       description: 'Product Description',
-      product_type: '',
       images: [],
       documents: [],
       faqs: [],
@@ -169,16 +488,35 @@ describe('toProductView', () => {
 
   test('convert raw data with missing translations', () => {
     const rawData: Product = {
-      id: 1,
+      ...baseData,
       translations: [],
     };
 
     expect(toProductView(rawData)).toEqual({
       id: '1',
+      status: 'in-production',
       name: '',
       summary: '',
       description: '',
-      product_type: '',
+      images: [],
+      documents: [],
+      faqs: [],
+      specs: [],
+    });
+  });
+
+  test('conert raw data with missing status', () => {
+    const rawData: Product = {
+      ...baseData,
+      status: undefined,
+    };
+
+    expect(toProductView(rawData)).toEqual({
+      id: '1',
+      status: 'discontinued',
+      name: 'Product Name',
+      summary: 'Product Summary',
+      description: 'Product Description',
       images: [],
       documents: [],
       faqs: [],

server/mappers/productMapper.ts

@@ -1,55 +1,42 @@
-import { toProductQuestionView } from './questionMapper';
-import { toProductDocumentView } from './documentMapper';
 import { isObject } from '../../server/utils/object';
+import { toDocumentTypeView } from './documentMapper';
 
 /**
- * 将Directus返回的ProductType数据转换为ProductTypeView视图模型
+ * 将 Directus 返回的 ProductImage 数据转换为 ProductImageView 视图模型
  *
- * @param raw: 原始的ProductType数据
+ * @param raw: 原始的 ProductsProductImage 数据
- * @returns 转换后的ProductTypeView对象
+ * @returns 转换后的 ProductImageView 对象
  *
  * @example
- * const view = toProductTypeView(rawProductType);
+ * const view = toProductImageView(rawProductImage);
  */
-export function toProductTypeView(raw: ProductType): ProductTypeView {
+export function toProductImageView(
-  const trans = raw.translations?.[0] ?? { name: '' };
+  raw: (ProductsProductImage | string)[]
+): ProductImageView[] {
+  return (raw ?? []).map((item) => {
+    if (!isObject<ProductsProductImage>(item))
+      return {
+        id: item,
+        image: '',
+        caption: '',
+      } satisfies ProductImageView;
 
-  return {
+    const image = item.product_images_id;
-    id: raw.id.toString(),
+    if (!isObject<ProductImage>(image))
-    name: trans.name,
+      return {
-    sort: raw?.sort ?? 999,
+        id: item.id.toString(),
-  };
+        image: '',
-}
+        caption: '',
+      } satisfies ProductImageView;
 
-/**
+    const trans = image.translations?.[0];
- * 将 Directus返回的 Product 数据转换为 ProductListView 视图模型
- *
- * @param raw: 原始的 Product 数据
- * @returns 转换后的 ProductListView 对象
- *
- * @example
- * const view = toProductListView(rawProduct);
- */
-export function toProductListView(raw: Product): ProductListView {
-  const trans = raw.translations?.[0];
 
-  const type = isObject<ProductType>(raw.product_type)
+    return {
-    ? toProductTypeView(raw.product_type)
+      id: item.id.toString(),
-    : ({
+      image: isObject<DirectusFile>(image.image) ? image.image.id : '',
-        id: '',
+      caption: trans?.caption || '',
-        name: '',
+    } satisfies ProductImageView;
-        sort: 999,
+  });
-      } satisfies ProductTypeView);
-
-  const cover = isObject<DirectusFile>(raw.cover) ? raw.cover.id : '';
-
-  return {
-    id: raw.id.toString(),
-    product_type: type,
-    name: trans?.name ?? '',
-    summary: trans?.summary ?? '',
-    cover: cover,
-  };
 }
 
 /**
@@ -62,19 +49,26 @@ export function toProductListView(raw: Product): ProductListView {
  * const view = toProductSpecGroupView(rawSpecGroup);
  */
 export function toProductSpecGroupView(
-  raw: ProductSpecGroup
+  raw: (ProductSpecGroup | string)[]
-): ProductSpecGroupView {
+): ProductSpecGroupView[] {
-  const trans = raw.translations?.[0];
+  return (raw ?? []).map((item) => {
+    if (!isObject<ProductSpecGroup>(item)) {
+      return {
+        id: item,
+        name: '',
+        specs: [],
+      } satisfies ProductSpecGroupView;
+    }
+    const trans = item.translations?.[0];
 
-  const specs = raw.specs ?? [];
+    const specs = toProductSpecView(item?.specs ?? []);
 
-  return {
+    return {
-    id: raw.id.toString(),
+      id: item.id.toString(),
-    name: trans?.name ?? '',
+      name: trans?.name ?? '',
-    specs: specs
+      specs: specs,
-      .filter(isObject<ProductSpec>)
+    } satisfies ProductSpecGroupView;
-      .map((item) => toProductSpecView(item)),
+  });
-  };
 }
 
 /**
@@ -86,14 +80,131 @@ export function toProductSpecGroupView(
  * @example
  * const view = toProductSpecView(rawSpecGroup);
  */
-export function toProductSpecView(raw: ProductSpec): ProductSpecView {
+export function toProductSpecView(
-  const trans = raw.translations?.[0];
+  raw: (ProductSpec | string)[]
+): ProductSpecView[] {
+  return (raw ?? []).map((item) => {
+    if (!isObject<ProductSpec>(item)) {
+      return {
+        id: item,
+        key: '',
+        value: '',
+      } satisfies ProductSpecView;
+    }
+    const trans = item.translations?.[0];
 
-  return {
+    return {
-    id: raw.id.toString(),
+      id: item.id.toString(),
-    key: trans?.key ?? '',
+      key: trans?.key ?? '',
-    value: trans?.value ?? '',
+      value: trans?.value ?? '',
-  };
+    } satisfies ProductSpecView;
+  });
+}
+
+/**
+ * 将 Directus 返回的 ProductQuestion 数据转换为 ProductQuestionView 视图模型
+ *
+ * @param raw: 原始的ProductQuestion 数据
+ * @returns 转换后的 ProductQuestionView 对象
+ *
+ * @example
+ * const view = toProductQuestionView(rawQuestion);
+ */
+export function toProductQuestionView(
+  raw: (ProductsQuestion | string)[]
+): ProductQuestionView[] {
+  return (raw ?? []).map((item) => {
+    if (!isObject<ProductsQuestion>(item)) {
+      return {
+        id: item,
+        title: '',
+        content: '',
+      } satisfies ProductQuestionView;
+    }
+
+    const question = item.questions_id;
+    if (!isObject<Question>(question)) {
+      return {
+        id: item.id.toString(),
+        title: '',
+        content: '',
+      } satisfies ProductQuestionView;
+    }
+
+    const trans = question.translations?.[0];
+
+    return {
+      id: item.id.toString(),
+      title: trans?.title ?? '',
+      content: trans?.content ?? '',
+    } satisfies ProductQuestionView;
+  });
+}
+
+/**
+ * 将 Directus 返回的 ProductDocument 数据转换为 ProductDocumentView 视图模型
+ *
+ * @param raw: 原始的ProductDocument 数据
+ * @returns 转换后的 ProductDocumentView 对象
+ *
+ * @example
+ * const view = toProductDocumentView(rawDocument);
+ */
+export function toProductDocumentView(
+  raw: (ProductsProductDocument | string)[]
+): ProductDocumentView[] {
+  return (raw ?? []).map((item) => {
+    if (!isObject<ProductsProductDocument>(item)) {
+      return {
+        id: item,
+        fileId: '',
+        filename: '',
+        size: 0,
+        title: '',
+        url: '',
+        type: {
+          id: '-1',
+          name: '',
+        },
+      } satisfies ProductDocumentView;
+    }
+
+    const document = item.product_documents_id;
+    if (!isObject<ProductDocument>(document)) {
+      return {
+        id: item.id.toString(),
+        fileId: '',
+        filename: '',
+        size: 0,
+        title: '',
+        url: '',
+        type: {
+          id: '-1',
+          name: '',
+        },
+      } satisfies ProductDocumentView;
+    }
+
+    const file = isObject<DirectusFile>(document.file)
+      ? document.file
+      : undefined;
+
+    const url = file ? `/api/assets/${file.id}` : '';
+
+    const trans = document.translations?.[0];
+
+    const typeView = toDocumentTypeView(document.type ?? null);
+
+    return {
+      id: item.id.toString(),
+      fileId: file?.id ?? '',
+      filename: file?.filename_download ?? '',
+      size: file?.filesize ?? 0,
+      title: trans?.title ?? '',
+      url: url,
+      type: typeView,
+    } satisfies ProductDocumentView;
+  });
 }
 
 /**
@@ -108,42 +219,19 @@ export function toProductSpecView(raw: ProductSpec): ProductSpecView {
 export function toProductView(raw: Product): ProductView {
   const trans = raw.translations?.[0];
 
-  const images = (raw.images ?? [])
+  const status = raw.status ?? 'discontinued';
-    .filter(isObject<ProductsProductImage>)
-    .map((item) => item.product_images_id)
-    .filter(isObject<ProductImage>)
-    .map((item) => {
-      const image = isObject<DirectusFile>(item.image) ? item.image.id : '';
-      return {
-        id: item.id.toString(),
-        image: image,
-        caption: item.translations?.[0]?.caption || '',
-      };
-    });
 
-  const type = isObject<ProductType>(raw.product_type)
+  const images = toProductImageView(raw.images ?? []);
-    ? (raw.product_type.translations?.[0]?.name ?? '')
-    : '';
 
-  const specs = (raw.specs ?? [])
+  const specs = toProductSpecGroupView(raw.specs ?? []);
-    .filter(isObject<ProductSpecGroup>)
-    .map((item) => toProductSpecGroupView(item));
 
-  const faqs = (raw.faqs ?? [])
+  const faqs = toProductQuestionView(raw.faqs ?? []);
-    .filter(isObject<ProductsQuestion>)
-    .map((item) => item.questions_id)
-    .filter(isObject<Question>)
-    .map((item) => toProductQuestionView(item));
 
-  const documents = (raw.documents ?? [])
+  const documents = toProductDocumentView(raw.documents ?? []);
-    .filter(isObject<ProductsProductDocument>)
-    .map((item) => item.product_documents_id)
-    .filter(isObject<ProductDocument>)
-    .map((item) => toProductDocumentView(item));
 
   return {
     id: raw.id.toString(),
-    product_type: type,
+    status: status,
     name: trans?.name ?? '',
     summary: trans?.summary ?? '',
     images: images,
@@ -151,5 +239,5 @@ export function toProductView(raw: Product): ProductView {
     specs: specs,
     faqs: faqs,
     documents: documents,
-  };
+  } satisfies ProductView;
 }

server/mappers/questionMapper.test.ts

@@ -1,38 +1,44 @@
 import { describe, expect, test } from 'vitest';
-import { toProductQuestionView, toQuestionListView } from './questionMapper';
+import { toQuestionListView, toQuestionTypeView } from './questionMapper';
 
 /**
- * 单元测试: toProductQuestionView
+ * 单元测试: toQuestionTypeView
  */
-describe('toProductQuestionView', () => {
+describe('toQuestionTypeView', () => {
-  const baseData: Question = {
+  const baseData: QuestionType = {
     id: 1,
-    translations: [
+    translations: [{ id: 1, name: 'Type Name' }],
-      { id: 1, title: 'Question Title', content: 'Question Answer' },
-    ],
   };
-  test('convert raw data to ProductQuestionView correctly', () => {
+
-    const rawData: Question = {
+  test('convert raw data to QuestionTypeView correctly', () => {
+    const rawData: QuestionType = {
       ...baseData,
     };
 
-    expect(toProductQuestionView(rawData)).toEqual({
+    expect(toQuestionTypeView(rawData)).toEqual({
       id: '1',
-      title: 'Question Title',
+      name: 'Type Name',
-      content: 'Question Answer',
     });
   });
 
   test('convert raw data with missing translations', () => {
-    const rawData: Question = {
+    const rawData: QuestionType = {
       ...baseData,
       translations: [],
     };
 
-    expect(toProductQuestionView(rawData)).toEqual({
+    expect(toQuestionTypeView(rawData)).toEqual({
       id: '1',
-      title: '',
+      name: '',
-      content: '',
+    });
+  });
+
+  test('convert null input to default QuestionTypeView', () => {
+    const rawData: QuestionType | null = null;
+
+    expect(toQuestionTypeView(rawData)).toEqual({
+      id: '-1',
+      name: '',
     });
   });
 });
@@ -43,6 +49,10 @@ describe('toProductQuestionView', () => {
 describe('toQuestionListView', () => {
   const baseData: Question = {
     id: 1,
+    type: {
+      id: 1,
+      translations: [{ id: 1, name: 'Type Name' }],
+    },
     translations: [
       { id: 1, title: 'Question Title', content: 'Question Answer' },
     ],
@@ -68,6 +78,10 @@ describe('toQuestionListView', () => {
 
     expect(toQuestionListView(rawData)).toEqual({
       id: '1',
+      type: {
+        id: '1',
+        name: 'Type Name',
+      },
       title: 'Question Title',
       content: 'Question Answer',
       products: [
@@ -104,6 +118,10 @@ describe('toQuestionListView', () => {
 
     expect(toQuestionListView(rawData)).toEqual({
       id: '1',
+      type: {
+        id: '1',
+        name: 'Type Name',
+      },
       title: '',
       content: '',
       products: [

server/mappers/questionMapper.ts

@@ -1,21 +1,28 @@
 import { isObject } from '../../server/utils/object';
 
 /**
- * 将 Directus 返回的 Question 数据转换为 ProductQuestionView 视图模型
+ * 将 Directus 返回的 QuestionType 类型转换为 QuestionTypeView 视图模型
  *
- * @param raw: 原始的 Question 数据
+ * @param raw: 原始的 QuestionType 数据
- * @returns 转换后的 ProductQuestionView 对象
+ * @returns 转换后的 QuestionTypeView 对象
  *
  * @example
- * const view = toProductQuestionView(rawQuestion);
+ * const view = toQuestionTypeView(rawQuestionType);
  */
-export function toProductQuestionView(raw: Question): ProductQuestionView {
+export function toQuestionTypeView(
+  raw: QuestionType | string | null
+): QuestionTypeView {
+  if (typeof raw === 'string' || raw === null) {
+    return {
+      id: '-1',
+      name: '',
+    } satisfies QuestionTypeView;
+  }
   const trans = raw.translations?.[0];
 
   return {
     id: raw.id.toString(),
-    title: trans?.title ?? '',
+    name: trans?.name ?? '',
-    content: trans?.content ?? '',
   };
 }
 
@@ -31,6 +38,8 @@ export function toProductQuestionView(raw: Question): ProductQuestionView {
 export function toQuestionListView(raw: Question): QuestionListView {
   const trans = raw.translations?.[0];
 
+  const type = toQuestionTypeView(raw.type ?? null);
+
   const related_products: QuestionListProduct[] = (raw.products ?? [])
     .filter(isObject<ProductsQuestion>)
     .map((item) => item.products_id)
@@ -57,6 +66,7 @@ export function toQuestionListView(raw: Question): QuestionListView {
 
   return {
     id: raw.id.toString(),
+    type: type,
     title: trans?.title ?? '',
     content: trans?.content ?? '',
     products: related_products,

server/mappers/solutionListMapper.test.ts

@@ -0,0 +1,109 @@
+import { describe, test, expect } from 'vitest';
+import { toSolutionListView, toSolutionTypeView } from './solutionListMapper';
+
+/**
+ * 单元测试: toSolutionTypeView
+ */
+describe('toSolutionTypeView', () => {
+  const baseData: SolutionType = {
+    id: 1,
+    translations: [
+      {
+        id: 1,
+        name: 'Type Name',
+      },
+    ],
+    sort: 5,
+  };
+
+  test('convert raw data to SolutionTypeView correctly', () => {
+    const rawData: SolutionType = { ...baseData };
+
+    expect(toSolutionTypeView(rawData)).toEqual({
+      id: '1',
+      name: 'Type Name',
+      sort: 5,
+    });
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: SolutionType = { ...baseData, translations: [] };
+
+    expect(toSolutionTypeView(rawData)).toEqual({
+      id: '1',
+      name: '',
+      sort: 5,
+    });
+  });
+
+  test('convert raw data with missing sort', () => {
+    const rawData: SolutionType = { ...baseData, sort: undefined };
+
+    expect(toSolutionTypeView(rawData)).toEqual({
+      id: '1',
+      name: 'Type Name',
+      sort: 999,
+    });
+  });
+
+  test('convert null input to default value', () => {
+    const rawData: SolutionType | string | null = null;
+
+    expect(toSolutionTypeView(rawData)).toEqual({
+      id: '-1',
+      name: 'uncategory',
+      sort: 999,
+    });
+  });
+});
+
+/**
+ * 单元测试: toSolutionListView
+ */
+describe('toSolutionListView', () => {
+  const baseData: Solution = {
+    id: 1,
+    translations: [
+      { id: 1, title: 'Solution Title', summary: 'Solution Summary' },
+    ],
+    type: {
+      id: 1,
+      translations: [{ id: 1, name: 'Type Name' }],
+      sort: 1,
+    },
+  };
+  test('convert raw data to SolutionListView correctly', () => {
+    const rawData: Solution = { ...baseData };
+
+    expect(toSolutionListView(rawData)).toEqual({
+      id: '1',
+      title: 'Solution Title',
+      summary: 'Solution Summary',
+      solution_type: {
+        id: '1',
+        name: 'Type Name',
+        sort: 1,
+      },
+      cover: '',
+    });
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: Solution = {
+      ...baseData,
+      translations: [],
+    };
+
+    expect(toSolutionListView(rawData)).toEqual({
+      id: '1',
+      title: '',
+      summary: '',
+      solution_type: {
+        id: '1',
+        name: 'Type Name',
+        sort: 1,
+      },
+      cover: '',
+    });
+  });
+});

server/mappers/solutionListMapper.ts

@@ -0,0 +1,58 @@
+import { isObject } from '../../server/utils/object';
+
+/**
+ * 将 Directus 返回的 SolutionType 数据转换为 SolutionTypeView 视图模型
+ *
+ * @param raw: 原始的 SolutionType 数据
+ * @returns 转换后的 SolutionTypeView 对象
+ *
+ * ---
+ *
+ *  @example
+ *  const view = toSolutionTypeView(rawSolutionType);
+ */
+export function toSolutionTypeView(
+  raw: SolutionType | string | null
+): SolutionTypeView {
+  if (typeof raw === 'string' || raw === null) {
+    return {
+      id: '-1',
+      name: 'uncategory',
+      sort: 999,
+    } satisfies SolutionTypeView;
+  }
+  const trans = raw?.translations?.[0];
+
+  return {
+    id: raw.id.toString(),
+    name: trans?.name ?? '',
+    sort: raw?.sort ?? 999,
+  };
+}
+
+/**
+ * 将 Directus 返回的 Solution 数据转换为 SolutionListView 视图模型
+ *
+ * @param raw: 原始的 Solution 数据
+ * @returns 转换后的 SolutionListView 对象
+ *
+ * ---
+ *
+ * @example
+ * const view = toSolutionListView(rawSolution);
+ */
+export function toSolutionListView(raw: Solution): SolutionListView {
+  const trans = raw.translations?.[0];
+
+  const type = toSolutionTypeView(raw.type ?? null);
+
+  const cover = isObject<DirectusFile>(raw.cover) ? (raw?.cover.id ?? '') : '';
+
+  return {
+    id: raw.id.toString(),
+    title: trans?.title ?? '',
+    summary: trans?.summary ?? '',
+    solution_type: type,
+    cover: cover,
+  };
+}

server/mappers/solutionMapper.test.ts

@@ -1,56 +1,5 @@
 import { describe, test, expect } from 'vitest';
-import { toSolutionListView, toSolutionView } from './solutionMapper';
+import { toSolutionView } from './solutionMapper';
-
-/**
- * 单元测试: toSolutionListView
- */
-describe('toSolutionListView', () => {
-  const baseData: Solution = {
-    id: 1,
-    translations: [
-      { id: 1, title: 'Solution Title', summary: 'Solution Summary' },
-    ],
-    type: {
-      id: 1,
-      translations: [{ id: 1, name: 'Type Name' }],
-      sort: 1,
-    },
-  };
-  test('convert raw data to SolutionListView correctly', () => {
-    const rawData: Solution = { ...baseData };
-
-    expect(toSolutionListView(rawData)).toEqual({
-      id: '1',
-      title: 'Solution Title',
-      summary: 'Solution Summary',
-      solution_type: {
-        id: '1',
-        name: 'Type Name',
-        sort: 1,
-      },
-      cover: '',
-    });
-  });
-
-  test('convert raw data with missing translations', () => {
-    const rawData: Solution = {
-      ...baseData,
-      translations: [],
-    };
-
-    expect(toSolutionListView(rawData)).toEqual({
-      id: '1',
-      title: '',
-      summary: '',
-      solution_type: {
-        id: '1',
-        name: 'Type Name',
-        sort: 1,
-      },
-      cover: '',
-    });
-  });
-});
 
 /**
  * 单元测试: toSolutionView

server/mappers/solutionMapper.ts

@@ -1,59 +1,3 @@
-import { isObject } from '../../server/utils/object';
-
-/**
- * 将 Directus 返回的 SolutionType 数据转换为 SolutionTypeView 视图模型
- *
- * @param raw: 原始的 SolutionType 数据
- * @returns 转换后的 SolutionTypeView 对象
- *
- * ---
- *
- *  @example
- *  const view = toSolutionTypeView(rawSolutionType);
- */
-export function toSolutionTypeView(raw: SolutionType): SolutionTypeView {
-  const trans = raw?.translations?.[0];
-
-  return {
-    id: raw.id.toString(),
-    name: trans?.name ?? '',
-    sort: raw?.sort ?? 999,
-  };
-}
-
-/**
- * 将 Directus 返回的 Solution 数据转换为 SolutionListView 视图模型
- *
- * @param raw: 原始的 Solution 数据
- * @returns 转换后的 SolutionListView 对象
- *
- * ---
- *
- * @example
- * const view = toSolutionListView(rawSolution);
- */
-export function toSolutionListView(raw: Solution): SolutionListView {
-  const trans = raw.translations?.[0];
-
-  const type = isObject<SolutionType>(raw.type)
-    ? toSolutionTypeView(raw.type)
-    : ({
-        id: '',
-        name: 'uncategory',
-        sort: 999,
-      } satisfies SolutionTypeView);
-
-  const cover = isObject<DirectusFile>(raw.cover) ? (raw?.cover.id ?? '') : '';
-
-  return {
-    id: raw.id.toString(),
-    title: trans?.title ?? '',
-    summary: trans?.summary ?? '',
-    solution_type: type,
-    cover: cover,
-  };
-}
-
 /**
  * 将 Directus 返回的 Solution 数据转换为 SolutionView 视图模型
  *

server/services/cms/productService.ts

@@ -1,7 +1,5 @@
-import {
+import { toProductView } from '~~/server/mappers/productMapper';
-  toProductView,
+import { toProductListView } from '~~/server/mappers/productListMapper';
-  toProductListView,
-} from '~~/server/mappers/productMapper';
 
 export const productService = {
   async getProductList(locale: string) {

server/services/cms/solutionService.ts

@@ -1,7 +1,5 @@
-import {
+import { toSolutionView } from '~~/server/mappers/solutionMapper';
-  toSolutionView,
+import { toSolutionListView } from '~~/server/mappers/solutionListMapper';
-  toSolutionListView,
-} from '~~/server/mappers/solutionMapper';
 
 export const solutionService = {
   async getSolutionList(locale: string) {

server/utils/search-converters.test.ts

@@ -12,13 +12,16 @@ describe('converters', () => {
       summary: 'High efficiency',
       description: 'Detailed description',
       type: 'pump',
+      cover: 'rand-om__-uuid-1234',
     };
     const result = converters.products(item);
     expect(result).toEqual({
       id: 1,
-      type: 'product',
+      sectionType: 'product',
       title: 'Hydraulic Pump',
       summary: 'High efficiency',
+      type: 'pump',
+      thumbnail: '/api/assets/rand-om__-uuid-1234',
     });
   });
 
@@ -29,13 +32,16 @@ describe('converters', () => {
       summary: 'Effective solution',
       content: 'Detailed content',
       type: 'Type A',
+      cover: 'rand-om__-uuid-5678',
     };
     const result = converters.solutions(item);
     expect(result).toEqual({
       id: 1,
-      type: 'solution',
+      sectionType: 'solution',
       title: 'Solution A',
       summary: 'Effective solution',
+      type: 'Type A',
+      thumbnail: '/api/assets/rand-om__-uuid-5678',
     });
   });
 
@@ -47,13 +53,15 @@ describe('converters', () => {
         'This is a detailed explanation of how to use the product effectively.',
       products: ['Product A'],
       product_types: ['Type A'],
+      type: 'Question Type',
     };
     const result = converters.questions(item);
     expect(result).toEqual({
       id: 1,
       title: 'How to use product?',
-      summary: '',
+      summary: undefined,
-      type: 'question',
+      type: 'Question Type',
+      sectionType: 'question',
     });
   });
 
@@ -64,13 +72,15 @@ describe('converters', () => {
       products: ['Product A'],
       product_types: ['Type A'],
       fileUUID: 'TEST-UUID',
+      type: 'manual',
     };
     const result = converters.product_documents(item);
     expect(result).toEqual({
       id: 'TEST-UUID',
       title: 'User Manual',
-      summary: '',
+      summary: undefined,
-      type: 'document',
+      sectionType: 'document',
+      type: 'manual',
     });
   });
 });

server/utils/search-converters.ts

@@ -6,31 +6,35 @@ export const converters: {
 } = {
   products: (item: MeiliIndexMap['products']): SearchItemView => ({
     id: item.id,
-    type: 'product',
+    sectionType: 'product',
     title: item.name,
-    summary: item.summary,
+    summary: item?.summary,
+    type: item?.type,
+    thumbnail: item?.cover ? `/api/assets/${item.cover}` : undefined,
   }),
 
   solutions: (item: MeiliIndexMap['solutions']): SearchItemView => ({
     id: item.id,
-    type: 'solution',
+    sectionType: 'solution',
     title: item.title,
-    summary: item.summary,
+    summary: item?.summary,
+    type: item?.type,
+    thumbnail: item?.cover ? `/api/assets/${item.cover}` : undefined,
   }),
 
   questions: (item: MeiliIndexMap['questions']): SearchItemView => ({
     id: item.id,
-    type: 'question',
+    sectionType: 'question',
     title: item.title,
-    summary: '',
+    type: item?.type,
   }),
 
   product_documents: (
     item: MeiliIndexMap['product_documents']
   ): SearchItemView => ({
     id: item.fileUUID || item.id,
-    type: 'document',
+    sectionType: 'document',
     title: item.title,
-    summary: '',
+    type: item?.type,
   }),
 };

shared/types/directus/my-schema.ts

@@ -1,3 +1,19 @@
+export interface AiPrompt {
+  /** @primaryKey */
+  id: string;
+  sort?: number | null;
+  date_created?: string | null;
+  user_created?: DirectusUser | string | null;
+  date_updated?: string | null;
+  user_updated?: DirectusUser | string | null;
+  /** @required */
+  name: string;
+  status?: 'published' | 'draft' | 'archived' | null;
+  description?: string | null;
+  system_prompt?: string | null;
+  messages?: Array<{ role: 'user' | 'assistant'; text: string }> | null;
+}
+
 export interface CompanyProfile {
   /** @primaryKey */
   id: number;
@@ -26,6 +42,20 @@ export interface ContactInfoTranslation {
   content?: string | null;
 }
 
+export interface DocumentType {
+  /** @primaryKey */
+  id: number;
+  translations?: DocumentTypesTranslation[] | null;
+}
+
+export interface DocumentTypesTranslation {
+  /** @primaryKey */
+  id: number;
+  document_types_id?: DocumentType | string | null;
+  languages_code?: Language | string | null;
+  name?: string | null;
+}
+
 export interface Homepage {
   /** @primaryKey */
   id: number;
@@ -75,8 +105,9 @@ export interface ProductDocument {
   id: number;
   status?: 'published' | 'draft' | 'archived';
   file?: DirectusFile | string | null;
-  products?: ProductsProductDocument[] | string[];
+  type?: DocumentType | string | null;
   translations?: ProductDocumentsTranslation[] | null;
+  products?: ProductsProductDocument[] | string[];
 }
 
 export interface ProductDocumentsTranslation {
@@ -209,10 +240,25 @@ export interface ProductsTranslation {
   description?: string | null;
 }
 
+export interface QuestionType {
+  /** @primaryKey */
+  id: number;
+  translations?: QuestionTypesTranslation[] | null;
+}
+
+export interface QuestionTypesTranslation {
+  /** @primaryKey */
+  id: number;
+  question_types_id?: QuestionType | string | null;
+  languages_code?: Language | string | null;
+  name?: string | null;
+}
+
 export interface Question {
   /** @primaryKey */
   id: number;
   status?: 'published' | 'draft' | 'archived';
+  type?: QuestionType | string | null;
   /** @description i18n字段 */
   translations?: QuestionsTranslation[] | null;
   products?: ProductsQuestion[] | string[];
@@ -741,10 +787,13 @@ export interface DirectusExtension {
 }
 
 export interface Schema {
+  ai_prompts: AiPrompt[];
   company_profile: CompanyProfile;
   company_profile_translations: CompanyProfileTranslation[];
   contact_info: ContactInfo;
   contact_info_translations: ContactInfoTranslation[];
+  document_types: DocumentType[];
+  document_types_translations: DocumentTypesTranslation[];
   homepage: Homepage;
   homepage_files: HomepageFile[];
   languages: Language[];
@@ -765,6 +814,8 @@ export interface Schema {
   products_product_images: ProductsProductImage[];
   products_questions: ProductsQuestion[];
   products_translations: ProductsTranslation[];
+  question_types: QuestionType[];
+  question_types_translations: QuestionTypesTranslation[];
   questions: Question[];
   questions_translations: QuestionsTranslation[];
   solution_types: SolutionType[];
@@ -801,10 +852,13 @@ export interface Schema {
 }
 
 export enum CollectionNames {
+  ai_prompts = 'ai_prompts',
   company_profile = 'company_profile',
   company_profile_translations = 'company_profile_translations',
   contact_info = 'contact_info',
   contact_info_translations = 'contact_info_translations',
+  document_types = 'document_types',
+  document_types_translations = 'document_types_translations',
   homepage = 'homepage',
   homepage_files = 'homepage_files',
   languages = 'languages',
@@ -825,6 +879,8 @@ export enum CollectionNames {
   products_product_images = 'products_product_images',
   products_questions = 'products_questions',
   products_translations = 'products_translations',
+  question_types = 'question_types',
+  question_types_translations = 'question_types_translations',
   questions = 'questions',
   questions_translations = 'questions_translations',
   solution_types = 'solution_types',

shared/types/meilisearch/meili-index.ts

@@ -9,13 +9,16 @@ export interface MeiliProductIndex {
   name: string;
 
   /** 产品简介 **/
-  summary: string;
+  summary?: string;
 
   /** 产品详情 **/
-  description: string;
+  description?: string;
 
   /** 产品类型 **/
-  type: string;
+  type?: string;
+
+  /** 产品缩略图 **/
+  cover?: string;
 }
 
 /**
@@ -29,13 +32,16 @@ export interface MeiliSolutionIndex {
   title: string;
 
   /** 解决方案摘要 **/
-  summary: string;
+  summary?: string;
 
   /** 解决方案内容 **/
-  content: string;
+  content?: string;
 
   /** 解决方案类型 **/
-  type: string;
+  type?: string;
+
+  /** 解决方案缩略图 **/
+  cover?: string;
 }
 
 /**
@@ -49,7 +55,10 @@ export interface MeiliQuestionIndex {
   title: string;
 
   /** 问题内容 **/
-  content: string;
+  content?: string;
+
+  /** 问题类型 **/
+  type?: string;
 
   /** 相关产品 **/
   products: string[];
@@ -68,6 +77,9 @@ export interface MeiliProductDocumentIndex {
   /** 文档标题 **/
   title: string;
 
+  /** 文档类型 **/
+  type?: string;
+
   /** 相关产品 **/
   products: string[];
 

shared/types/views/document-list-view.ts

@@ -1,3 +1,14 @@
+/**
+ * 文档类型视图模型
+ * 用于在文档库中提供类型筛选功能
+ */
+export interface DocumentTypeView {
+  /** 唯一标识符 **/
+  id: string;
+  /** 类型名 **/
+  name: string;
+}
+
 /**
  * 文档关联产品类型模型
  * 用于在文档库中提供产品筛选功能
@@ -40,6 +51,9 @@ export interface DocumentListView {
   /** 文档链接 **/
   url: string;
 
+  /** 文档类型 **/
+  type: DocumentTypeView;
+
   /** 相关产品 **/
   products: DocumentListProduct[];
 }

shared/types/views/index.ts

@@ -2,9 +2,6 @@ export * from './solution-view';
 export * from './solution-list-view';
 export * from './product-view';
 export * from './product-list-view';
-export * from './product-spec-group-view';
-export * from './product-document-view';
-export * from './product-question-view';
 export * from './document-list-view';
 export * from './question-list-view';
 export * from './company-profile-view';

shared/types/views/product-document-view.ts

@@ -1,23 +0,0 @@
-/**
- * 文档视图模型
- * 用于文档列表渲染的数据结构
- */
-export interface ProductDocumentView {
-  /** 唯一标识符 **/
-  id: string;
-
-  /** 文件UUID **/
-  fileId: string;
-
-  /** 文件名 **/
-  filename: string;
-
-  /** 文档标题 **/
-  title: string;
-
-  /** 文档大小 **/
-  size: number;
-
-  /** 文档链接 **/
-  url: string;
-}

shared/types/views/product-question-view.ts

@@ -1,14 +0,0 @@
-/**
- * 常见问题视图模型
- * 用于产品页常见问题渲染的数据结构
- */
-export interface ProductQuestionView {
-  /** 唯一标识符 **/
-  id: string;
-
-  /** 问题标题 **/
-  title: string;
-
-  /** 问题内容 **/
-  content: string;
-}

shared/types/views/product-spec-group-view.ts

@@ -1,29 +0,0 @@
-/**
- * 产品规格模型
- * 用于产品规格渲染的数据结构
- */
-export interface ProductSpecView {
-  /** 唯一标识符 **/
-  id: string;
-
-  /** 规格名称 **/
-  key: string;
-
-  /** 规格值 **/
-  value: string;
-}
-
-/**
- * 产品规格表模型
- * 用于产品规格表渲染的数据结构
- */
-export interface ProductSpecGroupView {
-  /** 唯一标识符 **/
-  id: string;
-
-  /** 规格组名称 **/
-  name: string;
-
-  /** 规格组 **/
-  specs: ProductSpecView[];
-}

shared/types/views/product-view.ts

@@ -1,13 +1,90 @@
-import type { ProductSpecGroupView } from './product-spec-group-view';
+import type { DocumentTypeView } from './document-list-view';
-import type { ProductQuestionView } from './product-question-view';
+import type { Product } from '../directus/my-schema.ts';
-import type { ProductDocumentView } from './product-document-view';
 
-interface ImageView {
+type ProductStatus = Product['status'];
+
+/**
+ * 产品图片视图模型
+ * 用于产品详情页(/products/[slug])中的产品图片数据结构
+ */
+export interface ProductImageView {
   id: string;
   image: string;
   caption: string;
 }
 
+/**
+ * 产品规格模型
+ * 用于产品规格渲染的数据结构
+ */
+export interface ProductSpecView {
+  /** 唯一标识符 **/
+  id: string;
+
+  /** 规格名称 **/
+  key: string;
+
+  /** 规格值 **/
+  value: string;
+}
+
+/**
+ * 产品规格表模型
+ * 用于产品规格表渲染的数据结构
+ */
+export interface ProductSpecGroupView {
+  /** 唯一标识符 **/
+  id: string;
+
+  /** 规格组名称 **/
+  name: string;
+
+  /** 规格组 **/
+  specs: ProductSpecView[];
+}
+
+/**
+ * 常见问题视图模型
+ * 用于产品页常见问题渲染的数据结构
+ */
+export interface ProductQuestionView {
+  /** 唯一标识符 **/
+  id: string;
+
+  /** 问题标题 **/
+  title: string;
+
+  /** 问题内容 **/
+  content: string;
+}
+
+/**
+ * 文档视图模型
+ * 用于文档列表渲染的数据结构
+ */
+export interface ProductDocumentView {
+  /** 唯一标识符 **/
+  id: string;
+
+  /** 文件UUID **/
+  fileId: string;
+
+  /** 文件名 **/
+  filename: string;
+
+  /** 文档标题 **/
+  title: string;
+
+  /** 文档大小 **/
+  size: number;
+
+  /** 文档类型 **/
+  type: DocumentTypeView;
+
+  /** 文档链接 **/
+  url: string;
+}
+
 /**
  * 产品视图模型
  * 用于产品详情页(/products/[slug])渲染的数据结构
@@ -16,17 +93,17 @@ export interface ProductView {
   /** 唯一标识符 **/
   id: string;
 
+  /** 产品状态 **/
+  status: ProductStatus;
+
   /** 产品名称 **/
   name: string;
 
   /** 产品简介 **/
   summary: string;
 
-  /** 产品类型 **/
-  product_type: string;
-
   /** 产品图片 **/
-  images: ImageView[];
+  images: ProductImageView[];
 
   /** 产品详情 **/
   description: string;

shared/types/views/question-list-view.ts

@@ -7,6 +7,18 @@ export interface QuestionListProductType {
   name: string;
 }
 
+/**
+ * 问题类型
+ * 用于在常见问题列表中提供产品筛选功能
+ */
+export interface QuestionTypeView {
+  /** 唯一标识符 **/
+  id: string;
+
+  /** 类型名 **/
+  name: string;
+}
+
 /**
  * 问题关联产品模型
  * 用于在常见问题列表中提供产品筛选功能
@@ -25,6 +37,9 @@ export interface QuestionListView {
   /** 唯一标识符 **/
   id: string;
 
+  /** 问题类型 **/
+  type: QuestionTypeView;
+
   /** 问题标题 **/
   title: string;
 

shared/types/views/search-item-view.ts

@@ -3,11 +3,17 @@ export interface SearchItemView {
   id: number | string;
 
   /** 条目类型 **/
-  type: 'product' | 'solution' | 'question' | 'document';
+  sectionType: 'product' | 'solution' | 'question' | 'document';
 
   /** 条目标题 **/
   title: string;
 
   /** 条目摘要 **/
-  summary: string;
+  summary?: string;
+
+  /** 条目分类 **/
+  type?: string;
+
+  /** 条目预览图 **/
+  thumbnail?: string;
 }