# 三勾springboot微信小程序商城单商户商城

**Repository Path**: victor123/single-java

## Basic Information

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

## Statistics

- **Stars**: 55
- **Forks**: 34
- **Created**: 2025-06-18
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: ecommerce

**Tags**: None

## README

# JJJ Shop 单商户商城系统

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

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

---

## 项目简介

三勾小程序商城是一套完整的单商户电商解决方案，提供从商品管理、订单处理、会员营销到数据统计的全流程业务能力。系统分为后端服务（jjj_shop_single）、管理端前端（jjj_shop_single_admin）、店铺端前端（jjj_shop_single_shop）、移动端前端（jjj_shop_single_app）四个部分。

## 项目特色

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

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端框架 | Java 8 + Spring Boot 2.3.12 |
| ORM 框架 | MyBatis-Plus 3.4.1 |
| 权限框架 | Shiro 1.10.0 + JWT 3.10.1 |
| 缓存 | Redis + Spring Cache |
| 构建工具 | Maven 多模块 |
| 数据库 | MySQL 5.7+ |
| 管理端前端 | Vue 3 + Vite + Element Plus + Pinia |
| 店铺端前端 | Vue 3 + Vite + Element Plus + Pinia |
| 移动端前端 | uni-app + Vue 3（支持微信小程序、H5、多端发布） |
| 微信集成 | weixin-java-sdk 4.7.2.B |
| 云存储 | 七牛云 / 阿里云 OSS / 腾讯云 COS |
| 文档工具 | Knife4j 2.0.2（Swagger UI 增强版） |

## 项目源码

| 项目目录 | 说明 | 开发工具 | 核心技术 |
|---------|------|---------|---------|
| database | 数据库 | MySQL 5.7、MySQL 8.0 | - |
| jjj_shop_single | Java 后端 | IntelliJ IDEA | Spring Boot 2.3.12.RELEASE |
| jjj_shop_single_admin | 管理端后台 | HBuilderX、VSCode 等 JS 开发工具 | Vue 3、Element Plus |
| jjj_shop_single_shop | 店铺端管理后台 | HBuilderX、VSCode 等 JS 开发工具 | Vue 3、Element Plus |
| jjj_shop_single_app | 移动端 | HBuilderX | Vue 3、uni-app |

## 后端架构

### 模块划分

后端采用 Maven 多模块架构，各模块职责清晰：

```
jjj_shop_single/
├── bootstrap/              # 启动模块（主入口）
├── config/                 # 配置模块（Shiro、Redis、Swagger 等）
├── jjj-common/             # 公共模块
│   ├── entity/             #   数据库实体（MyBatis-Plus）
│   ├── mapper/             #   Mapper 接口
│   ├── service/            #   Service 接口和实现
│   ├── enums/              #   业务枚举
│   └── util/               #   工具类
├── jjj-admin/              # 管理端 API（平台运营）
│   └── controller/         #   管理端接口（/api/admin/*）
├── jjj-shop/               # 店铺端 API（商家管理）
│   └── controller/         #   店铺端接口（/api/shop/*）
├── jjj-front/              # 移动端 API（用户端）
│   └── controller/         #   移动端接口（/api/front/*）
├── jjj-job/                # 定时任务模块
├── generator/              # 代码生成器
└── boot-admin/             # Spring Boot Admin 监控
```

关键设计：
- 三端（admin/shop/front）共用同一套 Entity、Mapper、Service
- 通过不同的 Controller 层实现接口隔离和权限控制
- 公共业务逻辑统一在 jjj-common 模块维护

### 核心能力

| 能力 | 实现 |
|------|------|
| 统一返回格式 | `ApiResult<T>` 封装 code/message/data |
| 认证鉴权 | Shiro + JWT（token 签发/校验/刷新） |
| 参数校验 | Hibernate Validator + 自定义校验器 |
| XSS 防护 | XSS 过滤器（详见 [富文本XSS安全漏洞修复说明.md](富文本XSS安全漏洞修复说明.md)） |
| 文件上传 | 工厂模式，支持本地/七牛云/阿里云/腾讯云（详见 [文件上传安全优化说明.md](文件上传安全优化说明.md)） |
| 分页查询 | MyBatis-Plus 分页插件 |
| 全局异常 | 统一异常处理 |
| 操作日志 | AOP 切面自动记录 |
| 定时任务 | ShedLock 分布式锁 + Spring @Scheduled |
| 接口文档 | Knife4j 可视化接口文档 |
| 微信支付 | 微信小程序支付、微信公众号支付 |
| 物流查询 | 快递100 物流查询接口 |
| 打印功能 | 小票打印、订单打印 |

