# warm-sun

**Repository Path**: lingxing/warm-sun

## Basic Information

- **Project Name**: warm-sun
- **Description**: 基于solon开发，jdk17+satoken+redisx/redisson+mybaits-flex+hutool+jackson+mapstruct+poi
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 51
- **Created**: 2023-10-10
- **Last Updated**: 2024-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">    <img alt="logo" src="https://oscimg.oschina.net/oscnet/up-d3d0a9303e11d522a06cd263f3079027715.png"></p><h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">warm-sun v0.0.1</h1><h4 align="center">基于solon+Vue3前后端分离的Java快速开发框架</h4><p align="center">    <a href='https://gitee.com/min290/warm-sun/stargazers'><img src='https://gitee.com/min290/warm-sun/badge/star.svg?theme=dark' alt='star'></img></a></p>

## 本框架介绍

| 功能   | 框架                                                                                                                        |
| ---- | ------------------------------------------------------------------------------------------------------------------------- |
| 前端项目 | 采用 Vue3 + js + Vite + ElementPlus                                                                                         |
| 后端   | jdk17、solon、satoken、redisson、mybati-flex、jackjsonjdk17+satoken+redisx/redisson+mybaits-flex+hutool+jackson+mapstruct+poi等 |

目前改造成solon框架，已经还原ruoyi-vue大部分功能，还差数据库监控、缓存监控。

**希望一键三连，你的⭐️ Star ⭐️是我持续开发的动力。     加入QQ群:778470567**

* 启动速度由 14.7s--> 2.5s

* 打包后大小减半一半

* 前端项目秒启动

* 文档齐全，并且都是中文文档，源码可读性强

* 支持前后端代码生成  

* 组件自由切换

<u>让我惊喜的是提升如此巨大，并且solon、satoken、mybati-flex、hutool和smart-http国内开源项目的开源社区及其活跃，很多问题可以快速解决</u>

## 在线体验

- admin/admin123

演示地址：http://www.warm-sun.vip  
文档地址：https://gitee.com/min290/warm-sun


## 部署步骤

### 准备工作

    JDK >= 17 (以上的每测过)
    Mysql >= 5.7.0 (推荐5.7版本，以上的没测过)
    Redis >= 5.0
    Maven >= 3.6
    Node >= 16

### 后端启动

1、导入/sql/warm.sql  
2、修改数据库和redis配置  
3、启动warm-admin下AppAdmin

<table>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1693547874693282967/8b1b8dc2_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1693547874666704694/00c3f78c_2218307.png"/></td>
    </tr>
</table>

### 前端部署

    # 克隆项目
    git clone https://gitee.com/min290/warm-sun.git
    
    # 进入项目目录
    cd warm-vue3
    
    # 安装依赖
    yarn --registry=https://registry.npmmirror.com
    
    # 启动服务
    yarn dev
    
    # 构建测试环境 yarn build:stage
    # 构建生产环境 yarn build:prod
    # 前端访问地址 http://localhost:80

## 工作流(待集成)

### [warm-flow](https://gitee.com/warm_4/warm-flow.git)

此项目是极其简单的工作流，没有太多设计，代码量少，并且只有6张表，一个小时就可以看完整个设计。使用起来方便

1. 支持简单的流程流转，比如跳转、回退、审批
2. 支持角色、部门和用户等权限配置
3. 官方提供简单流程封装很实用
4. 支持多租户，感谢【luoheyu】PR
5. 支持代办任务和已办任务，通过权限标识过滤数据  
6. 支持互斥网关，并行网关（会签、或签）



更新记录 ：https://gitee.com/warm_4/warm-flow/wikis/Home

流程规则 ：https://gitee.com/warm_4/warm-flow/wikis/%E6%B5%81%E7%A8%8B%E8%A7%84%E5%88%99

常见问题 ：https://gitee.com/warm_4/warm-flow/wikis/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98


### 演示图
<table>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1695188710491521077/57d6b8a4_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1695188762398536520/4730fe3b_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1695188769430380611/91b05a8d_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1695188776587670207/9a188f9f_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1695869289700125082/76a7e6ce_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1695869309561476266/faf196d9_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1696843582818811115/d90c75bb_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1696843604894928843/828a2493_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1695188998289095833/73611acd_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1695189024771234344/996d356d_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1681544763299393774/a25d33ab_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1685245304110972083/31a9105d_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1685418370349267839/f70e5589_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1685418217810487859/02883c8c_2218307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1685418386450207624/90327020_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1695189066903331422/09213a2c_2218307.png"/></td>
    </tr>
