@be-link/ecommerce-promotion-service-node-sdk 0.1.24 → 0.1.26

package/enum.d.ts

@@ -414,4 +414,71 @@ export declare namespace ENUM {
             OTHER = "OTHER"
         }
     }
+    namespace TASK_ENUM {
+        /** 任务状态 */
+        enum TASK_STATUS {
+            /** 待处理 */
+            PENDING = "PENDING",
+            /** 处理中 */
+            PROCESSING = "PROCESSING",
+            /** 已完成 */
+            COMPLETED = "COMPLETED",
+            /** 已撤回 */
+            CANCELLED = "CANCELLED",
+            /** 失败 */
+            FAILED = "FAILED"
+        }
+        /** 任务状态中文 */
+        enum TASK_STATUS_CHINESE {
+            PENDING = "\u5F85\u5904\u7406",
+            PROCESSING = "\u5904\u7406\u4E2D",
+            COMPLETED = "\u5DF2\u5B8C\u6210",
+            CANCELLED = "\u5DF2\u64A4\u56DE"
+        }
+        /** 变动类型 */
+        enum CHANGE_TYPE {
+            /** 增加积分 */
+            ADD_POINTS = "ADD_POINTS",
+            /** 扣减积分 */
+            DEDUCT_POINTS = "DEDUCT_POINTS",
+            /** 发放优惠券 */
+            ISSUE_COUPON = "ISSUE_COUPON",
+            /** 作废优惠券 */
+            ABANDON_COUPON = "ABANDON_COUPON"
+        }
+        /** 变动类型中文 */
+        enum CHANGE_TYPE_CHINESE {
+            ADD_POINTS = "\u589E\u52A0\u79EF\u5206",
+            DEDUCT_POINTS = "\u6263\u51CF\u79EF\u5206",
+            ISSUE_COUPON = "\u53D1\u653E\u4F18\u60E0\u5238",
+            ABANDON_COUPON = "\u4F5C\u5E9F\u4F18\u60E0\u5238"
+        }
+        /** 资产类型 */
+        enum ASSET_TYPE {
+            /** 积分 */
+            POINTS = "POINTS",
+            /** 优惠券 */
+            COUPON = "COUPON"
+        }
+        /** 资产类型中文 */
+        enum ASSET_TYPE_CHINESE {
+            POINTS = "\u79EF\u5206",
+            COUPON = "\u4F18\u60E0\u5238"
+        }
+        /** 明细处理状态 */
+        enum DETAIL_STATUS {
+            /** 待处理 */
+            PENDING = "PENDING",
+            /** 成功 */
+            SUCCESS = "SUCCESS",
+            /** 失败 */
+            FAILED = "FAILED"
+        }
+        /** 明细处理状态中文 */
+        enum DETAIL_STATUS_CHINESE {
+            PENDING = "\u5F85\u5904\u7406",
+            SUCCESS = "\u6210\u529F",
+            FAILED = "\u5931\u8D25"
+        }
+    }
 }

package/enum.js

@@ -469,4 +469,80 @@ var ENUM;
             ExchangeType["OTHER"] = "OTHER";
         })(ExchangeType = POINT_MALL.ExchangeType || (POINT_MALL.ExchangeType = {}));
     })(POINT_MALL = ENUM.POINT_MALL || (ENUM.POINT_MALL = {}));
