@be-link/ecommerce-client-backend-service-node-sdk 0.1.91 → 0.1.93

package/consts.d.ts

@@ -0,0 +1,30 @@
+export declare namespace HOTEL_TRAVEL_MQ {
+    /** 酒旅 MQ vhost */
+    const VHOST = "trade";
+    /** 正向订单 MQ */
+    namespace POS {
+        /** 正向订单主题 */
+        const TOPIC = "positive-topic";
+        /** 正向订单路由键 */
+        const ROUTING_KEY: {
+            /** 创建 */
+            readonly CREATE: "order.positive.create";
+            /** 支付成功 */
+            readonly PAY_SUCCESS: "order.positive.pay_success";
+            /** 关闭 */
+            readonly CLOSED: "order.positive.close";
+            /** 定金补全 */
+            readonly DEPOSIT_RESERVE_COMPLETED: "order.positive.deposit_reserve_completed";
+        };
+    }
+    /** 逆向订单 MQ */
+    namespace ROS {
+        /** 逆向订单主题 */
+        const TOPIC = "reverse-topic";
+        /** 逆向订单路由键 */
+        const ROUTING_KEY: {
+            /** 退款成功 */
+            readonly SUCCESS: "order.reverse.success";
+        };
+    }
+}

package/consts.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HOTEL_TRAVEL_MQ = void 0;
+var HOTEL_TRAVEL_MQ;
+(function (HOTEL_TRAVEL_MQ) {
+    /** 酒旅 MQ vhost */
+    HOTEL_TRAVEL_MQ.VHOST = 'trade';
+    /** 正向订单 MQ */
+    let POS;
+    (function (POS) {
+        /** 正向订单主题 */
+        POS.TOPIC = 'positive-topic';
+        /** 正向订单路由键 */
+        POS.ROUTING_KEY = {
+            /** 创建 */
+            CREATE: 'order.positive.create',
+            /** 支付成功 */
+            PAY_SUCCESS: 'order.positive.pay_success',
+            /** 关闭 */
+            CLOSED: 'order.positive.close',
+            /** 定金补全 */
+            DEPOSIT_RESERVE_COMPLETED: 'order.positive.deposit_reserve_completed',
+        };
+    })(POS = HOTEL_TRAVEL_MQ.POS || (HOTEL_TRAVEL_MQ.POS = {}));
+    /** 逆向订单 MQ */
+    let ROS;
+    (function (ROS) {
+        /** 逆向订单主题 */
+        ROS.TOPIC = 'reverse-topic';
+        /** 逆向订单路由键 */
+        ROS.ROUTING_KEY = {
+            /** 退款成功 */
+            SUCCESS: 'order.reverse.success',
+        };
+    })(ROS = HOTEL_TRAVEL_MQ.ROS || (HOTEL_TRAVEL_MQ.ROS = {}));
+})(HOTEL_TRAVEL_MQ || (exports.HOTEL_TRAVEL_MQ = HOTEL_TRAVEL_MQ = {}));

package/index.d.ts

@@ -13,6 +13,7 @@ export { ruleService } from './modules/rule/service';
 export { miniProgramService } from './modules/miniprogram/service';
 export { userDataService } from './modules/userData/service';
 export { ENUM as CLIENT_BACKEND_ENUM } from './enum';
+export { HOTEL_TRAVEL_MQ } from './consts';
 export { destroyHttpAgents } from './utils/http';
 export type { Room, RoomAutoStartConfig, RoomLoopVideo, RoomTag, RoomBindStore } from './types';
 export type { Domain, Current } from './modules/domain/types';

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.destroyHttpAgents = exports.CLIENT_BACKEND_ENUM = exports.userDataService = exports.miniProgramService = exports.ruleService = exports.domainService = exports.dataService = exports.roomDataService = exports.roomService = void 0;
+exports.destroyHttpAgents = exports.HOTEL_TRAVEL_MQ = exports.CLIENT_BACKEND_ENUM = exports.userDataService = exports.miniProgramService = exports.ruleService = exports.domainService = exports.dataService = exports.roomDataService = exports.roomService = void 0;
 var service_1 = require("./modules/room/service");
 Object.defineProperty(exports, "roomService", { enumerable: true, get: function () { return service_1.roomService; } });
 var service_2 = require("./modules/roomData/service");
