From 23f2700c0fd96f8f449181c6cd2709e13001ffd8 Mon Sep 17 00:00:00 2001
From: R2m1liA <15258427350@163.com>
Date: Thu, 13 Nov 2025 20:45:43 +0800
Subject: [PATCH] =?UTF-8?q?refactor:=20=E5=B0=86Data=E5=88=B0ViewModel?=
 =?UTF-8?q?=E7=9A=84=E8=BD=AC=E6=8D=A2=E7=94=B1App=E8=BD=AC=E7=A7=BB?=
 =?UTF-8?q?=E8=87=B3Server=E7=AB=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 将逻辑转移到Server端后，简化前端逻辑
---
 app/models/mappers/documentMapper.test.ts     | 106 -----------------
 app/models/mappers/documentMapper.ts          |  79 -------------
 app/pages/about/index.vue                     |   6 +-
 app/pages/index.vue                           |  16 +--
 app/pages/products/[slug].vue                 |  11 +-
 app/pages/products/index.vue                  |  10 +-
 app/pages/solutions/[slug].vue                |   9 +-
 app/pages/solutions/index.vue                 |   7 +-
 app/pages/support/contact-us.vue              |   6 +-
 app/pages/support/documents.vue               |   6 +-
 app/pages/support/faq.vue                     |   6 +-
 server/api/cms/companyProfile.get.ts          |   7 ++
 server/api/cms/companyProfile.ts              |  24 ----
 server/api/cms/contactInfo.get.ts             |   7 ++
 server/api/cms/contactInfo.ts                 |  21 ----
 server/api/cms/documentList.get.ts            |   7 ++
 server/api/cms/documentList.ts                |  24 ----
 server/api/cms/homepage.get.ts                |   7 ++
 server/api/cms/homepage.ts                    |  21 ----
 server/api/cms/product/[id].get.ts            |  13 +++
 server/api/cms/product/[id].ts                |  33 ------
 server/api/cms/productList.get.ts             |   6 +
 server/api/cms/productList.ts                 |  21 ----
 server/api/cms/questionList.get.ts            |   6 +
 server/api/cms/questionList.ts                |  21 ----
 server/api/cms/solution/[id].get.ts           |  14 +++
 server/api/cms/solution/[id].ts               |  33 ------
 server/api/cms/solutionList.get.ts            |   7 ++
 server/api/cms/solutionList.ts                |  21 ----
 .../mappers/companyProfileMapper.test.ts      |  13 ++-
 .../mappers/companyProfileMapper.ts           |   4 +-
 .../mappers/contactInfoMapper.test.ts         |  10 +-
 .../mappers/contactInfoMapper.ts              |   4 +-
 server/mappers/documentMapper.test.ts         | 109 ++++++++++++++++++
 server/mappers/documentMapper.ts              |  76 ++++++++++++
 .../mappers/homepageMapper.test.ts            |  17 ++-
 .../mappers/homepageMapper.ts                 |  24 ++--
 .../mappers/productMapper.test.ts             |   6 +
 .../mappers/productMapper.ts                  |  58 +++++-----
 .../mappers/questionMapper.test.ts            |  50 ++++----
 .../mappers/questionMapper.ts                 |  31 ++---
 .../mappers/searchItemMapper.ts               |   2 +-
 .../mappers/solutionMapper.test.ts            |  64 +++++-----
 .../mappers/solutionMapper.ts                 |  37 +++---
 server/services/cms/companyProfileService.ts  |  25 ++++
 server/services/cms/contactInfoService.ts     |  22 ++++
 server/services/cms/documentService.ts        |  27 +++++
 server/services/cms/homepageService.ts        |  22 ++++
 server/services/cms/productService.ts         |  55 +++++++++
 server/services/cms/questionService.ts        |  24 ++++
 server/services/cms/solutionService.ts        |  55 +++++++++
 server/utils/object.test.ts                   |  66 +++++++++++
 server/utils/object.ts                        |  30 +++++
 server/utils/search-converter.test.ts         |  76 ++++++++++++
 server/utils/search-converters.ts             |  36 ++++++
 shared/types/index.ts                         |   1 +
 .../types/views/company-profile-view.ts       |   0
 .../types/views/contact-info-view.ts          |   0
 .../types/views/document-list-view.ts         |   0
 .../types/views/homepage-view.ts              |   0
 shared/types/views/index.ts                   |  13 +++
 .../types/views/product-document-view.ts      |   0
 .../types/views/product-list-view.ts          |   0
 .../types/views/product-question-view.ts      |   0
 .../types/views/product-spec-group-view.ts    |   0
 .../types/views/product-view.ts               |   4 +
 .../types/views/question-list-view.ts         |   0
 .../types/views/search-item-view.ts           |   2 +-
 .../types/views/solution-list-view.ts         |   0
 .../types/views/solution-view.ts              |   0
 70 files changed, 904 insertions(+), 614 deletions(-)
 delete mode 100644 app/models/mappers/documentMapper.test.ts
 delete mode 100644 app/models/mappers/documentMapper.ts
 create mode 100644 server/api/cms/companyProfile.get.ts
 delete mode 100644 server/api/cms/companyProfile.ts
 create mode 100644 server/api/cms/contactInfo.get.ts
 delete mode 100644 server/api/cms/contactInfo.ts
 create mode 100644 server/api/cms/documentList.get.ts
 delete mode 100644 server/api/cms/documentList.ts
 create mode 100644 server/api/cms/homepage.get.ts
 delete mode 100644 server/api/cms/homepage.ts
 create mode 100644 server/api/cms/product/[id].get.ts
 delete mode 100644 server/api/cms/product/[id].ts
 create mode 100644 server/api/cms/productList.get.ts
 delete mode 100644 server/api/cms/productList.ts
 create mode 100644 server/api/cms/questionList.get.ts
 delete mode 100644 server/api/cms/questionList.ts
 create mode 100644 server/api/cms/solution/[id].get.ts
 delete mode 100644 server/api/cms/solution/[id].ts
 create mode 100644 server/api/cms/solutionList.get.ts
 delete mode 100644 server/api/cms/solutionList.ts
 rename {app/models => server}/mappers/companyProfileMapper.test.ts (72%)
 rename {app/models => server}/mappers/companyProfileMapper.ts (81%)
 rename {app/models => server}/mappers/contactInfoMapper.test.ts (72%)
 rename {app/models => server}/mappers/contactInfoMapper.ts (80%)
 create mode 100644 server/mappers/documentMapper.test.ts
 create mode 100644 server/mappers/documentMapper.ts
 rename {app/models => server}/mappers/homepageMapper.test.ts (88%)
 rename {app/models => server}/mappers/homepageMapper.ts (69%)
 rename {app/models => server}/mappers/productMapper.test.ts (97%)
 rename {app/models => server}/mappers/productMapper.ts (79%)
 rename {app/models => server}/mappers/questionMapper.test.ts (73%)
 rename {app/models => server}/mappers/questionMapper.ts (62%)
 rename {app/models => server}/mappers/searchItemMapper.ts (88%)
 rename {app/models => server}/mappers/solutionMapper.test.ts (67%)
 rename {app/models => server}/mappers/solutionMapper.ts (68%)
 create mode 100644 server/services/cms/companyProfileService.ts
 create mode 100644 server/services/cms/contactInfoService.ts
 create mode 100644 server/services/cms/documentService.ts
 create mode 100644 server/services/cms/homepageService.ts
 create mode 100644 server/services/cms/productService.ts
 create mode 100644 server/services/cms/questionService.ts
 create mode 100644 server/services/cms/solutionService.ts
 create mode 100644 server/utils/object.test.ts
 create mode 100644 server/utils/object.ts
 create mode 100644 server/utils/search-converter.test.ts
 create mode 100644 server/utils/search-converters.ts
 rename app/models/views/CompanyProfileView.ts => shared/types/views/company-profile-view.ts (100%)
 rename app/models/views/ContactInfoView.ts => shared/types/views/contact-info-view.ts (100%)
 rename app/models/views/DocumentListView.ts => shared/types/views/document-list-view.ts (100%)
 rename app/models/views/HomepageView.ts => shared/types/views/homepage-view.ts (100%)
 create mode 100644 shared/types/views/index.ts
 rename app/models/views/ProductDocumentView.ts => shared/types/views/product-document-view.ts (100%)
 rename app/models/views/ProductListView.ts => shared/types/views/product-list-view.ts (100%)
 rename app/models/views/ProductQuestionView.ts => shared/types/views/product-question-view.ts (100%)
 rename app/models/views/ProductSpecGroupView.ts => shared/types/views/product-spec-group-view.ts (100%)
 rename app/models/views/ProductView.ts => shared/types/views/product-view.ts (75%)
 rename app/models/views/QuestionListVuew.ts => shared/types/views/question-list-view.ts (100%)
 rename app/models/views/SearchItemView.ts => shared/types/views/search-item-view.ts (92%)
 rename app/models/views/SolutionListView.ts => shared/types/views/solution-list-view.ts (100%)
 rename app/models/views/SolutionView.ts => shared/types/views/solution-view.ts (100%)

