# 三勾springcloud微信小程序商城多商户商城系统

**Repository Path**: victor123/multicloud

## Basic Information

- **Project Name**: 三勾springcloud微信小程序商城多商户商城系统
- **Description**: 三勾商城是开发友好的微信小程序商城，框架支持SAAS，支持发布 iOS+Android+公众号+H5+各种小程序（微信/支付宝/百度/头条/QQ/钉钉/淘宝）等多个平台，不可多得的二开神器， 为大中小企业提供极致的移动电子商务解决方案。技术架构：java+springboot+springcloud+ uniapp +element-ui+vue3。【分销商城，小程序直播，B2B2C，S2B2C，商城源码】
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://www.jjjshop.net
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 20
- **Created**: 2025-06-11
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 三勾多商户商城系统 Cloud 版

**面向开发、二开友好的开源SAAS电商系统**

三勾多商户商城基于 Spring Boot + Spring Cloud + Element Plus + uni-app 打造的面向开发的SAAS商城系统，支持多商户入驻，方便二次开发或直接使用，可发布到多端，包括微信小程序、微信公众号、QQ小程序、支付宝小程序、字节跳动小程序、百度小程序、H5、Android端、iOS端。

---

## 项目简介

三勾多商户商城是一套完整的SAAS多商户电商解决方案，支持商户入驻、平台管理、供应商管理等功能，提供从商品管理、订单处理、会员营销到数据统计的全流程业务能力。系统分为后端服务（jjj_shop_multi_cloud）、平台管理端（jjj_shop_multi_cloud_admin）、店铺端（jjj_shop_multi_cloud_shop）、供应商端（jjj_shop_multi_cloud_supplier）、移动端（jjj_shop_multi_cloud_app）五个部分。

## 项目特色

- **SAAS架构**：支持多商户入驻，平台统一管理，商户独立运营
- **微服务架构**：基于 Spring Cloud Alibaba，支持单体和微服务两种部署模式
- **前后分离**：开发更清晰、分工更明确、提升开发效率
- **Element Plus**：基于饿了么团队 UI 库、用户体验超棒
- **Spring Cloud**：国内流行的微服务框架、结构代码清晰
- **极易二开**：代码结构清晰、快速开发应用
- **多平台支持**：微信小程序、H5、微信公众号、支付宝小程序、App 打包，开发不浪费
- **开发规范**：前后端高度一致的权限控制、实现项目规范
- **多端分离**：平台管理（admin）、店铺管理（shop）、供应商管理（supplier）、移动端（app）独立开发，共用后端服务
- **模块化设计**：后端采用 Maven 多模块架构，各业务模块职责清晰，易于扩展

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端框架 | Java 17 + Spring Boot 3.1.5 |
| 微服务框架 | Spring Cloud 2022.0.4 + Spring Cloud Alibaba 2022.0.0.0 |
| 服务注册与发现 | Nacos 2.0.4 |
| 服务网关 | Spring Cloud Gateway |
| 分布式事务 | Seata 2.0.0 |
| ORM 框架 | MyBatis-Plus 3.5.3.2 |
| 权限框架 | Shiro 1.12.0 + JWT 3.11.0 |
| 缓存 | Redis + Redisson 3.22.0 |
| 构建工具 | Maven 多模块 |
| 数据库 | MySQL 5.7+ / 8.0+ |
| 平台管理端前端 | Vue 3 + Vite + Element Plus + Pinia |
| 店铺端前端 | Vue 3 + Vite + Element Plus + Pinia |
| 供应商端前端 | Vue 3 + Vite + Element Plus + Pinia |
| 移动端前端 | uni-app + Vue 3（支持微信小程序、H5、多端发布） |
| 微信集成 | weixin-java-sdk 4.7.2.B |
| 支付集成 | 微信支付、支付宝支付 4.40.104.ALL |
| 云存储 | 七牛云 / 阿里云 OSS / 腾讯云 COS / 华为云 OBS / Minio |
| 文档工具 | Knife4j 4.4.0（Swagger UI 增强版） |
| 定时任务 | XXL-Job 2.4.1 |
| 监控工具 | Spring Boot Admin |

## 项目源码

