Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/Exrick/xmall

基于SOA架构的分布式电商购物商城前后端分离前台商城:Vue全家桶后台管理系统:Dubbo/SSM/Elasticsearch/Redis/MySQL/ActiveMQ/Shiro/Zookeeper等
https://github.com/Exrick/xmall
dubbo elasticsearch mq redis shiro soa ssm vue
Last synced: 9 days ago
JSON representation
基于SOA架构的分布式电商购物商城前后端分离前台商城:Vue全家桶后台管理系统:Dubbo/SSM/Elasticsearch/Redis/MySQL/ActiveMQ/Shiro/Zookeeper等
Host: GitHub
URL: https://github.com/Exrick/xmall
Owner: Exrick
License: gpl-3.0
Created: 2017-07-28T01:49:49.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2022-12-16T08:55:14.000Z (almost 2 years ago)
Last Synced: 2024-10-29T15:20:04.902Z (10 days ago)
Topics: dubbo, elasticsearch, mq, redis, shiro, soa, ssm, vue
Language: Java
Homepage: http://xmall.exrick.cn
Size: 106 MB
Stars: 7,149
Watchers: 373
Forks: 2,555
Open Issues: 38
Metadata Files:
- Readme: README.md
- License: License
Awesome Lists containing this project

README

        # XMall

