Guns Java 应用开发框架

README

<p align="center">
    <img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/55944e0a961bf7d862aeb2a3.png" width="300">
    <br>      
    <br>      
    <p align="center">
        Guns是一个现代化的Java应用开发框架，基于主流技术Spring Boot3 + Vue3 + JDK17，Guns的核心理念是提高开发人员开发效率，降低企业信息化系统的开发成本。
        <br>
        <br>
        <a href="http://spring.io/projects/spring-boot">
            <img src="https://img.shields.io/badge/spring--boot-3.3.2-green.svg" alt="spring-boot">
        </a>
        <a href="http://mp.baomidou.com">
            <img src="https://img.shields.io/badge/mybatis--plus-3.5.7-blue.svg" alt="mybatis-plus">
        </a>  
        <a href="https://www.hutool.cn/">
            <img src="https://img.shields.io/badge/hutool-5.8.29-blue.svg" alt="hutool">
        </a>
        <a href="https://gitcode.com/javaguns/guns">
            <img src="https://gitcode.com/javaguns/guns/star/badge.svg" alt="gitcode">
        </a>
    </p>
</p>

-----------------------------------------------------------------------------------------------

## 官方网站

[https://www.javaguns.com/](https://www.javaguns.com/)

## 快速启动

### Guns v8前端启动

前端项目位置：**当前项目的guns-front-project目录下。[guns-front-project](https://gitee.com/stylefeng/guns/tree/master/guns-front-project)**

前端需要使用**Node 20**，请先安装node20，请使用yarn启动，具体启动方法如下：

```shell
# 安装依赖
yarn

# 启动前端项目
yarn run dev

# 打包
npm run build
```

### Guns v8后端启动

以下为后台启动的过程：

**重要 重要 重要**，不要手动初始化sql，因为集成了flyway会自动初始化表，准备空库即可。

1. 在mysql数据库中创建guns数据库，推荐mysql 5.7或8版本。

2. 修改`application-local.yml`中的数据库连接配置连接到您的数据库。

3. 打开`ProjectStartApplication`运行main方法即可启动。

4. 初始化账号密码：admin/123456

## 扫码关注官方公众号和官方微信群

<table>
    <tr>
        <td>官方公众号</td>
        <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/eabc8ca5ebb1b12f0d70dde0.png" width="120"/></td>
        <td>扫码邀请入群</td>
        <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/c0e5964c5ebef89cf64b0aa3.png" width="120"/></td>
    </tr>
</table>

## 更新日志

### v8.3.5-2025年11月12日

1. 恢复图片验证码功能
2. 修复前端和后端的图片验证码，可同时开启两个验证码开关
3. 【前端】美化前端登录界面，更新底图
4. 【前端】美化拖拽验证码样式，并优化图片加载速度
5. 更新业务分组相关接口，优化下拉列表接口、新增分组接口、删除分组接口
6. sys_config配置表美化界面，方便进行修改变量配置，并把常用配置放在最前
7. 整体菜单风格优化，在保留原有风格下，增加了顶部应用模式。菜单导航改为4种模式左侧垂直、左侧双排、水平、混合双列。

### v8.3.4-2025年10月28日

1. 组织加层级管理，可自定义层级标识
2. 组织机构左侧树组件增加可拖拽自定义宽度范围
3. 角色管理功能升级，增加系统角色、业务角色和公司角色的区分
4. 数据范围升级，从单一绑定数据范围增加到多条绑定数据范围
5. 修复头像刷新缓存的bug
6. 【前端】新增分割面板 GunsSplitLayout 组件
7. 【前端】CommonTable组件新增工具栏 TableTool 组件
8. 【前端】美化ant-modal的边框
9. 【前端】修改TableTool的自定义列缓存逻辑
10. 【前端】优化Selection公共选择组件整体样式
11. 【前端】Layout新增顶部菜单栏布局，新增侧栏双菜单
12. 【前端】更新vue版本，兼容npm安装
13. 【前端】美化登录页面样式
14. 【前端】修复抽屉关闭按钮不能嵌套bug
15. 【前端】修复外链跳转地址不对bug

### v8.3.0-2024年11月9日

1. 升级核心包版本，升级Guns支持Spring Boot3 + JDK17。
2. 更新message消息列表界面。
3. 更新接参数接收日期格式，支持更多的日期格式。
4. 优化文件存储位置，支持文件存储在jar包所在目录。
5. 增加国密加解密算法的工具类。
6. 增加黑白名单功能的支持，更新密码安全策略的配置支持。
7. 更新对多次重试密码锁定用户的支持。
8. 完善scanner资源扫描器的功能，针对复杂类型的字段支持效果更好。
9. file模块更新对多文件上传的支持。
10. file模块增加对文件md5值记录的功能。

### v8.1.2-2024年3月25日

1. 界面整体经过专业UI设计，更加现代化、美观，更新系统菜单和按钮相关的图标，采用iconfont库图标。
2. 用户信息增加一些常用字段，并增加用户绑定多机构功能。
3. 系统右上角增加用户多机构切换功能。
4. 系统右上角增加应用切换功能，使用应用可以为系统的菜单分类区分。
5. 优化了大部分代码，提升了系统性能。
6. 角色增加区分系统角色、业务角色、公司角色，让用户在多机构任职展示不同的权限控制。
7. 权限绑定支持上述3种角色的权限绑定。
8. 菜单界面重构，支持按应用区分多颗树的菜单，更加直观。
9. 增加安全策略功能，支持密码重试策略，次数配置，支持密码失效策略，口令最小长度等配置。
10. 优化首页常用功能的配置，可以快捷设置常用功能。
11. 怎么加独立的授权界面，可以给用户在不同机构绑定不同业务角色和公司角色。
12. 原有用户管理界面的绑定角色改为只绑定系统角色。
13. 增加独立的@DataScope注解，可以便捷设置用户权限。
14. 文档待更新，后续会陆续更新。

## Guns介绍

Guns是一个现代化的Java应用开发框架，基于主流技术**Spring Boot3 + Vue3 + Antd Vue**，Guns基于**插件化架构**，通过灵活组装插件，可以进行集成和拓展相关功能。

**Guns v8**已经发布，前后端代码以及核心包源码，均可在如下Gitee仓库可找到：

主项目：[https://gitee.com/stylefeng/guns](https://gitee.com/stylefeng/guns)

主项目GitCode地址：[https://gitcode.com/javaguns/guns](https://gitcode.com/javaguns/guns)

核心包：[https://gitee.com/stylefeng/roses](https://gitee.com/stylefeng/roses)

核心包GitCode地址：[https://gitcode.com/javaguns/roses](https://gitcode.com/javaguns/roses)

经过多年发展，Guns已在业界具有一定影响力。Guns技术架构可以直接应用到任何软件产品和技术公司自身的技术体系建设中，帮助企业解决**规范问题**，解决**复用问题**，解决**架构问题**。

<table>
  <tr>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/a93248bfd07ee178df3b7f3e.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/7e0fdb4f2e77c8364759ced1.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/39bb528b8a346a8ea6aea832.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/3e65afcc097d3079a2294704.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/bb1b85003fd2f020f4868e51.png" /></td>
  </tr>
  <tr>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/63d4d889ec387b22cae64525.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/112a0b7456b488cce86aa610.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/542a92a206f3eb8989333efa.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/e2e19df1e6e12cd447dd13ee.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/06d4241bbc1f684f80fd1e8d.png" /></td>
  </tr>
  <tr>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/d89680c8d012a71b1280f8b4.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/dcaf377e46694755b8fe0f3f.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/eefe988641a02440891a7050.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/413fb129afa45014321d966d.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/09243cc6308ce0999557fded.png" /></td>
  </tr>
  <tr>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/09e7875b4dfc9d7ff60eb4be.png" /></td>
    <td><img src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/26789f06f897cb7863ed8b65.png" /