readme.md · zhangqingwen/awesome-admin

V1.0.0
# 项目介绍
本项目基于Spring Cloud 和Ant Design Pro实现前后端管理平台一站式脚手架，便于快速开发企业级应用。我们的愿景是 基于Copy&Paste技术，实现面向Google&Baidu编程，让码农搬砖不累，做更好的良民。

项目实现：
1. admin-service基于Spring Cloud Hoxton.RELEASE(Spring boot 2.2.2RELEASE)实现配置、注册、认证等通用服务，实现一键式生产级微服务框架
2. Spring Security基于Oauth2认证并生成JWT Token，并自定义SSO统一登录页面，实现标准认证协议，保证登陆安全
3. 基于Ant Design Pro实现admin-ui, 前后端分离，使用Spring Security SSO登录页面登录，并基于JWT Token实现权限控制。全栈工程师，前后端一站式服务。
4. 所有服务均编写了DockerFile文件，可以立即实现K8s部署。实现了阿里云云效的release文件，建议通过阿里云云效实现持续集成持续交付部署，目前我们的环境云效会自动监听git代码提交,当发生代码提交时，自动编译并部署到测试的k8s容器集群环境
5. Demo服务中实现多数据源配置，redis配置，并通过注解实现基于JWT Token中角色控制API访问权限
6. 增加Swagger配置，实现自动生成api文档
7. Config服务实现测试环境和生产环境配置文件隔离
8. Registry服务支持多实例高可以用部署

# 演示地址
https://admin.awesome-coder.com

用户名:admin
密码:admin

# admin-service
## 描述
建立Spring Cloud常用微服务，包括配置服务、注册服务、认证服务，满足中小企业及个人基础框架开箱即用。支持采用阿里云云效服务和kubernetes容器服务实现生产级持续部署持续集成。

Spring cloud中最复杂的其实是认证服务，本项目认证服务已经支持
1. 实现Oauth2认证生成JWT Token
2. 定义统一登录页面实现sso登录
3. 支持自定义认证方式，实现多种方式认证
4. 支持直接通过API直接获取JWT Token，满足小程序、微信公众号等已经认证过需要直接获取token的场景

##### 启动服务
    - 首先启动config服务和registry服务
    - 启动auth服务
    - 通过注册服务http://localhost:8761 即可查看启动的服务
![注册服务](https://images.gitee.com/uploads/images/2019/1228/011228_0b1112e9_693977.png "WX20191228-010712@2x.png")

# admin-ui
## 描述
本项目基于 Ant Design Pro V4.0 定制开发，加入以下内容:
1. 通过Spring Security中的统一登录平台进行登录
2. 基于后台返回的jwt token 中的角色进行权限认证
3. 增加 nodejs server 端 Koa、Koa Router，可以直接部署
4. 增加 dockerfile 文件，可以通过k8s进行部署

## 启动

1. 安装依赖

```bash
sudo npm install tyarn -g
tyarn install
```

或者

```bash
sudo npm install cnpm -g
cnpm install
```

2. 启动项目

```bash
npm start
```

3. 启动服务端
至admin-ui目录下
```bash
node ./server/app.js
```

## 编译项目

```bash
npm run build
```

# login-ui
本项目用于Spring Security中的统一登录前端界面，实现后，需要将打包后的生产文件(build/)拷入微服务auth项目下（resources/public）

## 本地测试运行

```bash
$ npm install
$ npm start
```
## 打包
```bash
$ npm run build
```
# 效果
1. 浏览器输入localhost:8000后会自动跳转到登录页
![登录](https://images.gitee.com/uploads/images/2020/0108/141459_00154a24_804916.png "屏幕快照 2020-01-08 上午11.52.54.png")

2. 输入用户名和密码 admin/admin后,跳转到首页
![首页](https://images.gitee.com/uploads/images/2020/0108/141357_2b7b1df0_804916.png "屏幕快照 2020-01-08 上午11.53.15.png")

3. Cookie中JWT Token
![JWT Token](https://images.gitee.com/uploads/images/2020/0108/142112_b4feb450_804916.png "屏幕快照 2020-01-08 下午2.20.11.png")

4. 移动端效果

登陆

![登陆](https://images.gitee.com/uploads/images/2020/0110/102023_a40ecfdf_804916.jpeg "1.jpg")

个人设置

![个人设置](https://images.gitee.com/uploads/images/2020/0110/102046_046aa40c_804916.jpeg "2.jpg")

个人中心

![个人中心](https://images.gitee.com/uploads/images/2020/0110/102104_612ecdd3_804916.jpeg "3.jpg")

分析页

![分析页](https://images.gitee.com/uploads/images/2020/0110/102148_c1fefa1b_804916.jpeg "7.jpg")

高级表单

![高级表单](https://images.gitee.com/uploads/images/2020/0110/102220_74bed4ef_804916.jpeg "5.jpg")

基础详情

![基础详情](https://images.gitee.com/uploads/images/2020/0110/102239_5a13857b_804916.jpeg "4.jpg")

# 文档
1. Spring Security认证基本原理 https://www.jianshu.com/p/f3a0fb302ef1
2. Spring Security OAuth2.0自定义登录页面 + JWT Token配置 https://www.jianshu.com/p/122dace5d570
3. Spring Secutity 添加过滤器实现自定义登录认证 https://www.jianshu.com/p/68885d0e1cd9
4. Spring Security 自定义生成JWT Token API https://www.jianshu.com/p/afed86fb90bb

zhangqingwen/awesome-admin

简介

发行版

贡献者

近期动态

zhangqingwen/awesome-admin .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

zhangqingwen/awesome-admin