diff --git a/app/models/mappers/documentMapper.test.ts b/app/models/mappers/documentMapper.test.ts
deleted file mode 100644
index 319ba4c..0000000
--- a/app/models/mappers/documentMapper.test.ts
+++ /dev/null
@@ -1,106 +0,0 @@
-import { describe, test, expect } from 'vitest';
-
-/**
- * 单元测试: toProductDocumentView
- */
-describe('toProductDocumentView', () => {
-  test('convert raw data with fileId to ProductDocumentView correctly', () => {
-    const rawData: ProductDocument = {
-      id: 1,
-      file: 'rand-om__-uuid-1234',
-      translations: [{ id: 10, title: 'Document Title' }],
-    };
-
-    expect(toProductDocumentView(rawData)).toEqual({
-      id: 1,
-      fileId: 'rand-om__-uuid-1234',
-      filename: undefined,
-      title: 'Document Title',
-      url: 'http://localhost:8055/assets/rand-om__-uuid-1234',
-      size: undefined,
-    });
-  });
-
-  test('convert raw data with fileMeta to ProductDocumentView correctly', () => {
-    const rawData: ProductDocument = {
-      id: 1,
-      file: {
-        id: 'rand-om__-uuid-1234',
-        filename_download: 'document.pdf',
-        filesize: 2048,
-      },
-      translations: [{ id: 10, title: 'Document Title' }],
-    };
-
-    expect(toProductDocumentView(rawData)).toEqual({
-      id: 1,
-      fileId: 'rand-om__-uuid-1234',
-      filename: 'document.pdf',
-      title: 'Document Title',
-      url: 'http://localhost:8055/assets/rand-om__-uuid-1234',
-      size: 2048,
-    });
-  });
-
-  test('convert raw data with missing translations', () => {
-    const rawData: ProductDocument = {
-      id: 1,
-      file: 'rand-om__-uuid-1234',
-      translations: [],
-    };
-
-    expect(toProductDocumentView(rawData)).toEqual({
-      id: 1,
-      fileId: 'rand-om__-uuid-1234',
-      filename: undefined,
-      title: '',
-      url: 'http://localhost:8055/assets/rand-om__-uuid-1234',
-      size: undefined,
-    });
-  });
-});
-
-/**
- * 单元测试: toDocumentListView
- */
-describe('toProductDocumentView', () => {
-  test('convert raw data with fileId to DocumentListView correctly', () => {
-    const rawData: ProductDocument = {
-      id: 1,
-      file: 'rand-om__-uuid-1234',
-      translations: [{ id: 10, title: 'Document Title' }],
-      products: [
-        {
-          id: 10,
-          products_id: {
-            id: 1,
-            translations: [{ id: 1, name: 'Product A' }],
-            product_type: {
-              id: 1,
-              translations: [{ id: 1, name: 'Type A' }],
-            },
-          },
-        },
-      ],
-    };
-
-    expect(toDocumentListView(rawData)).toEqual({
-      id: 1,
-      fileId: 'rand-om__-uuid-1234',
-      filename: undefined,
-      title: 'Document Title',
-      url: 'http://localhost:8055/assets/rand-om__-uuid-1234',
-      size: undefined,
-      products: [
-        {
-          id: 1,
-          name: 'Product A',
-          type: {
-            id: 1,
-            name: 'Type A',
-          },
-        },
-      ],
-    });
-  });
-});
diff --git a/app/models/mappers/documentMapper.ts b/app/models/mappers/documentMapper.ts
deleted file mode 100644
index d5c855d..0000000
--- a/app/models/mappers/documentMapper.ts
+++ /dev/null
@@ -1,79 +0,0 @@
-/**
- * 将 Directus 返回的 Document 数据转换为 ProductDocumentView 视图模型
- *
- * @param raw: 原始的 Document 数据
- * @returns 转换后的 ProductDocumentView 对象
- *
- * @example
- * const view = toProductDocumentView(rawDocument);
- */
-export function toProductDocumentView(
-  raw: ProductDocument
-): ProductDocumentView {
-  const trans = raw.translations?.[0] ?? {
-    title: '',
-  };
-
-  const fileId = typeof raw.file === 'string' ? raw.file : raw.file?.id;
-  const file = raw.file as DirectusFile;
-
-  const { getFileUrl } = useDirectusFiles();
-
-  const url = getFileUrl(fileId);
-
-  return {
-    id: raw.id,
-    fileId: fileId,
-    filename: file.filename_download,
-    title: trans.title,
-    url: url,
-    size: file.filesize,
-  };
-}
-
-/**
- * 将 Directus 返回的 Document 数据转换为 DocumentListView 视图模型
- *
- * @param raw: 原始的 Document 数据
- * @returns 转换后的 DocumentListView 对象
- *
- * @example
- * const view = toDocumentListView(rawDocument);
- */
-export function toDocumentListView(raw: ProductDocument): DocumentListView {
-  const trans = raw.translations?.[0] ?? { title: '' };
-
-  const fileId = typeof raw.file === 'string' ? raw.file : raw.file?.id;
-  const file = raw.file as DirectusFile;
-
-  const { getFileUrl } = useDirectusFiles();
-  const url = getFileUrl(fileId);
-
-  const related_products: DocumentListProduct[] = raw.products
-    ?.filter(isObject<ProductsProductDocument>)
-    .map((item) => item.products_id)
-    .filter(isObject<Product>)
-    .map((item) => {
-      const productType =
-        isObject<ProductType>(item.product_type) &&
-        ({
-          id: item.product_type.id,
-          name: item.product_type.translations?.[0]?.name,
-        } satisfies DocumentListProductType);
-      return {
-        id: item.id,
-        name: item.translations?.[0]?.name,
-        type: productType,
-      };
-    });
-
-  return {
-    id: raw.id,
-    fileId: fileId,
-    filename: file.filename_download,
-    title: trans.title,
-    url: url,
-    size: file.filesize,
-    products: related_products,
-  };
-}
diff --git a/app/pages/about/index.vue b/app/pages/about/index.vue
index 64dd05f..28a237a 100644
--- a/app/pages/about/index.vue
+++ b/app/pages/about/index.vue
@@ -4,7 +4,7 @@
       <app-breadcrumb class="breadcrumb" :items="breadcrumbItems" />
 
       <div class="content">
-        <markdown-renderer :content="content.content || ''" />
+        <markdown-renderer :content="companyProfile.content || ''" />
       </div>
 
       <el-divider content-position="left">{{ $t('learn-more') }}</el-divider>
@@ -32,9 +32,7 @@
     { label: $t('navigation.home'), to: localePath('/') },
     { label: $t('navigation.about-us') },
   ];