| 项目目录 | 说明 | 开发工具 | 核心技术 |
|---------|------|---------|---------|
| db | 数据库脚本 | MySQL 5.7、MySQL 8.0 | - |
| jjj_shop_multi_cloud | Java 后端（微服务） | IntelliJ IDEA | Spring Boot 3.1.5 + Spring Cloud |
| jjj_shop_multi_cloud_admin | 平台管理端 | HBuilderX、VSCode 等 JS 开发工具 | Vue 3、Element Plus |
| jjj_shop_multi_cloud_shop | 店铺端管理后台 | HBuilderX、VSCode 等 JS 开发工具 | Vue 3、Element Plus |
| jjj_shop_multi_cloud_supplier | 供应商端管理后台 | HBuilderX、VSCode 等 JS 开发工具 | Vue 3、Element Plus |
| jjj_shop_multi_cloud_app | 移动端 | HBuilderX | Vue 3、uni-app |

## 后端架构

### 模块划分

后端采用 Maven 多模块架构，支持单体和微服务两种部署模式：

```
jjj_shop_multi_cloud/
├── jjj-boot-base-core/         # 核心基础模块
│   ├── common/                 #   公共工具类
│   ├── entity/                 #   数据库实体（MyBatis-Plus）
│   ├── mapper/                 #   Mapper 接口
│   ├── service/                #   Service 接口和实现
│   ├── enums/                  #   业务枚举
│   └── util/                   #   工具类
├── jjj-module-system/          # 系统业务模块
│   ├── jjj-system-admin/       #   平台管理端 API（平台运营）
│   │   └── controller/         #     平台管理端接口（/api/admin/*）
│   ├── jjj-system-shop/        #   店铺端 API（商家管理）
│   │   └── controller/         #     店铺端接口（/api/shop/*）
│   ├── jjj-system-supplier/    #   供应商端 API（供应商管理）
│   │   └── controller/         #     供应商端接口（/api/supplier/*）
│   ├── jjj-system-front/       #   移动端 API（用户端）
│   │   └── controller/         #     移动端接口（/api/front/*）
│   ├── jjj-system-job/         #   定时任务模块
│   ├── jjj-system-start/       #   单体启动模块
│   ├── jjj-system-api/         #   API 接口定义
│   │   ├── jjj-system-local-api/   #   单体模式 API
│   │   └── jjj-system-cloud-api/   #   微服务模式 API
│   └── generator/              #   代码生成器
└── jjj-server-cloud/           # 微服务模块（仅微服务模式）
    ├── jjj-cloud-gateway/      #   网关服务
    ├── jjj-system-cloud-start/ #   系统服务启动
    └── jjj-visual/             #   可视化监控
        ├── jjj-cloud-monitor/  #     Spring Boot Admin 监控
        ├── jjj-cloud-sentinel/ #     Sentinel 控制台
        └── jjj-cloud-xxljob/   #     XXL-Job 调度中心
```

关键设计：
- 四端（admin/shop/supplier/front）共用同一套 Entity、Mapper、Service
- 通过不同的 Controller 层实现接口隔离和权限控制
- 公共业务逻辑统一在 jjj-boot-base-core 模块维护
- 支持单体和微服务两种部署模式，通过 Maven Profile 切换

### 核心能力

| 能力 | 实现 |
|------|------|
| 统一返回格式 | `ApiResult<T>` 封装 code/message/data |
| 认证鉴权 | Shiro + JWT（token 签发/校验/刷新） |
| 参数校验 | Hibernate Validator + 自定义校验器 |
| XSS 防护 | XSS 过滤器 |
| 文件上传 | 工厂模式，支持本地/七牛云/阿里云/腾讯云/华为云/Minio |
| 分页查询 | MyBatis-Plus 分页插件 |
| 全局异常 | 统一异常处理 |
| 操作日志 | AOP 切面自动记录 |
| 定时任务 | XXL-Job 分布式任务调度 |
| 接口文档 | Knife4j 可视化接口文档 |
| 微信支付 | 微信小程序支付、微信公众号支付 |
| 支付宝支付 | 支付宝小程序支付、支付宝H5支付 |
| 物流查询 | 快递100 物流查询接口 |
| 打印功能 | 小票打印、订单打印 |
| 服务注册 | Nacos 服务注册与发现 |
| 配置中心 | Nacos 统一配置管理 |
| 服务网关 | Gateway 统一网关路由 |
| 分布式事务 | Seata 分布式事务解决方案 |
| 分布式锁 | Redisson 分布式锁 |

### 多端 API 隔离

后端通过 URL 前缀区分不同端的 API：

