@be-link/ecommerce-client-backend-service-node-sdk 0.1.83 → 0.1.85

package/enum.d.ts

@@ -283,4 +283,63 @@ export declare namespace ENUM {
         /** 订单笔数调整（对账冲平） */
         ORDER_COUNT_ADJUST = 5
     }
+    /**
+     * 用户发育阶段
+     */
+    namespace GROWTH_STAGE {
+        /**
+         * 发育阶段（5个阶段）
+         * 1-新客未确认周期，2-新客确认周期，3-次新客未确认周期，4-次新客确认周期，5-老客
+         */
+        enum STAGE {
+            /** 新客未确认周期 */
+            NEW_UNCONFIRMED = 1,
+            /** 新客确认周期 */
+            NEW_CONFIRMED = 2,
+            /** 次新客未确认周期 */
+            SUB_NEW_UNCONFIRMED = 3,
+            /** 次新客确认周期 */
+            SUB_NEW_CONFIRMED = 4,
+            /** 老客 */
+            OLD = 5
+        }
+        /**
+         * 新老客身份（2个身份）
+         * stage < 5 为新客，stage = 5 为老客
+         */
+        enum IDENTITY {
+            /** 新客 */
+            NEW = 1,
+            /** 老客 */
+            OLD = 2
+        }
+    }
+    /**
+     * 用户周期类型
+     */
+    namespace CYCLE_TYPE {
+        enum TYPE {
+            /** 新客第一周期 */
+            FIRST = 1,
+            /** 次新客第二周期 */
+            SECOND = 2
+        }
+    }
+    /**
+     * 定时任务标识
+     */
+    namespace TASK_EXECUTION {
+        enum CODE {
+            T2 = "T2",
+            T3 = "T3",
+            T4 = "T4",
+            T5 = "T5"
+        }
+        enum STATUS {
+            /** 成功 */
+            SUCCESS = 1,
+            /** 失败 */
+            FAILED = 2
+        }
+    }
 }

package/enum.js

@@ -322,4 +322,71 @@ var ENUM;
         /** 订单笔数调整（对账冲平） */
         TransactionType[TransactionType["ORDER_COUNT_ADJUST"] = 5] = "ORDER_COUNT_ADJUST";
     })(TransactionType = ENUM.TransactionType || (ENUM.TransactionType = {}));