@@ -17,6 +17,8 @@ var service_7 = require("./modules/userData/service");
 Object.defineProperty(exports, "userDataService", { enumerable: true, get: function () { return service_7.userDataService; } });
 var enum_1 = require("./enum");
 Object.defineProperty(exports, "CLIENT_BACKEND_ENUM", { enumerable: true, get: function () { return enum_1.ENUM; } });
+var consts_1 = require("./consts");
+Object.defineProperty(exports, "HOTEL_TRAVEL_MQ", { enumerable: true, get: function () { return consts_1.HOTEL_TRAVEL_MQ; } });
 var http_1 = require("./utils/http");
 Object.defineProperty(exports, "destroyHttpAgents", { enumerable: true, get: function () { return http_1.destroyHttpAgents; } });
 // 服务.模块.枚举名称.枚举值 示例: DEMO_ENUM.ORDER_ENUM.STATUS.PENDING

package/modules/data/service.d.ts

@@ -40,6 +40,10 @@ declare class DataServiceClass extends BaseService implements DataService.BaseCo
     syncPreviewAudienceStatistics(): Promise<void>;
     /** 从订单服务同步 trade_order（定时调度：order_change_log 扫单回写） */
     syncTradeOrderFromOrderService(): Promise<void>;
+    /** 定时校准酒旅用户累计消费金额（脏用户集合回查） */
+    syncHotelTravelUserConsumptionAmount(request?: DataService.Request.SyncHotelTravelUserConsumptionAmount): Promise<void>;
+    /** 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传） */
+    backfillHotelTravelUserConsumptionAmount(request?: DataService.Request.BackfillHotelTravelUserConsumptionAmount): Promise<void>;
     /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
     compensateReplayAudienceStatistics(request: DataService.Request.CompensateReplayAudienceStatistics): Promise<void>;
     batchCompensateReplayAudienceStatistics(request: DataService.Request.BatchCompensateReplayAudienceStatistics): Promise<void>;

package/modules/data/service.js

@@ -101,6 +101,14 @@ let DataServiceClass = class DataServiceClass extends BaseService_1.default {
     syncTradeOrderFromOrderService() {
         return (0, http_1.callApi)(this.getApiUrl(this.syncTradeOrderFromOrderService), undefined);
     }
+    /** 定时校准酒旅用户累计消费金额（脏用户集合回查） */
+    syncHotelTravelUserConsumptionAmount(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.syncHotelTravelUserConsumptionAmount), request);
+    }
+    /** 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传） */
+    backfillHotelTravelUserConsumptionAmount(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.backfillHotelTravelUserConsumptionAmount), request);
+    }
     /** 补偿指定直播间的回放观众统计（拉火山回放写回放三字段，用于手动补偿） */
     compensateReplayAudienceStatistics(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.compensateReplayAudienceStatistics), request);
@@ -254,6 +262,16 @@ __decorate([
     (0, tsoa_1.OperationId)('从订单服务同步 trade_order'),
     (0, tsoa_1.Post)('sync-trade-order-from-order-service')
 ], DataServiceClass.prototype, "syncTradeOrderFromOrderService", null);