### 多端 API 隔离

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

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

默认端口：`8889`

## 项目结构

```
根目录
├── jjj_shop_single/                  # 后端 Java 源码
│   ├── bootstrap/                    #   启动模块
│   ├── config/                       #   配置模块
│   ├── jjj-common/                   #   公共模块（Entity/Mapper/Service）
│   ├── jjj-admin/                    #   管理端 API
│   ├── jjj-shop/                     #   店铺端 API
│   ├── jjj-front/                    #   移动端 API
│   ├── jjj-job/                      #   定时任务
│   ├── generator/                    #   代码生成器
│   └── boot-admin/                   #   Spring Boot Admin 监控
├── jjj_shop_single_admin/            # 管理端前端（Vue 3）
├── jjj_shop_single_shop/             # 店铺端前端（Vue 3）
├── jjj_shop_single_app/              # 移动端前端（uni-app）
├── db/                               # 数据库脚本
```

## 功能模块

### 管理端（jjj_shop_single_admin）

面向平台超级管理员使用，管理整个系统的基础配置。

| 模块 | 功能 |
|------|------|
| 店铺管理 | 店铺列表、店铺审核、店铺配置 |
| 权限管理 | 管理员账号、角色权限、菜单管理 |
| 区域管理 | 省市区数据维护 |
| 系统设置 | 系统参数配置、全局设置 |
| 应用管理 | 插件管理 |

### 店铺端（jjj_shop_single_shop）

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

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

### 移动端（jjj_shop_single_app）

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

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

## 数据库

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

## 环境要求

| 环境类型 | 开发工具 | 版本要求 |
|---------|---------|---------|
| Java 后端 | IntelliJ IDEA | JDK 1.8、Maven 3.6+ |
| 后端 Vue 管理页面 | HBuilderX、VSCode 等 JS 开发工具 | Node 16+（推荐16） |
| 前端页面 | HBuilderX | uni-app |
| 数据库 | MySQL | 5.7+ / 8.0+ |
| 缓存 | Redis | 3.0+ |

:warning: **注意**：Node.js 16 版本以下存在兼容性问题，请勿使用

## 快速开始

### 1. 数据库安装

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

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

### 2. Redis 安装

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

### 3. 后端启动

```bash
# 用 IDEA 打开 jjj_shop_single 目录，配置 Maven 镜像，编译成功
# 修改 jjj_shop_single/config/src/main/resources/config/application-dev.yml 里面的数据库配置和 Redis 配置
# 启动 SpringBootJjjApplication

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

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

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

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

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

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

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

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

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

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

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

## 部署说明

### 生产环境打包

```bash
# 后端打包
cd jjj_shop_single
mvn clean package -Pprod

# 店铺端打包
cd jjj_shop_single_shop
npm run build

# 管理端打包
cd jjj_shop_single_admin
npm run build

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

### 部署建议

- **后端**：使用 Nginx 反向代理 + Systemd/Supervisor 守护进程
- **前端**：静态文件部署到 Nginx，配置 gzip 压缩
- **数据库**：定期备份，开启慢查询日志
- **Redis**：配置持久化，设置合理的过期策略
- **文件存储**：生产环境建议使用云存储（七牛云/阿里云/腾讯云）

## 技术框架

![技术框架图](https://www.jjjshop.net/gitee/single-java/jiagou.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://doc.jjjshop.net/SingleJava |
| 视频教程 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=1292 |
| 本地安装 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=419 |
| 线上部署 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=425 |
| 二开说明 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=428 |
| 功能说明 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=432 |
| 常见问题 | https://doc.jjjshop.net/SingleJava?category_id=10032&document_id=1048 |
| 接口文档 | 支持 Swagger/Knife4j |

## 特别感谢

- 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/)

## 技术支持

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


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