| 端 | URL 前缀 | 对应模块 | 认证方式 |
|----|---------|---------|---------|
| 平台管理端 | `/api/admin/` | `jjj-system-admin` | Header Token |
| 店铺端 | `/api/shop/` | `jjj-system-shop` | Header Token |
| 供应商端 | `/api/supplier/` | `jjj-system-supplier` | Header Token |
| 移动端 | `/api/front/` | `jjj-system-front` | app_id + Token |

**单体模式**：默认端口 `8889`  
**微服务模式**：网关端口 `8888`，系统服务端口 `8889`

## 项目结构

```
根目录
├── jjj_shop_multi_cloud/                 # 后端 Java 源码
│   ├── jjj-boot-base-core/               #   核心基础模块（Entity/Mapper/Service）
│   ├── jjj-module-system/                #   系统业务模块
│   │   ├── jjj-system-admin/             #     平台管理端 API
│   │   ├── jjj-system-shop/              #     店铺端 API
│   │   ├── jjj-system-supplier/          #     供应商端 API
│   │   ├── jjj-system-front/             #     移动端 API
│   │   ├── jjj-system-job/               #     定时任务
│   │   ├── jjj-system-start/             #     单体启动模块
│   │   ├── jjj-system-api/               #     API 接口定义
│   │   └── generator/                    #     代码生成器
│   └── jjj-server-cloud/                 #   微服务模块
│       ├── jjj-cloud-gateway/            #     网关服务
│       ├── jjj-system-cloud-start/       #     系统服务启动
│       └── jjj-visual/                   #     可视化监控
├── jjj_shop_multi_cloud_admin/           # 平台管理端前端（Vue 3）
├── jjj_shop_multi_cloud_shop/            # 店铺端前端（Vue 3）
├── jjj_shop_multi_cloud_supplier/        # 供应商端前端（Vue 3）
├── jjj_shop_multi_cloud_app/             # 移动端前端（uni-app）
└── db/                                   # 数据库脚本
```

## 功能模块

### 平台管理端（jjj_shop_multi_cloud_admin）

面向平台超级管理员使用，管理整个SAAS平台。

| 模块 | 功能 |
|------|------|
| 商户管理 | 商户入驻审核、商户列表、商户配置、商户结算 |
| 供应商管理 | 供应商审核、供应商列表、供应商配置 |
| 平台商品 | 平台商品库、商品分类、商品审核 |
| 平台订单 | 订单监控、订单统计 |
| 权限管理 | 平台管理员账号、角色权限、菜单管理 |
| 区域管理 | 省市区数据维护 |
| 系统设置 | 系统参数配置、全局设置 |
| 应用管理 | 插件管理、小程序配置 |
| 数据统计 | 平台数据概览、商户数据统计 |
| 财务管理 | 商户结算、平台收益、财务报表 |

### 店铺端（jjj_shop_multi_cloud_shop）

面向店铺运营人员使用，管理店铺日常运营。

| 模块 | 功能 |
|------|------|
| 首页看板 | 数据概览、待处理事项、快捷入口 |
| 商品管理 | 商品列表、商品分类、商品规格、商品评价 |
| 订单管理 | 订单列表、订单详情、订单发货、退款/售后处理 |
| 会员管理 | 会员列表、会员等级、会员标签、余额明细 |
| 营销中心 | 优惠券管理、文章管理、文章分类、专题管理、推荐位、收藏管理 |
| 门店管理 | 门店列表、门店店员、门店订单（自提/核销） |
| 页面装修 | 首页装修、分类页装修、个人中心装修、底部导航、主题风格 |
| 数据统计 | 销售统计、用户统计 |
| 应用设置 | 小程序配置、微信配置 |
| 系统设置 | 店铺信息、交易设置、配送方式、快递公司、退货地址、上传设置、打印机、打印模板、短信设置、客服设置 |
| 权限管理 | 店铺账号、角色权限、登录日志、操作日志 |
| 文件管理 | 文件库、文件分组 |
| 财务管理 | 店铺收益、提现管理、账单明细 |

### 供应商端（jjj_shop_multi_cloud_supplier）

面向供应商使用，管理供应商商品和订单。

| 模块 | 功能 |
|------|------|
| 首页看板 | 数据概览、待处理事项 |
| 商品管理 | 供应商品列表、商品上架、商品库存 |
| 订单管理 | 供货订单、订单发货、退货处理 |
| 数据统计 | 供货统计、收益统计 |
| 系统设置 | 供应商信息、收款账户 |
| 财务管理 | 供应商收益、结算管理 |