[![AUR](https://img.shields.io/badge/GPL-v3-red)](https://github.com/Exrick/xmall/blob/master/License)

[![](https://img.shields.io/badge/Author-Exrick-orange.svg)](http://blog.exrick.cn)

[![](https://img.shields.io/badge/version-1.1-brightgreen)](https://github.com/Exrick/xmall)

[![GitHub stars](https://img.shields.io/github/stars/Exrick/xmall.svg?style=social&label=Stars)](https://github.com/Exrick/xmall)

[![GitHub forks](https://img.shields.io/github/forks/Exrick/xmall.svg?style=social&label=Fork)](https://github.com/Exrick/xmall)

> 作者本科毕业设计项目 期待您的捐赠支持

### [X系列项目宣传视频](https://www.bilibili.com/video/av23121122/)

- 作者亲自制作 [点我观看](https://www.bilibili.com/video/av23121122/)

### 项目已部署，在线Demo

- 前台商城：http://xmall.exrick.cn/

- 后台管理系统：http://xmadmin.exrick.cn/

### 单体版获取

- 单体XMall系统 非分布式 可跑在1g1核服务器上

- 获取方式：进入商城 http://xmall.exrick.cn/ 登陆后随意测试支付商品 填写捐赠信息 支付成功后将自动发至您填写的邮箱

### 前台页面为基于Vue的独立项目 请跳转至 [xmall-front](https://github.com/Exrick/xmall-front) 项目仓库查看

### 作者其他项目推荐

- [XPay个人免签收款支付系统](https://github.com/Exrick/xpay) 无需挂机App 自动回调

- [XMall微信小程序APP前端 现已开源！](https://github.com/Exrick/xmall-weapp)

    

    [![[email protected]](https://s2.ax1x.com/2019/10/06/ucEsBD.md.png)](https://www.bilibili.com/video/av70226175)

- [X-Boot前后端分离开发平台](https://github.com/Exrick/x-boot)

    ![](https://ooo.0o0.ooo/2020/03/13/rQGAWv1h8VMeIdi.png)

    

- 个人机器学习笔记

    - [Machine-Learning](https://github.com/Exrick/Machine-Learning)

- Spring Cloud版

    - [X-Cloud](https://github.com/Exrick/x-cloud) 框架开发中

### 基于SOA架构的分布式购物电商商城

- [x] 后台管理系统：管理商品、订单、类目、商品规格属性、用户、权限、系统统计、系统日志以及前台内容等功能

- [x] 前台系统：用户可以在前台系统中进行注册、登录、浏览商品、首页、下单等操作

- [x] 会员系统：用户可以在该系统中查询已下的订单、管理订单、我的优惠券等信息

- [x] 订单系统：提供下单、查询订单、修改订单状态、定时处理订单

- [x] 搜索系统：提供商品的搜索功能

- [x] 单点登录系统：为多个系统之间提供用户登录凭证以及查询登录用户的信息

### v1.1更新日志(需更新前后台代码及SQL)

- [x] 接入自己开源的[XPay个人免签收款支付系统](https://github.com/Exrick/xpay)

- [x] 更新Dubbo(2.6.1)、ES(6.2.3)等依赖版本 

- [x] 取消ES需在页面中配置及跨域问题，ES默认配置集群名改为原elasticsearch

- [x] 修复后台统计热卖商品SQL错误，xmall-front-web模块支持SpringMVC文件上传配置

- [x] 修改金额字段类型优化SQL与备注

- [x] 优化后台页面 修复用户修改BUG 优化批量删除 优化商品分类添加

- [x] 重构首页，后台可配置，包括3D轮播图

- [x] 后台新增缓存管理功能菜单 完成订单打印发货等功能，实现快递管理

- [x] 增添订单统计报表

- [x] 修复前后端分离极验验证码session存储问题

- [x] 实现ES IK分词插件扩展词典库管理 增添限流

- [x] 2018.7.22 取消快速搜索接口需前端配置 发送邮件端口改为465

- [x] 2018.7.27 首页导航栏可后台配置

- [x] 2019.10.06 修复分类管理BUG 开源小程序前端

- 注：SKU设计预计将在小程序后台实现

- [极验验证码移除文档](https://github.com/Exrick/xmall/wiki/%E6%9E%81%E9%AA%8C%E7%A7%BB%E9%99%A4%E6%96%87%E6%A1%A3)

![](https://ooo.0o0.ooo/2018/07/22/5b5461099039e.jpg "后台首页")

![](https://ooo.0o0.ooo/2018/07/22/5b546125886ca.jpg "商品管理")

![](https://ooo.0o0.ooo/2018/07/22/5b54613bc866f.jpg "管理员编辑")

![](https://ooo.0o0.ooo/2018/07/22/5b54615b95788.jpg "前台首页")

![](https://ooo.0o0.ooo/2018/07/22/5b5461756b2b0.jpg "ES分词搜索")

### 项目架构及功能模块图

![](https://ooo.0o0.ooo/2018/07/22/5b5461926969b.png)

![](https://ooo.0o0.ooo/2018/07/22/5b5461aa2fdee.jpg)

![](https://ooo.0o0.ooo/2018/07/22/5b5461c54cb55.jpg)

### 前端所用技术

- 后台页面

    - 感谢 [H-ui](http://www.h-ui.net/)、[FlatLab](https://github.com/Exrick/xmall/blob/master/study/FlatLab.md) 提供静态页面支持

    - [Ztree](http://www.treejs.cn/v3/main.php#_zTreeInfo)：jQuery树插件

    - [DataTables](http://www.datatables.club/)：jQuery表格插件

    - [Layer](http://layer.layui.com/)：web弹层组件

    - [Distpicker](https://github.com/fengyuanchen/distpicker)：中国省市区地址三级联动插件

    - [KindEditor](https://github.com/kindsoft/kindeditor)：富文本编辑器 简洁方便 没UEditor那么多坑

    - [WebUploader](http://fex.baidu.com/webuploader/getting-started.html)：百度文件上传插件

    - [HighCharts](http://www.hcharts.cn/)：图表库

    - [不蒜子](http://busuanzi.ibruce.info/)：极简网页计数器

- 前台页面

    - 详情请跳转至 [xmall-front](https://github.com/Exrick/xmall-front) 项目仓库

    - 感谢 [yucccc](https://github.com/yucccc) 的开源 [vue-mall](https://github.com/yucccc/vue-mall) 项目提供前端页面及框架支持

    - Vue2 + Vuex + Vue Router + Element UI + ES6 + webpack + axios + Node.js

    

### 后端所用技术

##### 各框架依赖版本皆使用目前最新版本 可进入xmall-parent中 [pom.xml](https://github.com/Exrick/xmall/blob/master/xmall-parent/pom.xml) 查看

- Spring

- [SpringMVC](https://github.com/Exrick/xmall/blob/master/study/SpringMVC.md)

- MyBatis

- [Dubbo](https://github.com/Exrick/xmall/blob/master/study/Dubbo.md)

- [ZooKeeper](https://github.com/Exrick/xmall/blob/master/study/Zookeeper.md)

- MySQL

- Mycat：数据库分库分表中间件

- [Redis](https://github.com/Exrick/xmall/blob/master/study/Redis.md)：缓存

- [Elasticsearch](https://github.com/Exrick/xmall/blob/master/study/Elasticsearch.md)：基于Lucene分布式搜索引擎

- [ActiveMQ](https://github.com/Exrick/xmall/blob/master/study/ActiveMQ.md)：消息队列

- [Druid](http://druid.io/)：阿里高性能数据库连接池

- Shiro：安全框架

- [Swagger2](https://github.com/Exrick/xmall/blob/master/study/Swagger2.md)：Api文档生成

- Docker

- [Nginx](https://github.com/Exrick/xmall/blob/master/study/Nginx.md)

- Tomcat

- [Maven](https://github.com/Exrick/xmall/blob/master/study/Maven.md)

- 第三方SDK

    - [七牛云文件存储服务](https://developer.qiniu.com/kodo/sdk/1239/java)

    - ~~[极验Test-button人机验证码](http://www.geetest.com/Test-button.html)~~ 因其收费见[极验验证码移除文档](https://github.com/Exrick/xmall/wiki/%E6%9E%81%E9%AA%8C%E7%A7%BB%E9%99%A4%E6%96%87%E6%A1%A3)

- 第三方插件

    - [hotjar](https://github.com/Exrick/xmall/blob/master/study/hotjar.md)：一体化分析和反馈

    - [搜狐畅言评论插件](http://changyan.kuaizhan.com/)

- 第三方接口

    - [Mob全国天气预报接口](http://api.mob.com/#/apiwiki/weather)：需注册账号创建应用后申请填入AppKey

- 其它开发工具

    - Jenkins：持续集成

    - [JRebel](https://github.com/Exrick/xmall/blob/master/study/JRebel.md)：开发热更新

    - [阿里JAVA开发规约插件](https://github.com/alibaba/p3c)

### 文件说明

- `xmall` 文件夹提供部分依赖与sql文件

    - xmall.sql：数据库文件

    - dubbo.xsd：需手动配置避免报错

    - redis-3.0.0.gem：Redis集群搭建所需Ruby库

- `generatorSqlmapCustom` 文件夹为 [Mybatis Generator](http://www.mybatis.org/generator/) 逆向生成工具，且已配置好maven插件

### 本地开发运行部署

- 下载zip直接解压或安装git后执行克隆命令 `git clone https://github.com/Exrick/xmall.git`

- 安装各中间件并启动：[ZooKeeper](https://github.com/Exrick/xmall/blob/master/study/Zookeeper.md)、[Redis](https://github.com/Exrick/xmall/blob/master/study/Redis.md)、[ActiveMQ](https://github.com/Exrick/xmall/blob/master/study/ActiveMQ.md)、[Elasticsearch](https://github.com/Exrick/xmall/blob/master/study/Elasticsearch.md)

- 修改各配置文件相应依赖IP配置(默认本地127.0.0.1)，以及七牛云、极验配置、天气接口在 `xmall-common - utils` 中找到修改，XPay邮箱配置在 `manager-service与sso-service` 中

- [Maven安装和在IDEA中配置](https://github.com/Exrick/xmall/blob/master/study/Maven.md)

- 使用IDEA([破解/免费注册](http://idea.lanyus.com/)) `File-Open` 直接打开xmall项目，点击右下角 `Import Changes` 等待安装完依赖即可

- MySQL数据库新建 `xmall` 数据库，运行sql文件，注意在有 `db.properties` 的模块中修改你的数据库连接配置

- 按照依赖顺序分别在每个模块文件夹根目录执行 `mvn install` 命令

- 项目需运行除 `xmall-parent` `xmall-common` 以外其它所有6个服务，且都已配置好Tomcat插件, 执行命令 `mvn tomcat7:run` 或在IDEA中使用插件(`View - Tool Buttons - 右侧菜单Maven Projects - tomcat7 - tomcat7:run`)运行即可，当然可自行配置

- 后端管理系统默认端口8888 http://localhost:8888 管理员账密admin|123456

- 前端项目接口默认端口7777 前台页面请启动基于Vue的 [xmall-front](https://github.com/Exrick/xmall-front) 项目，并修改其接口配置

### 相关技术点说明

- ES-IK分词插件词典库扩展

    - 详见 [elasticsearch-analysis-ik插件作者项目README说明](https://github.com/medcl/elasticsearch-analysis-ik)

    - 本项目中扩展接口和禁用词接口分别为 `http://localhost:8888/getDictList` 和 `http://localhost:8888/getStopDictList`，将以上2个接口配置进IK插件扩展配置文件{conf}/analysis-ik/config/IKAnalyzer.cfg.xml 或者 {plugins}/elasticsearch-analysis-ik-*/config/IKAnalyzer.cfg.xml中即可，示例：

    ```xml

    

    

    

        IK Analyzer 扩展配置

        

        http://localhost:8888/getDictList

        

        http://localhost:8888/getStopDictList

    

    ```

- 限流

    - `xmall-front-web` 中已配置限流，配置文件 `resource.properties` 中可配置全局限流，示例：

        ```properties

        #启用全局限流

        xmall.rateLimit.enable=true

        #每1秒内

        xmall.rateLimit.timeout=1000

        #限制10个请求

        xmall.rateLimit.limit=10

        ```

    - 指定方法限流注解

        ```java

        @RateLimiter(limit = 1, timeout = 5000)

        ```

    - 支持多维度IP、uid等限流 详见代码

### 技术疑问交流

- QQ交流群 `475743731(付费)`，可获取各项目详细图文文档、xmall毕设PPT [![](http://pub.idqqimg.com/wpa/images/group.png)](http://shang.qq.com/wpa/qunwpa?idkey=7b60cec12ba93ebed7568b0a63f22e6e034c0d1df33125ac43ed753342ec6ce7)

- 免费交流群 `562962309` [![](http://pub.idqqimg.com/wpa/images/group.png)](http://shang.qq.com/wpa/qunwpa?idkey=52f6003e230b26addeed0ba6cf343fcf3ba5d97829d17f5b8fa5b151dba7e842)

- 作者博客：[http://blog.exrick.cn](http://blog.exrick.cn)

### 商用授权

- 个人学习使用遵循GPL开源协议

- 商用需联系作者低价授权

### [捐赠](http://xmall.exrick.cn)