guns/README.md

184 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<p align="center">
<img src="https://images.gitee.com/uploads/images/2019/0109/214218_d2aa949b_551203.png" width="300">
<br>
<br>
<p align="center">
Guns是一个现代化的Java应用开发框架基于主流技术Spring Boot2 + Vue3Guns的核心理念是提高开发人员开发效率降低企业信息化系统的开发成本。
<br>
<br>
<a href="http://spring.io/projects/spring-boot">
<img src="https://img.shields.io/badge/spring--boot-2.4.2-green.svg" alt="spring-boot">
</a>
<a href="http://mp.baomidou.com">
<img src="https://img.shields.io/badge/mybatis--plus-3.4.0-blue.svg" alt="mybatis-plus">
</a>
<a href="https://www.hutool.cn/">
<img src="https://img.shields.io/badge/hutool-5.4.4-blue.svg" alt="hutool">
</a>
<a href="http://ibeetl.com/">
<img src="https://img.shields.io/badge/beetl-3.3.1-yellow.svg" alt="beetl">
</a>
</p>
</p>
-----------------------------------------------------------------------------------------------
## 官方网站
[https://www.javaguns.com/](https://www.javaguns.com/)
## 快速启动
Guns v7.3.0前端启动详情见:[https://gitee.com/stylefeng/guns-vue3-admin](https://gitee.com/stylefeng/guns-vue3-admin)
以下为后台启动的过程:
**启动前注意事项最新v7.3.0的核心包同步到中央仓库失败再次同步会有延迟请先手动下载Roses项目并本地install一下Roses核心包到本地Maven仓库**
Roses项目的地址下载master分支即可[https://gitee.com/stylefeng/roses](https://gitee.com/stylefeng/roses)
1. 在mysql数据库中创建guns数据库推荐mysql 5.7或8版本。
2. 修改`application-local.yml`中的数据库连接配置连接到您的数据库。
3. 打开`GunsApplication`运行main方法即可启动新版无需运行sql初始化文件因为集成了flyway会自动初始化表。
4. 初始化账号密码admin/123456
## 扫码关注官方公众号和官方微信群
<table>
<tr>
<td>官方公众号</td>
<td><img src="https://images.gitee.com/uploads/images/2019/0415/104911_9bc924a5_551203.png" width="120"/></td>
<td>扫码邀请入群</td>
<td><img src="https://images.gitee.com/uploads/images/2019/0419/103622_d6e9fa5d_551203.png" width="120"/></td>
</tr>
</table>
## 更新日志
### v7.3.0
最新v7.3.0版本,有两个大的新特性:
1. 移除前后端不分离Layui的前端界面提供Vue版本的前端集成。从v7.3.0起将不再支持Layui版本的更新如需旧版本可以在Gitee Tag中找到历史版本
2. 提供对Guns-DevOps的快速集成方式。之前DevOps平台仅支持CentOS的一键部署现在使用v7.3.0可以通过pom集成的方式直接启动Guns项目就可以启动Guns-DevOps平台但仍需配置秘钥。
#### devops集成指南
devops功能以Jar包集成的方式集成到项目Guns-DevOps功能不开放源码。
1. [点此下载Guns私服库的maven settings.xml](https://gitee.com/stylefeng/guns/blob/master/_devops/settings.xml) 替换掉你的本地的maven配置文件。
2. 在Guns项目的pom.xml中引入如下模块
```xml
<!--Guns-DevOps集成-->
<dependency>
<groupId>cn.stylefeng.roses</groupId>
<artifactId>kernel-s-devops-integration</artifactId>
<version>${roses.kernel.version}</version>
</dependency>
```
3. **关键**,在[https://javaguns.com/](https://javaguns.com/) 官网注册一个号,在官网右上角个人信息,申请一个平台秘钥,并在`application.yml`中配置`user.key`
```shell
# yml配置文件中加入如下配置
user:
key: xxxxxxxx
```
4. 启动项目后界面上点击右上角即可跳转到Guns-DevOps平台
![](.README_images/1ae18fee.png)
5. 项目上线后再把Guns-DevOps相关依赖删掉以减轻Jar包的重量
## Guns介绍
Guns是一个现代化的Java应用开发框架基于主流技术**Spring Boot2 + Vue3 + Antd Vue**Guns基于**插件化架构**,通过灵活组装插件,可以进行集成和拓展相关功能。
**Guns v7.3.0**已经发布前后端代码以及核心包源码均可在如下Gitee仓库可找到
前端代码:[https://gitee.com/stylefeng/guns-vue3-admin](https://gitee.com/stylefeng/guns-vue3-admin)
后端代码:[https://gitee.com/stylefeng/guns](https://gitee.com/stylefeng/guns)
核心包:[https://gitee.com/stylefeng/roses](https://gitee.com/stylefeng/roses)
经过多年发展Guns已在业界具有一定影响力。Guns技术架构可以直接应用到任何软件产品和技术公司自身的技术体系建设中帮助企业解决**规范问题**,解决**复用问题**,解决**架构问题**。
![](.README_images/4e63346d.png)
![](.README_images/223a7ade.png)
![](.README_images/9f05f0d3.png)
![](.README_images/49e229cb.png)
## Guns功能列表
- 1.控制面板
- 2.用户管理
- 3.职位管理
- 4.机构管理
- 5.应用管理
- 6.角色管理
- 7.菜单管理
- 8.资源查看
- 9.系统配置
- 10.字典管理
- 11.在线用户
- 12.定时任务
- 13.文件管理
- 14.多数据源
- 15.操作日志
- 16.登录日志
- 17.通知管理
- 18.SQL监控
- 19.服务器信息
- 20.持续更新...
## Guns插件列表
Guns默认封装了很多功能插件引用这些插件并使用相关接口开箱即用也可以以插件化方式拓展自定义的插件
- 1.缓存插件内存和Redis
- 2.系统配置
- 3.多数据源插件
- 4.邮件插件
- 5.文件插件minio、本地、阿里云、腾讯云
- 6.groovy脚本
- 7.jwt插件
- 8.日志插件(文件、数据库)
- 9.excel导出
- 10.拼音转化
- 11.短信插件(阿里云、腾讯云)
- 12.websocket
- 13.定时任务
- 14.参数校验
- 15.wrapper包装
- 16.C端用户
- 17.Demo拦截器
- 18.消息插件
- 19.持续更新...
## Guns曾获荣誉
*Gitee GVP最有价值开源项目。*
*开源中国2018年度最受欢迎中国开源软件。*
*开源中国2019年度最受欢迎中国开源软件。*
*开源中国2020年度最受欢迎中国开源软件。*
*开源中国2021年度最受欢迎中国开源软件。*
*2021“科创中国”开源创新榜年度优秀开源产品。*
![1-4](.README_images/1-4.png)
![1-5](.README_images/1-5.png)