1 Star 0 Fork 416

何兆汉 / mango-platform

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
Clone or download
README.md 10.35 KB
Copy Edit Web IDE Raw Blame History
朝雨忆轻尘(Louis) authored 2019-06-05 10:58 . 更新 README.md

mango

项目介绍

Mango后台权限管理系统是基于Spring Boot、Spring Cloud、Vue.js 、Element UI等主流前后端技术,采用前后端分离架构实现的权限管理系统。也是一款采用当前主流技术实现的界面优雅、架构优良、代码简洁、注释完善、基础功能相对完整的JAVA EE快速开发平台,前后端开发人员都可以以此为范例从中学习和汲取技术知识,也可以基于此系统开发和实现具体生产项目。

此项目为笔者和清华大学出版社合作出版的专业书籍《Spring Boot+Spring Cloud+Vue+Element项目实战:手把手教你开发权限管理系统》的配套附件,附件内容包含书籍项目相关源码、数据库脚本、项目安装和运行教程等。

书籍封面

输入图片说明

书籍链接

京东 参考链接:

https://item.jd.com/49029589963.html

https://item.jd.com/48751078393.html

当当 参考链接:

http://product.dangdang.com/1438252364.html

天猫 参考链接:

https://detail.tmall.com/item.htm?spm=a220m.1000858.1000725.16.a4721049QUevoi&id=595707200013

https://detail.tmall.com/item.htm?spm=a220m.1000858.1000725.6.a4721049QUevoi&id=596116466076

技术交流

为了方便大家提问和技术交流,整了个QQ群,欢迎童鞋们加入。

QQ技术交流群: 429854222

笔者技术博客:https://www.cnblogs.com/xifengxiaoma/

功能列表

✔ 系统登录:系统用户登录,系统登录认证(token方式)

✔ 用户管理:新建用户,修改用户,删除用户,查询用户

✔ 机构管理:新建机构,修改机构,删除机构,查询机构

✔ 角色管理:新建角色,修改角色,删除角色,查询角色

✔ 菜单管理:新建菜单,修改菜单,删除菜单,查询菜单

✔ 字典管理:新建字典,修改字典,删除字典,查询字典

✔ 配置管理:新建配置,修改配置,删除配置,查询配置

✔ 登录日志:记录用户的登录日志,查看系统登录日志记录

✔ 操作日志:记录用户的操作日志,查看系统操作日志记录

✔ 在线用户:根据用户的登录状态,查看统计当前在线用户

✔ 数据监控:定制Druid信息,提供简洁有效的SQL数据监控

✔ 聚合文档:定制Swagger文档,提供简洁美观的API文档

✔ 备份还原:系统数据备份还原,一键恢复系统初始化数据

✔ 主题切换:支持主题切换,自定主题颜色,实现一键换肤

✔ 服务治理:集成Consul注册中心,实现服务的注册和发现

✔ 服务监控:集成Spring Boot Admin,实现全方位的服务监控

✔ 服务消费:集成Ribbon、Feign,实现服务调用和负载均衡

✔ 服务熔断:集成Hystrix、Turbine,实现服务的熔断和监控

✔ 服务网关:集成Spring Cloud Zuul,实现统一API服务网关

✔ 链路追踪:集成Sleuth、Zipkin,实现服务分布式链路追踪

✔ 配置中心:集成Cloud Config和Bus,实现分布式配置中心

软件架构

前端架构

开发环境

IDE : VS Code 1.27

NODE: Node 10.15.x

NPM : NPM 6.4.x

技术选型

前端框架:Vue 2.x

页面组件:Element 2.x

状态管理:Vuex 2.x

后台交互:axios 0.18.x

图标使用:Font Awesome 4.x

项目结构

mango-ui

-- build:项目编译相关模块,项目模板自动生成

-- config:项目配置相关模块,项目模板自动生成

-- src:项目源码模块,前端开发工作集中在此目录

 -- assets: 图标、字体、国际化信息等静态信息

 -- components: 组件库,对常用组件进行封装

 -- http: 后台交互模块,统一后台接口请求API

 -- i18n: 国际化模块,使用Vue i18n进行国际化

 -- mock: Mock模块,模拟接口调用并返回定制数据

 -- permission: 权限控制模块,处理权限认证逻辑

 -- router: 路由管理模块,负责页面各种路由配置

 -- store: 状态管理模块,提供组件间状态共享

 -- utils: 工具模块,提供一些通用的工具方法

 -- views: 页面模块,主要放置各种页面视图组件

后端架构

开发环境

IDE : eclipse 4.x

JDK : JDK1.8.x

Maven : Maven 3.5.x

MySQL: MySQL 5.7.x

Consul: Consul 1.4.0

技术选型

核心框架:Spring Boot 2.x

服务治理:Spring Cloud Finchley

安全框架:Spring Security 5.x

视图框架:Spring MVC 5.x

持久层框架:MyBatis 3.x

数据库连接池:Druid 1.x

消息队里:RabbitMQ

接口文档:Swagger 2.9.x

日志管理:SLF4J、Log4j

项目结构

mango-common: 公共代码模块,主要放置一些工具类