+__decorate([
+    (0, tsoa_1.OperationId)('定时校准酒旅用户累计消费金额'),
+    (0, tsoa_1.Post)('sync-hotel-travel-user-consumption-amount'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "syncHotelTravelUserConsumptionAmount", null);
+__decorate([
+    (0, tsoa_1.OperationId)('一次性历史回填酒旅用户累计消费金额'),
+    (0, tsoa_1.Post)('backfill-hotel-travel-user-consumption-amount'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "backfillHotelTravelUserConsumptionAmount", null);
 __decorate([
     (0, tsoa_1.OperationId)('补偿回放观众统计'),
     (0, tsoa_1.Post)('compensate-replay-audience-statistics'),

package/modules/data/types.d.ts

@@ -211,6 +211,22 @@ export declare namespace DataService {
             /** 目标对账日期（ISO 8601格式，如 "2024-01-15"），不传则对账昨天 */
             targetDate?: string;
         }
+        /**
+         * 定时校准酒旅用户累计消费金额（脏用户集合回查）
+         */
+        interface SyncHotelTravelUserConsumptionAmount {
+            /** 单次处理用户数（默认500，最大5000） */
+            batchSize?: number;
+        }
+        /**
+         * 一次性历史回填酒旅用户累计消费金额（支持 userId 游标断点续传）
+         */
+        interface BackfillHotelTravelUserConsumptionAmount {
+            /** 单次分页大小（默认500，最大5000） */
+            pageSize?: number;
+            /** 起始 userId（断点续传游标） */
+            startUserId?: string;
+        }
         /**
          * 批量更新用户消费数据（从CSV文件）
          */
@@ -302,6 +318,33 @@ export declare namespace DataService {
             message: string;
         }
     }
+    /**
+     * 直播间统计缓存结构（Redis）
+     */
+    interface LiveStreamRoomStatisticsCache {
+        /** 直播间id */
+        liveStreamRoomId: string;
+        /** 交易总金额（待支付金额+实收金额、含退款金额） */
+        gmv?: number;
+        /** 实收金额：支付成功且未退款金额 */
+        actualReceivedAmount?: number;
+        /** 退款金额 */
+        refundAmount?: number;
+        /** 待支付金额 */
+        pendingPaymentAmount?: number;
+        /** 成交订单数 */
+        transactOrderCount?: number;
+        /** 商品销售量 */
+        salesVolume?: number;
+        /** 待支付份数 */
+        pendingSalesVolume?: number;
+        /** 下单人数（去重） */
+        orderUserCount?: number;
+        /** 退款人数（去重） */
+        refundUserCount?: number;
+        /** 酒旅预计尾款（单位：分） */
+        hotelTravelEstimatedFinalPayment?: number;
+    }
     interface BaseController {
         userLiveStreamRelation(request: Request.UserLiveStreamRelation, req?: FastifyRequest): Promise<void>;
         getUserViewDuration(request: Request.UserViewDuration, req?: FastifyRequest): Promise<Response.UserViewDuration>;
@@ -324,6 +367,8 @@ export declare namespace DataService {
         syncReplayAudienceStatistics(): Promise<void>;
         syncPreviewAudienceStatistics(): Promise<void>;
         syncTradeOrderFromOrderService(): Promise<void>;
+        syncHotelTravelUserConsumptionAmount(request?: Request.SyncHotelTravelUserConsumptionAmount, req?: FastifyRequest): Promise<void>;
+        backfillHotelTravelUserConsumptionAmount(request?: Request.BackfillHotelTravelUserConsumptionAmount, req?: FastifyRequest): Promise<void>;
         compensateReplayAudienceStatistics(request: Request.CompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
         batchCompensateReplayAudienceStatistics(request: Request.BatchCompensateReplayAudienceStatistics, req?: FastifyRequest): Promise<void>;
         dailyUpdateUserFirstWatchTime(req?: FastifyRequest): Promise<void>;

package/modules/room/service.d.ts

@@ -19,6 +19,7 @@ declare class RoomServiceClass extends BaseService implements RoomService.BaseCo
     viewRecord(request: RoomService.Request.ViewRecord): Promise<RoomService.Response.ViewRecord>;
     /** 门店直播规则查询 */
     storeLiveStreamRule(request: RoomService.Request.StoreLiveStreamRule): Promise<RoomService.Response.StoreLiveStreamRule>;
+    isNewCustomerLiveRoom(request: RoomService.Request.IsNewCustomerLiveRoom): Promise<RoomService.Response.IsNewCustomerLiveRoom>;
     searchByName(request: RoomService.Request.SearchByName): Promise<RoomService.Response.SearchByName>;
     getBasicInfo(request: RoomService.Request.GetBasicInfo): Promise<RoomService.Response.GetBasicInfo>;
     getRoomTagValues(request: RoomService.Request.GetRoomTagValues): Promise<RoomService.Response.GetRoomTagValues>;

package/modules/room/service.js

@@ -63,6 +63,9 @@ let RoomServiceClass = class RoomServiceClass extends BaseService_1.default {
     storeLiveStreamRule(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.storeLiveStreamRule), request);
     }
+    isNewCustomerLiveRoom(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.isNewCustomerLiveRoom), request);
+    }
     searchByName(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.searchByName), request);
     }
@@ -144,6 +147,11 @@ __decorate([
     (0, tsoa_1.Post)('store-live-stream-rule'),
     __param(0, (0, tsoa_1.Body)())
 ], RoomServiceClass.prototype, "storeLiveStreamRule", null);
+__decorate([
+    (0, tsoa_1.OperationId)('查询是否新客直播间'),
+    (0, tsoa_1.Post)('is-new-customer-live-room'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomServiceClass.prototype, "isNewCustomerLiveRoom", null);
 __decorate([
     (0, tsoa_1.OperationId)('根据名称搜索房间'),
     (0, tsoa_1.Post)('search-by-name'),

package/modules/room/types.d.ts

@@ -67,6 +67,13 @@ export declare namespace RoomService {
             /** 门店ID */
             storeId: string;
         }
+        /**
+         * 查询是否新客直播间
+         */
+        interface IsNewCustomerLiveRoom {
+            /** 直播间ID */
+            liveStreamRoomId: string;
+        }
         /**
          * 绑定门店
          */
@@ -253,6 +260,13 @@ export declare namespace RoomService {
         interface StoreLiveStreamRule {
             rule: boolean;
         }
+        /**
+         * 查询是否新客直播间响应
+         */
+        interface IsNewCustomerLiveRoom {
+            /** 是否新客直播间 */
+            isNewCustomerLiveRoom: boolean;
+        }
         /**
          * 房间基本信息
          */
@@ -363,6 +377,10 @@ export declare namespace RoomService {
         listByStoreBind(request: Request.ListByStoreBind, req?: FastifyRequest): Promise<Response.ListByStoreBind>;
         viewRecord(request: Request.ViewRecord, req?: FastifyRequest): Promise<Response.ViewRecord>;
         storeLiveStreamRule(request: Request.StoreLiveStreamRule, req?: FastifyRequest): Promise<Response.StoreLiveStreamRule>;
+        /**
+         * 查询是否新客直播间
+         */
+        isNewCustomerLiveRoom(request: Request.IsNewCustomerLiveRoom, req?: FastifyRequest): Promise<Response.IsNewCustomerLiveRoom>;
         /**
          * 根据名称搜索房间
          */

package/modules/userData/types.d.ts

@@ -76,6 +76,12 @@ export declare namespace UserDataService {
             nickname?: string;
             /** 会员等级 */
             memberLevel?: string;
+            /** 电商累计消费金额范围（分）[最小值, 最大值] */
+            accumulatedConsumptionAmountRange?: number[];
+            /** 总累计消费金额范围（分）[最小值, 最大值] */
+            totalAccumulatedConsumptionAmountRange?: number[];
+            /** 酒旅累计消费金额范围（分）[最小值, 最大值] */
+            hotelTravelAccumulatedConsumptionAmountRange?: number[];
             /** 页码，从0开始 */
             pageIndex: number;
             /** 每页数量，默认20，最大1000 */
@@ -97,6 +103,12 @@ export declare namespace UserDataService {
             nickname?: string;
             /** 会员等级 */
             memberLevel?: string;
+            /** 电商累计消费金额范围（分）[最小值, 最大值] */
+            accumulatedConsumptionAmountRange?: number[];
+            /** 总累计消费金额范围（分）[最小值, 最大值] */
+            totalAccumulatedConsumptionAmountRange?: number[];
+            /** 酒旅累计消费金额范围（分）[最小值, 最大值] */
+            hotelTravelAccumulatedConsumptionAmountRange?: number[];
             /** 页码，从0开始 */
             pageIndex: number;
             /** 每页数量，默认20，最大1000 */
@@ -406,6 +418,12 @@ export interface LiveRoomUserItem {
     replayConsumeAmount: number;
     /** 累计消费金额（支付总额 - 退款总额，元） */
     totalConsumeAmount: number;
+    /** 电商累计消费金额（元） */
+    accumulatedConsumptionAmount: number;
+    /** 总累计消费金额（元） */
+    totalAccumulatedConsumptionAmount: number;
+    /** 酒旅累计消费金额（元） */
+    hotelTravelAccumulatedConsumptionAmount: number;
     /** 首次进入直播间时间（毫秒时间戳） */
     firstEnterTime: number;
     /** 最后进入直播间时间（毫秒时间戳） */

package/package.json

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