{"id":13439703,"url":"https://github.com/macrozheng/mall","last_synced_at":"2025-05-12T16:19:53.230Z","repository":{"id":37276280,"uuid":"127988011","full_name":"macrozheng/mall","owner":"macrozheng","description":"mall项目是一套电商系统，包括前台商城系统及后台管理系统，基于Spring Boot+MyBatis实现，采用Docker容器化部署。 前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。 后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。","archived":false,"fork":false,"pushed_at":"2025-04-18T02:35:38.000Z","size":58689,"stargazers_count":80142,"open_issues_count":20,"forks_count":29235,"subscribers_count":2217,"default_branch":"master","last_synced_at":"2025-05-05T11:46:33.280Z","etag":null,"topics":["docker","elasticsearch","elk","java","mongodb","mybatis","mysql","rabbitmq","redis","spring","spring-boot","spring-cloud","spring-security","springboot","springcloud","swagger-ui"],"latest_commit_sha":null,"homepage":"https://www.macrozheng.com/admin/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/macrozheng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-04-04T01:11:44.000Z","updated_at":"2025-05-05T11:27:37.000Z","dependencies_parsed_at":"2022-07-13T15:59:47.044Z","dependency_job_id":"3f227ad1-bdd3-4ef9-ba1d-a6eb2e919fcd","html_url":"https://github.com/macrozheng/mall","commit_stats":{"total_commits":1036,"total_committers":2,"mean_commits":518.0,"dds":0.137065637065637,"last_synced_commit":"370eb4b7045b22dc05cf5a6cdde2fe4dfc79c3aa"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrozheng%2Fmall/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macrozheng","download_url":"https://codeload.github.com/macrozheng/mall/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252504142,"owners_count":21758654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","elasticsearch","elk","java","mongodb","mybatis","mysql","rabbitmq","redis","spring","spring-boot","spring-cloud","spring-security","springboot","springcloud","swagger-ui"],"created_at":"2024-07-31T03:01:16.381Z","updated_at":"2025-05-05T12:52:38.682Z","avatar_url":"https://github.com/macrozheng.png","language":"Java","readme":"# mall\n\n\u003cp\u003e\n  \u003ca href=\"#公众号\"\u003e\u003cimg src=\"http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/%E5%85%AC%E4%BC%97%E5%8F%B7-macrozheng-blue.svg\" alt=\"公众号\"\u003e\u003c/a\u003e\n  \u003ca href=\"#公众号\"\u003e\u003cimg 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=\"交流\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-learning\"\u003e\u003cimg 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=\"学习教程\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-swarm\"\u003e\u003cimg src=\"http://macro-oss.oss-cn-shenzhen.aliyuncs.com/mall/badge/Cloud%E7%89%88%E6%9C%AC-mall--swarm-brightgreen.svg\" alt=\"SpringCloud版本\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-admin-web\"\u003e\u003cimg 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=\"后台管理系统\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/macrozheng/mall-app-web\"\u003e\u003cimg 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=\"前台商城项目\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://gitee.com/macrozheng/mall\"\u003e\u003cimg 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=\"码云\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 友情提示\n\n\u003e 1. **快速体验项目**：[在线访问地址](https://www.macrozheng.com/admin/index.html) 。\n\u003e 2. **全套学习教程**：[《mall学习教程》](https://www.macrozheng.com) 。\n\u003e 3. **视频教程（最新版）**：[《mall视频教程》](https://www.macrozheng.com/mall/foreword/mall_video.html) 。\n\u003e 4. **微服务版本**：基于Spring Cloud Alibaba的项目：[mall-swarm](https://github.com/macrozheng/mall-swarm) 。\n\u003e 5. **分支说明**：`master`分支基于Spring Boot 2.7+JDK 8，`dev-v3`分支基于Spring Boot 3.2+JDK 17。\n\n## 前言\n\n`mall`项目致力于打造一个完整的电商系统，采用现阶段主流技术实现。\n\n## 项目文档\n\n文档地址：[https://www.macrozheng.com](https://www.macrozheng.com)\n\n## 项目介绍\n\n`mall`项目是一套电商系统，包括前台商城系统及后台管理系统，基于SpringBoot+MyBatis实现，采用Docker容器化部署。前台商城系统包含首页门户、商品推荐、商品搜索、商品展示、购物车、订单流程、会员中心、客户服务、帮助中心等模块。后台管理系统包含商品管理、订单管理、会员管理、促销管理、运营管理、内容管理、统计报表、财务管理、权限管理、设置等模块。\n\n### 项目演示\n\n#### 后台管理系统\n\n前端项目`mall-admin-web`地址：https://github.com/macrozheng/mall-admin-web\n\n项目演示地址： [https://www.macrozheng.com/admin/index.html](https://www.macrozheng.com/admin/index.html)  \n\n![后台管理系统功能演示](./document/resource/mall_admin_show.png)\n\n#### 前台商城系统\n\n前端项目`mall-app-web`地址：https://github.com/macrozheng/mall-app-web\n\n项目演示地址（将浏览器切换为手机模式效果更佳）：[https://www.macrozheng.com/app/](https://www.macrozheng.com/app/)\n\n![前台商城系统功能演示](./document/resource/re_mall_app_show.jpg)\n\n### 组织结构\n\n``` lua\nmall\n├── mall-common -- 工具类及通用代码\n├── mall-mbg -- MyBatisGenerator生成的数据库操作代码\n├── mall-security -- SpringSecurity封装公用模块\n├── mall-admin -- 后台商城管理系统接口\n├── mall-search -- 基于Elasticsearch的商品搜索系统\n├── mall-portal -- 前台商城系统接口\n└── mall-demo -- 框架搭建时的测试代码\n```\n\n### 技术选型\n\n#### 后端技术\n\n| 技术                 | 说明                | 官网                                           |\n| -------------------- | ------------------- | ---------------------------------------------- |\n| SpringBoot           | Web应用开发框架      | https://spring.io/projects/spring-boot         |\n| SpringSecurity       | 认证和授权框架      | https://spring.io/projects/spring-security     |\n| MyBatis              | ORM框架             | http://www.mybatis.org/mybatis-3/zh/index.html |\n| MyBatisGenerator     | 数据层代码生成器     | http://www.mybatis.org/generator/index.html    |\n| Elasticsearch        | 搜索引擎            | https://github.com/elastic/elasticsearch       |\n| RabbitMQ             | 消息队列            | https://www.rabbitmq.com/                      |\n| Redis                | 内存数据存储         | https://redis.io/                              |\n| MongoDB              | NoSql数据库         | https://www.mongodb.com                        |\n| LogStash             | 日志收集工具        | https://github.com/elastic/logstash            |\n| Kibana               | 日志可视化查看工具  | https://github.com/elastic/kibana              |\n| Nginx                | 静态资源服务器      | https://www.nginx.com/                         |\n| Docker               | 应用容器引擎        | https://www.docker.com                         |\n| Jenkins              | 自动化部署工具      | https://github.com/jenkinsci/jenkins           |\n| Druid                | 数据库连接池        | https://github.com/alibaba/druid               |\n| OSS                  | 对象存储            | https://github.com/aliyun/aliyun-oss-java-sdk  |\n| MinIO                | 对象存储            | https://github.com/minio/minio                 |\n| JWT                  | JWT登录支持         | https://github.com/jwtk/jjwt                   |\n| Lombok               | Java语言增强库      | https://github.com/rzwitserloot/lombok         |\n| Hutool               | Java工具类库        | https://github.com/looly/hutool                |\n| PageHelper           | MyBatis物理分页插件 | http://git.oschina.net/free/Mybatis_PageHelper |\n| Swagger-UI           | API文档生成工具      | https://github.com/swagger-api/swagger-ui      |\n| Hibernator-Validator | 验证框架            | http://hibernate.org/validator                 |\n\n#### 前端技术\n\n| 技术       | 说明                  | 官网                                   |\n| ---------- | --------------------- | -------------------------------------- |\n| Vue        | 前端框架              | https://vuejs.org/                     |\n| Vue-router | 路由框架              | https://router.vuejs.org/              |\n| Vuex       | 全局状态管理框架      | https://vuex.vuejs.org/                |\n| Element    | 前端UI框架            | https://element.eleme.io               |\n| Axios      | 前端HTTP框架          | https://github.com/axios/axios         |\n| v-charts   | 基于Echarts的图表框架 | https://v-charts.js.org/               |\n| Js-cookie  | cookie管理工具        | https://github.com/js-cookie/js-cookie |\n| nprogress  | 进度条控件            | https://github.com/rstacruz/nprogress  |\n\n#### 移动端技术\n\n| 技术         | 说明             | 官网                                    |\n| ------------ | ---------------- | --------------------------------------- |\n| Vue          | 核心前端框架     | https://vuejs.org                       |\n| Vuex         | 全局状态管理框架 | https://vuex.vuejs.org                  |\n| uni-app      | 移动端前端框架   | https://uniapp.dcloud.io                |\n| mix-mall     | 电商项目模板     | https://ext.dcloud.net.cn/plugin?id=200 |\n| luch-request | HTTP请求框架     | https://github.com/lei-mu/luch-request  |\n\n#### 架构图\n\n##### 系统架构图\n\n![系统架构图](./document/resource/re_mall_system_arch.jpg)\n\n##### 业务架构图\n\n![业务架构图](./document/resource/re_mall_business_arch.jpg)\n\n#### 模块介绍\n\n##### 后台管理系统 `mall-admin`\n\n- 商品管理：[功能结构图-商品.jpg](document/resource/mind_product.jpg)\n- 订单管理：[功能结构图-订单.jpg](document/resource/mind_order.jpg)\n- 促销管理：[功能结构图-促销.jpg](document/resource/mind_sale.jpg)\n- 内容管理：[功能结构图-内容.jpg](document/resource/mind_content.jpg)\n- 用户管理：[功能结构图-用户.jpg](document/resource/mind_member.jpg)\n\n##### 前台商城系统 `mall-portal`\n\n[功能结构图-前台.jpg](document/resource/mind_portal.jpg)\n\n#### 开发进度\n\n![项目开发进度图](./document/resource/re_mall_dev_flow.jpg)\n\n## 环境搭建\n\n### 开发工具\n\n| 工具          | 说明                | 官网                                            |\n| ------------- | ------------------- | ----------------------------------------------- |\n| IDEA          | 开发IDE             | https://www.jetbrains.com/idea/download         |\n| RedisDesktop  | redis客户端连接工具 | https://github.com/qishibo/AnotherRedisDesktopManager  |\n| Robomongo     | mongo客户端连接工具 | https://robomongo.org/download                  |\n| SwitchHosts   | 本地host管理        | https://oldj.github.io/SwitchHosts/             |\n| X-shell       | Linux远程连接工具   | http://www.netsarang.com/download/software.html |\n| Navicat       | 数据库连接工具      | http://www.formysql.com/xiazai.html             |\n| PowerDesigner | 数据库设计工具      | http://powerdesigner.de/                        |\n| Axure         | 原型设计工具        | https://www.axure.com/                          |\n| MindMaster    | 思维导图设计工具    | http://www.edrawsoft.cn/mindmaster              |\n| ScreenToGif   | gif录制工具         | https://www.screentogif.com/                    |\n| ProcessOn     | 流程图绘制工具      | https://www.processon.com/                      |\n| PicPick       | 图片处理工具        | https://picpick.app/zh/                         |\n| Snipaste      | 屏幕截图工具        | https://www.snipaste.com/                       |\n| Postman       | API接口调试工具      | https://www.postman.com/                        |\n| Typora        | Markdown编辑器      | https://typora.io/                              |\n\n### 开发环境\n\n| 工具          | 版本号 | 下载                                                         |\n| ------------- | ------ | ------------------------------------------------------------ |\n| JDK           | 1.8    | https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html |\n| MySQL         | 5.7    | https://www.mysql.com/                                       |\n| Redis         | 7.0    | https://redis.io/download                                    |\n| MongoDB       | 5.0    | https://www.mongodb.com/download-center                      |\n| RabbitMQ      | 3.10.5 | http://www.rabbitmq.com/download.html                        |\n| Nginx         | 1.22   | http://nginx.org/en/download.html                            |\n| Elasticsearch | 7.17.3 | https://www.elastic.co/downloads/elasticsearch               |\n| Logstash      | 7.17.3 | https://www.elastic.co/cn/downloads/logstash                 |\n| Kibana        | 7.17.3 | https://www.elastic.co/cn/downloads/kibana                   |\n\n### 搭建步骤\n\n\u003e Windows环境部署\n\n- Windows环境搭建请参考：[mall项目后端开发环境搭建](https://www.macrozheng.com/mall/start/mall_deploy_windows.html);\n- 注意：如果只启动`mall-admin`模块，仅需安装MySQL、Redis即可;\n- 克隆`mall-admin-web`项目，并导入到IDEA中完成编译：[前端项目地址](https://github.com/macrozheng/mall-admin-web);\n- `mall-admin-web`项目的安装及部署请参考：[mall项目前端发环境搭建](https://www.macrozheng.com/mall/start/mall_deploy_web.html) 。\n\n\u003e Docker环境部署\n\n- 使用虚拟机安装CentOS7.6请参考：[虚拟机安装及使用Linux，看这一篇就够了](https://www.macrozheng.com/mall/deploy/linux_install.html);\n- 本项目Docker镜像构建请参考：[使用Maven插件为SpringBoot应用构建Docker镜像](https://www.macrozheng.com/project/maven_docker_fabric8.html);\n- 本项目在Docker容器下的部署请参考：[mall在Linux环境下的部署（基于Docker容器）](https://www.macrozheng.com/mall/deploy/mall_deploy_docker.html);\n- 本项目使用Docker Compose请参考： [mall在Linux环境下的部署（基于Docker Compose）](https://www.macrozheng.com/mall/deploy/mall_deploy_docker_compose.html);\n- 本项目在Linux下的自动化部署请参考：[mall在Linux环境下的自动化部署（基于Jenkins）](https://www.macrozheng.com/mall/deploy/mall_deploy_jenkins.html);\n\n## 公众号\n\n加微信群交流，关注公众号「**macrozheng**」，回复「**加群**」即可。\n\n![公众号图片](./document/resource/qrcode_for_macrozheng_258.jpg)\n\n## 许可证\n\n[Apache License 2.0](https://github.com/macrozheng/mall/blob/master/LICENSE)\n\nCopyright (c) 2018-2025 macrozheng\n","funding_links":[],"categories":["Java","编程学习","开源","开源项目","Practical Project","Java 实战项目","Java (504)"],"sub_categories":["Others","Spring Boot","开源项目"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrozheng%2Fmall","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacrozheng%2Fmall","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrozheng%2Fmall/lists"}