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

package/index.d.ts

@@ -1,5 +1,5 @@
 export type { RoomService } from './modules/room/types';
-export type { RoomDataService } from './modules/roomData/types';
+export type { RoomDataService, StoreAnalysisService } from './modules/roomData/types';
 export type { DataService } from './modules/data/types';
 export type { DomainService } from './modules/domain/types';
 export type { RuleService } from './modules/rule/types';

package/modules/data/service.d.ts

@@ -61,6 +61,11 @@ declare class DataServiceClass extends BaseService implements DataService.BaseCo
     weeklyCleanupNewCustomers(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
     /** 新老客分流存量数据清洗（一次性补偿入口） */
     migrateExistingGrowthStageData(): Promise<void>;
+    /**
+     * 预热新老客发育阶段缓存（昨日看播用户）
+     * 用于提高用户首次拉取阶段接口的命中率
+     */
+    warmupGrowthStageCacheForYesterdayWatchers(request?: DataService.Request.ExecuteGrowthStageTask): Promise<void>;
 }
 export declare const dataService: DataServiceClass;
 export default dataService;

package/modules/data/service.js

@@ -146,6 +146,13 @@ let DataServiceClass = class DataServiceClass extends BaseService_1.default {
     migrateExistingGrowthStageData() {
         return (0, http_1.callApi)(this.getApiUrl(this.migrateExistingGrowthStageData), undefined);
     }
+    /**
+     * 预热新老客发育阶段缓存（昨日看播用户）
+     * 用于提高用户首次拉取阶段接口的命中率
+     */
+    warmupGrowthStageCacheForYesterdayWatchers(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.warmupGrowthStageCacheForYesterdayWatchers), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('获取用户观看时长'),
@@ -301,6 +308,11 @@ __decorate([
     (0, tsoa_1.OperationId)('migrateExistingGrowthStageData'),
     (0, tsoa_1.Post)('migrate-existing-growth-stage-data')
 ], DataServiceClass.prototype, "migrateExistingGrowthStageData", null);
+__decorate([
+    (0, tsoa_1.OperationId)('warmupGrowthStageCacheForYesterdayWatchers'),
+    (0, tsoa_1.Post)('warmup-growth-stage-cache-for-yesterday-watchers'),
+    __param(0, (0, tsoa_1.Body)())
+], DataServiceClass.prototype, "warmupGrowthStageCacheForYesterdayWatchers", null);
 DataServiceClass = __decorate([
     (0, tsoa_1.Route)('data'),
     (0, tsoa_1.Tags)('Data')

package/modules/data/types.d.ts

@@ -335,6 +335,7 @@ export declare namespace DataService {
         weeklySettleFirstCycle(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
         dailyDetermineSecondCycle(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
         weeklyCleanupNewCustomers(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
+        warmupGrowthStageCacheForYesterdayWatchers(request?: Request.ExecuteGrowthStageTask, req?: FastifyRequest): Promise<void>;
         migrateExistingGrowthStageData(req?: FastifyRequest): Promise<void>;
     }
 }

package/modules/roomData/service.d.ts

@@ -1,4 +1,4 @@
-import { RoomDataService } from './types';
+import { RoomDataService, StoreAnalysisService } from './types';
 import BaseService from '../BaseService';
 declare class RoomDataServiceClass extends BaseService implements RoomDataService.BaseController {
     protected prefixUrl: string;
@@ -9,6 +9,10 @@ declare class RoomDataServiceClass extends BaseService implements RoomDataServic
     productSalesRanking(request: RoomDataService.Request.ProductSalesRanking): Promise<RoomDataService.Response.ProductSalesRanking>;
     getViewerCountForSales(request: RoomDataService.Request.GetViewerCountForSales): Promise<RoomDataService.Response.GetViewerCountForSales>;
     getDailyViewerCountForSales(request: RoomDataService.Request.GetDailyViewerCountForSales): Promise<RoomDataService.Response.GetDailyViewerCountForSales>;
+    getStoreAnalysisSummary(request: StoreAnalysisService.Request.Summary): Promise<StoreAnalysisService.Response.Summary>;
+    getStoreAnalysisList(request: StoreAnalysisService.Request.List): Promise<StoreAnalysisService.Response.List>;
+    getStoreAnalysisExportData(request: StoreAnalysisService.Request.Export): Promise<StoreAnalysisService.Response.Export>;
+    getStoreAnalysisProductList(request: StoreAnalysisService.Request.ProductList): Promise<StoreAnalysisService.Response.ProductList>;
 }
 export declare const roomDataService: RoomDataServiceClass;
 export default roomDataService;

package/modules/roomData/service.js

@@ -42,6 +42,19 @@ let RoomDataServiceClass = class RoomDataServiceClass extends BaseService_1.defa
     getDailyViewerCountForSales(request) {
         return (0, http_1.callApi)(this.getApiUrl(this.getDailyViewerCountForSales), request);
     }
+    // ---------- 门店分析（同 RoomDataController，路径 /room-data/get-store-analysis-*） ----------
+    getStoreAnalysisSummary(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getStoreAnalysisSummary), request);
+    }
+    getStoreAnalysisList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getStoreAnalysisList), request);
+    }
+    getStoreAnalysisExportData(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getStoreAnalysisExportData), request);
+    }
+    getStoreAnalysisProductList(request) {
+        return (0, http_1.callApi)(this.getApiUrl(this.getStoreAnalysisProductList), request);
+    }
 };
 __decorate([
     (0, tsoa_1.OperationId)('直播间列表接口（门店维度）'),
@@ -78,6 +91,26 @@ __decorate([
     (0, tsoa_1.Post)('get-daily-viewer-count-for-sales'),
     __param(0, (0, tsoa_1.Body)())
 ], RoomDataServiceClass.prototype, "getDailyViewerCountForSales", null);
+__decorate([
+    (0, tsoa_1.OperationId)('门店分析汇总'),
+    (0, tsoa_1.Post)('get-store-analysis-summary'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomDataServiceClass.prototype, "getStoreAnalysisSummary", null);
+__decorate([
+    (0, tsoa_1.OperationId)('门店分析列表'),
+    (0, tsoa_1.Post)('get-store-analysis-list'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomDataServiceClass.prototype, "getStoreAnalysisList", null);
+__decorate([
+    (0, tsoa_1.OperationId)('门店分析导出'),
+    (0, tsoa_1.Post)('get-store-analysis-export-data'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomDataServiceClass.prototype, "getStoreAnalysisExportData", null);
+__decorate([
+    (0, tsoa_1.OperationId)('门店商品数据'),
+    (0, tsoa_1.Post)('get-store-analysis-product-list'),
+    __param(0, (0, tsoa_1.Body)())
+], RoomDataServiceClass.prototype, "getStoreAnalysisProductList", null);
 RoomDataServiceClass = __decorate([
     (0, tsoa_1.Route)('room-data'),
     (0, tsoa_1.Tags)('RoomData')

package/modules/roomData/types.d.ts

@@ -161,3 +161,103 @@ export declare namespace RoomDataService {
         getDailyViewerCountForSales(request: Request.GetDailyViewerCountForSales, req?: FastifyRequest): Promise<Response.GetDailyViewerCountForSales>;
     }
 }
+/** 门店分析（接口挂在 room-data 下，与 RoomDataService 同模块） */
+export declare namespace StoreAnalysisService {
+    namespace Request {
+        interface Summary {
+            liveStreamRoomId: string;
+        }
+        interface List {
+            liveStreamRoomId: string;
+            storeIds?: string[];
+            province?: string;
+            city?: string;
+            area?: string;
+            pageIndex?: number;
+            pageSize?: number;
+            sortField?: 'viewerCount' | 'gmv' | 'actualAmount';
+            sortOrder?: 'asc' | 'desc';
+        }
+        interface Export {
+            liveStreamRoomId: string;
+            storeIds?: string[];
+            province?: string;
+            city?: string;
+            area?: string;
+            pageIndex?: number;
+            pageSize?: number;
+            sortField?: 'viewerCount' | 'gmv' | 'actualAmount';
+            sortOrder?: 'asc' | 'desc';
+        }
+        interface ProductList {
+            liveStreamRoomId: string;
+            storeId: string;
+            sortField?: 'actualAmount' | 'soldQuantity';
+            sortOrder?: 'asc' | 'desc';
+            pageIndex?: number;
+            pageSize?: number;
+        }
+        interface ProductExport {
+            liveStreamRoomId: string;
+            storeId: string;
+            sortField?: 'actualAmount' | 'soldQuantity';
+            sortOrder?: 'asc' | 'desc';
+            pageIndex?: number;
+            pageSize?: number;
+        }
+    }
+    namespace Response {
+        interface Summary {
+            totalViewerCount: number;
+            totalGmv: number;
+        }
+        interface StoreAnalysisItem {
+            storeId: string;
+            storeName: string;
+            storeAddress: string;
+            viewerCount: number;
+            orderUserCount: number;
+            gmv: number;
+            actualAmount: number;
+            uvValue: number;
+            orderCount: number;
+            avgOrderAmount: number;
+            refundGmv: number;
+            refundOrderCount: number;
+            conversionRate: number;
+        }
+        interface List {
+            list: StoreAnalysisItem[];
+            total: number;
+            pageIndex: number;
+            pageSize: number;
+        }
+        interface Export {
+            headers: string[];
+            data: (string | number)[][];
+        }
+        interface ProductItem {
+            productId: string;
+            productName: string;
+            actualAmount: number;
+            orderQuantity: number;
+            soldQuantity: number;
+            refundQuantity: number;
+            refundRate: number;
+            paySuccessRate: number;
+        }
+        interface ProductList {
+            list: ProductItem[];
+            total: number;
+            pageIndex: number;
+            pageSize: number;
+        }
+    }
+    interface BaseController {
+        getStoreAnalysisSummary(request: Request.Summary, req?: FastifyRequest): Promise<Response.Summary>;
+        getStoreAnalysisList(request: Request.List, req?: FastifyRequest): Promise<Response.List>;
+        getStoreAnalysisExportData(request: Request.Export, req?: FastifyRequest): Promise<Response.Export>;
+        getStoreAnalysisProductList(request: Request.ProductList, req?: FastifyRequest): Promise<Response.ProductList>;
+        getStoreAnalysisProductExportData(request: Request.ProductExport, req?: FastifyRequest): Promise<Response.Export>;
+    }
+}

package/package.json

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