+    let TASK_ENUM;
+    (function (TASK_ENUM) {
+        /** 任务状态 */
+        let TASK_STATUS;
+        (function (TASK_STATUS) {
+            /** 待处理 */
+            TASK_STATUS["PENDING"] = "PENDING";
+            /** 处理中 */
+            TASK_STATUS["PROCESSING"] = "PROCESSING";
+            /** 已完成 */
+            TASK_STATUS["COMPLETED"] = "COMPLETED";
+            /** 已撤回 */
+            TASK_STATUS["CANCELLED"] = "CANCELLED";
+            /** 失败 */
+            TASK_STATUS["FAILED"] = "FAILED";
+        })(TASK_STATUS = TASK_ENUM.TASK_STATUS || (TASK_ENUM.TASK_STATUS = {}));
+        /** 任务状态中文 */
+        let TASK_STATUS_CHINESE;
+        (function (TASK_STATUS_CHINESE) {
+            TASK_STATUS_CHINESE["PENDING"] = "\u5F85\u5904\u7406";
+            TASK_STATUS_CHINESE["PROCESSING"] = "\u5904\u7406\u4E2D";
+            TASK_STATUS_CHINESE["COMPLETED"] = "\u5DF2\u5B8C\u6210";
+            TASK_STATUS_CHINESE["CANCELLED"] = "\u5DF2\u64A4\u56DE";
+        })(TASK_STATUS_CHINESE = TASK_ENUM.TASK_STATUS_CHINESE || (TASK_ENUM.TASK_STATUS_CHINESE = {}));
+        /** 变动类型 */
+        let CHANGE_TYPE;
+        (function (CHANGE_TYPE) {
+            /** 增加积分 */
+            CHANGE_TYPE["ADD_POINTS"] = "ADD_POINTS";
+            /** 扣减积分 */
+            CHANGE_TYPE["DEDUCT_POINTS"] = "DEDUCT_POINTS";
+            /** 发放优惠券 */
+            CHANGE_TYPE["ISSUE_COUPON"] = "ISSUE_COUPON";
+            /** 作废优惠券 */
+            CHANGE_TYPE["ABANDON_COUPON"] = "ABANDON_COUPON";
+        })(CHANGE_TYPE = TASK_ENUM.CHANGE_TYPE || (TASK_ENUM.CHANGE_TYPE = {}));
+        /** 变动类型中文 */
+        let CHANGE_TYPE_CHINESE;
+        (function (CHANGE_TYPE_CHINESE) {
+            CHANGE_TYPE_CHINESE["ADD_POINTS"] = "\u589E\u52A0\u79EF\u5206";
+            CHANGE_TYPE_CHINESE["DEDUCT_POINTS"] = "\u6263\u51CF\u79EF\u5206";
+            CHANGE_TYPE_CHINESE["ISSUE_COUPON"] = "\u53D1\u653E\u4F18\u60E0\u5238";
+            CHANGE_TYPE_CHINESE["ABANDON_COUPON"] = "\u4F5C\u5E9F\u4F18\u60E0\u5238";
+        })(CHANGE_TYPE_CHINESE = TASK_ENUM.CHANGE_TYPE_CHINESE || (TASK_ENUM.CHANGE_TYPE_CHINESE = {}));
+        /** 资产类型 */
+        let ASSET_TYPE;
+        (function (ASSET_TYPE) {
+            /** 积分 */
+            ASSET_TYPE["POINTS"] = "POINTS";
+            /** 优惠券 */
+            ASSET_TYPE["COUPON"] = "COUPON";
+        })(ASSET_TYPE = TASK_ENUM.ASSET_TYPE || (TASK_ENUM.ASSET_TYPE = {}));
+        /** 资产类型中文 */
+        let ASSET_TYPE_CHINESE;
+        (function (ASSET_TYPE_CHINESE) {
+            ASSET_TYPE_CHINESE["POINTS"] = "\u79EF\u5206";
+            ASSET_TYPE_CHINESE["COUPON"] = "\u4F18\u60E0\u5238";
+        })(ASSET_TYPE_CHINESE = TASK_ENUM.ASSET_TYPE_CHINESE || (TASK_ENUM.ASSET_TYPE_CHINESE = {}));
+        /** 明细处理状态 */
+        let DETAIL_STATUS;
+        (function (DETAIL_STATUS) {
+            /** 待处理 */
+            DETAIL_STATUS["PENDING"] = "PENDING";
+            /** 成功 */
+            DETAIL_STATUS["SUCCESS"] = "SUCCESS";
+            /** 失败 */
+            DETAIL_STATUS["FAILED"] = "FAILED";
+        })(DETAIL_STATUS = TASK_ENUM.DETAIL_STATUS || (TASK_ENUM.DETAIL_STATUS = {}));
+        /** 明细处理状态中文 */
+        let DETAIL_STATUS_CHINESE;
+        (function (DETAIL_STATUS_CHINESE) {
+            DETAIL_STATUS_CHINESE["PENDING"] = "\u5F85\u5904\u7406";
+            DETAIL_STATUS_CHINESE["SUCCESS"] = "\u6210\u529F";
+            DETAIL_STATUS_CHINESE["FAILED"] = "\u5931\u8D25";
+        })(DETAIL_STATUS_CHINESE = TASK_ENUM.DETAIL_STATUS_CHINESE || (TASK_ENUM.DETAIL_STATUS_CHINESE = {}));
+    })(TASK_ENUM = ENUM.TASK_ENUM || (ENUM.TASK_ENUM = {}));
 })(ENUM || (exports.ENUM = ENUM = {}));