### 移动端（jjj_shop_multi_cloud_app）

面向终端用户使用（微信小程序/H5/App）。

| 模块 | 功能 |
|------|------|
| 首页 | 轮播图、商品推荐、分类导航、营销活动入口 |
| 商品浏览 | 商品列表、商品详情、商品搜索、商品分类 |
| 购物车 | 加入购物车、购物车管理、批量结算 |
| 订单流程 | 确认订单、收银台支付、订单列表、订单详情、物流跟踪、订单评价 |
| 售后服务 | 申请退款、退款详情 |
| 会员中心 | 个人信息、收货地址管理、我的优惠券、我的收藏、我的钱包、积分明细 |
| 营销活动 | 优惠券领取 |
| 内容浏览 | 文章列表、文章详情 |
| 门店服务 | 门店列表、门店详情、门店订单（自提） |
| 自定义页面 | 支持 DIY 页面装修 |
| 微信功能 | 微信登录、微信支付、手机号绑定 |
| 多商户 | 商户列表、商户店铺、跨店铺购物 |

## 数据库

`db/` 目录包含数据库初始化和迁移脚本。

## 环境要求

| 环境类型 | 开发工具 | 版本要求 |
|---------|---------|---------|
| Java 后端 | IntelliJ IDEA | JDK 17、Maven 3.6+ |
| 后端 Vue 管理页面 | HBuilderX、VSCode 等 JS 开发工具 | Node 16+（推荐16） |
| 前端页面 | HBuilderX | uni-app |
| 数据库 | MySQL | 5.7+ / 8.0+ |
| 缓存 | Redis | 3.0+ |
| 服务注册中心 | Nacos | 2.0.4+（仅微服务模式） |

:warning: **注意**：
- Node.js 16 版本以下存在兼容性问题，请勿使用
- JDK 必须使用 17 版本
- IDEA 必须安装 Lombok 插件

## 快速开始

### 1. 数据库安装

```bash
# MySQL 5.7 或 8.0 新建数据库
CREATE DATABASE jjj_shop_multi_cloud DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

# 导入脚本 db/init.sql
```

### 2. Redis 安装

```bash
# 安装 Redis 3.0+，设置密码
```

### 3. Nacos 安装（微服务模式）

```bash
# 下载 Nacos 2.0.4+
# 启动 Nacos Server
# 访问 http://localhost:8848/nacos（默认账号密码：nacos/nacos）
```

### 4. 后端启动

#### 单体模式（默认）

```bash
# 用 IDEA 打开 jjj_shop_multi_cloud 目录，配置 Maven 镜像，编译成功
# 修改 jjj-module-system/jjj-system-start/src/main/resources/application-dev.yml 里面的数据库配置和 Redis 配置
# 启动 jjj-system-start 模块的主类

# 后端默认端口：8889
# 接口文档地址：http://localhost:8889/doc.html（支持 Swagger/Knife4j）
```

#### 微服务模式

```bash
# 修改 pom.xml，激活 SpringCloud profile
# 配置 Nacos 连接信息
# 启动 jjj-cloud-gateway（网关服务，端口 8888）
# 启动 jjj-system-cloud-start（系统服务，端口 8889）

# 网关地址：http://localhost:8888
# 接口文档地址：http://localhost:8889/doc.html
```

### 5. 平台管理端页面启动

```bash
# cmd 进入 jjj_shop_multi_cloud_admin 目录
cd jjj_shop_multi_cloud_admin
npm install

# 修改 .env.development 里面的后端地址，默认是 http://127.0.0.1:8889
npm run dev

# 启动成功后进入平台后台
```

### 6. 店铺端页面启动

```bash
# cmd 进入 jjj_shop_multi_cloud_shop 目录
cd jjj_shop_multi_cloud_shop
npm install

# 修改 .env.development 里面的后端地址，默认是 http://127.0.0.1:8889
npm run dev

# 启动成功后进入店铺后台，默认密码 admin/123456
```

### 7. 供应商端页面启动

```bash
# cmd 进入 jjj_shop_multi_cloud_supplier 目录
cd jjj_shop_multi_cloud_supplier
npm install

# 修改 .env.development 里面的后端地址
npm run dev
```

### 8. uni-app 移动端启动