-  const { data, pending, error } = await useCompanyProfile();
-
-  const content = computed(() => toCompanyProfileView(data.value));
+  const { data: companyProfile, pending, error } = await useCompanyProfile();
 
   watch(error, (value) => {
     if (value) {
diff --git a/app/pages/index.vue b/app/pages/index.vue
index f2eb413..d9ecd28 100644
--- a/app/pages/index.vue
+++ b/app/pages/index.vue
@@ -1,24 +1,14 @@
 <template>
   <div class="homepage">
-    <homepage-carousel :homepage-data="homepageData" :pending="pending" />
-    <homepage-product-section
-      :homepage-data="homepageData"
-      :pending="pending"
-    />
-    <homepage-solution-section
-      :homepage-data="homepageData"
-      :pending="pending"
-    />
+    <homepage-carousel :homepage-data="data" :pending="pending" />
+    <homepage-product-section :homepage-data="data" :pending="pending" />
+    <homepage-solution-section :homepage-data="data" :pending="pending" />
   </div>
 </template>
 
 <script setup lang="ts">
   const { data, pending, error } = await useHomepage();
 
-  const homepageData = computed(() => {
-    return toHomepageView(data.value);
-  });
-
   const pageTilte = $t('page-title.homepage');
 
   watch(error, (value) => {
diff --git a/app/pages/products/[slug].vue b/app/pages/products/[slug].vue
index fb06327..d3a7284 100644
--- a/app/pages/products/[slug].vue
+++ b/app/pages/products/[slug].vue
@@ -37,16 +37,7 @@
   // 获取路由参数
   const id = route.params.slug as string;
 
-  const { data, pending, error } = await useProduct(id);
-
-  const rawProduct = computed(() => data.value ?? null);
-
-  const product = computed(() => {
-    if (rawProduct.value === null) {
-      return null;
-    }
-    return toProductView(rawProduct.value);
-  });
+  const { data: product, pending, error } = await useProduct(id);
 
   const breadcrumbItems = computed(() => [
     { label: $t('navigation.home'), to: localePath('/') },
diff --git a/app/pages/products/index.vue b/app/pages/products/index.vue
index 49c3b0c..b8c9918 100644
--- a/app/pages/products/index.vue
+++ b/app/pages/products/index.vue
@@ -37,7 +37,7 @@
   const localePath = useLocalePath();
   const { getImageUrl } = useDirectusImage();
 
-  const { data, pending, error } = await useProductList();
+  const { data: products, pending, error } = await useProductList();
 
   const activeNames = ref<string[]>([]);
 
@@ -46,14 +46,6 @@
     { label: $t('navigation.products') },
   ];
 
-  const productsRaw = computed(() => data.value ?? []);
-
-  const products = computed(() =>
-    productsRaw.value.map((item) => toProductListView(item))
-  );
-
-  logger.debug('产品列表数据: ', products.value);
-
   // 按类型分组
   const groupedProducts = computed(() => {
     const groups: Record<string, { data: ProductListView[]; sort: number }> =
diff --git a/app/pages/solutions/[slug].vue b/app/pages/solutions/[slug].vue
index fd37aae..373754f 100644
--- a/app/pages/solutions/[slug].vue
+++ b/app/pages/solutions/[slug].vue
@@ -29,14 +29,7 @@
   // 获取路由参数
   const id = route.params.slug as string;
 
-  const { data, pending, error } = await useSolution(id);
-
-  const solution = computed(() => {
-    if (!data.value) {
-      return null;
-    }
-    return toSolutionView(data.value);
-  });
+  const { data: solution, pending, error } = await useSolution(id);
 
   const breadcrumbItems = computed(() => [
     { label: $t('navigation.home'), to: localePath('/') },
diff --git a/app/pages/solutions/index.vue b/app/pages/solutions/index.vue
index 33bf637..0b15140 100644
--- a/app/pages/solutions/index.vue
+++ b/app/pages/solutions/index.vue
@@ -52,12 +52,7 @@
     { label: $t('navigation.solutions') },
   ];
 
-  const { data, pending, error } = await useSolutionList();
-
-  const solutionsRaw = computed(() => data.value ?? []);
-  const solutions = computed(() =>
-    solutionsRaw.value.map((item) => toSolutionListView(item))
-  );
+  const { data: solutions, pending, error } = await useSolutionList();
 
   const activeName = ref<string>('all');
 
diff --git a/app/pages/support/contact-us.vue b/app/pages/support/contact-us.vue
index d6d09e2..5ba4ff6 100644
--- a/app/pages/support/contact-us.vue
+++ b/app/pages/support/contact-us.vue
@@ -7,7 +7,7 @@
     </div>
 
     <div v-if="!pending" class="page-content">
-      <markdown-renderer :content="content.content || ''" />
+      <markdown-renderer :content="contactInfo.content || ''" />
     </div>
     <div v-else class="loading">
       <el-skeleton :rows="5" animated />
@@ -22,9 +22,7 @@
     { label: $t('navigation.support'), to: localePath('/support') },
     { label: $t('navigation.contact-info') },
   ];
-  const { data, pending, error } = await useContactInfo();
-
-  const content = computed(() => toContactInfoView(data.value));
+  const { data: contactInfo, pending, error } = await useContactInfo();
 
   watch(error, (value) => {
     if (value) {
diff --git a/app/pages/support/documents.vue b/app/pages/support/documents.vue
index 3320a67..63519eb 100644
--- a/app/pages/support/documents.vue
+++ b/app/pages/support/documents.vue
@@ -35,11 +35,7 @@
     keyword: '',
   });
 
-  const { data, pending, error } = await useDocumentList();
-
-  const documents = computed(
-    () => data?.value.map((item) => toDocumentListView(item)) ?? []
-  );
+  const { data: documents, pending, error } = await useDocumentList();
 
   const productTypeOptions = computed(() => {
     const types: DocumentListProductType[] = [];
diff --git a/app/pages/support/faq.vue b/app/pages/support/faq.vue
index eb668f2..dafe3c8 100644
--- a/app/pages/support/faq.vue
+++ b/app/pages/support/faq.vue
@@ -38,11 +38,7 @@
     { label: $t('navigation.faq') },
   ];
 
-  const { data, pending, error } = await useQuestionList();
-
-  const questions = computed(
-    () => data.value.map((item) => toQuestionListView(item)) ?? null
-  );
+  const { data: questions, pending, error } = await useQuestionList();
 
   const productTypeOptions = computed(() => {
     const types: QuestionListProductType[] = [];
diff --git a/server/api/cms/companyProfile.get.ts b/server/api/cms/companyProfile.get.ts
new file mode 100644
index 0000000..84bc472
--- /dev/null
+++ b/server/api/cms/companyProfile.get.ts
@@ -0,0 +1,7 @@
+import { companyProfileService } from '~~/server/services/cms/companyProfileService';
+
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return companyProfileService.getCompanyProfile(locale);
+});
diff --git a/server/api/cms/companyProfile.ts b/server/api/cms/companyProfile.ts
deleted file mode 100644
index d624a24..0000000
--- a/server/api/cms/companyProfile.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/companyProfile.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ company_profile: CompanyProfile }>(
-    query,
-    {
-      locale: locale,
-    }
-  );
-
-  const companyProfile = data?.company_profile;
-
-  return companyProfile;
-});
diff --git a/server/api/cms/contactInfo.get.ts b/server/api/cms/contactInfo.get.ts
new file mode 100644
index 0000000..149ec9e
--- /dev/null
+++ b/server/api/cms/contactInfo.get.ts
@@ -0,0 +1,7 @@
+import { contactInfoService } from '~~/server/services/cms/contactInfoService';
+
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return contactInfoService.getContactInfo(locale);
+});
diff --git a/server/api/cms/contactInfo.ts b/server/api/cms/contactInfo.ts
deleted file mode 100644
index 7f71f65..0000000
--- a/server/api/cms/contactInfo.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/contactInfo.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ contact_info: ContactInfo }>(query, {
-    locale: locale,
-  });
-
-  const contactInfo = data?.contact_info;
-
-  return contactInfo;
-});
diff --git a/server/api/cms/documentList.get.ts b/server/api/cms/documentList.get.ts
new file mode 100644
index 0000000..083478e
--- /dev/null
+++ b/server/api/cms/documentList.get.ts
@@ -0,0 +1,7 @@
+import { documentService } from '~~/server/services/cms/documentService';
+
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return documentService.getDocumentList(locale);
+});
diff --git a/server/api/cms/documentList.ts b/server/api/cms/documentList.ts
deleted file mode 100644
index 9c6bf02..0000000
--- a/server/api/cms/documentList.ts
+++ /dev/null
@@ -1,24 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/documentList.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ product_documents: ProductDocument[] }>(
-    query,
-    {
-      locale: locale,
-    }
-  );
-
-  const documents = data?.product_documents;
-
-  return documents;
-});
diff --git a/server/api/cms/homepage.get.ts b/server/api/cms/homepage.get.ts
new file mode 100644
index 0000000..79caa7a
--- /dev/null
+++ b/server/api/cms/homepage.get.ts
@@ -0,0 +1,7 @@
+import { homepageService } from '~~/server/services/cms/homepageService';
+
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return homepageService.getHomepage(locale);
+});
diff --git a/server/api/cms/homepage.ts b/server/api/cms/homepage.ts
deleted file mode 100644
index 6cce426..0000000
--- a/server/api/cms/homepage.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/homepage.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ homepage: Homepage }>(query, {
-    locale: locale,
-  });
-
-  const homepage = data?.homepage;
-
-  return homepage;
-});
diff --git a/server/api/cms/product/[id].get.ts b/server/api/cms/product/[id].get.ts
new file mode 100644
index 0000000..644078b
--- /dev/null
+++ b/server/api/cms/product/[id].get.ts
@@ -0,0 +1,13 @@
+import { productService } from '~~/server/services/cms/productService';
+
+export default defineEventHandler(async (event) => {
+  const id = getRouterParam(event, 'id');
+  if (!id)
+    throw createError({
+      statusCode: 400,
+      statusMessage: 'Product ID is required',
+    });
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return productService.getProductById(id, locale);
+});
diff --git a/server/api/cms/product/[id].ts b/server/api/cms/product/[id].ts
deleted file mode 100644
index 441d2b7..0000000
--- a/server/api/cms/product/[id].ts
+++ /dev/null
@@ -1,33 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const id = getRouterParam(event, 'id');
-  if (!id)
-    throw createError({
-      statusCode: 400,
-      statusMessage: 'Product ID is required',
-    });
-
-  const query = await loadAssetAsString(
-    'assets/server',
-    'graphql/product.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ products_by_id: Product }>(query, {
-    id: id,
-    locale: locale,
-  });
-
-  const product = data?.products_by_id;
-
-  if (!product || product.status === 'archived') {
-    throw createError({ statusCode: 404, statusMessage: 'Product not found' });
-  }
-
-  return product;
-});
diff --git a/server/api/cms/productList.get.ts b/server/api/cms/productList.get.ts
new file mode 100644
index 0000000..31fd94c
--- /dev/null
+++ b/server/api/cms/productList.get.ts
@@ -0,0 +1,6 @@
+import { productService } from '~~/server/services/cms/productService';
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return productService.getProductList(locale);
+});
diff --git a/server/api/cms/productList.ts b/server/api/cms/productList.ts
deleted file mode 100644
index 0e4054d..0000000
--- a/server/api/cms/productList.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/productList.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ products: Product[] }>(query, {
-    locale: locale,
-  });
-
-  const products = data?.products || [];
-
-  return products;
-});
diff --git a/server/api/cms/questionList.get.ts b/server/api/cms/questionList.get.ts
new file mode 100644
index 0000000..18a2a11
--- /dev/null
+++ b/server/api/cms/questionList.get.ts
@@ -0,0 +1,6 @@
+import { questionService } from '~~/server/services/cms/questionService';
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return questionService.getQuestionList(locale);
+});
diff --git a/server/api/cms/questionList.ts b/server/api/cms/questionList.ts
deleted file mode 100644
index e47b941..0000000
--- a/server/api/cms/questionList.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/questionList.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ questions: Question[] }>(query, {
-    locale: locale,
-  });
-
-  const questions = data?.questions || [];
-
-  return questions;
-});
diff --git a/server/api/cms/solution/[id].get.ts b/server/api/cms/solution/[id].get.ts
new file mode 100644
index 0000000..2ca740c
--- /dev/null
+++ b/server/api/cms/solution/[id].get.ts
@@ -0,0 +1,14 @@
+import { solutionService } from '~~/server/services/cms/solutionService';
+
+export default defineEventHandler(async (event) => {
+  const id = getRouterParam(event, 'id');
+  if (!id)
+    throw createError({
+      statusCode: 400,
+      statusMessage: 'Solution ID is required',
+    });
+
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return solutionService.getSolutionById(id, locale);
+});
diff --git a/server/api/cms/solution/[id].ts b/server/api/cms/solution/[id].ts
deleted file mode 100644
index 9b8e742..0000000
--- a/server/api/cms/solution/[id].ts
+++ /dev/null
@@ -1,33 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const id = getRouterParam(event, 'id');
-  if (!id)
-    throw createError({
-      statusCode: 400,
-      statusMessage: 'Solution ID is required',
-    });
-
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/solution.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ solutions_by_id: Solution }>(query, {
-    id: id,
-    locale: locale,
-  });
-
-  const solution = data?.solutions_by_id;
-
-  if (!solution || solution.status === 'archived') {
-    throw createError({ statusCode: 404, statusMessage: 'Solution not found' });
-  }
-
-  return solution;
-});
diff --git a/server/api/cms/solutionList.get.ts b/server/api/cms/solutionList.get.ts
new file mode 100644
index 0000000..fb18c45
--- /dev/null
+++ b/server/api/cms/solutionList.get.ts
@@ -0,0 +1,7 @@
+import { solutionService } from '~~/server/services/cms/solutionService';
+
+export default defineEventHandler(async (event) => {
+  const locale = getHeader(event, 'x-locale') || 'zh-CN';
+
+  return solutionService.getSolutionList(locale);
+});
diff --git a/server/api/cms/solutionList.ts b/server/api/cms/solutionList.ts
deleted file mode 100644
index ff36e0e..0000000
--- a/server/api/cms/solutionList.ts
+++ /dev/null
@@ -1,21 +0,0 @@
-import { directus } from '~~/server/utils/directus';
-import { loadAssetAsString } from '~~/server/utils/serverAssets';
-
-export default defineEventHandler(async (event) => {
-  const query = await loadAssetAsString(
-    'assets:server',
-    'graphql/solutionList.graphql'
-  );
-  if (!query)
-    throw createError({ statusCode: 500, message: 'GraphQL query not found' });
-
-  const locale = getHeader(event, 'x-locale') || 'zh-CN';
-
-  const data = await directus.query<{ solutions: Solution[] }>(query, {
-    locale: locale,
-  });
-
-  const solutions = data?.solutions || [];
-
-  return solutions;
-});
diff --git a/app/models/mappers/companyProfileMapper.test.ts b/server/mappers/companyProfileMapper.test.ts
similarity index 72%
rename from app/models/mappers/companyProfileMapper.test.ts
rename to server/mappers/companyProfileMapper.test.ts
index 59ea13b..8b0fc66 100644
--- a/app/models/mappers/companyProfileMapper.test.ts
+++ b/server/mappers/companyProfileMapper.test.ts
@@ -1,15 +1,18 @@
 import { expect, test, describe } from 'vitest';
