@be-link/ecommerce-backend-bff-service-node-sdk 0.0.65 → 0.0.66

package/cjs/bff/modules/pandora/pointsMall/types.d.ts

@@ -0,0 +1,193 @@
+import { PROMOTION_ENUM } from '../../../../enums';
+import type { StandardResponse } from '../../../../types';
+export declare namespace PointMallService {
+    namespace Entity {
+        /** 商品积分兑换配置 */
+        interface ProductPointExchange {
+            /** 主键ID */
+            id: string;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+            /** 删除时间 */
+            deletedAt: number;
+            /** 商品ID */
+            productId: string;
+            /** 所需券的数量 */
+            couponRequired: number;
+            /** 所需积分的数量 */
+            pointsRequired: number;
+            /** 兑换类型 */
+            exchangeType: PROMOTION_ENUM.POINT_MALL.ExchangeType;
+            /** 是否开启 */
+            enabled: boolean;
+            /** 是否上架 */
+            online: boolean;
+            /** 排序权重 */
+            sortOrder: number;
+        }
+        /** 后台管理列表 - 完整12个字段 */
+        interface AdminProductItem {
+            id: string;
+            sortOrder: number;
+            productName: string;
+            productId: string;
+            skuSpecs: string[];
+            salePrice: number;
+            online: boolean;
+            enabled: boolean;
+            exchangeType: PROMOTION_ENUM.POINT_MALL.ExchangeType;
+            stock: number;
+            limitPerUser?: number;
+            pointsRequired: number;
+            couponRequired: number;
+            productImage: string;
+        }
+        /** C端积分商城列表 - 精确7个字段 */
+        interface ClientProductItem {
+            id: string;
+            sortOrder: number;
+            productName: string;
+            productId: string;
+            productImage: string;
+            exchangeType: PROMOTION_ENUM.POINT_MALL.ExchangeType;
+            pointsRequired: number;
+            couponRequired: number;
+        }
+    }
+    namespace Request {
+        interface BaseParams {
+            productId: string;
+            pointsRequired?: number;
+            couponRequired?: number;
+            exchangeType: PROMOTION_ENUM.POINT_MALL.ExchangeType;
+            online?: boolean;
+            sortOrder?: number;
+        }
+        export interface CreateProduct extends BaseParams {
+        }
+        export interface UpdateProduct extends Partial<BaseParams> {
+            id: string;
+        }
+        /** 批量创建积分商城商品 */
+        export interface batchCreateProducts {
+            items: CreateProduct[];
+        }
+        /** 批量编辑积分商城商品 */
+        export interface batchUpdateProducts {
+            items: UpdateProduct[];
+        }
+        /** 批量是否开启 */
+        export interface batchToggleProductEnabled {
+            /** 主键ID列表 */
+            ids: string[];
+            /** 是否开启 */
+            enabled: boolean;
+        }
+        /** 批量是否上下架 */
+        export interface batchToggleProductOnline {
+            /** 主键ID列表 */
+            ids: string[];
+            /** 是否上架 */
+            online: boolean;
+        }
+        /** 根据条件查询积分商城商品 */
+        export interface queryProducts {
+            /** 商品ID */
+            productIds?: string[];
+            /** 是否上架，传null/undefined表示不筛选 */
+            online?: boolean | null | undefined;
+            /** 是否开启，传null/undefined表示不筛选 */
+            enabled?: boolean | null | undefined;
+            /** 页码 */
+            page?: number;
+            /** 每页数量 */
+            pageSize?: number;
+        }
+        /** 查询开启且上架的积分商城列表 */
+        export interface queryEnabledAndOnlineProducts {
+            /** 页码 */
+            page?: number;
+            /** 每页数量 */
+            pageSize?: number;
+        }
+        /** 根据商品ID查询商品详情 */
+        export interface getProductDetail {
+            /** 商品ID */
+            productId: string;
+        }
+        export {};
+    }
+    namespace Response {
+        /** 创建积分商城商品响应 */
+        interface createProduct {
+            /** 主键ID */
+            id: string;
+        }
+        /** 批量创建积分商城商品响应 */
+        interface batchCreateProducts {
+            /** 创建成功的ID列表 */
+            ids: string[];
+        }
+        /** 查询积分商城商品响应 */
+        interface queryProducts {
+            /** 商品列表 */
+            items: Entity.AdminProductItem[];
+            /** 总数 */
+            total: number;
+            /** 当前页码 */
+            page: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+        /** 查询商品详情响应 */
+        interface getProductDetail {
+            /** 商品详情 */
+            data: Entity.ProductPointExchange;
+        }
+        /** 查询开启且上架的积分商城列表响应 */
+        interface queryEnabledAndOnlineProducts {
+            /** 商品列表 */
+            items: Entity.ClientProductItem[];
+            /** 总数 */
+            total: number;
+            /** 当前页码 */
+            page: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+    }
+    namespace Controller {
+        interface PointsMallController {
+            /**
+             * 批量创建积分商城商品
+             */
+            batchCreateProducts(request: PointMallService.Request.batchCreateProducts): Promise<StandardResponse<PointMallService.Response.batchCreateProducts>>;
+            /**
+             * 批量编辑积分商城商品
+             */
+            batchUpdateProducts(request: PointMallService.Request.batchUpdateProducts): Promise<StandardResponse<void>>;
+            /**
+             * 批量是否开启
+             */
+            batchToggleProductEnabled(request: PointMallService.Request.batchToggleProductEnabled): Promise<StandardResponse<void>>;
+            /**
+             * 批量是否上下架
+             */
+            batchToggleProductOnline(request: PointMallService.Request.batchToggleProductOnline): Promise<StandardResponse<void>>;
+            /**
+             * 根据条件查询积分商城商品
+             */
+            queryProducts(request: PointMallService.Request.queryProducts): Promise<StandardResponse<PointMallService.Response.queryProducts>>;
+            /**
+             * 根据商品ID查询商品详情
+             */
+            getProductDetail(request: PointMallService.Request.getProductDetail): Promise<StandardResponse<PointMallService.Response.getProductDetail>>;
+            /**
+             * 查询开启且上架的积分商城列表
+             */
+            queryEnabledAndOnlineProducts(request: PointMallService.Request.queryEnabledAndOnlineProducts): Promise<StandardResponse<PointMallService.Response.queryEnabledAndOnlineProducts>>;
+        }
+    }
+}

package/cjs/bff/modules/pandora/product/service.d.ts

@@ -55,7 +55,7 @@ export declare class PandoraProductService extends BaseService implements Servic
      * @param request - 请求参数
      * @returns Promise，解析为标准响应格式
      */
-    export(request: Service.Request.list): Promise<StandardResponse<void>>;
+    export(request: Service.Request.list): Promise<StandardResponse<Service.Response.productDetail>>;
     /**
      * 获取商品信息(不含规格信息)
      * @param request - 请求参数
@@ -74,4 +74,16 @@ export declare class PandoraProductService extends BaseService implements Servic
      * @returns Promise，解析为标准响应格式
      */
     productQrCode(request: Service.Request.productQrCode): Promise<StandardResponse<Service.Response.productQrCode>>;
+    /**
+     * 删除定时任务
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    deleteScheduledTask(request: Service.Request.deleteScheduledTask): Promise<StandardResponse<void>>;
+    /**
+     * 根据商品名获取商品id列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    searchProductByName(request: Service.Request.searchProductByName): Promise<StandardResponse<Service.Response.searchProductByName[]>>;
 }

package/cjs/bff/modules/pandora/product/service.js

@@ -103,5 +103,21 @@ class PandoraProductService extends BaseService_1.default {
     productQrCode(request) {
         return this.request(this.productQrCode, request);
     }
+    /**
+     * 删除定时任务
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    deleteScheduledTask(request) {
+        return this.request(this.deleteScheduledTask, request);
+    }
+    /**
+     * 根据商品名获取商品id列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    searchProductByName(request) {
+        return this.request(this.searchProductByName, request);
+    }
 }
 exports.PandoraProductService = PandoraProductService;

package/cjs/bff/modules/pandora/product/types.d.ts

@@ -1,199 +1,377 @@
 import { StandardResponse } from '../../../../types';
 export declare namespace PandoraProductService {
+    /** 商品明细项 */
+    interface ProductDetailItem {
+        商品ID: string;
+        商品名称: string;
+        一级类目: string;
+        二级类目: string;
+        三级类目: string;
+        商品分类: string;
+        储存方式: string;
+        取货方式: string;
+        配送方式: string;
+        供应商: string;
+        产品经理: string;
+        直播分组: string;
+        上下架状态: string;
+        起售数量: number;
+        限购数量: number | string;
+        商品类型: string;
+        售卖类型: string;
+        规格明细: string;
+        规格编码: string;
+        库存: number;
+        划线价: number;
+        售价: number;
+        采购价: number;
+    }
     /**
      * 核销期限接口
      */
     interface VerifyPeriod {
-        startDate: number;
-        endDate: number;
-        payAfterDay: number;
-        type: number;
+        /** 开始时间戳 */
+        startDate?: number;
+        /** 结束时间戳 */
+        endDate?: number;
+        /** 付款后天数 */
+        payAfterDay?: number;
+        /** 类型 1: 时间范围 2: 付款后天数 */
+        type?: number;
     }
     /**
      * 属性接口
      */
     interface Attr {
+        /** 属性名称 */
         attrName: string;
+        /** 属性值 */
         attrValue: string;
     }
     /**
      * 绑定的SKU接口
      */
     interface BindSku {
+        /** 商品ID */
         productId: string;
+        /** 绑定的子SKUID */
         skuId: string;
+        /** 数量 */
         quantity: number;
     }
     /**
      * 定时任务接口
      */
     interface ScheduledTask {
+        /** 任务ID */
+        id?: string;
+        /** 定时任务时间戳 */
         scheduledTime: number;
+        /** 上下状态 */
         status: string;
     }
     /**
      * SKU项接口
      */
     interface SkuItem {
+        /** SKU ID（编辑/更新时传入） */
         skuId?: string;
+        /** 属性列表 */
         attrs: Attr[];
+        /** 价格（分） */
         price: number;
+        /** 划线价（分） */
         strikethroughPrice: number;
+        /** 采购价（分） */
         purchasePrice: number;
-        skuCode: string;
-        multiSkuCodes: string[];
-        bindSkus: BindSku[];
+        /** SKU编码 */
+        skuCode?: string;
+        /** 多SKU编码 */
+        multiSkuCodes?: string[];
+        /** 绑定的SKU列表 */
+        bindSkus?: BindSku[];
+        /** 库存 */
         stock: number;
+        /** 是否展示绑定子商品 1展示，0不展示 */
+        showBindSkus?: number;
     }
     /**
      * 产品信息接口
      */
     interface ProductInfo {
+        /** 商品ID（编辑/更新时传入） */
         productId?: string;
+        /** 产品类型 */
         productType: string;
+        /** 是否组合商品 */
         isCombo: number;
+        /** 商品名称 */
         productName: string;
+        /** 主图URL */
         mainImg: string;
+        /** 图片列表 */
         imgList: string[];
+        /** 商品描述 */
         productDesc?: string;
+        /** 一级分类ID */
         categoryId: string;
+        /** 二级分类ID */
         twoCategoryId: string;
+        /** 三级分类ID */
         threeCategoryId: string;
+        /** 提货方式 */
         pickType: string;
+        /** 发货方式 */
         dispatchType: string;
+        /** 存储方式 */
         storageMethod: string;
+        /** 商品分类 */
         classification: string;
-        stockUnit: string;
+        /** 库存单位 */
+        stockUnit?: string;
+        /** 产品经理ID */
         productManagerId?: string;
+        /** 供应商ID */
         supplierId?: string;
+        /** 直播分组ID */
         liveGroupId?: string;
+        /** 上下架状态 */
         status?: string;
-        scheduledTasks?: ScheduledTask[];
+        /** 是否需要核销 */
         needVerify?: number;
+        /** 核销期限 */
         verifyPeriod?: VerifyPeriod;
+        /** 起售数量 */
         miniSaleQuantity?: number;
+        /** 限购 */
         purchaseLimit?: number;
+        /** 运费模板版本类型 */
         freightType?: string;
     }
     interface ProductData {
+        /** 产品信息 */
         productInfo: ProductInfo;
+        /** SKU列表 */
         skuList: SkuItem[];
-        creatorId: string;
     }
     namespace Request {
         interface detail {
+            /** 商品Id */
             productId: string;
         }
         interface list {
+            /** 0 开始 */
             pageIndex: number;
+            /** 每页数量 */
             pageSize: number;
+            /** 商品Id */
             productIds?: string[];
+            /** 商品名称 */
             productNames?: string[];
+            /** 商品分类 */
             classifications?: string[];
+            /** 存储方式 */
             storageMethods?: string[];
+            /** 配货方式 */
             dispatchTypes?: string[];
+            /** 供应商Id */
             supplierIds?: string[];
+            /** 直播分组ID */
             liveGroupIds?: string[];
+            /** 产品经理ID */
             productManagerIds?: string[];
+            /** 商品类型 */
             productType?: string;
+            /** 上下架状态 */
             status?: string;
+            /** 是否套餐 */
             isCombo?: number;
+            /** 69码列表 */
             skuCodes?: string[];
         }
         interface batchUpdate {
+            /** 商品Id列表 */
             productIds: string[];
+            /** 上下架状态 */
             status?: string;
+            /** 定时上下架任务 */
             scheduledTasks?: ScheduledTask[];
+            /** 商品分类 */
             classification?: string;
+            /** 存储方式 */
             storageMethod?: string;
+            /** 配货方式 */
             dispatchType?: string;
+            /** 直播分组ID */
             liveGroupId?: string;
+            /** 是否删除 */
             isDelete?: boolean;
         }
         interface queryScheduledTask {
+            /** 商品Id */
             productId: string;
         }
         interface checkSkuCode {
+            /** 商品Id */
             productId?: string;
+            /** SKU ID（更新已有SKU时传入，排除自身） */
             skuId?: string;
+            /** SKU编码 */
             skuCode: string;
         }
         interface queryProductList {
+            /** 0 开始 */
             pageIndex: number;
+            /** 页码数量 */
             pageSize: number;
+            /** 商品Id列表 */
             productIds?: string[];
+            /** 商品名称列表 */
             productNames?: string[];
+            /** 69码列表 */
             skuCodes?: string[];
+            /** 是否套餐 */
             isCombo?: number;
+            /** 提货方式 */
+            pickTypes?: string[];
+            /** 配货方式 */
+            dispatchTypes?: string[];
+            /** 存储方式 */
+            storageMethods?: string[];
+            /** 商品分类 */
+            classifications?: string[];
+            /** 上下架状态 */
+            status?: string;
         }
         interface productQrCode {
+            /** 路径 */
             path: string;
         }
+        interface deleteScheduledTask {
+            /** 任务ID */
+            taskId: string;
+        }
+        interface searchProductByName {
+            /** 商品名称 */
+            productName: string;
+        }
     }
     namespace Response {
         interface create {
+            /** 商品Id */
             productId: string;
         }
         interface queryScheduledTask {
+            /** 任务ID */
+            id: string;
+            /** 定时任务时间戳 */
             scheduledTime: number;
+            /** 任务状态 */
             status: string;
+            /** 操作类型 上下架 */
             operationType: string;
         }
         interface list {
             total: number;
             list: {
+                /** 商品ID */
                 productId: string;
+                /** 商品名称 */
                 productName: string;
+                /** 商品图片 */
                 productImage: string;
+                /** 分类名称 */
                 cateName: string;
+                /** 商品分类 */
                 classification: string;
+                /** 存储方式 */
                 storageMethod: string;
+                /** 配货方式 */
                 dispatchType: string;
+                /** 销售数量 */
                 salesQuantity: number;
+                /** 退货数量 */
                 refundQuantity: number;
+                /** 价格 */
                 price: number;
+                /** 库存 */
                 stock: number;
+                /** 上下架状态 */
                 status: string;
+                /** 创建时间 */
                 createdAt: number;
             }[];
         }
         interface checkSkuCode {
+            /** 是否可用 */
             enable: boolean;
         }
+        interface productDetail {
+            data: ProductDetailItem[];
+            headerMap: string[];
+        }
         interface queryProductList {
             total: number;
             list: {
+                /** 商品ID */
                 productId: string;
+                /** 商品名称 */
                 productName: string;
+                /** 商品图片 */
                 productImage: string;
+                /** 商品分类 */
                 classification: string;
+                /** 存储方式 */
                 storageMethod: string;
+                /** 配货方式 */
                 dispatchType: string;
+                /** 价格 */
                 price: number;
+                /** 库存 */
                 stock: number;
+                /** 上下架状态 */
                 status: string;
             }[];
         }
         interface queryProductSkuList {
             total: number;
             list: {
+                /** 商品ID */
                 productId: string;
+                /** 商品名称 */
                 productName: string;
+                /** 商品图片 */
                 productImage: string;
+                /** 商品分类 */
                 classification: string;
+                /** 存储方式 */
                 storageMethod: string;
+                /** 配货方式 */
                 dispatchType: string;
+                /** 价格 */
                 price: number;
+                /** 库存 */
                 stock: number;
+                /** 上下架状态 */
                 status: string;
+                /** SKU ID */
                 skuId: string;
+                /** 属性列表 */
                 attrs: Attr[];
+                /** SKU编码 */
                 skuCode: string;
             }[];
         }
         interface productQrCode {
+            /** 二维码URL */
             qrCodeUrl: string;
         }
+        interface searchProductByName {
+            /** 商品名称 */
+            productName: string;
+            /** 商品ID */
+            productId: string;
+        }
     }
     /**
      * ProductLive Controller 接口定义
@@ -230,7 +408,7 @@ export declare namespace PandoraProductService {
         /**
          * 商品导出
          */
-        export(request: PandoraProductService.Request.list): Promise<StandardResponse<void>>;
+        export(request: PandoraProductService.Request.list): Promise<StandardResponse<PandoraProductService.Response.productDetail>>;
         /**
          * 获取商品信息(不含规格信息)
          */
@@ -243,5 +421,13 @@ export declare namespace PandoraProductService {
          * 商品二维码
          */
         productQrCode(request: PandoraProductService.Request.productQrCode): Promise<StandardResponse<PandoraProductService.Response.productQrCode>>;
+        /**
+         * 删除定时任务
+         */
+        deleteScheduledTask(request: PandoraProductService.Request.deleteScheduledTask): Promise<StandardResponse<void>>;
+        /**
+         * 根据商品名获取商品id列表
+         */
+        searchProductByName(request: PandoraProductService.Request.searchProductByName): Promise<StandardResponse<PandoraProductService.Response.searchProductByName[]>>;
     }
 }