@be-link/ecommerce-backend-bff-service-node-sdk 0.0.26 → 0.0.28

package/esm/bff/modules/pandora/store/types.d.ts

@@ -0,0 +1,628 @@
+/**
+ * Store Service 的类型定义
+ * 使用命名空间组织类型，与后端 SDK 保持一致
+ */
+export declare namespace Service {
+    /**
+     * 实体定义
+     */
+    namespace Entity {
+        /**
+         * 门店基础信息
+         */
+        interface StoreBasicInfo {
+            /** 门店id */
+            id: number;
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+            /** 删除时间 */
+            deletedAt: number;
+            /** 门店名称 */
+            storeName: string;
+            /** 省 */
+            province: string;
+            /** 市 */
+            city: string;
+            /** 区 */
+            area: string;
+            /** 详细地址 */
+            address: string;
+            /** 纬度 */
+            latitude: number;
+            /** 经度 */
+            longitude: number;
+            /** 联系电话 */
+            telephone: string;
+            /** 加盟商id */
+            franchiseeId: string;
+            /** BD 负责人 Pandora ID */
+            bdPandoraId: string;
+            /** 店长 Pandora ID */
+            storeManagerPandoraId: string;
+            /** 门店二维码 */
+            qrCodeState?: any;
+            /** 经营状态，0未绑定负责人，1营业中，2已打烊 */
+            businessStatus: number;
+            /** 商家合作类型:0, 未配置；1, 独立店；2, 店中店 */
+            merchantCooperationType: number;
+            /** 门店类型:0, 未配置；1, 自营；2, 加盟 */
+            storeType: number;
+            /** 门店承接类型：0-未配置，1-老店期承接，2-拉新期承接，3-开播后承接 */
+            storeUndertakingType: number;
+            /** 是否需要平台拉新：0, 未配置；1, 是；2, 否 */
+            isPlatformNewCustomerOperation: number;
+            /** 拉新时间 毫秒级时间戳 */
+            newCustomerTime: number;
+            /** 最新活动时间 毫秒级时间戳 */
+            latestActiveTime: number;
+        }
+        /**
+         * 门店结算信息
+         */
+        interface StoreSettlement {
+            /** 结算信息id */
+            id: number;
+            /** 门店ID */
+            storeId: number;
+            /** 工作机 uid，工作机手机号和授权手机号做系统匹配 */
+            workPhoneUid: string;
+            /** 结算分佣比例 */
+            settlementCommissionRate?: any;
+            /** 直播时间 毫秒级时间戳 */
+            liveTime: number;
+            /** 免润期(天) */
+            gracePeriod: number;
+            /** 工作机企微 id，系统匹配 */
+            workPhoneWxCorpId: string;
+        }
+        /**
+         * 门店仓配信息
+         */
+        interface StoreWarehouseDelivery {
+            /** 仓配信息id */
+            id: number;
+            /** 门店ID */
+            storeId: number;
+            /** 收货紧急联系人姓名 */
+            emergencyContactName: string;
+            /** 收货紧急联系人手机号 */
+            emergencyContactPhone: string;
+            /** 仓配时间：白配、夜配 */
+            warehouseDeliveryTime: number;
+            /** 须知 */
+            remark: string;
+            /** 营业时间，时间格式，手动录入 */
+            businessHours?: any;
+            /** 门店打烊时间;{loop: [mon,tue,wed,thu,fri,sat,sun]},{once: [[1758556800000, 1758643200000]]} */
+            closingHour?: any;
+        }
+        /**
+         * 完整门店信息（包含基础、结算、仓配信息）
+         */
+        interface StoreFullInfo extends StoreBasicInfo {
+            settlement?: StoreSettlement;
+            warehouseDelivery?: StoreWarehouseDelivery;
+        }
+        /**
+         * 门店分组信息
+         */
+        interface StoreGroup {
+            /** 分组ID */
+            groupId: string;
+            /** 分组名称 */
+            groupName: string;
+            /** 门店ID列表 */
+            storeIds: string[];
+            /** 创建时间 */
+            createdAt: number;
+            /** 更新时间 */
+            updatedAt: number;
+        }
+    }
+    /**
+     * 查询块定义
+     */
+    namespace QueryBlock {
+        /**
+         * 门店基础信息查询块
+         */
+        interface BasicInfo {
+            /** 门店名称（模糊搜索） */
+            storeName?: string;
+            /** 门店微赞ID */
+            storeId?: number;
+            /** 省 */
+            province?: string;
+            /** 市 */
+            city?: string;
+            /** 区 */
+            area?: string;
+            /** 加盟商ID列表 */
+            franchiseeIds?: string[];
+            /** 是否绑定加盟商 */
+            hasFranchisee?: boolean;
+            /** BD 负责人 Pandora ID 列表 */
+            bdPandoraIds?: string[];
+            /** 店长 Pandora ID */
+            storeManagerPandoraId?: string;
+            /** 经营状态：0-未绑定负责人，1-营业中，2-已打烊 */
+            businessStatus?: number;
+            /** 商家合作类型：0-未配置，1-独立店，2-店中店 */
+            merchantCooperationType?: number;
+            /** 门店类型：0-未配置，1-自营，2-加盟 */
+            storeType?: number;
+            /** 门店承接类型：0-未配置，1-老店期承接，2-拉新期承接，3-开播后承接 */
+            storeUndertakingType?: number;
+            /** 是否需要平台拉新：0-未配置，1-是，2-否 */
+            isPlatformNewCustomerOperation?: number;
+        }
+        /**
+         * 门店结算信息查询块
+         */
+        interface Settlement {
+            /** 直播时间（开始时间，毫秒级时间戳） */
+            liveTimeStart?: number;
+            /** 直播时间（结束时间，毫秒级时间戳） */
+            liveTimeEnd?: number;
+        }
+        /**
+         * 门店仓配信息查询块
+         */
+        interface WarehouseDelivery {
+            /** 仓配时间：白配、夜配 */
+            warehouseDeliveryTime?: number;
+        }
+    }
+    /**
+     * 响应块类型枚举
+     */
+    namespace ResponseBlock {
+        enum BlockType {
+            /** 门店基础信息表 */
+            BASIC_INFO = "BASIC_INFO",
+            /** 门店结算信息表 */
+            SETTLEMENT = "SETTLEMENT",
+            /** 门店仓配信息表 */
+            WAREHOUSE_DELIVERY = "WAREHOUSE_DELIVERY"
+        }
+    }
+    /**
+     * 请求参数定义
+     */
+    namespace Request {
+        /**
+         * 创建门店请求
+         */
+        interface createStore {
+            /** 门店基础信息 */
+            basicInfo: {
+                /** 门店名称 */
+                storeName: string;
+                /** 省 */
+                province: string;
+                /** 市 */
+                city: string;
+                /** 区 */
+                area: string;
+                /** 详细地址 */
+                address: string;
+                /** 纬度（地图选点） */
+                latitude: number;
+                /** 经度（地图选点） */
+                longitude: number;
+            };
+            /** 门店结算信息 */
+            settlementInfo?: {
+                /** 工作机 uid */
+                workPhoneUid?: string;
+                /** 工作机企微 id */
+                workPhoneWxCorpId?: string;
+                /** 结算分佣比例 */
+                settlementCommissionRate?: any;
+                /** 直播时间 毫秒级时间戳 */
+                liveTime?: number;
+                /** 免润期(天) */
+                gracePeriod?: number;
+            };
+            /** 门店仓配信息 */
+            warehouseDeliveryInfo?: {
+                /** 收货紧急联系人姓名 */
+                emergencyContactName?: string;
+                /** 收货紧急联系人手机号 */
+                emergencyContactPhone?: string;
+                /** 仓配时间：白配、夜配 */
+                warehouseDeliveryTime?: number;
+                /** 须知 */
+                remark?: string;
+                /** 营业时间 */
+                businessHours?: any;
+                /** 门店打烊时间 */
+                closingHour?: any;
+            };
+        }
+        /**
+         * 编辑门店信息请求
+         */
+        interface updateStoreInfo {
+            /** 门店id */
+            storeId: number;
+            /** 门店基础信息 */
+            basicInfo?: {
+                /** 经营状态 */
+                businessStatus?: number;
+                /** 商家合作类型 */
+                merchantCooperationType?: number;
+                /** 门店类型 */
+                storeType?: number;
+                /** 是否需要平台拉新 */
+                isPlatformNewCustomerOperation?: number;
+            };
+            /** 门店地址信息 */
+            addressInfo?: {
+                /** 省 */
+                province?: string;
+                /** 市 */
+                city?: string;
+                /** 区 */
+                area?: string;
+                /** 详细地址 */
+                address?: string;
+                /** 纬度（地图选点） */
+                latitude?: number;
+                /** 经度（地图选点） */
+                longitude?: number;
+            };
+            /** 门店结算信息 */
+            settlementInfo?: {
+                /** 工作机 uid */
+                workPhoneUid?: string;
+                /** 工作机企微 id */
+                workPhoneWxCorpId?: string;
+                /** 结算分佣比例 */
+                settlementCommissionRate?: any;
+                /** 直播时间 毫秒级时间戳 */
+                liveTime?: number;
+                /** 免润期(天) */
+                gracePeriod?: number;
+            };
+            /** 门店仓配信息 */
+            warehouseDeliveryInfo?: {
+                /** 收货紧急联系人姓名 */
+                emergencyContactName?: string;
+                /** 收货紧急联系人手机号 */
+                emergencyContactPhone?: string;
+                /** 仓配时间：白配、夜配 */
+                warehouseDeliveryTime?: number;
+                /** 须知 */
+                remark?: string;
+                /** 营业时间 */
+                businessHours?: any;
+                /** 门店打烊时间 */
+                closingHour?: any;
+            };
+        }
+        /**
+         * 获取门店详情请求
+         */
+        interface getStoreDetail {
+            /** 门店id */
+            storeId: number;
+        }
+        /**
+         * 获取门店列表请求
+         */
+        interface getStoreList {
+            /** 页码 */
+            page?: number;
+            /** 每页数量 */
+            pageSize?: number;
+            /** 门店基础信息查询块 */
+            basicInfoQuery?: QueryBlock.BasicInfo;
+            /** 门店结算信息查询块 */
+            settlementQuery?: QueryBlock.Settlement;
+            /** 门店仓配信息查询块 */
+            warehouseDeliveryQuery?: QueryBlock.WarehouseDelivery;
+            /** 需要返回的响应块（数据表）列表 */
+            responseBlocks?: ResponseBlock.BlockType[];
+        }
+        /**
+         * 批量修改门店经营状态请求
+         */
+        interface batchUpdateBusinessStatus {
+            /** 门店ID列表 */
+            storeIds: number[];
+            /** 经营状态：0-未绑定负责人，1-营业中，2-已打烊 */
+            businessStatus: number;
+        }
+        /**
+         * 绑定用户到门店请求（批量）
+         */
+        interface bindUserToStore {
+            /** 门店id */
+            storeId: number;
+            /** 用户 Pandora ID 列表 */
+            userPandoraIds: string[];
+            /** 操作者 Pandora ID */
+            operatorPandoraId: string;
+        }
+        /**
+         * 解绑用户请求（批量）
+         */
+        interface unbindUserFromStore {
+            /** 门店id */
+            storeId: number;
+            /** 用户 Pandora ID 列表 */
+            userPandoraIds: string[];
+            /** 操作者 Pandora ID */
+            operatorPandoraId: string;
+        }
+        /**
+         * 创建门店分组请求
+         */
+        interface createStoreGroup {
+            /** 分组名称 */
+            groupName: string;
+            /** 门店ID列表 */
+            storeIds: string[];
+        }
+        /**
+         * 编辑门店分组请求
+         */
+        interface editStoreGroup {
+            /** 分组ID */
+            groupId: string;
+            /** 分组名称 */
+            groupName: string;
+            /** 门店ID列表 */
+            storeIds: string[];
+        }
+        /**
+         * 删除门店分组请求
+         */
+        interface deleteStoreGroup {
+            /** 分组ID */
+            groupId: string;
+        }
+        /**
+         * 查询门店分组列表请求
+         */
+        interface getStoreGroupList {
+            /** 页码 */
+            page?: number;
+            /** 每页数量 */
+            pageSize?: number;
+            /** 分组名称（模糊搜索） */
+            groupName?: string;
+        }
+    }
+    /**
+     * 响应数据定义
+     */
+    namespace Response {
+        /**
+         * 创建门店响应
+         */
+        interface createStore {
+            /** 门店id */
+            storeId: number;
+            /** 门店信息 */
+            store: Entity.StoreBasicInfo;
+            /** 门店二维码（系统生成） */
+            qrCodeState: any;
+        }
+        /**
+         * 编辑门店信息响应
+         */
+        interface updateStoreInfo {
+            /** 是否成功 */
+            success: boolean;
+            /** 更新后的门店完整信息 */
+            store?: Entity.StoreFullInfo;
+        }
+        /**
+         * 获取门店详情响应
+         */
+        interface getStoreDetail {
+            /** 门店完整信息 */
+            store: Entity.StoreFullInfo;
+        }
+        /**
+         * 获取门店列表响应
+         */
+        interface getStoreList {
+            /** 门店列表 */
+            stores: Array<{
+                /** 门店ID */
+                storeId: number;
+                /** 门店基础信息（如果请求了该块） */
+                basicInfo?: Entity.StoreBasicInfo;
+                /** 门店结算信息（如果请求了该块） */
+                settlement?: Entity.StoreSettlement;
+                /** 门店仓配信息（如果请求了该块） */
+                warehouseDelivery?: Entity.StoreWarehouseDelivery;
+            }>;
+            /** 总数 */
+            total: number;
+            /** 当前页 */
+            page: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+        /**
+         * 批量修改门店经营状态响应
+         */
+        interface batchUpdateBusinessStatus {
+            /** 是否成功 */
+            success: boolean;
+            /** 成功更新的门店ID列表 */
+            updatedStoreIds: number[];
+            /** 失败的门店列表 */
+            failedStores?: Array<{
+                /** 门店ID */
+                storeId: number;
+                /** 失败原因 */
+                reason: string;
+            }>;
+        }
+        /**
+         * 绑定用户到门店响应（批量）
+         */
+        interface bindUserToStore {
+            /** 是否成功 */
+            success: boolean;
+            /** 成功绑定的关系列表 */
+            relations: Array<{
+                /** 用户 Pandora ID */
+                userPandoraId: string;
+                /** 关系id */
+                relationId: string;
+            }>;
+            /** 失败的用户列表 */
+            failedUsers?: Array<{
+                /** 用户 Pandora ID */
+                userPandoraId: string;
+                /** 失败原因 */
+                reason: string;
+            }>;
+        }
+        /**
+         * 解绑用户响应（批量）
+         */
+        interface unbindUserFromStore {
+            /** 是否成功 */
+            success: boolean;
+            /** 成功解绑的用户 Pandora ID 列表 */
+            unboundUserIds: string[];
+            /** 失败的用户列表 */
+            failedUsers?: Array<{
+                /** 用户 Pandora ID */
+                userPandoraId: string;
+                /** 失败原因 */
+                reason: string;
+            }>;
+        }
+        /**
+         * 创建门店分组响应
+         */
+        interface createStoreGroup {
+            /** 分组ID */
+            groupId: string;
+            /** 分组信息 */
+            group: Entity.StoreGroup;
+        }
+        /**
+         * 编辑门店分组响应
+         */
+        interface editStoreGroup {
+            /** 是否成功 */
+            success: boolean;
+            /** 更新后的分组信息 */
+            group: Entity.StoreGroup;
+        }
+        /**
+         * 删除门店分组响应
+         */
+        interface deleteStoreGroup {
+            /** 是否成功 */
+            success: boolean;
+        }
+        /**
+         * 查询门店分组列表响应
+         */
+        interface getStoreGroupList {
+            /** 分组列表 */
+            groups: Entity.StoreGroup[];
+            /** 总数 */
+            total: number;
+            /** 当前页 */
+            page: number;
+            /** 每页数量 */
+            pageSize: number;
+        }
+    }
+    /**
+     * Store Controller 接口定义
+     * 用于后端 Server 实现
+     */
+    interface StoreController {
+        /**
+         * 创建门店
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        createStore(request: Service.Request.createStore, req: any): Promise<Service.Response.createStore>;
+        /**
+         * 编辑门店信息
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        updateStoreInfo(request: Service.Request.updateStoreInfo, req: any): Promise<Service.Response.updateStoreInfo>;
+        /**
+         * 获取门店详情
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        getStoreDetail(request: Service.Request.getStoreDetail, req: any): Promise<Service.Response.getStoreDetail>;
+        /**
+         * 获取门店列表
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        getStoreList(request: Service.Request.getStoreList, req: any): Promise<Service.Response.getStoreList>;
+        /**
+         * 批量修改门店经营状态
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        batchUpdateBusinessStatus(request: Service.Request.batchUpdateBusinessStatus, req: any): Promise<Service.Response.batchUpdateBusinessStatus>;
+        /**
+         * 绑定用户到门店
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        bindUserToStore(request: Service.Request.bindUserToStore, req: any): Promise<Service.Response.bindUserToStore>;
+        /**
+         * 解绑用户
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        unbindUserFromStore(request: Service.Request.unbindUserFromStore, req: any): Promise<Service.Response.unbindUserFromStore>;
+        /**
+         * 创建门店分组
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        createStoreGroup(request: Service.Request.createStoreGroup, req: any): Promise<Service.Response.createStoreGroup>;
+        /**
+         * 编辑门店分组
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        editStoreGroup(request: Service.Request.editStoreGroup, req: any): Promise<Service.Response.editStoreGroup>;
+        /**
+         * 删除门店分组
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        deleteStoreGroup(request: Service.Request.deleteStoreGroup, req: any): Promise<Service.Response.deleteStoreGroup>;
+        /**
+         * 查询门店分组列表
+         * @param request 请求参数
+         * @param req 请求上下文
+         * @returns 响应数据
+         */
+        getStoreGroupList(request: Service.Request.getStoreGroupList, req: any): Promise<Service.Response.getStoreGroupList>;
+    }
+}

package/esm/bff/modules/pandora/store/types.mjs

@@ -0,0 +1,22 @@
+/**
+ * Store Service 的类型定义
+ * 使用命名空间组织类型，与后端 SDK 保持一致
+ */
+export var Service;
+(function (Service) {
+    /**
+     * 响应块类型枚举
+     */
+    let ResponseBlock;
+    (function (ResponseBlock) {
+        let BlockType;
+        (function (BlockType) {
+            /** 门店基础信息表 */
+            BlockType["BASIC_INFO"] = "BASIC_INFO";
+            /** 门店结算信息表 */
+            BlockType["SETTLEMENT"] = "SETTLEMENT";
+            /** 门店仓配信息表 */
+            BlockType["WAREHOUSE_DELIVERY"] = "WAREHOUSE_DELIVERY";
+        })(BlockType = ResponseBlock.BlockType || (ResponseBlock.BlockType = {}));
+    })(ResponseBlock = Service.ResponseBlock || (Service.ResponseBlock = {}));
+})(Service || (Service = {}));

package/esm/bff/modules/pandora/storeSelection/service.d.ts

@@ -0,0 +1,47 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * PandoraStoreSelectionService - Pandora 圈选门店服务模块
+ * 提供商品圈门店 / 直播间圈门店相关的 API 方法
+ * 平台: pandora
+ */
+export declare class PandoraStoreSelectionService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 创建标签分组（业务关系类型）
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    createTagGroup(request: Service.Request.createTagGroup): Promise<StandardResponse<Service.Response.createTagGroup>>;
+    /**
+     * 创建标签
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    createTag(request: Service.Request.createTag): Promise<StandardResponse<Service.Response.createTag>>;
+    /**
+     * 批量创建业务关系（圈选门店）
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    batchCreateBizRelation(request: Service.Request.batchCreateBizRelation): Promise<StandardResponse<Service.Response.batchCreateBizRelation>>;
+    /**
+     * 批量删除业务关系（取消圈选门店）
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    batchDeleteBizRelation(request: Service.Request.batchDeleteBizRelation): Promise<StandardResponse<Service.Response.batchDeleteBizRelation>>;
+    /**
+     * 根据标签分组和关联主体查询关联对象（查询商品/直播间圈选的门店）
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    queryRelatedByGroupAndSubject(request: Service.Request.queryRelatedByGroupAndSubject): Promise<StandardResponse<Service.Response.queryRelatedByGroupAndSubject>>;
+    /**
+     * 根据标签分组和关联对象查询关联主体（查询门店关联的商品/直播间）
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    querySubjectsByGroupAndRelated(request: Service.Request.querySubjectsByGroupAndRelated): Promise<StandardResponse<Service.Response.querySubjectsByGroupAndRelated>>;
+}