mango-core: 封装业务模块,主要封装公共业务模块

mango-admin: 后台管理模块,包含用户、角色、菜单管理等

mango-backup: 系统数据备份还原模块,可选择独立部署

mango-monitor: 系统监控服务端,监控Spring Boot应用

mango-producer: 服务提供者示例,方便在此基础上搭建模块

mango-consumer: 服务消费者示例,方便在此基础上搭建模块

mango-hystrix: 服务熔断监控模块,收集汇总熔断统计信息

mango-zuul: API服务网关模块,统一管理和转发外部调用请求

mango-config: 配置中心服务端,生成GIT配置文件的访问接口

mango-consul: 注册中心,安装说明目录,内附安装引导说明

mango-zipkin: 链路追踪,安装说明目录,内附安装引导说明

config-repo: 配置中心仓库,在GIT上统一存储系统配置文件

mango-pom: 聚合模块,仅为简化打包,一键执行打包所有模块

安装教程

前端安装

获取源码

获取前端源码,整个前端只有一个工程mango-ui,将其拷贝放置到本地目录。

编译源码

在mango-ui目录下打开CMD终端,执行 npm install, 下载和安装项目依赖包。

启动系统

执行 npm run dev 命令,启动项目,启动之后通过 http://localhost:8080 访问。

项目打包

执行 npm run build 命令,进行前端项目打包,打包完成之后会生成 dist 目录。 将生成的目录直接放置到如Tomcat之类的WEB服务器,启动服务即可访问。

Mock 开关

本系统采用前后端分离架构,前端若开启Mock模块,可以模拟大部分接口数据。 通过修改src/mock/index.js中的openMock变量,可以一键开启或关闭Mock功能。

修改配置

如果想自定义端口(默认是8080),可以修改 config/index.js 下的 port 属性。 后台接口和备份服务器地址配置在 src/utils/global.js,如有修改请做相应变更。

后端安装

获取源码

获取后端源码,获取上面所列所有项目结构,将其拷贝放置到本地目录。

导入工程

使用 Eclipse导入 Maven 项目,在此之前请确认已安装 JDK 和 Maven 工具。

编译源码

找到 mango-pom 工程下的 pom.xml,执行 maven clean install 命令进行一键打包。 一般来说不会有什么问题,如果还打包失败,可以按照优先级逐个编译试一试。

导入数据库

新建mango数据库,使用项目sql目录下的mango.sql 脚本,导入初始化数据库。 修改 mango-admin 下 application.yml 中的数据源配置信息为自己的数据库配置。 修改 mango-backup下 application.yml 中的数据源配置信息为自己的数据库配置。

启动系统
基础必需模块(注册中心:mango-consul,服务监控:mango-monitor)

找到 mango-consul 工程,根据安装说明安装注册中心,执行 consul agent -dev 启动。 找到 mango-monitor 工程下的MangoMonitorApplication, 启动项目,开启服务监控。

权限管理模块(权限管理:mango-admin,备份还原:mango-backup)

找到 mango-admin 工程下的MangoAdminApplication, 启动项目,开启权限系统服务。 找到 mango-backup 工程下的MangoBackupApplication.java,启动项目,开启备份服务。

其他示例模块(Spring Cloud示例模块,作为开发模板和范例,根据需要启动)

以下为Spring Cloud体系各种功能的实现范例,可以根据需要启动,后续扩展开发也可以作为参考和模板使用,具体使用教程请参考本书后面Spring Cloud系列教程的章节,关于Spring Cloud体系的各种功能模块都有详细的讲解和完整的案例实现。

这些示例模块包括:

mango-producer: 服务提供者示例,演示服务提供者的实现

mango-consumer: 服务消费者示例,演示服务消费者的实现

mango-hystrix: 服务熔断监控模块,演示熔断监控功能的实现

mango-zuul: API服务网关模块,演示API统一网关的实现

mango-config: 配置中心服务端,演示分布式配置中心的实现

注意事项:

注册中心是基础服务,需要先安装Consul,找到mango-consul工程,根据安装说明安装Consul。

如果需要链路追踪服务,需要安装zipkin,找到mango-zipkin 工程,根据安装说明安装zipkin。

如果需要配置中心服务,需要安装rabbitMQ,找到mango-config 工程,根据安装说明安装rabbitMQ。

参与贡献

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

码云特技

  1. 使用 Readme_XXX.md 来支持不同的语言,例如 Readme_en.md, Readme_zh.md
  2. 码云官方博客 blog.gitee.com
  3. 你可以 https://gitee.com/explore 这个地址来了解码云上的优秀开源项目
  4. GVP 全称是码云最有价值开源项目,是码云综合评定出的优秀开源项目
  5. 码云官方提供的使用手册 https://gitee.com/help
  6. 码云封面人物是一档用来展示码云会员风采的栏目 https://gitee.com/gitee-stars/

Comment ( 0 )

Sign in for post a comment

Java
1
https://gitee.com/LeftJson/mango-platform.git
git@gitee.com:LeftJson/mango-platform.git
LeftJson
mango-platform
mango-platform
master

Search