@be-link/ecommerce-backend-bff-service-node-sdk 0.0.12 → 0.0.13

package/cjs/bff/modules/pandora/store/service.d.ts

@@ -0,0 +1,53 @@
+import { Service } from './types';
+import BaseService from '../../BaseService';
+import type { StandardResponse } from '../../../../types';
+/**
+ * PandoraStoreService - Pandora Store 服务模块
+ * 提供门店管理相关的 API 方法
+ * 平台: pandora
+ */
+export declare class PandoraStoreService extends BaseService {
+    protected prefixUrl: string;
+    /**
+     * 创建门店
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    createStore(request: Service.Request.createStore): Promise<StandardResponse<Service.Response.createStore>>;
+    /**
+     * 编辑门店信息
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateStoreInfo(request: Service.Request.updateStoreInfo): Promise<StandardResponse<Service.Response.updateStoreInfo>>;
+    /**
+     * 获取门店详情
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getStoreDetail(request: Service.Request.getStoreDetail): Promise<StandardResponse<Service.Response.getStoreDetail>>;
+    /**
+     * 获取门店列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getStoreList(request: Service.Request.getStoreList): Promise<StandardResponse<Service.Response.getStoreList>>;
+    /**
+     * 批量修改门店经营状态
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    batchUpdateBusinessStatus(request: Service.Request.batchUpdateBusinessStatus): Promise<StandardResponse<Service.Response.batchUpdateBusinessStatus>>;
+    /**
+     * 绑定用户到门店
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    bindUserToStore(request: Service.Request.bindUserToStore): Promise<StandardResponse<Service.Response.bindUserToStore>>;
+    /**
+     * 解绑用户
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    unbindUserFromStore(request: Service.Request.unbindUserFromStore): Promise<StandardResponse<Service.Response.unbindUserFromStore>>;
+}

package/cjs/bff/modules/pandora/store/service.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PandoraStoreService = void 0;
+const BaseService_1 = __importDefault(require("../../BaseService"));
+/**
+ * PandoraStoreService - Pandora Store 服务模块
+ * 提供门店管理相关的 API 方法
+ * 平台: pandora
+ */
+class PandoraStoreService extends BaseService_1.default {
+    constructor() {
+        super(...arguments);
+        this.prefixUrl = '/pandora/store';
+    }
+    /**
+     * 创建门店
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    createStore(request) {
+        return this.request(this.createStore, request);
+    }
+    /**
+     * 编辑门店信息
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    updateStoreInfo(request) {
+        return this.request(this.updateStoreInfo, request);
+    }
+    /**
+     * 获取门店详情
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getStoreDetail(request) {
+        return this.request(this.getStoreDetail, request);
+    }
+    /**
+     * 获取门店列表
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    getStoreList(request) {
+        return this.request(this.getStoreList, request);
+    }
+    /**
+     * 批量修改门店经营状态
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    batchUpdateBusinessStatus(request) {
+        return this.request(this.batchUpdateBusinessStatus, request);
+    }
+    /**
+     * 绑定用户到门店
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    bindUserToStore(request) {
+        return this.request(this.bindUserToStore, request);
+    }
+    /**
+     * 解绑用户
+     * @param request - 请求参数
+     * @returns Promise，解析为标准响应格式
+     */
+    unbindUserFromStore(request) {
+        return this.request(this.unbindUserFromStore, request);
+    }
+}
+exports.PandoraStoreService = PandoraStoreService;

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

@@ -0,0 +1,509 @@
+/**
+ * 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;
+        }
+    }
+    /**
+     * 查询块定义
+     */
+    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;
+        }
+    }
+    /**
+     * 响应数据定义
+     */
+    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;
+            }>;
+        }
+    }
+    /**
+     * 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>;
+    }
+}

package/cjs/bff/modules/pandora/store/types.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Service = void 0;
+/**
+ * Store Service 的类型定义
+ * 使用命名空间组织类型，与后端 SDK 保持一致
+ */
+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 || (exports.Service = Service = {}));