package/index.d.ts

@@ -10,4 +10,6 @@ export { pointsMallService } from './modules/pointsMall/service';
 export type { Service as PointsMallServiceTypes } from './modules/pointsMall/types';
 export { jobService } from './modules/job/service';
 export type { Service as JobServiceTypes } from './modules/job/types';
+export { taskService } from './modules/task/service';
+export type { Service as TaskServiceTypes } from './modules/task/types';
 export { ENUM as PROMOTION_ENUM } from './enum';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROMOTION_ENUM = exports.jobService = exports.pointsMallService = exports.pricingCalculationService = exports.configService = exports.couponService = exports.awardService = void 0;
+exports.PROMOTION_ENUM = exports.taskService = exports.jobService = exports.pointsMallService = exports.pricingCalculationService = exports.configService = exports.couponService = exports.awardService = void 0;
 var service_1 = require("./modules/award/service");
 Object.defineProperty(exports, "awardService", { enumerable: true, get: function () { return service_1.awardService; } });
 var service_2 = require("./modules/coupon/service");
@@ -13,6 +13,8 @@ var service_5 = require("./modules/pointsMall/service");
 Object.defineProperty(exports, "pointsMallService", { enumerable: true, get: function () { return service_5.pointsMallService; } });
 var service_6 = require("./modules/job/service");
 Object.defineProperty(exports, "jobService", { enumerable: true, get: function () { return service_6.jobService; } });
+var service_7 = require("./modules/task/service");
+Object.defineProperty(exports, "taskService", { enumerable: true, get: function () { return service_7.taskService; } });
 // 服务.模块.枚举名称.枚举值 示例: AWARD_ENUM.DISTRIBUTION_CHANNEL.ORDER
 var enum_1 = require("./enum");
 Object.defineProperty(exports, "PROMOTION_ENUM", { enumerable: true, get: function () { return enum_1.ENUM; } });

package/modules/award/service.d.ts

@@ -7,7 +7,6 @@ declare class AwardService extends BaseService implements Service.PrizeDistribut
     liveRoomIssueCoupon(request: Service.Request.liveRoomIssueCoupon): Promise<Service.Response.distributePrize>;
     queryLiveRoomDistributionStats(request: Service.Request.queryLiveRoomDistributionStats): Promise<Service.Response.queryLiveRoomDistributionStatsResponse>;
     adminSingleIssueCoupon(request: Service.Request.adminSingleIssueCoupon): Promise<Service.Response.distributePrize>;
-    batchIssueCoupon(request: Service.Request.batchIssueCoupon): Promise<Service.Response.distributePrize>;
 }
 export declare const awardService: AwardService;
 export default awardService;

package/modules/award/service.js

@@ -36,9 +36,6 @@ let AwardService = class AwardService extends BaseService_1.default {
     adminSingleIssueCoupon(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.adminSingleIssueCoupon), request);
     }
