feat：【antd/ele】【mall/promotion】优化 api 的注释

apps/web-ele/src/api/mall/promotion/combination/combinationActivity.ts

@@ -5,67 +5,42 @@ import type { MallSpuApi } from '#/api/mall/product/spu';
 import { requestClient } from '#/api/request';
 
 export namespace MallCombinationActivityApi {
-  /** 拼团活动所需属性 */
-  export interface CombinationProduct {
-    /** 商品 SPU 编号 */
-    spuId: number;
-    /** 商品 SKU 编号 */
-    skuId: number;
-    /** 拼团价格 */
-    combinationPrice: number;
-  }
   /** 拼团活动 */
   export interface CombinationActivity {
-    /** 活动编号 */
-    id?: number;
-    /** 活动名称 */
-    name?: string;
-    /** 商品 SPU 编号 */
-    spuId?: number;
-    /** 总限购数量 */
-    totalLimitCount?: number;
-    /** 单次限购数量 */
-    singleLimitCount?: number;
-    /** 开始时间 */
-    startTime?: Date;
-    /** 结束时间 */
-    endTime?: Date;
-    /** 用户数量 */
-    userSize?: number;
-    /** 总数量 */
-    totalCount?: number;
-    /** 成功数量 */
-    successCount?: number;
-    /** 订单用户数量 */
-    orderUserCount?: number;
-    /** 虚拟成团 */
-    virtualGroup?: number;
-    /** 状态 */
-    status?: number;
-    /** 限制时长 */
-    limitDuration?: number;
-    /** 拼团价格 */
-    combinationPrice?: number;
-    /** 商品列表 */
-    products: CombinationProduct[];
-    /** 图片 */
-    picUrl?: string;
-    /** 商品名称 */
-    spuName?: string;
-    /** 市场价 */
-    marketPrice?: number;
+    id?: number; // 活动编号
+    name?: string; // 活动名称
+    spuId?: number; // 商品 SPU 编号
+    totalLimitCount?: number; // 总限购数量
+    singleLimitCount?: number; // 单次限购数量
+    startTime?: Date; // 开始时间
+    endTime?: Date; // 结束时间
+    userSize?: number; // 用户数量
+    totalCount?: number; // 总数量
+    successCount?: number; // 成功数量
+    orderUserCount?: number; // 订单用户数量
+    virtualGroup?: number; // 虚拟成团
+    status?: number; // 状态
+    limitDuration?: number; // 限制时长
+    combinationPrice?: number; // 拼团价格
+    products: CombinationProduct[]; // 商品列表
+  }
+
+  // TODO @puhui999：要不要删除？
+  /** 拼团活动所需属性 */
+  export interface CombinationProduct {
+    spuId: number; // 商品 SPU 编号
+    skuId: number; // 商品 SKU 编号
+    combinationPrice: number; // 拼团价格
   }
 
   /** 扩展 SKU 配置 */
   export type SkuExtension = {
-    /** 拼团活动配置 */
-    productConfig: CombinationProduct;
+    productConfig: CombinationProduct; // 拼团活动配置
   } & MallSpuApi.Sku;
 
   /** 扩展 SPU 配置 */
   export interface SpuExtension extends MallSpuApi.Spu {
-    /** SKU 列表 */
-    skus: SkuExtension[];
+    skus: SkuExtension[]; // SKU 列表
   }
 }