# gulimall **Repository Path**: pikachu_plus/gulimall ## Basic Information - **Project Name**: gulimall - **Description**: 基于Spring Cloud 分布式电商平台。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: online - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2022-11-24 - **Last Updated**: 2024-06-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 商城简介 ### 前言 easyshop 项目致力于打造一个完整的电商系统，采用现阶段流行技术来实现，采用前后端分离继续编写。 [项目笔记](./笔记/zero.md) ### 开源代码与组件使用情况说明 [renren-generator](https://gitee.com/link?target=https://gitee.com/renrenio/renren-generator) 是人人开源项目的代码生成器，可在线生成entity、xml、dao、service、html、js、sql代码，减少70%以上的开发任务 [renren-fast-vue](https://gitee.com/link?target=https://gitee.com/renrenio/renren-fast) 基于vue、element-ui构建开发，实现renren-fast后台管理前端功能，提供一套更优的前端解决方案 [Hutool](https://gitee.com/link?target=https://gitee.com/dromara/hutool) 是项目中“util”包友好的替代，它节省了开发人员对项目中公用类和公用工具方法的封装时间，使开发专注于业务，同时可以最大限度的避免封装不完善带来的bug。 ### 项目API接口文档 - 文档地址：[https://easydoc.xyz/s/78237135/ZUqEdvA4/hKJTcbfd](https://gitee.com/link?target=https://easydoc.xyz/s/78237135/ZUqEdvA4/hKJTcbfd) ### 项目介绍 easyshop 项目是一套电商项目，包括前台商城系统以及后台管理系统，基于 SpringCloud + SpringCloudAlibaba + MyBatis-Plus实现，采用 Docker 容器化部署。前台商城系统包括：用户登录、注册、商品搜索、商品详情、购物车、下订单流程、秒杀活动等模块。后台管理系统包括：系统管理、商品系统、优惠营销、库存系统、订单系统、用户系统、内容管理等七大模块。 ### 项目演示 更换 logo (京东，谷粒) ──>京粒 #### **前台部分功能演示效果** ![UUvLAU.png](imgs/193421_2e595b5f_4914148.png) ![UUv7n0.png](imgs/193422_0ed39103_4914148.png) #### 后端登录界面 ![UUvXh4.png](imgs/193422_cd40fc31_4914148.png) #### 主页面 ![UUv51s.png](imgs/193422_d1a789d5_4914148.png) #### 后台部分功能 [![UUvoXq.th.png](imgs/193422_9758a0a6_4914148.png)](https://gitee.com/link?target=https%3A%2F%2Fimgchr.com%2Fi%2FUUvoXq)[![UUvONF.th.png](imgs/193423_ed014fcc_4914148.png)](https://gitee.com/link?target=https%3A%2F%2Fimgchr.com%2Fi%2FUUvONF)[![UUvHBV.th.png](imgs/193423_0996ef2d_4914148.png)](https://gitee.com/link?target=https%3A%2F%2Fimgchr.com%2Fi%2FUUvHBV)[![UUvIcn.th.png](imgs/193424_bb60e0f4_4914148.png)](https://gitee.com/link?target=https%3A%2F%2Fimgchr.com%2Fi%2FUUvIcn) ### 组织结构 ``` easyshop ├── cloud-guli-auth -- 认证中心（社交登录、OAuth2.0、单点登录） ├── cloud-guli-cart -- 购物车服务 ├── cloud-guli-fast -- 后台管理 ├── cloud-guli-gateway -- 统一配置网关 ├── cloud-guli-member -- 会员服务 ├── cloud-guli-order -- 订单服务 ├── cloud-guli-product -- 商品服务 ├── cloud-guli-search -- 检索服务 ├── cloud-guli-seckill -- 秒杀服务 ├── cloud-guli-third-service -- 第三方服务 ├── cloud-guli-ware -- 仓储服务 ├── cloud-guli-yhq -- 优惠卷服务 ├── easyshop-common -- 工具类及通用代码 ├── renren-generator -- 人人开源项目的代码生成器 ├── unionpay-spring-boot-starter -- 整合银联支付场景启动器 ``` ### 技术选型 **后端技术** | 技术 | 说明 | 官网 | |--------------------|--------------|--------------------------------------------------------------------------------------------------------------------------------------------| | SpringBoot | 容器+MVC框架 | [https://spring.io/projects/spring-boot](https://gitee.com/link?target=https%3A%2F%2Fspring.io%2Fprojects%2Fspring-boot) | | SpringCloud | 微服务架构 | [https://spring.io/projects/spring-cloud](https://gitee.com/link?target=https%3A%2F%2Fspring.io%2Fprojects%2Fspring-cloud) | | SpringCloudAlibaba | 一系列组件 | [https://spring.io/projects/spring-cloud-alibaba](https://gitee.com/link?target=https%3A%2F%2Fspring.io%2Fprojects%2Fspring-cloud-alibaba) | | MyBatis-Plus | ORM框架 | [https://mp.baomidou.com](https://gitee.com/link?target=https%3A%2F%2Fmp.baomidou.com) | | renren-generator | 人人开源项目的代码生成器 | https://gitee.com/renrenio/renren-generator | | Elasticsearch | 搜索引擎 | [https://github.com/elastic/elasticsearch](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Felastic%2Felasticsearch) | | RabbitMQ | 消息队列 | [https://www.rabbitmq.com](https://gitee.com/link?target=https%3A%2F%2Fwww.rabbitmq.com) | | SpringSession | 分布式缓存 | [https://projects.spring.io/spring-session](https://gitee.com/link?target=https%3A%2F%2Fprojects.spring.io%2Fspring-session) | | Redisson | 分布式锁 | [https://github.com/redisson/redisson](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Fredisson%2Fredisson) | | Docker | 应用容器引擎 | [https://www.docker.com](https://gitee.com/link?target=https%3A%2F%2Fwww.docker.com) | | OSS | 对象云存储 | [https://github.com/aliyun/aliyun-oss-java-sdk](https://gitee.com/link?target=https%3A%2F%2Fgithub.com%2Faliyun%2Faliyun-oss-java-sdk) | **前端技术** | 技术 | 说明 | 官网 | |-----------|--------|--------------------------------------------------------------------------------------------| | Vue | 前端框架 | [https://vuejs.org](https://gitee.com/link?target=https%3A%2F%2Fvuejs.org) | | Element | 前端UI框架 | [https://element.eleme.io](https://gitee.com/link?target=https%3A%2F%2Felement.eleme.io) | | Thymeleaf | 模板引擎 | [https://www.thymeleaf.org](https://gitee.com/link?target=https%3A%2F%2Fwww.thymeleaf.org) | | Node.js | 服务端的js | [https://nodejs.org/en](https://gitee.com/link?target=https%3A%2F%2Fnodejs.org%2Fen) | ### 架构图 **系统架构图** [![UUvRAS.png](imgs/193425_4a1056c4_4914148.png)](https://gitee.com/link?target=https%3A%2F%2Fimgchr.com%2Fi%2FUUvRAS) **业务架构图** ![UUvb7T.png](imgs/193425_9bb153d1_4914148.png) ### 环境搭建 #### 开发工具 | 工具 | 说明 | 官网 | |---------------|--------------|--------------------------------------------------------------------------------------------------------------------------------------| | IDEA | 开发Java程序 | [https://www.jetbrains.com/idea/download](https://gitee.com/link?target=https%3A%2F%2Fwww.jetbrains.com%2Fidea%2Fdownload) | | RedisInsight | redis客户端连接工具 | [https://redis.com/redis-enterprise/redis-insight/](https://gitee.com/link?target=https://redis.com/redis-enterprise/redis-insight/) | | SwitchHosts | 本地host管理 | [https://oldj.github.io/SwitchHosts](https://gitee.com/link?target=https%3A%2F%2Foldj.github.io%2FSwitchHosts) | | FinalShell | Linux远程连接工具 | [http://www.hostbuf.com/t/988.html](https://gitee.com/link?target=http://www.hostbuf.com/t/988.html) | | Navicat | 数据库连接工具 | [http://www.formysql.com/xiazai.html](https://gitee.com/link?target=http%3A%2F%2Fwww.formysql.com%2Fxiazai.html) | | PowerDesigner | 数据库设计工具 | [http://powerdesigner.de](https://gitee.com/link?target=http%3A%2F%2Fpowerdesigner.de) | | Postman | API接口调试工具 | [https://www.postman.com](https://gitee.com/link?target=https%3A%2F%2Fwww.postman.com) | | Jmeter | 性能压测工具 | [https://jmeter.apache.org](https://gitee.com/link?target=https%3A%2F%2Fjmeter.apache.org) | | Typora | Markdown编辑器 | [https://typora.io](https://gitee.com/link?target=https%3A%2F%2Ftypora.io) | | Cpolar | 内网穿透 | [https://www.cpolar.com](https://gitee.com/link?target=https://www.cpolar.com) | #### 开发环境 | 工具 | 版本号 | 下载 | |----------------|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | WSL | Linux环境 | [https://learn.microsoft.com/zh-cn/windows/wsl/install](https://gitee.com/link?target=https://learn.microsoft.com/zh-cn/windows/wsl/install) | | Docker Desktop | Docker桌面客户端 | [https://docs.docker.com/desktop/install/windows-install](https://gitee.com/link?target=https://docs.docker.com/desktop/install/windows-install) | | JDK | 1.8 | [https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html](https://gitee.com/link?target=https%3A%2F%2Fwww.oracle.com%2Fjava%2Ftechnologies%2Fjavase%2Fjavase-jdk8-downloads.html) | | Mysql | 5.7 | [https://www.mysql.com](https://gitee.com/link?target=https%3A%2F%2Fwww.mysql.com) | | Redis | Redis | [https://redis.io/download](https://gitee.com/link?target=https%3A%2F%2Fredis.io%2Fdownload) | | Elasticsearch | 7.6.2 | [https://www.elastic.co/downloads](https://gitee.com/link?target=https%3A%2F%2Fwww.elastic.co%2Fdownloads) | | Kibana | 7.6.2 | [https://www.elastic.co/cn/kibana](https://gitee.com/link?target=https%3A%2F%2Fwww.elastic.co%2Fcn%2Fkibana) | | RabbitMQ | 3.8.5 | [http://www.rabbitmq.com/download.html](https://gitee.com/link?target=http%3A%2F%2Fwww.rabbitmq.com%2Fdownload.html) | | Nginx | 1.1.6 | [http://nginx.org/en/download.html](https://gitee.com/link?target=http%3A%2F%2Fnginx.org%2Fen%2Fdownload.html) | 注意：以上的除了jdk都是采用docker方式进行安装，详细安装步骤可参考百度!!! #### 搭建步骤 > Windows环境部署 - 修改本机的host文件，映射域名端口(WSL环境与主机会共用端口) ``` #easyshop localhost easyshop.com localhost search.easyshop.com localhost member.easyshop.com localhost ware.easyshop.com localhost item.easyshop.com localhost auth.easyshop.com localhost cart.easyshop.com localhost order.easyshop.com localhost seckill.easyshop.com localhost third.easyshop.com 以上端口换成自己Linux的ip地址 ``` - 修改Linux中Nginx的配置文件 ``` 1、在nginx.conf中添加负载均衡的配置 upstream easyshop{ server host.docker.internal:6000; } 2、在conf.d目录下创建default.conf,easyshop.conf 在default.conf中添加如下配置(转发支付宝支付回调) server { listen 80; server_name localhost; charset utf-8; access_log logs/pass.access.log main; location ^~ /paid/notify { proxy_pass http://easyshop; proxy_set_header Host third.easyshop.com; } location / { root html; index index.html index.htm; } } 在easyshop.conf中添加如下配置 server { listen 80; server_name easyshop.com *.easyshop.com; charset utf-8; access_log logs/easyshop.access.log main; location / { proxy_pass http://easyshop; proxy_set_header Host $host; } #动静分离 location ~* /static/.*/.*(image|libs|bootStrap|sass|scss|script|font|images|js|fonts|img|css|imgs)/*\w+ { root html; } } ``` - 克隆前端项目 `renren-fast-vue` 以 `npm run dev` 方式去运行 - 克隆整个后端项目 `easyshop` ，并导入 IDEA 中完成编译 - 运行docker-compose up (可选)