+    /**
+     * 用户发育阶段
+     */
+    let GROWTH_STAGE;
+    (function (GROWTH_STAGE) {
+        /**
+         * 发育阶段（5个阶段）
+         * 1-新客未确认周期，2-新客确认周期，3-次新客未确认周期，4-次新客确认周期，5-老客
+         */
+        let STAGE;
+        (function (STAGE) {
+            /** 新客未确认周期 */
+            STAGE[STAGE["NEW_UNCONFIRMED"] = 1] = "NEW_UNCONFIRMED";
+            /** 新客确认周期 */
+            STAGE[STAGE["NEW_CONFIRMED"] = 2] = "NEW_CONFIRMED";
+            /** 次新客未确认周期 */
+            STAGE[STAGE["SUB_NEW_UNCONFIRMED"] = 3] = "SUB_NEW_UNCONFIRMED";
+            /** 次新客确认周期 */
+            STAGE[STAGE["SUB_NEW_CONFIRMED"] = 4] = "SUB_NEW_CONFIRMED";
+            /** 老客 */
+            STAGE[STAGE["OLD"] = 5] = "OLD";
+        })(STAGE = GROWTH_STAGE.STAGE || (GROWTH_STAGE.STAGE = {}));
+        /**
+         * 新老客身份（2个身份）
+         * stage < 5 为新客，stage = 5 为老客
+         */
+        let IDENTITY;
+        (function (IDENTITY) {
+            /** 新客 */
+            IDENTITY[IDENTITY["NEW"] = 1] = "NEW";
+            /** 老客 */
+            IDENTITY[IDENTITY["OLD"] = 2] = "OLD";
+        })(IDENTITY = GROWTH_STAGE.IDENTITY || (GROWTH_STAGE.IDENTITY = {}));
+    })(GROWTH_STAGE = ENUM.GROWTH_STAGE || (ENUM.GROWTH_STAGE = {}));
+    /**
+     * 用户周期类型
+     */
+    let CYCLE_TYPE;
+    (function (CYCLE_TYPE) {
+        let TYPE;
+        (function (TYPE) {
+            /** 新客第一周期 */
+            TYPE[TYPE["FIRST"] = 1] = "FIRST";
+            /** 次新客第二周期 */
+            TYPE[TYPE["SECOND"] = 2] = "SECOND";
+        })(TYPE = CYCLE_TYPE.TYPE || (CYCLE_TYPE.TYPE = {}));
+    })(CYCLE_TYPE = ENUM.CYCLE_TYPE || (ENUM.CYCLE_TYPE = {}));
+    /**
+     * 定时任务标识
+     */
+    let TASK_EXECUTION;
+    (function (TASK_EXECUTION) {
+        let CODE;
+        (function (CODE) {
+            CODE["T2"] = "T2";
+            CODE["T3"] = "T3";
+            CODE["T4"] = "T4";
+            CODE["T5"] = "T5";
+        })(CODE = TASK_EXECUTION.CODE || (TASK_EXECUTION.CODE = {}));
+        let STATUS;
+        (function (STATUS) {
+            /** 成功 */
+            STATUS[STATUS["SUCCESS"] = 1] = "SUCCESS";
+            /** 失败 */
+            STATUS[STATUS["FAILED"] = 2] = "FAILED";
+        })(STATUS = TASK_EXECUTION.STATUS || (TASK_EXECUTION.STATUS = {}));
+    })(TASK_EXECUTION = ENUM.TASK_EXECUTION || (ENUM.TASK_EXECUTION = {}));
 })(ENUM || (exports.ENUM = ENUM = {}));

package/modules/data/service.d.ts

@@ -51,6 +51,16 @@ declare class DataServiceClass extends BaseService implements DataService.BaseCo
     batchUpdateUserConsumptionFromCsv(request: DataService.Request.BatchUpdateUserConsumptionFromCsv): Promise<void>;
     batchUpdateUserWatchDataFromCsv(request: DataService.Request.BatchUpdateUserWatchDataFromCsv): Promise<void>;
     batchUpdateCrossPlatformSummaryFromCsv(request: DataService.Request.BatchUpdateCrossPlatformSummaryFromCsv): Promise<void>;