```bash
# 用 HBuilderX 打开 jjj_shop_multi_cloud_app 目录
# 修改 manifest.json 文件，可视化修改 Web 配置 -> 路由模式为 hash
# 修改 env/development.js 里面的域名，默认是 http://127.0.0.1:8889
# 点击菜单 运行 -> 运行到浏览器 -> Chrome

# 或编译到微信小程序
# 点击菜单 运行 -> 运行到小程序模拟器 -> 微信开发者工具
```

## 部署说明

### 生产环境打包

```bash
# 后端打包（单体模式）
cd jjj_shop_multi_cloud
mvn clean package -Pprod

# 后端打包（微服务模式）
cd jjj_shop_multi_cloud
mvn clean package -Pprod,SpringCloud

# 平台管理端打包
cd jjj_shop_multi_cloud_admin
npm run build

# 店铺端打包
cd jjj_shop_multi_cloud_shop
npm run build

# 供应商端打包
cd jjj_shop_multi_cloud_supplier
npm run build

# 移动端打包
# 使用 HBuilderX 打开 jjj_shop_multi_cloud_app
# 点击菜单 发行 -> 小程序-微信（仅适用于uni-app）
# 或 发行 -> H5
```

### 部署建议

- **后端**：使用 Nginx 反向代理 + Systemd/Supervisor 守护进程
- **微服务**：使用 Docker + Kubernetes 容器化部署
- **前端**：静态文件部署到 Nginx，配置 gzip 压缩
- **数据库**：定期备份，开启慢查询日志，主从复制
- **Redis**：配置持久化，设置合理的过期策略，哨兵模式
- **Nacos**：集群部署，配置持久化到 MySQL
- **文件存储**：生产环境建议使用云存储（七牛云/阿里云/腾讯云/华为云）

## 技术架构

![技术架构图](https://www.jjjshop.net/gitee/all/jcdsh02.png)

## 项目截图

### 移动端截图

| ![移动端1](https://www.jjjshop.net/gitee/all/dky01.jpg) | ![移动端2](https://www.jjjshop.net/gitee/all/dky02.jpg) | ![移动端3](https://www.jjjshop.net/gitee/all/dky03.jpg) |
|---|---|---|
| ![移动端4](https://www.jjjshop.net/gitee/all/dky04.jpg) | ![移动端5](https://www.jjjshop.net/gitee/all/dky05.jpg) | ![移动端6](https://www.jjjshop.net/gitee/all/dky06.jpg) |

### 后台截图

![后台截图1](https://www.jjjshop.net/gitee/all/jdkyht01.png)
![后台截图2](https://www.jjjshop.net/gitee/all/jdkyht02.png)
![后台截图3](https://www.jjjshop.net/gitee/all/jdkyht03.png)
![后台截图4](https://www.jjjshop.net/gitee/all/jdkyht04.png)

## 开发指南

| 名称 | 地址 |
|------|------|
| 官方网站 | https://www.jjjshop.net |
| 官方文档 | https://doc.jjjshop.net/MultiCloud |
| 视频教程 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1707 |
| 本地安装 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1715 |
| 线上部署 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1731 |
| 二开说明 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1743 |
| 功能说明 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1747 |
| 常见问题 | https://doc.jjjshop.net/MultiCloud?category_id=0&document_id=1752 |
| 接口文档 | 支持 Swagger/Knife4j |

## 微服务解决方案

1. **服务注册和发现**：Nacos
2. **统一配置中心**：Nacos
3. **路由网关**：Spring Cloud Gateway
4. **分布式调用**：OpenFeign
5. **分布式文件**：Minio、阿里云 OSS
6. **统一权限控制**：JWT + Shiro
7. **分布式事务**：Seata
8. **分布式锁**：Redisson
9. **任务调度**：XXL-Job
10. **服务监控**：Spring Boot Admin

## 特别感谢

- Gitee 官方
- Element Plus: [https://element-plus.gitee.io/zh-CN/](https://element-plus.gitee.io/zh-CN/)
- Vue: [https://cn.vuejs.org/](https://cn.vuejs.org/)
- uni-app: [https://uniapp.dcloud.io/](https://uniapp.dcloud.io/)
- Spring Cloud Alibaba: [https://github.com/alibaba/spring-cloud-alibaba](https://github.com/alibaba/spring-cloud-alibaba)
- Nacos: [https://nacos.io/](https://nacos.io/)

## 技术支持

- **官网地址**：[https://www.jjjshop.net](https://www.jjjshop.net)
- **交流QQ群**：638926352
- **问题反馈**：提交 Issue

---

如果这个项目对你有帮助，欢迎 Star ⭐ 支持！