feat: 产品列表与解决方案列表的排序

- 为产品/解决方案类型添加sort字段用于排序
- 各个栏目的类型按照sort升序排序
- 更新directus类型

app/composables/directus/useProductList.ts

@@ -19,6 +19,7 @@ export const useProductList = () => {
               {
                 translations: ['id', 'name'],
               },
+              'sort',
             ],
           },
         ],

app/composables/directus/useSolutionList.ts

@@ -12,7 +12,7 @@ export const useSolutionList = () => {
           'id',
           'cover',
           {
-            type: ['id', { translations: ['id', 'name'] }],
+            type: ['id', { translations: ['id', 'name'] }, 'sort'],
           },
           {
             translations: ['id', 'title', 'summary'],

app/models/mappers/productMapper.test.ts

@@ -14,6 +14,7 @@ describe('toProductListView', () => {
       product_type: {
         id: 1,
         translations: [{ id: 20, name: 'Type Name' }],
+        sort: 1,
       },
     };
 
@@ -22,7 +23,11 @@ describe('toProductListView', () => {
       name: 'Product Name',
       summary: 'Product Summary',
       cover: 'cover-file-uuid-1234',
-      product_type: 'Type Name',
+      product_type: {
+        id: 1,
+        name: 'Type Name',
+        sort: 1,
+      },
     });
   });
 
@@ -34,6 +39,7 @@ describe('toProductListView', () => {
       product_type: {
         id: 20,
         translations: [],
+        sort: 1,
       },
     };
 
@@ -42,7 +48,11 @@ describe('toProductListView', () => {
       name: '',
       summary: '',
       cover: 'cover-file-uuid-1234',
-      product_type: '',
+      product_type: {
+        id: 20,
+        name: '',
+        sort: 1,
+      },
     });
   });
 });

app/models/mappers/productMapper.ts

@@ -1,3 +1,22 @@
+/**
+ * 将Directus返回的ProductType数据转换为ProductTypeView视图模型
+ *
+ * @param raw: 原始的ProductType数据
+ * @returns 转换后的ProductTypeView对象
+ *
+ * @example
+ * const view = toProductTypeView(rawProductType);
+ */
+export function toProductTypeView(raw: ProductType): ProductTypeView {
+  const trans = raw.translations?.[0] ?? { name: '' };
+
+  return {
+    id: raw.id,
+    name: trans.name,
+    sort: raw?.sort ?? 999,
+  };
+}
+
 /**
  * 将 Directus返回的 Product 数据转换为 ProductListView 视图模型
  *
@@ -11,10 +30,8 @@ export function toProductListView(raw: Product): ProductListView {
   const trans = raw.translations?.[0] ?? { name: '', summary: '' };
 
   const type = isObject<ProductType>(raw.product_type)
-    ? raw.product_type.translations.length === 0
-      ? ''
-      : raw.product_type.translations[0].name
-    : '';
+    ? toProductTypeView(raw.product_type)
+    : undefined;
 
   return {
     id: raw.id,

app/models/mappers/solutionMapper.test.ts

@@ -13,6 +13,7 @@ describe('toSolutionListView', () => {
       type: {
         id: 1,
         translations: [{ id: 1, name: 'Type Name' }],
+        sort: 1,
       },
     };
 
@@ -20,7 +21,11 @@ describe('toSolutionListView', () => {
       id: 1,
       title: 'Solution Title',
       summary: 'Solution Summary',
-      solution_type: 'Type Name',
+      solution_type: {
+        id: 1,
+        name: 'Type Name',
+        sort: 1,
+      },
     });
   });
 
@@ -31,6 +36,7 @@ describe('toSolutionListView', () => {
       type: {
         id: 1,
         translations: [],
+        sort: null,
       },
     };
 
@@ -38,7 +44,11 @@ describe('toSolutionListView', () => {
       id: 1,
       title: '',
       summary: '',
-      solution_type: '',
+      solution_type: {
+        id: 1,
+        name: '',
+        sort: 999,
+      },
     });
   });
 });

app/models/mappers/solutionMapper.ts

@@ -1,3 +1,24 @@
+/**
+ * 将 Directus 返回的 SolutionType 数据转换为 SolutionTypeView 视图模型
+ *
+ * @param raw: 原始的 SolutionType 数据
+ * @returns 转换后的 SolutionTypeView 对象
+ *
+ * ---
+ *
+ *  @example
+ *  const view = toSolutionTypeView(rawSolutionType);
+ */
+export function toSolutionTypeView(raw: SolutionType): SolutionTypeView {
+  const trans = raw.translations?.[0] ?? { name: '' };
+
+  return {
+    id: raw.id,
+    name: trans.name,
+    sort: raw?.sort ?? 999,
+  };
+}
+
 /**
  * 将 Directus 返回的 Solution 数据转换为 SolutionListView 视图模型
  *
@@ -16,10 +37,8 @@ export function toSolutionListView(raw: Solution): SolutionListView {
   };
 
   const type = isObject<SolutionType>(raw.type)
-    ? raw.type.translations.length === 0
-      ? ''
-      : raw.type.translations[0].name
-    : '';
+    ? toSolutionTypeView(raw.type)
+    : undefined;
 
   return {
     id: raw.id,

app/models/views/ProductListView.ts

@@ -1,3 +1,18 @@
+/**
+ * 产品类型视图模型
+ * 用于产品列表页的section渲染与排序
+ */
+export interface ProductTypeView {
+  /** 唯一标识符 **/
+  id: number;
+
+  /** 类型名 **/
+  name: string;
+
+  /** 排序字段 **/
+  sort: number;
+}
+
 /**
  * 产品列表视图模型
  * 用于产品列表(/products)渲染的数据结构
@@ -13,7 +28,7 @@ export interface ProductListView {
   summary: string;
 
   /** 产品类型 **/