</table>


## 组件切换

1、redis缓存切换，通过redis+satoken-redis 或者 redisson+satoken-redission

自由切换redisx或者redisson客户端

<table>
    <tr>
        <td><img src="https://foruda.gitee.com/images/1693551506808563096/6ba45eb7_2218307.png"/></td>
        <td><img src="https://foruda.gitee.com/images/1693551525401980210/594a53bc_2218307.png"/></td>
    </tr>
</table>
2、warm-admin中pom.xml通过多环境切换是否加载knife4j

## 组件扩展支持
比如提供mybatis-plus适配，可以按照mf模块结合solon官网mybatis-plus集成方式，新建模块，并且可参照如上实现组件切换原理
如有不清楚地方，可加群联系，原因组件pr。mybatis系列以外的，如果和mybatis没有冲突理论也可以

## 常见问题

https://gitee.com/min290/warm-sun/wikis/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98?sort_id=8387532

## 你可以请作者喝杯咖啡表示鼓励

<div class="body">    <img    src="warm-vue3/src/assets/images/pay.png"      alt="donate"      style="width:100%"    />

## 最后要感谢：

[solon](https://gitee.com/noear/solon.git)

[RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue.git)

[Sa-Token](https://gitee.com/dromara/sa-token.git)

[hutool](https://gitee.com/dromara/hutool.git)

[MyBatis-Flex](https://gitee.com/mybatis-flex/mybatis-flex.git)

[smart-http](https://gitee.com/smartboot/smart-http.git)

## 内置功能

1. 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2. 部门管理：配置系统组织机构（公司、部门、小组），树结构展现支持数据权限。
3. 岗位管理：配置系统用户所属担任职务。
4. 菜单管理：配置系统菜单，操作权限，按钮权限标识等。
5. 角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
6. 字典管理：对系统中经常使用的一些较为固定的数据进行维护。
7. 参数管理：对系统动态配置常用参数。
8. 通知公告：系统通知公告信息发布维护。
9. 操作日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
10. 登录日志：系统登录日志记录查询包含登录异常。
11. 在线用户：当前系统中活跃用户状态监控。
12. 定时任务：在线（添加、修改、删除)任务调度包含执行结果日志。
13. 代码生成：前后端代码的生成（java、html、xml、sql）支持CRUD下载 。
14. 系统接口：根据业务代码自动生成相关的api接口文档。
15. 缓存监控：对系统的缓存信息查询，命令统计等。

## 演示图

<table>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/cd1f90be5f2684f4560c9519c0f2a232ee8.jpg"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/1cbcf0e6f257c7d3a063c0e3f2ff989e4b3.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/up-8074972883b5ba0622e13246738ebba237a.png"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/up-9f88719cdfca9af2e58b352a20e23d43b12.png"/></td>
    </tr>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/up-39bf2584ec3a529b0d5a3b70d15c9b37646.png"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/up-936ec82d1f4872e1bc980927654b6007307.png"/></td>
    </tr>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/up-b2d62ceb95d2dd9b3fbe157bb70d26001e9.png"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/up-d67451d308b7a79ad6819723396f7c3d77a.png"/></td>
    </tr>     
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/5e8c387724954459291aafd5eb52b456f53.jpg"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/644e78da53c2e92a95dfda4f76e6d117c4b.jpg"/></td>
    </tr>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/up-8370a0d02977eebf6dbf854c8450293c937.png"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/up-49003ed83f60f633e7153609a53a2b644f7.png"/></td>
    </tr>
    <tr>
        <td><img src="https://oscimg.oschina.net/oscnet/up-d4fe726319ece268d4746602c39cffc0621.png"/></td>
        <td><img src="https://oscimg.oschina.net/oscnet/up-c195234bbcd30be6927f037a6755e6ab69c.png"/></td>
    </tr>
</table>

git提交规范

    [init] 初始化  
    [feat] 增加新功能  
    [fix] 修复问题/BUG  
    [style] 代码风格相关无影响运行结果的  
    [perf] 优化/性能提升  
    [refactor] 重构  
    [revert] 撤销修改  
    [test] 测试相关  
    [docs] 文档/注释  
    [chore] 依赖更新/脚手架配置修改等  
    [workflow] 工作流改进  
    [ci] 持续集成  
    [types] 类型定义文件更改  
    [wip] 开发中