# mall-parent

**Repository Path**: JeeThink/mall-parent

## Basic Information

- **Project Name**: mall-parent
- **Description**: 基于 SpringBoot + Vue + uni-app 的电商系统，包括前台商城项目及后台管理系统，采用Docker容器化部署。前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。 后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-02
- **Last Updated**: 2026-10-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mall

<p>
  <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-macrozheng-blue.svg" alt="公众号"></a>
  <a href="#公众号"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E4%BA%A4%E6%B5%81-%E5%BE%AE%E4%BF%A1%E7%BE%A4-2BA245.svg" alt="交流"></a>
  <a href="https://github.com/macrozheng/mall-learning"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%AD%A6%E4%B9%A0%E6%95%99%E7%A8%8B-mall--learning-green.svg" alt="学习教程"></a>
  <a href="https://github.com/macrozheng/mall-swarm"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/Cloud%E7%89%88%E6%9C%AC-mall--swarm-brightgreen.svg" alt="SpringCloud版本"></a>
  <a href="https://github.com/macrozheng/mall-admin-web"><img src="https://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%90%8E%E5%8F%B0%E7%AE%A1%E7%90%86%E7%B3%BB%E7%BB%9F-mall--admin--web-green.svg" alt="后台管理系统"></a>
  <a href="https://github.com/macrozheng/mall-app-web"><img src="https://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%89%8D%E5%8F%B0%E5%95%86%E5%9F%8E%E9%A1%B9%E7%9B%AE-mall--app--web-green.svg" alt="前台商城项目"></a>
  <a href="https://gitee.com/macrozheng/mall"><img src="http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E7%A0%81%E4%BA%91-%E9%A1%B9%E7%9B%AE%E5%9C%B0%E5%9D%80-orange.svg" alt="码云"></a>
</p>


## 友情提示