+import { toCompanyProfileView } from './companyProfileMapper';
 
 /**
  * 单元测试: companyProfileMapper
  */
 describe('companyProfileMapper', () => {
+  const baseData: CompanyProfile = {
+    id: 1,
+    translations: [{ id: 10, content: 'This is raw data of company profile' }],
+  };
+
   test('convert raw data to CompanyProfileView correctly', () => {
     const rawData: CompanyProfile = {
-      id: 1,
-      translations: [
-        { id: 10, content: 'This is raw data of company profile' },
-      ],
+      ...baseData,
     };
 
     expect(toCompanyProfileView(rawData)).toEqual({
@@ -19,7 +22,7 @@ describe('companyProfileMapper', () => {
   });
   test('convert raw data with missing translations', () => {
     const rawData: CompanyProfile = {
-      id: 1,
+      ...baseData,
       translations: [],
     };
 
diff --git a/app/models/mappers/companyProfileMapper.ts b/server/mappers/companyProfileMapper.ts
similarity index 81%
rename from app/models/mappers/companyProfileMapper.ts
rename to server/mappers/companyProfileMapper.ts
index 34eda30..50315d3 100644
--- a/app/models/mappers/companyProfileMapper.ts
+++ b/server/mappers/companyProfileMapper.ts
@@ -8,10 +8,10 @@
  * const view = toCompanyProfileView(rawCompanyProfile);
  */
 export function toCompanyProfileView(raw: CompanyProfile): CompanyProfileView {
-  const trans = raw.translations?.[0] ?? { content: '' };
+  const trans = raw.translations?.[0];
 
   return {
     id: raw.id,
-    content: trans.content,
+    content: trans?.content ?? '',
   };
 }
diff --git a/app/models/mappers/contactInfoMapper.test.ts b/server/mappers/contactInfoMapper.test.ts
similarity index 72%
rename from app/models/mappers/contactInfoMapper.test.ts
rename to server/mappers/contactInfoMapper.test.ts
index c73d203..f15f77e 100644
--- a/app/models/mappers/contactInfoMapper.test.ts
+++ b/server/mappers/contactInfoMapper.test.ts
@@ -1,13 +1,17 @@
 import { describe, test, expect } from 'vitest';
+import { toContactInfoView } from './contactInfoMapper';
 
 /**
  * 单元测试: contactInfoMapper
  */
 describe('contactInfoMapper', () => {
+  const baseData: ContactInfo = {
+    id: 1,
+    translations: [{ id: 10, content: 'This is raw data of contact info' }],
+  };
   test('convert raw data to ContactInfoView correctly', () => {
     const rawData: ContactInfo = {
-      id: 1,
-      translations: [{ id: 10, content: 'This is raw data of contact info' }],
+      ...baseData,
     };
 
     expect(toContactInfoView(rawData)).toEqual({
@@ -18,7 +22,7 @@ describe('contactInfoMapper', () => {
 
   test('convert raw data with missing translations', () => {
     const rawData: ContactInfo = {
-      id: 1,
+      ...baseData,
       translations: [],
     };
 
diff --git a/app/models/mappers/contactInfoMapper.ts b/server/mappers/contactInfoMapper.ts
similarity index 80%
rename from app/models/mappers/contactInfoMapper.ts
rename to server/mappers/contactInfoMapper.ts
index efda729..1ea7489 100644
--- a/app/models/mappers/contactInfoMapper.ts
+++ b/server/mappers/contactInfoMapper.ts
@@ -8,10 +8,10 @@
  * const view = toContactInfoView(rawContactInfo);
  */
 export function toContactInfoView(raw: ContactInfo): ContactInfoView {
-  const trans = raw.translations?.[0] ?? { content: '' };
+  const trans = raw.translations?.[0];
 
   return {
     id: raw.id,
-    content: trans.content,
+    content: trans?.content ?? '',
   };
 }
diff --git a/server/mappers/documentMapper.test.ts b/server/mappers/documentMapper.test.ts
new file mode 100644
index 0000000..d54e661
--- /dev/null
+++ b/server/mappers/documentMapper.test.ts
@@ -0,0 +1,109 @@
+import { describe, test, expect } from 'vitest';
+import { toProductDocumentView, toDocumentListView } from './documentMapper';
+
+/**
+ * 单元测试: toProductDocumentView
+ */
+describe('toProductDocumentView', () => {
+  const baseData: ProductDocument = {
+    id: 1,
+    file: {
+      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', () => {
+    const rawData: ProductDocument = { ...baseData };
+    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({
+      id: 1,
+      fileId: '',
+      filename: '',
+      title: 'Document Title',
+      url: '/api/assets/',
+      size: 0,
+    });
+  });
+
+  test('convert raw data with missing translations', () => {
+    const rawData: ProductDocument = {
+      ...baseData,
+      translations: [],
+    };
+    expect(toProductDocumentView(rawData)).toEqual({
+      id: 1,
+      fileId: 'rand-om__-uuid-1234',
+      filename: 'document.pdf',
+      title: '',
+      url: '/api/assets/rand-om__-uuid-1234',
+      size: 2048,
+    });
+  });
+});
+
+/**
+ * 单元测试: toDocumentListView
+ */
+describe('toDocumentListView', () => {
+  const baseData: ProductDocument = {
+    id: 1,
+    file: {
+      id: 'rand-om__-uuid-1234',
+      filename_download: 'document.pdf',
+      filesize: 2048,
+    },
+    translations: [{ id: 10, title: 'Document Title' }],
+    products: [
+      {
+        id: 10,
+        products_id: {
+          id: 1,
+          translations: [{ id: 1, name: 'Product A' }],
+          product_type: {
+            id: 1,
+            translations: [{ id: 1, name: 'Type A' }],
+          },
+        },
+      },
+    ],
+  };
+  test('convert raw data with fileMeta to DocumentListView correctly', () => {
+    const rawData: ProductDocument = { ...baseData };
+    expect(toDocumentListView(rawData)).toEqual({
+      id: 1,
+      fileId: 'rand-om__-uuid-1234',
+      filename: 'document.pdf',
+      title: 'Document Title',
+      url: '/api/assets/rand-om__-uuid-1234',
+      size: 2048,
+      products: [
+        {
+          id: 1,
+          name: 'Product A',
+          type: {
+            id: 1,
+            name: 'Type A',
+          },
+        },
+      ],
+    });
+  });
+});
diff --git a/server/mappers/documentMapper.ts b/server/mappers/documentMapper.ts
new file mode 100644
index 0000000..d1d7113
--- /dev/null
+++ b/server/mappers/documentMapper.ts
@@ -0,0 +1,76 @@
+/**
+ * 将 Directus 返回的 Document 数据转换为 ProductDocumentView 视图模型
+ *
+ * @param raw: 原始的 Document 数据
+ * @returns 转换后的 ProductDocumentView 对象
+ *
+ * @example
+ * const view = toProductDocumentView(rawDocument);
+ */
+export function toProductDocumentView(
+  raw: ProductDocument
+): ProductDocumentView {
+  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,
+    fileId: fileId,
+    filename: file?.filename_download ?? '',
+    title: trans?.title ?? '',
+    url: url,
+    size: file?.filesize ?? 0,
+  };
+}
+
+/**
+ * 将 Directus 返回的 Document 数据转换为 DocumentListView 视图模型
+ *
+ * @param raw: 原始的 Document 数据
+ * @returns 转换后的 DocumentListView 对象
+ *
+ * @example
+ * const view = toDocumentListView(rawDocument);
+ */
+export function toDocumentListView(raw: ProductDocument): DocumentListView {
+  const trans = raw.translations?.[0];
+
+  const file = isObject<DirectusFile>(raw.file) ? raw.file : undefined;
+  const fileId = file?.id ?? '';
+
+  const url = `/api/assets/${fileId}`;
+
+  const related_products: DocumentListProduct[] = (raw.products ?? [])
+    .filter(isObject<ProductsProductDocument>)
+    .map((item) => item.products_id)
+    .filter(isObject<Product>)
+    .map((item) => {
+      const productType = isObject<ProductType>(item.product_type)
+        ? ({
+            id: item.product_type.id,
+            name: item.product_type.translations?.[0]?.name ?? '',
+          } satisfies DocumentListProductType)
+        : ({
+            id: -1,
+            name: '',
+          } satisfies DocumentListProductType);
+      return {
+        id: item.id,
+        name: item.translations?.[0]?.name ?? '',
+        type: productType,
+      };
+    });
+
+  return {
+    id: raw.id,
+    fileId: fileId,
+    filename: file?.filename_download ?? '',
+    title: trans?.title ?? '',
+    url: url,
+    size: file?.filesize ?? 0,
+    products: related_products,
+  };
+}
diff --git a/app/models/mappers/homepageMapper.test.ts b/server/mappers/homepageMapper.test.ts
similarity index 88%
rename from app/models/mappers/homepageMapper.test.ts
rename to server/mappers/homepageMapper.test.ts
index 055cf09..e477bd3 100644
--- a/app/models/mappers/homepageMapper.test.ts
+++ b/server/mappers/homepageMapper.test.ts
@@ -1,4 +1,5 @@
 import { describe, test, expect } from 'vitest';
+import { toHomepageView } from './homepageMapper';
 
 /**
  * 单元测试: toHomepageView
@@ -25,19 +26,25 @@ describe('toHomepageView', () => {
         {
           id: 1,
           translations: [{ id: 1, name: 'Product 1', summary: 'Summary 1' }],
-          cover: 'cover-file-uuid-1',
+          cover: {
+            id: 'cover-file-uuid-1',
+          },
         },
         {
           id: 2,
           translations: [{ id: 2, name: 'Product 2', summary: 'Summary 2' }],
-          cover: { id: 'cover-file-uuid-2' },
+          cover: {
+            id: 'cover-file-uuid-2',
+          },
         },
       ],
       recommend_solutions: [
         {
           id: 1,
           translations: [{ id: 1, title: 'Solution 1', summary: 'Summary 1' }],
-          cover: 'cover-file-uuid-1',
+          cover: {
+            id: 'cover-file-uuid-1',
+          },
         },
       ],
     };
@@ -81,8 +88,8 @@ describe('toHomepageView', () => {
     expect(toHomepageView(rawData)).toEqual({
       id: 1,
       carousel: [],
-      recommendProducts: [{ id: 1, name: '', summary: '', cover: null }],
-      recommendSolutions: [{ id: 1, title: '', summary: '', cover: null }],
+      recommendProducts: [{ id: 1, name: '', summary: '', cover: '' }],
+      recommendSolutions: [{ id: 1, title: '', summary: '', cover: '' }],
     });
   });
 });
diff --git a/app/models/mappers/homepageMapper.ts b/server/mappers/homepageMapper.ts
similarity index 69%
rename from app/models/mappers/homepageMapper.ts
rename to server/mappers/homepageMapper.ts
index 078890b..a3836b5 100644
--- a/app/models/mappers/homepageMapper.ts
+++ b/server/mappers/homepageMapper.ts
@@ -1,3 +1,5 @@
+import { isObject } from '../utils/object';
+
 /**
  * 将 Directus 返回的 Homepage 数据转换为 HomepageView 视图模型
  *
@@ -17,14 +19,14 @@ export function toHomepageView(raw: Homepage): HomepageView {
   const products = (raw.recommend_products ?? [])
     .filter(isObject<Product>)
     .map((item) => {
-      const cover = isObject<DirectusFile>(item.cover)
-        ? item.cover.id
-        : item.cover;
-      const trans = item.translations?.[0] ?? { name: '', summary: '' };
+      const trans = item.translations?.[0];
+
+      const cover = isObject<DirectusFile>(item.cover) ? item.cover.id : '';
+
       return {
         id: item.id,
-        name: trans.name,
-        summary: trans.summary,
+        name: trans?.name ?? '',
+        summary: trans?.summary ?? '',
         cover: cover,
       } satisfies HomepageProductView;
     });
@@ -32,15 +34,13 @@ export function toHomepageView(raw: Homepage): HomepageView {
   const solutions = (raw.recommend_solutions ?? [])
     .filter(isObject<Solution>)
     .map((item) => {
-      const cover = isObject<DirectusFile>(item.cover)
-        ? item.cover.id
-        : item.cover;
-      const trans = item.translations?.[0] ?? { title: '', summary: '' };
+      const trans = item.translations?.[0];
+      const cover = isObject<DirectusFile>(item.cover) ? item.cover.id : '';
 
       return {
         id: item.id,
-        title: trans.title,
-        summary: trans.summary,
+        title: trans?.title ?? '',
+        summary: trans?.summary ?? '',
         cover: cover,
       } satisfies HomepageSolutionView;
     });
diff --git a/app/models/mappers/productMapper.test.ts b/server/mappers/productMapper.test.ts
similarity index 97%
rename from app/models/mappers/productMapper.test.ts
rename to server/mappers/productMapper.test.ts
index ad9a837..22fcf76 100644
--- a/app/models/mappers/productMapper.test.ts
+++ b/server/mappers/productMapper.test.ts
@@ -1,4 +1,10 @@
 import { describe, test, expect } from 'vitest';
+import {
+  toProductListView,
+  toProductSpecView,
+  toProductSpecGroupView,
+  toProductView,
+} from './productMapper';
 
 /**
  * 单元测试: toProductListView
diff --git a/app/models/mappers/productMapper.ts b/server/mappers/productMapper.ts
similarity index 79%
rename from app/models/mappers/productMapper.ts
rename to server/mappers/productMapper.ts
index 9c61a5e..138659c 100644
--- a/app/models/mappers/productMapper.ts
+++ b/server/mappers/productMapper.ts
@@ -1,3 +1,6 @@
+import { toProductQuestionView } from './questionMapper';
+import { toProductDocumentView } from './documentMapper';
+
 /**
  * 将Directus返回的ProductType数据转换为ProductTypeView视图模型
  *
@@ -27,19 +30,23 @@ export function toProductTypeView(raw: ProductType): ProductTypeView {
  * const view = toProductListView(rawProduct);
  */
 export function toProductListView(raw: Product): ProductListView {
-  const trans = raw.translations?.[0] ?? { name: '', summary: '' };
+  const trans = raw.translations?.[0];
 
   const type = isObject<ProductType>(raw.product_type)
     ? toProductTypeView(raw.product_type)
-    : undefined;
+    : ({
+        id: -1,
+        name: '',
+        sort: 999,
+      } satisfies ProductTypeView);
 
   const cover = isObject<DirectusFile>(raw.cover) ? raw.cover.id : '';
 
   return {
     id: raw.id,
     product_type: type,
-    name: trans.name,
-    summary: trans.summary,
+    name: trans?.name ?? '',
+    summary: trans?.summary ?? '',
     cover: cover,
   };
 }
@@ -56,14 +63,14 @@ export function toProductListView(raw: Product): ProductListView {
 export function toProductSpecGroupView(
   raw: ProductSpecGroup
 ): ProductSpecGroupView {
-  const trans = raw.translations?.[0] ?? {
-    name: '',
-  };
+  const trans = raw.translations?.[0];
+
+  const specs = raw.specs ?? [];
 
   return {
     id: raw.id,
-    name: trans.name,
-    specs: raw.specs
+    name: trans?.name ?? '',
+    specs: specs
       .filter(isObject<ProductSpec>)
       .map((item) => toProductSpecView(item)),
   };
@@ -79,15 +86,12 @@ export function toProductSpecGroupView(
  * const view = toProductSpecView(rawSpecGroup);
  */
 export function toProductSpecView(raw: ProductSpec): ProductSpecView {
-  const trans = raw.translations?.[0] ?? {
-    key: '',
-    value: '',
-  };
+  const trans = raw.translations?.[0];
 
   return {
     id: raw.id,
-    key: trans.key,
-    value: trans.value,
+    key: trans?.key ?? '',
+    value: trans?.value ?? '',
   };
 }
 
@@ -101,11 +105,7 @@ export function toProductSpecView(raw: ProductSpec): ProductSpecView {
  * const view = toProductView(rawProduct);
  */
 export function toProductView(raw: Product): ProductView {
-  const trans = raw.translations?.[0] ?? {
-    name: '',
-    summary: '',
-    description: '',
-  };
+  const trans = raw.translations?.[0];
 
   const images = (raw.images ?? [])
     .filter(isObject<ProductsProductImage>)
@@ -120,6 +120,10 @@ export function toProductView(raw: Product): ProductView {
       };
     });
 
+  const type = isObject<ProductType>(raw.product_type)
+    ? (raw.product_type.translations?.[0]?.name ?? '')
+    : '';
+
   const specs = (raw.specs ?? [])
     .filter(isObject<ProductSpecGroup>)
     .map((item) => toProductSpecGroupView(item));
@@ -138,17 +142,11 @@ export function toProductView(raw: Product): ProductView {
 
   return {
     id: raw.id,
-
-    product_type:
-      typeof raw.product_type === 'string'
-        ? raw.product_type
-        : typeof raw.product_type === 'object' && raw.product_type
-          ? raw.product_type.translations[0].name || ''
-          : '',
-    name: trans.name,
-    summary: trans.summary,
+    product_type: type,
+    name: trans?.name ?? '',
+    summary: trans?.summary ?? '',
     images: images,
-    description: trans.description,
+    description: trans?.description ?? '',
     specs: specs,
     faqs: faqs,
     documents: documents,
diff --git a/app/models/mappers/questionMapper.test.ts b/server/mappers/questionMapper.test.ts
similarity index 73%
rename from app/models/mappers/questionMapper.test.ts
rename to server/mappers/questionMapper.test.ts
index 4705dc1..6f341ab 100644
--- a/app/models/mappers/questionMapper.test.ts
+++ b/server/mappers/questionMapper.test.ts
@@ -1,15 +1,19 @@
 import { describe, expect, test } from 'vitest';
+import { toProductQuestionView, toQuestionListView } from './questionMapper';
 
 /**
  * 单元测试: toProductQuestionView
  */
 describe('toProductQuestionView', () => {
+  const baseData: Question = {
+    id: 1,
+    translations: [
+      { id: 1, title: 'Question Title', content: 'Question Answer' },
+    ],
+  };
   test('convert raw data to ProductQuestionView correctly', () => {
     const rawData: Question = {
-      id: 1,
-      translations: [
-        { id: 1, title: 'Question Title', content: 'Question Answer' },
-      ],
+      ...baseData,
     };
 
     expect(toProductQuestionView(rawData)).toEqual({
@@ -21,7 +25,7 @@ describe('toProductQuestionView', () => {
 
   test('convert raw data with missing translations', () => {
     const rawData: Question = {
-      id: 1,
+      ...baseData,
       translations: [],
     };
 
@@ -37,25 +41,29 @@ describe('toProductQuestionView', () => {
  * 单元测试: toQuestionListView
  */
 describe('toQuestionListView', () => {
-  test('convert raw data to QuestionListView correctly', () => {
-    const rawData: Question = {
-      id: 1,
-      translations: [
-        { id: 1, title: 'Question Title', content: 'Question Answer' },
-      ],
-      products: [
-        {
+  const baseData: Question = {
+    id: 1,
+    translations: [
+      { id: 1, title: 'Question Title', content: 'Question Answer' },
+    ],
+    products: [
+      {
+        id: 1,
+        products_id: {
           id: 1,
-          products_id: {
+          translations: [{ id: 1, name: 'Product Name' }],
+          product_type: {
             id: 1,
-            translations: [{ id: 1, name: 'Product Name' }],
-            product_type: {
-              id: 1,
-              translations: [{ id: 1, name: 'Type Name' }],
-            },
+            translations: [{ id: 1, name: 'Type Name' }],
           },
         },
-      ],
+      },
+    ],
+  };
+
+  test('convert raw data to QuestionListView correctly', () => {
+    const rawData: Question = {
+      ...baseData,
     };
 
     expect(toQuestionListView(rawData)).toEqual({
@@ -77,7 +85,7 @@ describe('toQuestionListView', () => {
 
   test('convert raw data with missing translations', () => {
     const rawData: Question = {
-      id: 1,
+      ...baseData,
       translations: [],
       products: [
         {
diff --git a/app/models/mappers/questionMapper.ts b/server/mappers/questionMapper.ts
similarity index 62%
rename from app/models/mappers/questionMapper.ts
rename to server/mappers/questionMapper.ts
index 5f37926..497ca0f 100644
--- a/app/models/mappers/questionMapper.ts
+++ b/server/mappers/questionMapper.ts
@@ -8,12 +8,12 @@
  * const view = toProductQuestionView(rawQuestion);
  */
 export function toProductQuestionView(raw: Question): ProductQuestionView {
-  const trans = raw.translations?.[0] ?? { title: '', content: '' };
+  const trans = raw.translations?.[0];
 
   return {
     id: raw.id,
-    title: trans.title,
-    content: trans.content,
+    title: trans?.title ?? '',
+    content: trans?.content ?? '',
   };
 }
 
@@ -27,33 +27,36 @@ export function toProductQuestionView(raw: Question): ProductQuestionView {
  *  const view = toQuestionListView(rawQuestion);
  */
 export function toQuestionListView(raw: Question): QuestionListView {
-  const trans = raw.translations?.[0] ?? { title: '', content: '' };
+  const trans = raw.translations?.[0];
 
   const related_products: QuestionListProduct[] = (raw.products ?? [])
     .filter(isObject<ProductsQuestion>)
     .map((item) => item.products_id)
     .filter(isObject<Product>)
     .map((item) => {
-      const translations = item.translations[0] ?? { name: '' };
+      const translations = item.translations?.[0];
 
-      const product_type =
-        isObject<ProductType>(item.product_type) &&
-        ({
-          id: item.product_type.id,
-          name: item.product_type.translations[0]?.name ?? '',
-        } satisfies QuestionListProductType);
+      const product_type = isObject<ProductType>(item.product_type)
+        ? ({
+            id: item.product_type.id,
+            name: item.product_type.translations?.[0]?.name ?? '',
+          } satisfies QuestionListProductType)
+        : ({
+            id: -1,
+            name: '',
+          } satisfies QuestionListProductType);
 
       return {
         id: item.id,
-        name: translations.name,
+        name: translations?.name ?? '',
         type: product_type,
       };
     });
 
   return {
     id: raw.id,
-    title: trans.title,
-    content: trans.content,
+    title: trans?.title ?? '',
+    content: trans?.content ?? '',
     products: related_products,
   };
 }
diff --git a/app/models/mappers/searchItemMapper.ts b/server/mappers/searchItemMapper.ts
similarity index 88%
rename from app/models/mappers/searchItemMapper.ts
rename to server/mappers/searchItemMapper.ts
index f48368e..b3fcc85 100644
--- a/app/models/mappers/searchItemMapper.ts
+++ b/server/mappers/searchItemMapper.ts
@@ -12,5 +12,5 @@ export function toSearchItemView<T extends MeiliSearchItemType>(
   type: T
 ): SearchItemView {
   const converter = converters[type];
-  return converter ? converter(item) : null;
+  return converter(item);
 }
diff --git a/app/models/mappers/solutionMapper.test.ts b/server/mappers/solutionMapper.test.ts
similarity index 67%
rename from app/models/mappers/solutionMapper.test.ts
rename to server/mappers/solutionMapper.test.ts
index 743414f..fbdc292 100644
--- a/app/models/mappers/solutionMapper.test.ts
+++ b/server/mappers/solutionMapper.test.ts
@@ -1,21 +1,23 @@
 import { describe, test, expect } from 'vitest';
+import { toSolutionListView, toSolutionView } from './solutionMapper';
 
 /**
  * 单元测试: toSolutionListView
  */
 describe('toSolutionListView', () => {
-  test('convert raw data to SolutionListView correctly', () => {
-    const rawData: Solution = {
+  const baseData: Solution = {
+    id: 1,
+    translations: [
+      { id: 1, title: 'Solution Title', summary: 'Solution Summary' },
+    ],
+    type: {
       id: 1,
-      translations: [
-        { id: 1, title: 'Solution Title', summary: 'Solution Summary' },
-      ],
-      type: {
-        id: 1,
-        translations: [{ id: 1, name: 'Type Name' }],
-        sort: 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,
@@ -26,18 +28,14 @@ describe('toSolutionListView', () => {
         name: 'Type Name',
         sort: 1,
       },
+      cover: '',
     });
   });
 
   test('convert raw data with missing translations', () => {
     const rawData: Solution = {
-      id: 1,
+      ...baseData,
       translations: [],
-      type: {
-        id: 1,
-        translations: [],
-        sort: null,
-      },
     };
 
     expect(toSolutionListView(rawData)).toEqual({
@@ -46,9 +44,10 @@ describe('toSolutionListView', () => {
       summary: '',
       solution_type: {
         id: 1,
-        name: '',
-        sort: 999,
+        name: 'Type Name',
+        sort: 1,
       },
+      cover: '',
     });
   });
 });
@@ -57,18 +56,22 @@ describe('toSolutionListView', () => {
  * 单元测试: toSolutionView
  */
 describe('toSolutionView', () => {
+  const baseData: Solution = {
+    id: 1,
+    translations: [
+      {
+        id: 1,
+        title: 'Solution Title',
+        summary: 'Solution Summary',
+        content: 'Solution Content',
+      },
+    ],
+    create_at: '2023-01-01T00:00:00Z',
+  };
+
   test('convert raw data to SolutionView correctly', () => {
     const rawData: Solution = {
-      id: 1,
-      translations: [
-        {
-          id: 1,
-          title: 'Solution Title',
-          summary: 'Solution Summary',
-          content: 'Solution Content',
-        },
-      ],
-      create_at: '2023-01-01T00:00:00Z',
+      ...baseData,
     };
 
     expect(toSolutionView(rawData)).toEqual({
@@ -82,9 +85,8 @@ describe('toSolutionView', () => {
 
   test('convert raw data with missing translations', () => {
     const rawData: Solution = {
-      id: 1,
+      ...baseData,
       translations: [],
-      create_at: '2023-01-01T00:00:00Z',
     };
 
     expect(toSolutionView(rawData)).toEqual({
diff --git a/app/models/mappers/solutionMapper.ts b/server/mappers/solutionMapper.ts
similarity index 68%
rename from app/models/mappers/solutionMapper.ts
rename to server/mappers/solutionMapper.ts
index d869024..9352092 100644
--- a/app/models/mappers/solutionMapper.ts
+++ b/server/mappers/solutionMapper.ts
@@ -10,11 +10,11 @@
  *  const view = toSolutionTypeView(rawSolutionType);
  */
 export function toSolutionTypeView(raw: SolutionType): SolutionTypeView {
-  const trans = raw.translations?.[0] ?? { name: '' };
+  const trans = raw?.translations?.[0];
 
   return {
     id: raw.id,
-    name: trans.name,
+    name: trans?.name ?? '',
     sort: raw?.sort ?? 999,
   };
 }
@@ -31,21 +31,24 @@ export function toSolutionTypeView(raw: SolutionType): SolutionTypeView {
  * const view = toSolutionListView(rawSolution);
  */
 export function toSolutionListView(raw: Solution): SolutionListView {
-  const trans = raw.translations?.[0] ?? {
-    title: '',
-    summary: '',
-  };
+  const trans = raw.translations?.[0];
 
   const type = isObject<SolutionType>(raw.type)
     ? toSolutionTypeView(raw.type)
-    : undefined;
+    : ({
+        id: -1,
+        name: 'uncategory',
+        sort: 999,
+      } satisfies SolutionTypeView);
+
+  const cover = isObject<DirectusFile>(raw.cover) ? (raw?.cover.id ?? '') : '';
 
   return {
     id: raw.id,
-    title: trans.title,
-    summary: trans.summary,
+    title: trans?.title ?? '',
+    summary: trans?.summary ?? '',
     solution_type: type,
-    cover: isObject<DirectusFile>(raw.cover) ? raw.cover.id : raw.cover,
+    cover: cover,
   };
 }
 
@@ -61,17 +64,13 @@ export function toSolutionListView(raw: Solution): SolutionListView {
  * const view = toSolutionView(rawSolution);
  */
 export function toSolutionView(raw: Solution): SolutionView {
-  const trans = raw.translations?.[0] ?? {
-    title: '',
-    summary: '',
-    content: '',
-  };
+  const trans = raw.translations?.[0];
 
   return {
     id: raw.id,
-    title: trans.title,
-    summary: trans.summary,
-    content: trans.content,
-    createAt: raw.create_at,
+    title: trans?.title ?? '',
+    summary: trans?.summary ?? '',
+    content: trans?.content ?? '',
+    createAt: raw?.create_at ?? '',
   };
 }
diff --git a/server/services/cms/companyProfileService.ts b/server/services/cms/companyProfileService.ts
new file mode 100644
index 0000000..7b169ee
--- /dev/null
+++ b/server/services/cms/companyProfileService.ts
@@ -0,0 +1,25 @@
+import { toCompanyProfileView } from '~~/server/mappers/companyProfileMapper';
+
+export const companyProfileService = {
+  async getCompanyProfile(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/companyProfile.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ company_profile: CompanyProfile }>(
+      query,
+      {
+        locale: locale,
+      }
+    );
+
+    return toCompanyProfileView(data?.company_profile);
+  },
+};
diff --git a/server/services/cms/contactInfoService.ts b/server/services/cms/contactInfoService.ts
new file mode 100644
index 0000000..0942a8a
--- /dev/null
+++ b/server/services/cms/contactInfoService.ts
@@ -0,0 +1,22 @@
+import { toContactInfoView } from '~~/server/mappers/contactInfoMapper';
+
+export const contactInfoService = {
+  async getContactInfo(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/contactInfo.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ contact_info: ContactInfo }>(query, {
+      locale: locale,
+    });
+
+    return toContactInfoView(data?.contact_info);
+  },
+};
diff --git a/server/services/cms/documentService.ts b/server/services/cms/documentService.ts
new file mode 100644
index 0000000..887ff43
--- /dev/null
+++ b/server/services/cms/documentService.ts
@@ -0,0 +1,27 @@
+import { toDocumentListView } from '~~/server/mappers/documentMapper';
+
+export const documentService = {
+  async getDocumentList(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/documentList.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ product_documents: ProductDocument[] }>(
+      query,
+      {
+        locale: locale,
+      }
+    );
+
+    const documents = data?.product_documents || [];
+
+    return documents.map((document) => toDocumentListView(document));
+  },
+};
diff --git a/server/services/cms/homepageService.ts b/server/services/cms/homepageService.ts
new file mode 100644
index 0000000..42f8309
--- /dev/null
+++ b/server/services/cms/homepageService.ts
@@ -0,0 +1,22 @@
+import { toHomepageView } from '~~/server/mappers/homepageMapper';
+
+export const homepageService = {
+  async getHomepage(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/homepage.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ homepage: Homepage }>(query, {
+      locale: locale,
+    });
+
+    return toHomepageView(data?.homepage);
+  },
+};
diff --git a/server/services/cms/productService.ts b/server/services/cms/productService.ts
new file mode 100644
index 0000000..c45d64d
--- /dev/null
+++ b/server/services/cms/productService.ts
@@ -0,0 +1,55 @@
+import {
+  toProductView,
+  toProductListView,
+} from '~~/server/mappers/productMapper';
+
+export const productService = {
+  async getProductList(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/productList.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ products: Product[] }>(query, {
+      locale: locale,
+    });
+
+    const products = data?.products || [];
+
+    return products.map((product) => toProductListView(product));
+  },
+  async getProductById(id: string, locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/product.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ products_by_id: Product }>(query, {
+      id: id,
+      locale: locale,
+    });
+
+    const product = data?.products_by_id;
+
+    if (!product || product.status === 'archived') {
+      throw createError({
+        statusCode: 404,
+        statusMessage: 'Product not found',
+      });
+    }
+
+    return toProductView(product);
+  },
+};
diff --git a/server/services/cms/questionService.ts b/server/services/cms/questionService.ts
new file mode 100644
index 0000000..77f51dd
--- /dev/null
+++ b/server/services/cms/questionService.ts
@@ -0,0 +1,24 @@
+import { toQuestionListView } from '~~/server/mappers/questionMapper';
+
+export const questionService = {
+  async getQuestionList(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/questionList.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ questions: Question[] }>(query, {
+      locale: locale,
+    });
+
+    const questions = data?.questions || [];
+
+    return questions.map((question) => toQuestionListView(question));
+  },
+};
diff --git a/server/services/cms/solutionService.ts b/server/services/cms/solutionService.ts
new file mode 100644
index 0000000..6c8f050
--- /dev/null
+++ b/server/services/cms/solutionService.ts
@@ -0,0 +1,55 @@
+import {
+  toSolutionView,
+  toSolutionListView,
+} from '~~/server/mappers/solutionMapper';
+
+export const solutionService = {
+  async getSolutionList(locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/solutionList.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ solutions: Solution[] }>(query, {
+      locale: locale,
+    });
+
+    const solutions = data?.solutions || [];
+
+    return solutions.map((solution) => toSolutionListView(solution));
+  },
+  async getSolutionById(id: string, locale: string) {
+    const query = await loadAssetAsString(
+      'assets/server',
+      'graphql/solution.graphql'
+    );
+    if (!query) {
+      throw createError({
+        statusCode: 500,
+        message: 'GraphQL query not found',
+      });
+    }
+
+    const data = await directus.query<{ solutions_by_id: Solution }>(query, {
+      id: id,
+      locale: locale,
+    });
+
+    const solution = data?.solutions_by_id;
+
+    if (!solution || solution.status === 'archived') {
+      throw createError({
+        statusCode: 404,
+        statusMessage: 'Solution not found',
+      });
+    }
+
+    return toSolutionView(solution);
+  },
+};
diff --git a/server/utils/object.test.ts b/server/utils/object.test.ts
new file mode 100644
index 0000000..b217543
--- /dev/null
+++ b/server/utils/object.test.ts
@@ -0,0 +1,66 @@
+import { expect, test, describe } from 'vitest';
+
+/**
+ * 单元测试: isObject
+ */
+describe('isObject', () => {
+  test('identify plain object', () => {
+    expect(isObject({})).toBe(true);
+    expect(isObject({ key: 'value' })).toBe(true);
+  });
+  test('identify null as non objevt', () => {
+    expect(isObject(null)).toBe(false);
+  });
+  test('identify non-object types', () => {
+    expect(isObject(undefined)).toBe(false);
+    expect(isObject(42)).toBe(false);
+    expect(isObject('string')).toBe(false);
+    expect(isObject(Symbol('sym'))).toBe(false);
+    expect(isObject(true)).toBe(false);
+    expect(isObject(() => {})).toBe(false);
+  });
+  test('identify arrays as objects', () => {
+    expect(isObject([])).toBe(true);
+  });
+  test('identify narrowed object type', () => {
+    const value: unknown = { id: 1 };
+    if (isObject<{ id: number }>(value)) {
+      expect(value.id).toBe(1);
+    } else {
+      throw new Error('Type narrowing failed');
+    }
+  });
+});
+
+/**
+ * 单元测试: isArrayOfObject
+ */
+describe('isArrayOfObject', () => {
+  test('identify array of plain objects', () => {
+    const arr = [{ id: 1 }, { name: 'Alice' }];
+    expect(isArrayOfObject<{ id?: number; name?: string }>(arr)).toBe(true);
+  });
+  test('identify array containing non-objects', () => {
+    expect(isArrayOfObject([1, 2, 3])).toBe(false);
+    expect(isArrayOfObject([{ id: 1 }, null])).toBe(false);
+    expect(isArrayOfObject([{ id: 1 }, 'string'])).toBe(false);
+  });
+  test('identify non-array types', () => {
+    expect(isArrayOfObject(null)).toBe(false);
+    expect(isArrayOfObject({})).toBe(false);
+    expect(isArrayOfObject(42)).toBe(false);
+  });
+  test('identify empty array as array of objects', () => {
+    expect(isArrayOfObject([])).toBe(true);
+  });
+  test('identify narrowed array of object type', () => {
+    const data: unknown = [{ id: 1 }, { id: 2 }];
+    if (isArrayOfObject<{ id: number }>(data)) {
+      // TS 能识别为 { id: number }[]
+      expect(data[0].id).toBe(1);
+      expect(data[1].id).toBe(2);
+    } else {
+      throw new Error('Type guard failed');
+    }
+  });
+});
diff --git a/server/utils/object.ts b/server/utils/object.ts
new file mode 100644
index 0000000..37ef512
--- /dev/null
+++ b/server/utils/object.ts
@@ -0,0 +1,30 @@
+/**
+ * 判断某一值是否为非null对象
+ *
+ * @template T 泛型类型，用于推断目标对象的类型
+ * @param value: 需要判断的值
+ * @returns 如果值是非null对象则返回true，否则返回false
+ *
+ * @example
+ * if (isObject<Product>(value)) value.id
+ */
+export const isObject = <T extends object>(value: unknown): value is T =>
+  typeof value === 'object' && value !== null;
+
+/**
+ * 判断某一值是否为非null对象组成的数组
+ *
+ * @template T 泛型类型，用于推断目标对象的类型
+ * @param value: 需要判断的值
+ * @returns 如果值是非null对象组成的数组则返回true，否则返回false
+ *
+ * @example
+ * const data: unknown = [{ id: 1 }, { id: 2 }];
+ * if (isArrayOfObject)<{ id: number }>(data) {
+ * // TypeScript 知道 data 是 { id: number }[] 类型
+ *   console.log(data[0].id);
+ * }
+ */
+export const isArrayOfObject = <T extends object>(arr: unknown): arr is T[] => {
+  return Array.isArray(arr) && arr.every(isObject<T>);
+};
diff --git a/server/utils/search-converter.test.ts b/server/utils/search-converter.test.ts
new file mode 100644
index 0000000..5e079ab
--- /dev/null
+++ b/server/utils/search-converter.test.ts
@@ -0,0 +1,76 @@
+import { describe, expect, test } from 'vitest';
+
+/**
+ * 单元测试: converters
+ */
+describe('converters', () => {
+  test('convert product item', () => {
+    const item = {
+      id: 1,
+      name: 'Hydraulic Pump',
+      summary: 'High efficiency',
+      description: 'Detailed description',
+      type: 'pump',
+    };
+    const result = converters.products(item);
+    expect(result).toEqual({
+      id: 1,
+      type: 'product',
+      title: 'Hydraulic Pump',
+      summary: 'High efficiency',
+    });
+  });
+
+  test('convert solution item', () => {
+    const item = {
+      id: 1,
+      title: 'Solution A',
+      summary: 'Effective solution',
+      content: 'Detailed content',
+      type: 'Type A',
+    };
+    const result = converters.solutions(item);
+    expect(result).toEqual({
+      id: 1,
+      type: 'solution',
+      title: 'Solution A',
+      summary: 'Effective solution',
+    });
+  });
+
+  test('convert question item', () => {
+    const item = {
+      id: 1,
+      title: 'How to use product?',
+      content:
+        'This is a detailed explanation of how to use the product effectively.',
+      products: ['Product A'],
+      product_types: ['Type A'],
+    };
+    const result = converters.questions(item);
+    expect(result).toEqual({
+      id: 1,
+      title: 'How to use product?',
+      summary:
+        'This is a detailed explanation of how to use the product effectively....',
+      type: 'question',
+    });
+  });
+
+  test('convert product document item', () => {
+    const item = {
+      id: 1,
+      title: 'User Manual',
+      products: ['Product A'],
+      product_types: ['Type A'],
+      fileUUID: 'TEST-UUID',
+    };
+    const result = converters.product_documents(item);
+    expect(result).toEqual({
+      id: 'TEST-UUID',
+      title: 'User Manual',
+      summary: undefined,
+      type: 'document',
+    });
+  });
+});
diff --git a/server/utils/search-converters.ts b/server/utils/search-converters.ts
new file mode 100644
index 0000000..b7d8217
--- /dev/null
+++ b/server/utils/search-converters.ts
@@ -0,0 +1,36 @@
+/**
+ * 各索引对应的转换函数表
+ */
+export const converters: {
+  [K in keyof MeiliIndexMap]: (item: MeiliIndexMap[K]) => SearchItemView;
+} = {
+  products: (item: MeiliIndexMap['products']): SearchItemView => ({
+    id: item.id,
+    type: 'product',
+    title: item.name,
+    summary: item.summary,
+  }),
+
+  solutions: (item: MeiliIndexMap['solutions']): SearchItemView => ({
+    id: item.id,
+    type: 'solution',
+    title: item.title,
+    summary: item.summary,
+  }),
+
+  questions: (item: MeiliIndexMap['questions']): SearchItemView => ({
+    id: item.id,
+    type: 'question',
+    title: item.title,
+    summary: item.content.slice(0, 100) + '...',
+  }),
+
+  product_documents: (
+    item: MeiliIndexMap['product_documents']
+  ): SearchItemView => ({
+    id: item.fileUUID || item.id,
+    type: 'document',
+    title: item.title,
+    summary: '',
+  }),
+};
diff --git a/shared/types/index.ts b/shared/types/index.ts
index f0ea818..8daa6a7 100644
--- a/shared/types/index.ts
+++ b/shared/types/index.ts
@@ -1,2 +1,3 @@
 export * from './directus';
 export * from './meilisearch';
+export * from './views';
diff --git a/app/models/views/CompanyProfileView.ts b/shared/types/views/company-profile-view.ts
similarity index 100%
rename from app/models/views/CompanyProfileView.ts
rename to shared/types/views/company-profile-view.ts
diff --git a/app/models/views/ContactInfoView.ts b/shared/types/views/contact-info-view.ts
similarity index 100%
rename from app/models/views/ContactInfoView.ts
rename to shared/types/views/contact-info-view.ts
diff --git a/app/models/views/DocumentListView.ts b/shared/types/views/document-list-view.ts
similarity index 100%
rename from app/models/views/DocumentListView.ts
rename to shared/types/views/document-list-view.ts
diff --git a/app/models/views/HomepageView.ts b/shared/types/views/homepage-view.ts
similarity index 100%
rename from app/models/views/HomepageView.ts
rename to shared/types/views/homepage-view.ts
diff --git a/shared/types/views/index.ts b/shared/types/views/index.ts
new file mode 100644
index 0000000..c45e40d
--- /dev/null
+++ b/shared/types/views/index.ts
@@ -0,0 +1,13 @@
+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';
+export * from './contact-info-view';
+export * from './homepage-view';
+export * from './search-item-view';
diff --git a/app/models/views/ProductDocumentView.ts b/shared/types/views/product-document-view.ts
similarity index 100%
rename from app/models/views/ProductDocumentView.ts
rename to shared/types/views/product-document-view.ts
diff --git a/app/models/views/ProductListView.ts b/shared/types/views/product-list-view.ts
similarity index 100%
rename from app/models/views/ProductListView.ts
rename to shared/types/views/product-list-view.ts
diff --git a/app/models/views/ProductQuestionView.ts b/shared/types/views/product-question-view.ts
similarity index 100%
rename from app/models/views/ProductQuestionView.ts
rename to shared/types/views/product-question-view.ts
diff --git a/app/models/views/ProductSpecGroupView.ts b/shared/types/views/product-spec-group-view.ts
similarity index 100%
rename from app/models/views/ProductSpecGroupView.ts
rename to shared/types/views/product-spec-group-view.ts
diff --git a/app/models/views/ProductView.ts b/shared/types/views/product-view.ts
similarity index 75%
rename from app/models/views/ProductView.ts
rename to shared/types/views/product-view.ts
index 3ef1735..6c56017 100644
--- a/app/models/views/ProductView.ts
+++ b/shared/types/views/product-view.ts
@@ -1,3 +1,7 @@
+import type { ProductSpecGroupView } from './product-spec-group-view';
+import type { ProductQuestionView } from './product-question-view';
+import type { ProductDocumentView } from './product-document-view';
+
 interface ImageView {
   id: number;
   image: string;
diff --git a/app/models/views/QuestionListVuew.ts b/shared/types/views/question-list-view.ts
similarity index 100%
rename from app/models/views/QuestionListVuew.ts
rename to shared/types/views/question-list-view.ts
diff --git a/app/models/views/SearchItemView.ts b/shared/types/views/search-item-view.ts
similarity index 92%
rename from app/models/views/SearchItemView.ts
rename to shared/types/views/search-item-view.ts
index 5851292..e9070f0 100644
--- a/app/models/views/SearchItemView.ts
+++ b/shared/types/views/search-item-view.ts
@@ -9,5 +9,5 @@ export interface SearchItemView {
   title: string;
 
   /** 条目摘要 **/
-  summary?: string;
+  summary: string;
 }
diff --git a/app/models/views/SolutionListView.ts b/shared/types/views/solution-list-view.ts
similarity index 100%
rename from app/models/views/SolutionListView.ts
rename to shared/types/views/solution-list-view.ts
diff --git a/app/models/views/SolutionView.ts b/shared/types/views/solution-view.ts
similarity index 100%
rename from app/models/views/SolutionView.ts
rename to shared/types/views/solution-view.ts