-    batchIssueCoupon(request) {
-        return (0, http_1.callApi)(this.getApiUrl(this.batchIssueCoupon), request);
-    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('发放奖励'),
@@ -65,11 +62,6 @@ __decorate([
     (0, tsoa_1.Post)('admin-single-issue-coupon'),
     __param(0, (0, tsoa_1.Body)())
 ], AwardService.prototype, "adminSingleIssueCoupon", null);
-__decorate([
-    (0, tsoa_1.OperationId)('批量发放券'),
-    (0, tsoa_1.Post)('batch-issue-coupon'),
-    __param(0, (0, tsoa_1.Body)())
-], AwardService.prototype, "batchIssueCoupon", null);
 AwardService = __decorate([
     (0, tsoa_1.Route)('award'),
     (0, tsoa_1.Tags)('Award')

package/modules/award/types.d.ts

@@ -1,3 +1,4 @@
+import { TaskServiceTypes } from '../..';
 import { ENUM } from '../../enum';
 export declare namespace Service {
     namespace Entity {
@@ -127,34 +128,6 @@ export declare namespace Service {
             /** 数量 */
             quantity?: number;
         }
-        /** 批量发放券请求项 */
-        interface batchIssueCouponItem {
-            /** 业务编号 */
-            bizNo: string;
-            /** 直播间ID */
-            liveRoomId: string;
-            /** 用户ID */
-            userId: string;
-            /** 优惠券ID */
-            couponId: string;
-            /** 数量 */
-            quantity: number;
-            /** 业务ID */
-            bizId: string;
-            /** 操作人ID */
-            operatorId: string;
-            /** 开始时间 */
-            startTime?: number;
-            /** 结束时间 */
-            endTime?: number;
-        }
-        /** 批量发放券 */
-        interface batchIssueCoupon {
-            /** 批量发放券请求列表 */
-            requests: batchIssueCouponItem[];
-            /** 发放渠道 */
-            getChannel: ENUM.AWARD_ENUM.DISTRIBUTION_CHANNEL;
-        }
     }
     namespace Response {
         /** 发放奖励响应 */
@@ -163,6 +136,8 @@ export declare namespace Service {
             success: boolean;
             /** 失败原因 */
             message?: string;
+            /** 失败详情 */
+            failureDetail?: TaskServiceTypes.Response.FailureListItem[];
         }
         /** 直播间积分&券发放统计响应 */
         interface queryLiveRoomDistributionStatsResponse {
@@ -190,7 +165,5 @@ export declare namespace Service {
         queryLiveRoomDistributionStats(request: Service.Request.queryLiveRoomDistributionStats, req: any): Promise<Service.Response.queryLiveRoomDistributionStatsResponse>;
         /** 后台单个发券 */
         adminSingleIssueCoupon(request: Service.Request.adminSingleIssueCoupon, req: any): Promise<Service.Response.distributePrize>;
-        /** 批量发放券 */
-        batchIssueCoupon(request: Service.Request.batchIssueCoupon, req: any): Promise<Service.Response.distributePrize>;
     }
 }

package/modules/pointsMall/service.d.ts

@@ -9,6 +9,7 @@ declare class PointsMallService extends BaseService implements Service.PointsMal
     getProductDetail(request: Service.Request.getProductDetail): Promise<Service.Response.getProductDetail>;
     queryEnabledAndOnlineProducts(request: Service.Request.queryEnabledAndOnlineProducts): Promise<Service.Response.queryEnabledAndOnlineProducts>;
     getAvailableCouponCountForProduct(request: Service.Request.getAvailableCouponCountForProduct): Promise<Service.Response.getAvailableCouponCountForProduct>;
+    getConsumptionThresholdInfo(request: Service.Request.getConsumptionThresholdInfo): Promise<Service.Response.getConsumptionThresholdInfo>;
 }
 export declare const pointsMallService: PointsMallService;
 export default pointsMallService;

package/modules/pointsMall/service.js

@@ -42,6 +42,9 @@ let PointsMallService = class PointsMallService extends BaseService_1.default {
     getAvailableCouponCountForProduct(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.getAvailableCouponCountForProduct), request);
     }
+    getConsumptionThresholdInfo(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getConsumptionThresholdInfo), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('批量创建积分商城商品'),
@@ -78,6 +81,11 @@ __decorate([
     (0, tsoa_1.Post)('get-available-coupon-count-for-product'),
     __param(0, (0, tsoa_1.Body)())
 ], PointsMallService.prototype, "getAvailableCouponCountForProduct", null);
+__decorate([
+    (0, tsoa_1.OperationId)('查询商品消费门槛校验信息'),
+    (0, tsoa_1.Post)('get-consumption-threshold-info'),
+    __param(0, (0, tsoa_1.Body)())
+], PointsMallService.prototype, "getConsumptionThresholdInfo", null);
 PointsMallService = __decorate([
     (0, tsoa_1.Route)('points-mall'),
     (0, tsoa_1.Tags)('PointsMall')

package/modules/pointsMall/types.d.ts

@@ -23,6 +23,10 @@ export declare namespace Service {
             enabled: number;
             /** 排序权重 */
             sortOrder: number;
+            /** 消费周期天数 */
+            consumptionPeriodDays: number;
+            /** 消费门槛金额（单位：分） */
+            consumptionThresholdAmount: number;
         }
         /** 后台管理列表 - 完整12个字段 */
         interface AdminProductItem {
@@ -42,6 +46,8 @@ export declare namespace Service {
             limitPerUser?: number;
             pointsRequired: number;
             couponRequired: number;
+            consumptionPeriodDays: number | null;
+            consumptionThresholdAmount: number | null;
             productImage: string;
         }
         /** C端积分商城列表 - 精确7个字段 */
@@ -64,6 +70,8 @@ export declare namespace Service {
             exchangeType: ENUM.POINT_MALL.ExchangeType;
             enabled?: number;
             sortOrder?: number;
+            consumptionPeriodDays?: number;
+            consumptionThresholdAmount?: number;
         }
         export interface CreateProduct extends BaseParams {
         }
@@ -121,6 +129,13 @@ export declare namespace Service {
             /** 是否开启 */
             enabled?: number;
         }
+        /** 查询商品消费门槛校验信息 */
+        export interface getConsumptionThresholdInfo {
+            /** 用户ID */
+            userId: string;
+            /** 商品ID */
+            productId: string;
+        }
         export {};
     }
     namespace Response {
@@ -166,6 +181,17 @@ export declare namespace Service {
             /** 可用优惠券数量 */
             count: number;
         }
+        /** 查询商品消费门槛校验信息响应 */
+        interface getConsumptionThresholdInfo {
+            /** 是否需要校验消费门槛 */
+            needValidation: boolean;
+            /** 消费金额（单位：分，不需要校验返回-1） */
+            consumptionAmount: number;
+            /** 门槛金额（单位：分，不需要校验返回-1） */
+            thresholdAmount: number;
+            /** 是否满足消费门槛 */
+            isThresholdMet: boolean;
+        }
     }
     interface PointsMallController {
         /** 批量创建积分商城商品 */
@@ -182,5 +208,7 @@ export declare namespace Service {
         queryEnabledAndOnlineProducts(request: Service.Request.queryEnabledAndOnlineProducts): Promise<Service.Response.queryEnabledAndOnlineProducts>;
         /** 查询指定商品用户可用优惠券的数量 */
         getAvailableCouponCountForProduct(request: Service.Request.getAvailableCouponCountForProduct): Promise<Service.Response.getAvailableCouponCountForProduct>;
+        /** 查询商品消费门槛校验信息 */
+        getConsumptionThresholdInfo(request: Service.Request.getConsumptionThresholdInfo): Promise<Service.Response.getConsumptionThresholdInfo>;
     }
 }

package/modules/task/service.d.ts

@@ -0,0 +1,12 @@
+import { Service } from './types';
+import BaseService from '../BaseService';
+declare class TaskService extends BaseService implements Service.BatchTaskController {
+    protected prefixUrl: string;
+    createBatchTask(request: Service.Request.createBatchTask): Promise<void>;
+    getBatchTaskList(request: Service.Request.getBatchTaskList): Promise<Service.Response.getBatchTaskList>;
+    getBatchTaskDetail(request: Service.Request.getBatchTaskDetail): Promise<Service.Response.getBatchTaskDetail>;
+    cancelBatchTask(request: Service.Request.cancelBatchTask): Promise<void>;
+    getFailureList(request: Service.Request.getFailureList): Promise<Service.Response.getFailureList>;
+}
+export declare const taskService: TaskService;
+export {};

package/modules/task/service.js

@@ -0,0 +1,69 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskService = void 0;
+const tsoa_1 = require("tsoa");
+const http_1 = require("../../utils/http");
+const BaseService_1 = __importDefault(require("../BaseService"));
+let TaskService = class TaskService extends BaseService_1.default {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/task';
+    }
+    createBatchTask(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.createBatchTask), request);
+    }
+    getBatchTaskList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getBatchTaskList), request);
+    }
+    getBatchTaskDetail(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getBatchTaskDetail), request);
+    }
+    cancelBatchTask(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.cancelBatchTask), request);
+    }
+    getFailureList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getFailureList), request);
+    }
+};
+__decorate([
+    (0, tsoa_1.OperationId)('创建批量任务'),
+    (0, tsoa_1.Post)('create-batch-task'),
+    __param(0, (0, tsoa_1.Body)())
+], TaskService.prototype, "createBatchTask", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取批量任务列表'),
+    (0, tsoa_1.Post)('get-batch-task-list'),
+    __param(0, (0, tsoa_1.Body)())
+], TaskService.prototype, "getBatchTaskList", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取批量任务详情'),
+    (0, tsoa_1.Post)('get-batch-task-detail'),
+    __param(0, (0, tsoa_1.Body)())
+], TaskService.prototype, "getBatchTaskDetail", null);
+__decorate([
+    (0, tsoa_1.OperationId)('撤回批量任务'),
+    (0, tsoa_1.Post)('cancel-batch-task'),
+    __param(0, (0, tsoa_1.Body)())
+], TaskService.prototype, "cancelBatchTask", null);
+__decorate([
+    (0, tsoa_1.OperationId)('获取失败名单'),
+    (0, tsoa_1.Post)('get-failure-list'),
+    __param(0, (0, tsoa_1.Body)())
+], TaskService.prototype, "getFailureList", null);
+TaskService = __decorate([
+    (0, tsoa_1.Route)('task'),
+    (0, tsoa_1.Tags)('Task')
+], TaskService);
+exports.taskService = new TaskService();

