# rocks

**Repository Path**: rocksdev/rocks

## Basic Information

- **Project Name**: rocks
- **Description**: rocks开发平台后端项目
https://gitee.com/rocksdev/rocks-ui (前端)
https://gitee.com/rocksdev/rocks （后端）
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://rocksdev.top/app/rocks/login
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 3
- **Created**: 2023-11-30
- **Last Updated**: 2025-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
    <div align="center">
      <img src="https://rocksdev.top/app/rocks-minio/logo/logo.png" width="100">
      <h1>Rocks（后端）</h1>
    </div>
    <br>      
    <p align="center">
        Rocks是基于Springboot3 + JDK21 + Vue3 + Element-plus构建的中后台系统快速开发平台,目的是提高开发人员开发效率，降低企业信息化、数字化开发成本。
        <br>
        <br>
        <a href="http://spring.io/projects/spring-boot">
            <img src="https://img.shields.io/badge/spring--boot-3.4.1-green.svg" alt="spring-boot">
        </a>
        <a href="http://mp.baomidou.com">
            <img src="https://img.shields.io/badge/mybatis--plus-3.5.10.1-blue.svg" alt="mybatis-plus">
        </a>  
        <a href="https://www.hutool.cn/">
            <img src="https://img.shields.io/badge/hutool-6.0.0-blue.svg" alt="hutool">
        </a>
    </p>
</p>

### 在线体验
演示地址：https://rocksdev.top/app/rocks/login （点击头像-后台管理 可进入系统后台）

`rocks将前后台功能集成到一个项目中，通过权限控制用户是否具有后台管理权限，不需要再访问新的地址即可进入系统后台管理
登录后默认进入前台系统（业务功能），点击头像-后台管理（权限控制），进入系统后台管理。`

### 内置功能

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

### 技术栈

 分类               | 内容                                                                                                                                                                               
-------------------|-------------------------------------------------------------------------------
 编程语言           | Java 17/21                                                                                        
 开发框架           | Spring Boot 3.4   
 安全框架	       | pring Authorization Server / SaToken （双认证中心支持）                                                                           
 任务调度            | XXL-JOB                                                                                      
 数据库支持          | MySQL8、Oracle 12C+、SQL Server 2017+、PostgreSQL 16+、 达梦8、 TiDB 4 
 持久层框架	      | MyBatis & MyBatis Plus                                                                                                                  
 数据库连接池        | Druid                                                                                                                              
 服务注册与发现/配置中心             | Nacos
 熔断组件             | Sentinel   
 网关组件             | Spring Cloud Gateway   
 日志管理             | Logback   
 运行容器             | Undertow / Docker
 分布式事务	        | Seata
 工作流	        | Flowable 7

### 项目结构
可根据业务需要，调整项目名称、包名、项目结构，但不建议破坏项目中各模块的依赖关系。
``` 
rocks
├── rocks-api -- 对外服务接口模块：对外接口及出入参实体
├── rocks-common -- SSM框架公共模块：实体、常量、枚举、工具类
├── rocks-consumer -- 服务接口消费模块：外部接口代理层，不做具体业务处理
├── rocks-dal -- dal层模块：表实体、mapper、crud接口、结果集实体
├── rocks-service -- 业务服务层
├── rocks-provider -- 对外服务接口业务实现模块：
├── rocks-web -- 控制层模块：control层及项目启动配置
```


### 项目内部模块依赖规则

 模块名        | 依赖模块                
------------|---------------------
 common模块   | 无                   
 dal模块      | api(对外返回实体作为结果集)    
 service模块  | common、dal、consumer 
 api模块      | 无                   
 provider模块 | service、api         
 consumer模块 | 无                   
 web        | service             

### 代码生成器(MyBatis Generator)使用规范

本项目gen模块用于生成dal层代码：

    1、在config.properties中填写要生成dal层代码的表名及模块名称
    
    2、运行Main类中的main方法
### 环境准备
- **Mysql**: 版本 8.0.0 或更高
- **Redis**: 版本 8.0.0 或更高
- **XXL-JOB**: 版本 2.4.0 或更高
- **JDK**: 版本 17 或更高

### 快速开始
#### 1. 安装依赖
使用maven下载依赖，建议使用阿里云mavne镜像地址
```xml
<mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
    <mirrorOf>central</mirrorOf>
</mirror>
```
#### 2. 创建数据库，并执行初始化脚本
* 字符集: utf8mb4 
* 排序规则：utf8mb4_general_ci
* 初始脚本位置： doc/db/rocks-init.sql
#### 3. 初始化并运行xxl_job
官网地址： http://www.xuxueli.com/xxl-job/
#### 4. 将项目配置改成自己的
如：数据库地址、数据库用户名/密码、redis相关配置、项目端口号等
#### 4. 启动main
main方法位置： io.gitee.rocksdev.RocksApplication
### 联系作者
<img src="https://rocksdev.top/app/rocks-minio/qrcode/wechat.jpg" width="100">
<img src="https://rocksdev.top/app/rocks-minio/qrcode/qq.jpg" width="100">