-  product_type: string;
+  product_type: ProductTypeView;
 
   /** 产品封面(图片的id) **/
   cover: string;

app/models/views/SolutionListView.ts

@@ -1,3 +1,18 @@
+/**
+ * 解决方案类型视图模型
+ * 用于解决方案列表页标签栏的渲染与排序
+ */
+export interface SolutionTypeView {
+  /** 唯一标识符 **/
+  id: number;
+
+  /** 类型名 **/
+  name: string;
+
+  /** 排序字段 **/
+  sort: number;
+}
+
 /**
  * 解决方案列表模型
  * 用于解决方案列表(/solutions)渲染的数据结构
@@ -13,7 +28,7 @@ export interface SolutionListView {
   summary: string;
 
   /** 解决方案类型 **/
-  solution_type: string;
+  solution_type: SolutionTypeView;
 
   /** 解决方案封面(图片id) **/
   cover: string;

app/pages/products/index.vue

@@ -8,14 +8,14 @@
       <div class="products-container">
         <el-collapse v-model="activeNames" class="product-collapse">
           <el-collapse-item
-            v-for="(group, type) in groupedProducts"
-            :key="type"
-            :title="type || '未分类'"
-            :name="type || 'no-category'"
+            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 group"
+                v-for="product in value.data"
                 :key="product.id"
                 :slug="product.id.toString()"
                 :image-url="getImageUrl(product.cover.toString())"
@@ -51,25 +51,23 @@
     productsRaw.value.map((item) => toProductListView(item))
   );
 
+  logger.debug('products: ', products.value);
+
   // 按类型分组
-  // 兼容 product_type 既可能为对象也可能为字符串
   const groupedProducts = computed(() => {
-    const groups: Record<string, ProductListView[]> = {};
+    const groups: Record<string, { data: ProductListView[]; sort: number }> =
+      {};
     for (const prod of products.value) {
-      let typeKey = '';
-      if (typeof prod.product_type === 'string') {
-        typeKey = prod.product_type;
-      } else if (
-        prod.product_type &&
-        typeof prod.product_type === 'object' &&
-        'name' in prod.product_type
-      ) {
-        typeKey = prod.product_type || '';
+      const typeKey = prod.product_type?.name ?? '';
+      if (!groups[typeKey]) {
+        groups[typeKey] = { data: [], sort: prod.product_type?.sort ?? 999 };
       }
-      if (!groups[typeKey]) groups[typeKey] = [];
-      groups[typeKey]?.push(prod);
+      groups[typeKey]?.data.push(prod);
     }
-    return groups;
+    const sortedGroups = Object.fromEntries(
+      Object.entries(groups).sort(([, a], [, b]) => a.sort - b.sort)
+    );
+    return sortedGroups;
   });
 
   watch(groupedProducts, () => {

app/pages/solutions/index.vue

@@ -19,14 +19,14 @@
           </div>
         </el-tab-pane>
         <el-tab-pane
-          v-for="(group, type) in groupedSolutions"
-          :key="type"
-          :label="type || '未分类'"
-          :name="type || 'no-category'"
+          v-for="[key, value] in Object.entries(groupedSolutions)"
+          :key="key"
+          :label="key || '未分类'"
+          :name="key || 'no-category'"
         >
           <div class="solution-list">
             <solution-card
-              v-for="solution in group"
+              v-for="solution in value.data"
               :key="solution.id"
               :document-id="solution.id.toString()"
               :cover-url="getImageUrl(solution.cover || '')"
@@ -63,22 +63,19 @@
 
   // 按类型分组
   const groupedSolutions = computed(() => {
-    const gourps: Record<string, SolutionListView[]> = {};
+    const groups: Record<string, { data: SolutionListView[]; sort: number }> =
+      {};
     for (const sol of solutions.value) {
-      let typeKey = '';
-      if (typeof sol.solution_type === 'string') {
-        typeKey = sol.solution_type;
-      } else if (
-        sol.solution_type &&
-        typeof sol.solution_type === 'object' &&
-        'type' in sol.solution_type
-      ) {
-        typeKey = sol.solution_type || '';
+      const typeKey = sol.solution_type?.name ?? '';
+      if (!groups[typeKey]) {
+        groups[typeKey] = { data: [], sort: sol.solution_type?.sort ?? 999 };
       }
-      if (!gourps[typeKey]) gourps[typeKey] = [];
-      gourps[typeKey]?.push(sol);
+      groups[typeKey]?.data.push(sol);
     }
-    return gourps;
+    const sortedGroups = Object.fromEntries(
+      Object.entries(groups).sort(([, a], [, b]) => a.sort - b.sort)
+    );
+    return sortedGroups;
   });
 
   watch(error, (value) => {

shared/types/directus/my-schema.ts

@@ -142,6 +142,7 @@ export interface ProductType {
   id: number;
   /** @description 当前产品条目的状态 */
   status?: 'published' | 'draft' | 'archived';
+  sort?: number | null;
   /** @description i18n文本 */
   translations?: ProductTypesTranslation[] | null;
 }
@@ -231,6 +232,7 @@ export interface SolutionType {
   /** @primaryKey */
   id: number;
   status?: 'published' | 'draft' | 'archived';
+  sort?: number | null;
   /** @description i18n字段 */
   translations?: SolutionTypesTranslation[] | null;
 }