Shopizer多商户系统配置：支持多店铺管理的完整教程

Shopizer是一个基于Java的开源电子商务软件，提供无头商务和REST API，支持构建现代化的电子商务平台。本教程将详细介绍如何配置Shopizer多商户系统，实现多店铺管理功能，帮助商家轻松搭建和管理多个独立店铺。

一、多商户系统核心概念

Shopizer的多商户系统基于MerchantStore模型实现，每个商户店铺拥有独立的配置、商品、订单和用户数据。核心类包括：

• MerchantStore：存储店铺基本信息，如名称、URL、联系人等
• ReadableMerchantStore：店铺信息读取模型
• PersistableMerchantStore：店铺信息持久化模型

相关实现可查看：sm-shop-model/src/main/java/com/salesmanager/shop/model/store/MerchantStoreEntity.java

二、快速搭建多商户环境

2.1 环境准备

1. 克隆项目代码库：

git clone https://gitcode.com/gh_mirrors/sh/shopizer

2. 确保系统已安装：

• JDK 11+
• Maven 3.6+
• MySQL 8.0+

2.2 配置多商户支持

Shopizer的多商户功能默认已集成，主要配置文件位于：

• 核心配置：sm-core/src/main/java/com/salesmanager/core/business/configuration/CoreApplicationConfiguration.java
• 数据配置：sm-core/src/main/java/com/salesmanager/core/business/configuration/DataConfiguration.java

三、创建和管理商户店铺

3.1 创建新店铺

通过API创建新店铺的示例代码：

PersistableMerchantStore createdStore = new PersistableMerchantStore();
createdStore.setCode("STORE001");
createdStore.setName("My New Store");
createdStore.setUrl("https://mystore.example.com");
// 设置其他店铺信息...

// 调用创建店铺API
ResponseEntity<Void> createResponse = restTemplate.exchange(
    "/api/v1/private/store/" + MerchantStore.DEFAULT_STORE,
    HttpMethod.POST,
    new HttpEntity<>(createdStore, headers),
    Void.class
);

详细实现可参考测试类：sm-shop/src/test/java/com/salesmanager/test/shop/integration/store/MerchantStoreApiIntegrationTest.java

3.2 店铺信息管理

Shopizer提供完整的店铺管理功能，包括：

• 更新店铺信息
• 配置店铺logo
• 设置配送方式
• 管理支付选项

相关API接口位于：sm-shop/src/main/java/com/salesmanager/shop/store/api/v1/目录下的店铺管理控制器。

四、多店铺数据隔离

Shopizer通过MerchantStore参数实现数据隔离，所有核心服务都需要传入店铺标识：

// 获取指定店铺的商品列表
ReadableProductList listItemsByManufacturer(
    MerchantStore store, 
    Language language, 
    Long manufacturerId, 
    int startCount, 
    int maxCount
) throws Exception;

示例代码来自：sm-shop-model/src/main/java/com/salesmanager/shop/store/controller/items/facade/ProductItemsFacade.java

五、店铺个性化配置

5.1 配送配置

每个店铺可独立配置配送方式和区域：

// 获取店铺配送配置
ExpeditionConfiguration getExpeditionConfiguration(MerchantStore store, Language language);

// 保存店铺配送配置
void saveExpeditionConfiguration(ExpeditionConfiguration expedition, MerchantStore store);

实现类：sm-shop-model/src/main/java/com/salesmanager/shop/store/controller/shipping/facade/ShippingFacade.java

5.2 用户权限管理

多店铺环境下的用户权限控制：

// 验证用户是否有权限访问店铺
boolean authorizeStore(MerchantStore store, String path);

实现类：sm-shop-model/src/main/java/com/salesmanager/shop/store/controller/user/facade/UserFacade.java

六、常见问题解决

6.1 店铺数据冲突

确保所有数据库查询都包含MerchantStore条件，避免店铺间数据混淆。

6.2 跨店铺访问控制

使用authorizeStore方法验证用户对店铺的访问权限，实现代码位于用户管理模块。

6.3 店铺配置备份

定期备份店铺配置数据，相关配置文件位于sm-shop/files/store/目录。

七、总结

Shopizer的多商户系统通过MerchantStore模型提供了强大的多店铺管理能力，支持店铺独立配置、数据隔离和权限控制。通过本教程的配置指南，您可以快速搭建起支持多商户的电子商务平台，满足不同商家的个性化需求。

要深入了解更多功能，可查阅项目中的测试用例和API文档，开始您的多商户电商平台之旅吧！ 🚀