+    /** 新老客分流任务：每日确立第一周期 */
+    dailyDetermineFirstCycle(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
+    /** 新老客分流任务：每周一新客周期结算 */
+    weeklySettleFirstCycle(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
+    /** 新老客分流任务：每日确立第二周期 */
+    dailyDetermineSecondCycle(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
+    /** 新老客分流任务：每周一次新客清理 */
+    weeklyCleanupNewCustomers(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
+    /** 新老客分流存量数据清洗（一次性补偿入口） */
+    migrateExistingGrowthStageData(): Promise<void>;
 }
 export declare const dataService: DataServiceClass;
 export default dataService;

package/modules/data/service.js

@@ -126,6 +126,26 @@ let DataServiceClass = class DataServiceClass extends BaseService_1.default {
     batchUpdateCrossPlatformSummaryFromCsv(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.batchUpdateCrossPlatformSummaryFromCsv), request);
     }
+    /** 新老客分流任务：每日确立第一周期 */
+    dailyDetermineFirstCycle(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.dailyDetermineFirstCycle), request);
+    }
+    /** 新老客分流任务：每周一新客周期结算 */
+    weeklySettleFirstCycle(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.weeklySettleFirstCycle), request);
+    }
+    /** 新老客分流任务：每日确立第二周期 */
+    dailyDetermineSecondCycle(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.dailyDetermineSecondCycle), request);
+    }
+    /** 新老客分流任务：每周一次新客清理 */
+    weeklyCleanupNewCustomers(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.weeklyCleanupNewCustomers), request);
+    }
+    /** 新老客分流存量数据清洗（一次性补偿入口） */
+    migrateExistingGrowthStageData() {
+        return (0, http_1.callApi)(this.getApiUrl(this.migrateExistingGrowthStageData), undefined);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户观看时长'),
@@ -257,6 +277,30 @@ __decorate([
     (0, tsoa_1.Post)('batch-update-cross-platform-summary-from-csv'),
     __param(0, (0, tsoa_1.Body)())
 ], DataServiceClass.prototype, "batchUpdateCrossPlatformSummaryFromCsv", null);
+__decorate([
+    (0, tsoa_1.OperationId)('dailyDetermineFirstCycle'),
+    (0, tsoa_1.Post)('daily-determine-first-cycle'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "dailyDetermineFirstCycle", null);
+__decorate([
+    (0, tsoa_1.OperationId)('weeklySettleFirstCycle'),
+    (0, tsoa_1.Post)('weekly-settle-first-cycle'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "weeklySettleFirstCycle", null);
+__decorate([
+    (0, tsoa_1.OperationId)('dailyDetermineSecondCycle'),
+    (0, tsoa_1.Post)('daily-determine-second-cycle'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "dailyDetermineSecondCycle", null);
+__decorate([
+    (0, tsoa_1.OperationId)('weeklyCleanupNewCustomers'),
+    (0, tsoa_1.Post)('weekly-cleanup-new-customers'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "weeklyCleanupNewCustomers", null);
+__decorate([
+    (0, tsoa_1.OperationId)('migrateExistingGrowthStageData'),
+    (0, tsoa_1.Post)('migrate-existing-growth-stage-data')
+], DataServiceClass.prototype, "migrateExistingGrowthStageData", null);
 DataServiceClass = __decorate([
     (0, tsoa_1.Route)('data'),
     (0, tsoa_1.Tags)('Data')

package/modules/data/types.d.ts

@@ -232,6 +232,13 @@ export declare namespace DataService {
             /** CSV文件的COS地址 */
             fileUrl: string;
         }
+        /**
+         * 执行新老客发育阶段定时任务（T2/T3/T4/T5）
+         */
+        interface ExecuteGrowthStageTask {
+            /** 业务日期时间戳（当天0点毫秒级时间戳），不传则取当天 */
+            bizDateTs?: number;
+        }
     }
     namespace Response {
         /**
@@ -294,15 +301,6 @@ export declare namespace DataService {
             /** 执行结果消息 */
             message: string;
         }
-        /**
-         * 手动补偿更新用户最后看播时间响应
-         */
-        interface CompensateUserLastWatchTime {
-            /** 是否成功 */
-            success: boolean;
-            /** 执行结果消息 */
-            message: string;
-        }
     }
     interface BaseController {
         userLiveStreamRelation(request: Request.UserLiveStreamRelation, req?: FastifyRequest): Promise<void>;
@@ -333,6 +331,11 @@ export declare namespace DataService {
         batchUpdateUserConsumptionFromCsv(request: Request.BatchUpdateUserConsumptionFromCsv, req?: FastifyRequest): Promise<void>;
         batchUpdateUserWatchDataFromCsv(request: Request.BatchUpdateUserWatchDataFromCsv, req?: FastifyRequest): Promise<void>;
         batchUpdateCrossPlatformSummaryFromCsv(request: Request.BatchUpdateCrossPlatformSummaryFromCsv, req?: FastifyRequest): Promise<void>;
+        dailyDetermineFirstCycle(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
+        weeklySettleFirstCycle(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
+        dailyDetermineSecondCycle(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
+        weeklyCleanupNewCustomers(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
+        migrateExistingGrowthStageData(req?: FastifyRequest): Promise<void>;
     }
 }
 /**

package/modules/userData/service.d.ts

@@ -10,6 +10,8 @@ declare class UserDataServiceClass extends BaseService implements UserDataServic
     getUserLiveWatchCalendar(request: UserDataService.Request.GetUserLiveWatchCalendar): Promise<UserDataService.Response.GetUserLiveWatchCalendar>;
     replaceThirdPartyUserIdToUserId(request: UserDataService.Request.ReplaceThirdPartyUserIdToUserId): Promise<UserDataService.Response.ReplaceThirdPartyUserIdToUserId>;
     getStoreUserSummary(request: UserDataService.Request.GetStoreUserSummary): Promise<UserDataService.Response.GetStoreUserSummary>;
+    /** 查询用户新老客身份 */
+    getUserGrowthStage(request: UserDataService.Request.GetUserGrowthStage): Promise<UserDataService.Response.GetUserGrowthStage>;
 }
 export declare const userDataService: UserDataServiceClass;
 export default userDataService;

package/modules/userData/service.js

@@ -45,6 +45,10 @@ let UserDataServiceClass = class UserDataServiceClass extends BaseService_1.defa
     getStoreUserSummary(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.getStoreUserSummary), request);
     }
+    /** 查询用户新老客身份 */
+    getUserGrowthStage(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getUserGrowthStage), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户列表'),
@@ -86,6 +90,11 @@ __decorate([
     (0, tsoa_1.Post)('get-store-user-summary'),
     __param(0, (0, tsoa_1.Body)())
 ], UserDataServiceClass.prototype, "getStoreUserSummary", null);
+__decorate([
+    (0, tsoa_1.OperationId)('查询用户新老客身份'),
+    (0, tsoa_1.Post)('get-user-growth-stage'),
+    __param(0, (0, tsoa_1.Body)())
+], UserDataServiceClass.prototype, "getUserGrowthStage", null);
 UserDataServiceClass = __decorate([
     (0, tsoa_1.Route)('userData'),
     (0, tsoa_1.Tags)('UserData')

package/modules/userData/types.d.ts

@@ -1,4 +1,5 @@
 import { FastifyRequest } from 'fastify';
+import { ENUM } from '../../enum';
 export declare namespace UserDataService {
     namespace Request {
         /**
@@ -129,6 +130,13 @@ export declare namespace UserDataService {
             /** 黑钻会员等级 */
             blackDiamondMemberLevel: string;
         }
+        /**
+         * 查询用户新老客身份
+         */
+        interface GetUserGrowthStage {
+            /** 用户ID */
+            userId: string;
+        }
     }
     namespace Response {
         /**
@@ -192,6 +200,15 @@ export declare namespace UserDataService {
             /** 总观看时长（分钟），前端展示如 "127.5h" 时可自行换算为小时 */
             totalWatchDurationMinutes: number;
         }
+        /**
+         * 查询用户新老客身份响应
+         */
+        interface GetUserGrowthStage {
+            /** 发育阶段（1~5） */
+            growthStage: ENUM.GROWTH_STAGE.STAGE;
+            /** 新老客身份（1-新客，2-老客） */
+            identity: ENUM.GROWTH_STAGE.IDENTITY;
+        }
         /**
          * 获取用户看播日历数据响应
          */
@@ -263,6 +280,7 @@ export declare namespace UserDataService {
         getUserLiveWatchSummary(request: Request.GetUserLiveWatchSummary, req?: FastifyRequest): Promise<Response.GetUserLiveWatchSummary>;
         getUserLiveWatchCalendar(request: Request.GetUserLiveWatchCalendar, req?: FastifyRequest): Promise<Response.GetUserLiveWatchCalendar>;
         getStoreUserSummary(request: Request.GetStoreUserSummary, req?: FastifyRequest): Promise<Response.GetStoreUserSummary>;
+        getUserGrowthStage(request: Request.GetUserGrowthStage, req?: FastifyRequest): Promise<Response.GetUserGrowthStage>;
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/ecommerce-client-backend-service-node-sdk",
-  "version": "0.1.83",
+  "version": "0.1.85",
   "description": "EcommerceClientBackendService Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",