package/modules/task/types.d.ts

@@ -0,0 +1,205 @@
+import { ENUM } from '../../enum';
+export declare namespace Service {
+    namespace Entity {
+        /** 批量任务基础信息 */
+        interface BatchTask {
+            /** 任务ID */
+            id: string;
+            /** 任务名称 */
+            taskName: string;
+            /** 变动类型：增加/发放/扣减/作废 */
+            changeType: ENUM.TASK_ENUM.CHANGE_TYPE;
+            /** 资产类型：积分/优惠券 */
+            assetType: ENUM.TASK_ENUM.ASSET_TYPE;
+            /** 资产ID（券ID或积分类型标识） */
+            assetId?: string;
+            /** 变动数量 */
+            changeAmount: number;
+            /** 变动人数 */
+            changeUserCount: number;
+            /** 成功数量 */
+            successCount: number;
+            /** 失败数量 */
+            failureCount: number;
+            /** Excel文件URL（COS链接） */
+            fileUrl: string;
+            /** 任务状态 */
+            status: ENUM.TASK_ENUM.TASK_STATUS;
+            /** 操作人ID */
+            operatorId: string;
+            /** 操作人姓名 */
+            operatorName: string;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+            /** 失败详情（JSON字符串） */
+            failureDetail?: string;
+        }
+        /** 批量任务详情项 */
+        interface BatchTaskDetail {
+            /** 用户ID */
+            userId: string;
+            /** 变动数量 */
+            amount: number;
+            /** 处理状态 */
+            status: ENUM.TASK_ENUM.DETAIL_STATUS;
+            /** 失败原因 */
+            failureReason?: string;
+        }
+    }
+    namespace Request {
+        /** 创建批量任务 */
+        interface createBatchTask {
+            /** 任务名称 */
+            taskName: string;
+            /** 变动类型：增加/发放/扣减/作废 */
+            changeType: ENUM.TASK_ENUM.CHANGE_TYPE;
+            /** 资产类型：积分/优惠券 */
+            assetType: ENUM.TASK_ENUM.ASSET_TYPE;
+            /** 资产ID（券ID，积分类型可不填） */
+            assetId?: string;
+            /** 创建原因 */
+            reason: string;
+            /** Excel文件URL（COS链接） */
+            fileUrl: string;
+        }
+        /** 批量任务列表查询 */
+        interface getBatchTaskList {
+            /** 页码 */
+            pageIndex?: number;
+            /** 每页数量 */
+            pageSize?: number;
+            /** 任务ID */
+            taskId?: string;
+            /** 任务名称（模糊查询） */
+            taskName?: string;
+            /** 变动类型 */
+            changeType?: ENUM.TASK_ENUM.CHANGE_TYPE;
+            /** 资产类型 */
+            assetType?: ENUM.TASK_ENUM.ASSET_TYPE;
+            /** 任务状态 */
+            status?: ENUM.TASK_ENUM.TASK_STATUS;
+        }
+        /** 获取批量任务详情 */
+        interface getBatchTaskDetail {
+            /** 任务ID */
+            taskId: string;
+        }
+        /** 撤回批量任务 */
+        interface cancelBatchTask {
+            /** 任务ID */
+            taskId: string;
+        }
+        /** 获取失败名单 */
+        interface getFailureList {
+            /** 任务ID */
+            taskId: string;
+        }
+    }
+    namespace Response {
+        /** 批量任务列表项 */
+        interface BatchTaskListItem {
+            /** 任务ID */
+            id: string;
+            /** 任务名称 */
+            taskName: string;
+            /** 变动类型 */
+            changeType: ENUM.TASK_ENUM.CHANGE_TYPE;
+            /** 变动类型中文 */
+            changeTypeChinese: string;
+            /** 资产类型 */
+            assetType: ENUM.TASK_ENUM.ASSET_TYPE;
+            /** 资产类型中文 */
+            assetTypeChinese: string;
+            /** 变动人数 */
+            changeUserCount: number;
+            /** 成功数/失败数 */
+            successCount: number;
+            failureCount: number;
+            /** 操作人 */
+            operatorId: string;
+            /** 创建时间 */
+            createdAt: number;
+            /** 任务状态 */
+            status: ENUM.TASK_ENUM.TASK_STATUS;
+            /** 任务状态中文 */
+            statusChinese: string;
+        }
+        /** 批量任务列表响应 */
+        interface getBatchTaskList {
+            /** 总数 */
+            total: number;
+            /** 任务列表 */
+            list: BatchTaskListItem[];
+            /** 当前页码 */
+            pageIndex: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+        /** 批量任务详情响应 */
+        interface getBatchTaskDetail {
+            /** 任务ID */
+            id: string;
+            /** 任务名称 */
+            taskName: string;
+            /** 变动类型 */
+            changeType: ENUM.TASK_ENUM.CHANGE_TYPE;
+            /** 变动类型中文 */
+            changeTypeChinese: string;
+            /** 资产类型 */
+            assetType: ENUM.TASK_ENUM.ASSET_TYPE;
+            /** 资产类型中文 */
+            assetTypeChinese: string;
+            /** 资产ID */
+            assetId?: string;
+            /** 资产名称 */
+            assetName?: string;
+            /** 变动人数 */
+            changeUserCount: number;
+            /** 成功数/失败数 */
+            successCount: number;
+            failureCount: number;
+            /** Excel文件URL */
+            fileUrl: string;
+            /** 操作人 */
+            operatorId: string;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+            /** 任务状态 */
+            status: ENUM.TASK_ENUM.TASK_STATUS;
+            /** 任务状态中文 */
+            statusChinese: string;
+        }
+        /** 失败名单项 */
+        interface FailureListItem {
+            /** 用户ID */
+            userId: string;
+            /** 变动数量 */
+            amount: number;
+            /** 失败原因 */
+            failureReason: string;
+        }
+        /** 失败名单响应 */
+        interface getFailureList {
+            /** 表头 */
+            headerMap: Record<string, string>;
+            /** 数据 */
+            data: Record<string, any>[];
+        }
+    }
+    interface BatchTaskController {
+        /** 创建批量任务 */
+        createBatchTask(request: Service.Request.createBatchTask, req: any): Promise<void>;
+        /** 获取批量任务列表 */
+        getBatchTaskList(request: Service.Request.getBatchTaskList, req: any): Promise<Service.Response.getBatchTaskList>;
+        /** 获取批量任务详情 */
+        getBatchTaskDetail(request: Service.Request.getBatchTaskDetail, req: any): Promise<Service.Response.getBatchTaskDetail>;
+        /** 撤回批量任务 */
+        cancelBatchTask(request: Service.Request.cancelBatchTask, req: any): Promise<void>;
+        /** 获取失败名单 */
+        getFailureList(request: Service.Request.getFailureList, req: any): Promise<Service.Response.getFailureList>;
+    }
+}

package/modules/task/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-promotion-service-node-sdk",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "EcommercePromotionService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",
@@ -14,7 +14,7 @@
     "axios": "1.13.2",
     "axios-retry": "4.0.0",
     "uuid": "9.0.1",
-    "tsoa": "^6.6.0",
+    "tsoa": "6.6.0",
     "safe-stable-stringify": "2.5.0"
   },
   "scripts": {