**项目来源** [mall: 🔥🔥🔥mall项目是一套基于 SpringBoot + Vue + uni-app 的电商系统，包括前台商城项目及后台管理系统，采用Docker容器化部署。前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。 后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。](https://gitee.com/macrozheng/mall)

为方便获取前端代码，**mall-parent**中同时包含前端项目：**mall-admin-web**和**mall-app-web**

`master` 分支基于 **Spring Boot 3.5 + JDK 17**

## 前言

`mall` 项目致力于打造一个完整的电商系统，采用现阶段主流技术实现。

> ⚠️ **本仓库为升级版本**：已从原 `fabric8 docker-maven-plugin` 迁移到 **Jib + nerdctl + containerd** 容器化方案，不再依赖 Docker Daemon。详见 [容器化部署](#容器化部署jib--nerdctl) 章节。

## 项目文档

文档地址：[https://www.macrozheng.com](https://www.macrozheng.com)

## 项目介绍

`mall` 项目是一套电商系统，包括**前台商城系统**及**后台管理系统**，基于 Spring Boot + MyBatis 实现，采用容器化部署。

- **前台商城系统**：首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。
- **后台管理系统**：商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。

### 项目演示

#### 后台管理系统

- 前端项目：`mall-admin-web`，地址 https://github.com/macrozheng/mall-admin-web
- 演示地址：https://www.macrozheng.com/admin/index.html

账号：admin 密码：123456

![用户列表](./document/resource/update_usr_list.png)



![后台管理系统功能演示](./document/resource/mall_admin_show.png)

#### 前台商城系统

- 前端项目：`mall-app-web`，地址 https://github.com/macrozheng/mall-app-web
- 演示地址（将浏览器切换为手机模式效果更佳）：https://www.macrozheng.com/app/

账号：test 密码：123456

![前台商城系统功能演示](./document/resource/re_mall_app_show.jpg)

### 组织结构

```
mall
├── mall-common        -- 工具类及通用代码
├── mall-mbg           -- MyBatisGenerator 生成的数据库操作代码
├── mall-security      -- Spring Security 封装公用模块
├── mall-admin         -- 后台商城管理系统接口
├── mall-search        -- 基于 Elasticsearch 的商品搜索系统
├── mall-portal        -- 前台商城系统接口
└── mall-demo          -- 框架搭建时的测试代码
```

### 技术选型

#### 后端技术

| 技术                | 说明                      | 官网                                           |
| ------------------- | ------------------------- | ---------------------------------------------- |
| SpringBoot          | Web 应用开发框架          | https://spring.io/projects/spring-boot         |
| SpringSecurity      | 认证和授权框架            | https://spring.io/projects/spring-security     |
| MyBatis             | ORM 框架                  | http://www.mybatis.org/mybatis-3/zh/index.html |
| MyBatisGenerator    | 数据层代码生成器          | http://www.mybatis.org/generator/index.html    |
| Elasticsearch       | 搜索引擎                  | https://github.com/elastic/elasticsearch       |
| RabbitMQ            | 消息队列                  | https://www.rabbitmq.com/                      |
| Redis               | 内存数据存储              | https://redis.io/                              |
| MongoDB             | NoSQL 数据库              | https://www.mongodb.com                        |
| LogStash            | 日志收集工具              | https://github.com/elastic/logstash            |
| Kibana              | 日志可视化查看工具        | https://github.com/elastic/kibana              |
| Nginx               | 静态资源服务器            | https://www.nginx.com/                         |
| Docker / containerd | 应用容器引擎              | https://www.docker.com                         |
| Jib                 | 镜像构建工具（无 daemon） | https://github.com/GoogleContainerTools/jib    |
| nerdctl             | containerd CLI 工具       | https://github.com/containerd/nerdctl          |
| Jenkins             | 自动化部署工具            | https://github.com/jenkinsci/jenkins           |
| Druid               | 数据库连接池              | https://github.com/alibaba/druid               |
| OSS                 | 对象存储                  | https://github.com/aliyun/aliyun-oss-java-sdk  |
| MinIO               | 对象存储                  | https://github.com/minio/minio                 |
| JWT                 | JWT 登录支持              | https://github.com/jwtk/jjwt                   |
| Lombok              | Java 语言增强库           | https://github.com/rzwitserloot/lombok         |
| Hutool              | Java 工具类库             | https://github.com/looly/hutool                |
| PageHelper          | MyBatis 物理分页插件      | http://git.oschina.net/free/Mybatis_PageHelper |
| SpringDoc           | API 文档生成工具          | https://github.com/springdoc/springdoc-openapi |
| Hibernate-Validator | 验证框架                  | http://hibernate.org/validator                 |

#### 前端技术

| 技术       | 说明                    | 官网                                   |
| ---------- | ----------------------- | -------------------------------------- |
| Vue        | 前端框架                | https://vuejs.org/                     |
| Vue-router | 路由框架                | https://router.vuejs.org/              |
| Vuex       | 全局状态管理框架        | https://vuex.vuejs.org/                |
| Element    | 前端 UI 框架            | https://element.eleme.io               |
| Axios      | 前端 HTTP 框架          | https://github.com/axios/axios         |
| v-charts   | 基于 ECharts 的图表框架 | https://v-charts.js.org/               |
| Js-cookie  | cookie 管理工具         | https://github.com/js-cookie/js-cookie |
| nprogress  | 进度条控件              | https://github.com/rstacruz/nprogress  |

#### 移动端技术

| 技术         | 说明             | 官网                                    |
| ------------ | ---------------- | --------------------------------------- |
| Vue          | 核心前端框架     | https://vuejs.org                       |
| Vuex         | 全局状态管理框架 | https://vuex.vuejs.org                  |
| uni-app      | 移动端前端框架   | https://uniapp.dcloud.io                |
| mix-mall     | 电商项目模板     | https://ext.dcloud.net.cn/plugin?id=200 |
| luch-request | HTTP 请求框架    | https://github.com/lei-mu/luch-request  |

### 架构图

#### 系统架构图

![系统架构图](./document/resource/re_mall_system_arch.jpg)

#### 业务架构图

![业务架构图](./document/resource/re_mall_business_arch.jpg)

### 模块介绍

#### 后台管理系统 `mall-admin`

- 商品管理：[功能结构图-商品.jpg](document/resource/mind_product.jpg)
- 订单管理：[功能结构图-订单.jpg](document/resource/mind_order.jpg)
- 促销管理：[功能结构图-促销.jpg](document/resource/mind_sale.jpg)
- 内容管理：[功能结构图-内容.jpg](document/resource/mind_content.jpg)
- 用户管理：[功能结构图-用户.jpg](document/resource/mind_member.jpg)

#### 前台商城系统 `mall-portal`

- [功能结构图-前台.jpg](document/resource/mind_portal.jpg)

### 开发进度

![项目开发进度图](./document/resource/re_mall_dev_flow.jpg)

## 环境搭建

### 开发工具

| 工具          | 说明                 | 官网                                                  |
| ------------- | -------------------- | ----------------------------------------------------- |
| IDEA          | 开发 IDE             | https://www.jetbrains.com/idea/download               |
| RedisDesktop  | Redis 客户端连接工具 | https://github.com/qishibo/AnotherRedisDesktopManager |
| Robomongo     | Mongo 客户端连接工具 | https://robomongo.org/download                        |
| SwitchHosts   | 本地 host 管理       | https://oldj.github.io/SwitchHosts/                   |
| X-shell       | Linux 远程连接工具   | http://www.netsarang.com/download/software.html       |
| Navicat       | 数据库连接工具       | http://www.formysql.com/xiazai.html                   |
| PowerDesigner | 数据库设计工具       | http://powerdesigner.de/                              |
| Axure         | 原型设计工具         | https://www.axure.com/                                |
| MindMaster    | 思维导图设计工具     | http://www.edrawsoft.cn/mindmaster                    |
| ScreenToGif   | GIF 录制工具         | https://www.screentogif.com/                          |
| ProcessOn     | 流程图绘制工具       | https://www.processon.com/                            |
| PicPick       | 图片处理工具         | https://picpick.app/zh/                               |
| Snipaste      | 屏幕截图工具         | https://www.snipaste.com/                             |
| Postman       | API 接口调试工具     | https://www.postman.com/                              |
| Typora        | Markdown 编辑器      | https://typora.io/                                    |

### 开发环境

| 工具          | 版本号 | 下载                                                         |
| ------------- | ------ | ------------------------------------------------------------ |
| JDK           | 17     | https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html |
| MySQL         | 5.7    | https://www.mysql.com/                                       |
| Redis         | 7.0    | https://redis.io/download                                    |
| MongoDB       | 5.0    | https://www.mongodb.com/download-center                      |
| RabbitMQ      | 3.10.5 | http://www.rabbitmq.com/download.html                        |
| Nginx         | 1.22   | http://nginx.org/en/download.html                            |
| Elasticsearch | 7.17.3 | https://www.elastic.co/downloads/elasticsearch               |
| Logstash      | 7.17.3 | https://www.elastic.co/cn/downloads/logstash                 |
| Kibana        | 7.17.3 | https://www.elastic.co/cn/downloads/kibana                   |

### 搭建步骤

#### Windows 环境部署

- Windows 环境搭建请参考：[mall 在 Windows 环境下的部署](https://www.macrozheng.com/mall/deploy/mall_deploy_windows.html)。
- **注意**：如果只启动 `mall-admin` 模块，仅需安装 **MySQL、Redis** 即可。
- 克隆 `mall-admin-web` 项目，并导入到 IDEA 中完成编译：[前端项目地址](https://github.com/macrozheng/mall-admin-web)。
- `mall-admin-web` 项目的安装及部署请参考：[mall 前端项目的安装与部署](https://www.macrozheng.com/mall/deploy/mall_deploy_web.html)。

#### 容器环境部署

- 使用虚拟机安装 CentOS 7.6 请参考：[虚拟机安装及使用 Linux，看这一篇就够了](https://www.macrozheng.com/tool/linux_install.html)。
- 本项目容器镜像构建请参考：[使用 Jib 为 Spring Boot 应用构建容器镜像](#容器化部署jib--nerdctl)。
- 本项目在容器下的部署请参考：[mall 在 Linux 环境下的部署](https://www.macrozheng.com/mall/deploy/mall_deploy_docker.html)。
- 本项目使用 Docker Compose 请参考：[mall 在 Linux 环境下的部署（基于 Docker Compose）](https://www.macrozheng.com/mall/deploy/mall_deploy_docker_compose.html)。
- 本项目在 Linux 下的自动化部署请参考：[mall 在 Linux 环境下的自动化部署（基于 Jenkins）](https://www.macrozheng.com/mall/deploy/mall_deploy_jenkins.html)。

#### 相关环境部署

- ELK 日志收集系统的搭建请参考：[mall 项目 ELK 日志收集解决方案](https://www.macrozheng.com/project/mall_kibana_start.html)。
- 使用 MinIO 存储文件请参考：[使用 MinIO 实现文件存储](https://www.macrozheng.com/project/minio_console_start.html)。
- 读写分离解决方案请参考：[你还在代码里做读写分离么，试试这个中间件吧](https://www.macrozheng.com/project/gaea.html)。
- Redis 集群解决方案请参考：[Docker 环境下秒建 Redis 集群](https://www.macrozheng.com/blog/redis_cluster.html)。

## 容器化部署（Jib + nerdctl）

> 本工程已从 `fabric8 docker-maven-plugin` 迁移到 **Jib + nerdctl + containerd**，**不再需要 Docker Daemon**，也不再依赖 `tcp://xxx:2375` 这类远程管理接口。

### 一、运行时准备（一次性）

确保已安装并启动 **containerd** 与 **nerdctl**，然后启动本地镜像仓库：

```sh
# 1. 启动本地 Registry（持久化存储）
mkdir -p /mydata/registry
nerdctl run -d --name registry \
  -p 5000:5000 \
  -v /mydata/registry:/var/lib/registry \
  registry:2

# 2. 设置开机自启
nerdctl update --restart=always registry
nerdctl restart registry
```

配置 **containerd** 允许访问 HTTP 私有仓库：

```sh
# 创建 certs.d 目录
mkdir -p /etc/containerd/certs.d/192.168.56.100:5000

# 写入 hosts.toml
cat > /etc/containerd/certs.d/192.168.56.100:5000/hosts.toml <<EOF
server = "http://192.168.56.100:5000"

[host."http://192.168.56.100:5000"]
  capabilities = ["pull", "resolve", "push"]
  skip_verify = true
EOF
```

> ⚠️ **重要**：无需在 `nerdctl.toml` 中重复配置 `insecure-registry`，containerd 的 `certs.d` 已覆盖该功能。

### 二、Maven 构建配置

父 POM 中引入 **Jib Maven Plugin**，并配置私仓地址：

```xml
<plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>jib-maven-plugin</artifactId>
    <version>${jib-maven-plugin.version}</version>
    <configuration>
        <!-- 父工程默认跳过，子模块按需覆盖 -->
        <skip>true</skip>

        <from>
            <!-- 建议使用国内加速器，避免访问 Docker Hub 超时 -->
            <image>docker.1ms.run/library/eclipse-temurin:17-jre</image>
        </from>
        <to>
            <image>192.168.56.100:5000/mall/${project.artifactId}</image>
            <tags>
                <tag>${project.version}</tag>
                <tag>latest</tag>
            </tags>
        </to>

        <!-- 使用 Spring Boot fat jar 作为启动入口 -->
        <containerizingMode>packaged</containerizingMode>

        <!-- 允许推送至 HTTP 私有仓库 -->
        <allowInsecureRegistries>true</allowInsecureRegistries>

        <container>
            <jvmFlags>
                <jvmFlag>-Dspring.profiles.active=prod</jvmFlag>
            </jvmFlags>
        </container>
    </configuration>
</plugin>
```

子模块（如 `mall-admin`、`mall-portal`、`mall-search`）中启用 Jib：

```xml
<plugin>
    <groupId>com.google.cloud.tools</groupId>
    <artifactId>jib-maven-plugin</artifactId>
    <configuration>
        <skip>false</skip>
    </configuration>
</plugin>
```

### 三、构建并推送镜像

```sh
# 1. 安装所有模块到本地仓库（关键：Jib 需要 reactor 内依赖已就绪）
mvn clean install -DskipTests

# 2. 构建并推送镜像到私有仓库
mvn jib:build -DskipTests
```

或一步到位：

```sh
mvn clean install jib:build -DskipTests
```

### 四、运行镜像

```sh
# 从私仓拉取
nerdctl pull 192.168.56.100:5000/mall/mall-admin:1.0-SNAPSHOT

# 运行容器
nerdctl run -d --name mall-admin \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  192.168.56.100:5000/mall/mall-admin:1.0-SNAPSHOT
```

### 五、常见问题

| 问题                                                 | 原因                                        | 解决方案                                                     |
| ---------------------------------------------------- | ------------------------------------------- | ------------------------------------------------------------ |
| `Connect to registry-1.docker.io:443 timeout`        | Jib 无法访问 Docker Hub 拉基础镜像          | 将 `<from>` 改为国内加速器地址                               |
| `Could not find artifact com.macro.mall:mall-common` | 未先执行 `install`，Jib 无法从 reactor 解析 | 先 `mvn clean install` 再 `mvn jib:build`                    |
| `http: server gave HTTP response to HTTPS client`    | containerd 未配置私仓为 insecure            | 配置 `/etc/containerd/certs.d/` 并重启 containerd            |
| `Cannot find 'containerizingMode'`                   | 配置位置错误                                | `containerizingMode` 必须放在 `<configuration>` 顶层，**不是** `<container>` 内 |
| `Access Denied`（MinIO）                             | 当前用户缺少 `s3:CreateBucket` 权限         | 用 `minioadmin` 登录，或给用户绑定含 `CreateBucket` 的 policy |



## 许可证

[Apache License 2.0](https://github.com/macrozheng/mall/blob/master/LICENSE)

Copyright (c) 2018-2026 macrozheng