# xmall **Repository Path**: dingjunjun_codeSpace/xmall ## Basic Information - **Project Name**: xmall - **Description**: 基于SOA架构的分布式电商购物商城 前后端分离 前台商城:Vue全家桶 后台管理系统:Dubbo/SSM/Elasticsearch/Redis/MySQL/ActiveMQ/Shiro/Zookeeper等 - **Primary Language**: Java - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: http://xmall.exrick.cn/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 815 - **Created**: 2023-02-27 - **Last Updated**: 2023-02-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## 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) [![WX20190924-234416@2x.png](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)