# EDEN-MACE **Repository Path**: codingdb/distribution_management ## Basic Information - **Project Name**: EDEN-MACE - **Description**: 微服务下的分销管理利器，更加灵活的管理佣金，涵盖并且总结了目前流行的分销模式，让分销更加简单,后期开发立足于产业互联网，致力于打通产业内部之间的联系，有问题可以加qq 3174667330，欢迎大家star,你的鼓励是开发的动力 - **Primary Language**: Java - **License**: MulanPSL-1.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1253 - **Forks**: 673 - **Created**: 2018-04-04 - **Last Updated**: 2025-06-13 ## Categories & Tags **Categories**: erp **Tags**: None ## README ## 分销管理系统（EDEN-MACE） ### 视频教程 链接：https://pan.baidu.com/s/1he3Tnk324JKoMPsbtEPcyw 提取码：p20v 1.分销系统概览 2.分润计算 ## 相关软件下载 zookeeper下载:https://pan.baidu.com/s/184q_XyAL-R7n4KZnOgUs1w 如果Maven下载慢，请参考网站，[maven加速网站](https://gitee.com/codingdb/recently-available-airports)，可以让镜像下载的更快一点 ### 更新记录 * 2020-07-26 系统优化，以及增加可视化插件 * 2020-04-02 增加同步老系统数据插件 * 2019-11-06 增加docker部署(参考[传送门](https://my.oschina.net/u/3704586/blog/3126725)) * 2019-09-26 增加zk分布式锁 * 2019-07-05 定时任务bug修复 * 2019-05-21 新增代理-会员关系图 * 2019-05-19 重构分润核心代码,增加分段计算分润的方式，让分润更加精准化,防止因分润带来财务风险 * 2019-05-08 新增账务使用模板方法，新增账务更加快捷 * 2019-02-26 数据清理，一键初始化数据库 * 2019-02-12 优化界面查询，重构后端分页，增加会员邀请限制 * 2019-01-22 更新邀请会员接口，可以支持邀请会员或者平台任选一个 ### 模块介绍 dist-primary 分销主模块 dist-front 模拟前端 dist-api 分销接口调用插件 #### 前言 随着微信等社交工具的出现，很多软件出现了通过人脉赚钱的方式，每个人通过各种方式将数据传递给另外的人，通过这种分裂式的发展，使得产品能够得到有效的推广，并且可以进行有效的精准推广，于是市场上产生了很多的微信三级分销等软件，也有很多成功的产品，比如拼多多等，根据我个人了解 很多初创企业 都使用这种模式，在产品刚刚上线的时候就使用这种模式，为企业赚得了第一桶金。 但是我们用第三方软件，有很多问题，比如 很多东西都不能够定制化，很多业务不够满足自己产品的需求，于是只能"凑合着用",有些公司会定制开发，产生了很大的开发成本和时间，在任何一个产品上线的时候，时间就是产品的生命线，尤其是遇到不熟悉这些业务的开发的时候 ，可能需求和产品会产生误差，会导致产品拖延很长时间。 我通过对分销系统多年的研究发现，分销的分润和等级的计算完全在后台进行配置化管理，将抽象的分销系统具体化，前端可以单独开发，开发成本和时间完全可以进行控制，于是就开发这样的一套系统。 > primary 分销主项目，用于分销配置和api的调用 > front 为了更加的形象,模拟前端对接，主要是http调用api接口 ### 我们的价值 > 对于程序员 ，可以学到技术和业务逻辑紧密结合，用业务作为跳板去学习技术 > 对于企业，可以实现企业的推广，快速将人脉变现 > 立足产业互联网，打造产业互联网每个环节的利润点，致力于打通产业内部之间的联系，做产业之间的核心和纽带 ### 产品亮点 1、权限和分销完全分离，符合开发的 低耦合的需求。 2、产品完全可配置化，仅需要少量改动 3、采用微服务思想，和原业务低耦合 ，不需要的时候可以随时下线。 4、可视化图形化界面统计。 5、完善化的账务体系，可追溯每一笔分润的来源。 ### 适用企业 1、已有项目，需要增加分销功能。 2、项目需要暂时使用分销功能。 3、对接多个系统，需要对多个账户进行控制的系统 ### 场景案例 1. 电商商品需要增加购买商品分佣功能 2. 广告网站需要增加邀请奖励功能 3. 金融机构需要增加推广奖励 的功能 ### 目标 企业级软件，为企业低成本、高效率、快速的盈利。 ### 开源地址 https://gitee.com/codingdb/distribution_management ### 技术特色 1、引用guns 权限管理系统 2、采用spring boot 简化了配置、并且将开发环境的配置和生产环境配置分离开。 3、jwt 安全验证。 4、将权限数据库和业务数据库进行分离 5、采用quartz进行任务调度，直接修改数据库即可 6、采用枚举类和数据字典配合的方式进行数据维护，不必要的地方直接调用枚举类，减少数据库的调用。 7、策略模式和简单工厂模式实现佣金的扩展，可以很容易的扩展分销系统。 8、 采用swagger方式对外开放接口,并且使用restful风格。 9、采用阿里云编码规约。 10、分销商自动分配权限。 11、自动权限配置功能。 ### 代码展示 枚举类实现自动计算分润 ```java ZERO_STATUS("0","按照百分比计算") { @Override public BigDecimal calResult(BigDecimal amount, BigDecimal arg) { return amount.multiply(arg); } } ``` 策略模式实现分佣账户的扩展 ```java public AmountFactoryContext(String type) { switch (type){ case "0": amountService = new TradeAmountServiceImpl(); break; case "1": amountService = new LevelAmountServiceImpl(); break; default: break; } } ``` ### 项目总览 项目使用场景图示 ![输入图片说明](https://gitee.com/uploads/images/2018/0609/190905_38816529_1497609.png "分销场景.png") 分销功能架构图 ![输入图片说明](https://images.gitee.com/uploads/images/2018/0828/101219_4d445e9d_1497609.jpeg "代理分销.jpg") 分销内部设计图 ![输入图片说明](https://gitee.com/uploads/images/2018/0510/085941_47511fa1_1497609.png "未命名文件.png") ### 项目说明 distribution_management 用来运行分销管理系统 plug用来调试接口，调试完成后，可以直接使用 ### 安装方法 下载此项目后，generator.ExecuSql 修改数据库和密码，可以自动导入sql。 运行/distribution_management 目录下的项目,访问http://localhost/。 账号 ： admin /111111 ​ dist/123 ### 项目特色 #### 经典分销模式 如下图中的分销模式，就可以很好的与本系统对接 ![输入图片说明](https://gitee.com/uploads/images/2018/0503/203047_afd028a5_1497609.png "未命名文件.png") #### 强大的账户体系 ![输入图片说明](https://gitee.com/uploads/images/2018/0530/161429_4728a749_1497609.png "账户系统 (1).png") #### 系统可拔插 ​ 系统以微服务的形式运行，即独立于其他的软件，提供接口进行交互，不会对其他的系统产生新的冗余数据。 ​ 假设**李老板** 前期需要推广自己的软件，自己的软件又没有设计这个功能，加功能又需要很多钱，这个时候，使用这个软件就可以减少资金的投入（写很少的代码就可以实现自己的需求）。 系统稳定了，**李老板** 不需要这个分销软件了， 那么可以直接将原来的几行代码关了，或者在自己的系统中增加开关，直接就可以关掉。并且不影响原来的系统的运行。 #### 分销配置化 假设平台原来只设置一级又分润，后面需要给二级或者三级分润，这个时候只需要在后台进行配置就可以。平台 如果设置原来的配置每笔交易按照百分比收取，后来改为每笔交易按照固定金额收取，就可以直接在后台进行配置。 如下图中的分润配置，可以根据各种情况进行配置分润。 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/124938_5c6bfe2a_1497609.jpeg "1.jpg") #### 会员关系可视化 会员的发展理论上可以无限制的发展下去，并且可以通过树状图表现出来。 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125057_50d7945a_1497609.png "2.png") #### 分销关系权限化 每个分销商只能看到自己名下的会员。并且可以看到自己的交易明细，这个就减少原有的系统的开发。 #### 积分控制可视化 ![输入图片说明](https://images.gitee.com/uploads/images/2018/0723/003756_50bc8665_1497609.jpeg "积分模块.jpg") ### 平台简介 对接参考，用来对系统进行对接，并且已经写好了的模拟接口，可以模仿使用 ![输入图片说明](https://gitee.com/uploads/images/2018/0531/232723_3195cc5d_1497609.jpeg "1.jpg") 会员信息对会员账号和会员资金进行管理 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125304_39f85ddb_1497609.jpeg "3.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125317_29b491b0_1497609.jpeg "4.jpg") 分销配置用来配置分润等信息 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125606_c861fc15_1497609.jpeg "5-1.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125615_ba303b29_1497609.jpeg "5-2.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125626_1eb5a8fc_1497609.jpeg "5-3.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125635_36af37a0_1497609.jpeg "5-4.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125642_78bde0ea_1497609.jpeg "5-5.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125651_2e20c013_1497609.jpeg "5-6.jpg") 交易中心 集中对收入和支出进行管理 ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125745_1d7fd7a7_1497609.jpeg "6-1.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125759_5e0ef61c_1497609.jpeg "6-2.jpg") 统计中心 对数据进行统计 交易动态，可以查看最新的交易成功的动态 ![输入图片说明](https://gitee.com/uploads/images/2018/0609/143627_87c48977_1497609.jpeg "111.jpg") 账户收益统计图 ![输入图片说明](https://gitee.com/uploads/images/2018/0610/120127_3fc5142b_1497609.jpeg "111.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2019/0802/125900_97438488_1497609.jpeg "7.jpg") ### 模拟前端界面展示 ![输入图片说明](https://images.gitee.com/uploads/images/2018/1210/214443_ab8b49e4_1497609.jpeg "11.jpg") ![输入图片说明](https://images.gitee.com/uploads/images/2018/1210/214455_da5952e1_1497609.jpeg "22.jpg") ### 利用docker 本地部署 inside docker folder, start docker by ``` $ ./start.sh ``` Then dump the data inside docker folder, access mysql container by ``` $ docker exec -it distribution-mysql bash -l $ mysql -uroot -p $ source /docker-entrypoint-initdb.d/distribution.sql; $ source /docker-entrypoint-initdb.d/authority.sql; ``` 注意： 这里mysql 的port 是 6603， 需要在application-dev.yml 中替换成相应的port.