# boot

**Repository Path**: frsimple/frsimple-boot

## Basic Information

- **Project Name**: boot
- **Description**: 一个开箱即用的中后端解决方案
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: https://frsimple.com
- **GVP Project**: No

## Statistics

- **Stars**: 95
- **Forks**: 30
- **Created**: 2022-10-23
- **Last Updated**: 2025-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, Vue, frsimple, frsimpleBoot, SpringBoot

## README

# FrSimple 项目文档


## pro版本演示环境
- [tdesign版本](https://pro.frsimple.com)
- [element plus版本](https://el.frsimple.com)
- [antdesign版本](https://antd.frsimple.com)
- [naive ui版本](https://naive.frsimple.com)

## 官网地址
[官方网站](http://frsimple.com)

## 系统预览

<table>
    <tr>
        <td><img src="https://pengpengyu-test.oss-cn-zhangjiakou.aliyuncs.com/image/v1.png"/></td>
        <td><img src="https://pengpengyu-test.oss-cn-zhangjiakou.aliyuncs.com/image/v2.png"/></td>
    </tr>
    <tr>
        <td><img src="https://pengpengyu-test.oss-cn-zhangjiakou.aliyuncs.com/image/v3.png"/></td>
        <td><img src="https://pengpengyu-test.oss-cn-zhangjiakou.aliyuncs.com/image/v4.png"/></td>
    </tr>
    <tr>
        <td><img src="https://pengpengyu-test.oss-cn-zhangjiakou.aliyuncs.com/image/v5.png"/></td> 
    </tr> 
</table>


## 软件架构
- 基础框架：SpringBoot 3.2.7
- 授权认证：sa-token（轻量级的Java权限认证框架 1.43.0）
- 高可用缓存：Redis
- 持久层：MyBatis Plus
- 数据库连接池：Alibaba Druid
- 文件存储：MinIO
- 在线接口文档：SpringDoc
- 短信服务：阿里云 | 腾讯云
- 工具类：HuTool | IdGenerator

## 开发部署
### 开发工具
- IDE：IntelliJ IDEA
- 数据库：MySQL 8.0
- Redis版本：5.0.14

## 目录结构
```
├─ simple-boot // 父级工程
│ ├─ simple-base // 基础公共模块
│ ├─ simple-center // 系统管理业务功能模块
│ └─ simple-start // SpringBoot启动模块
```

## 功能特性
### 用户权限管理
- 基于sa-token实现的权限认证
- 支持多级权限控制（@SaCheckPermission注解）
- 完善的登录/注销功能
- 用户信息管理（头像、密码、手机号、邮箱等）
- 支持管理员踢人下线功能

### 系统管理
- 菜单管理：支持菜单树形结构，权限分配
- 字典管理：支持系统级字典配置
- 日志管理：记录系统操作日志
- 数据源管理：支持多数据源配置
- 角色管理：支持角色权限分配
- 组织管理：机构组织架构维护

### 文件存储
- 支持多种存储方式：
  - 阿里云OSS
  - 腾讯云COS
  - MinIO
- 文件上传/下载管理
- 文件链接生成与管理

### 短信&邮件
- 支持多云短信服务：
  - 阿里云短信
  - 腾讯云短信
- 完整的邮件发送功能
- 短信/邮件配置管理

## 代码生成
- 支持根据数据库表结构自动生成代码
- 提供代码模板管理
- 支持ZIP打包下载生成的代码

## 异常处理
- 统一的异常处理机制（GlobalExceptionHandler）
- 支持多种异常类型：
  - WorkFlowException
  - CustomException
  - FileException
  - NotLoginException
  - NotPermissionException
  - IllegalArgumentException

## 特色功能
- Redis数据初始化：自动加载OSS、邮件、短信、字典等配置信息
- XXL-JOB定时任务支持：包含演示任务和分片任务
- 数据库字段自动填充：使用CustomMetaObjectHandler
- 雪花算法ID生成：SnowFlakeConfig
- 动态数据源：支持MyBatis Plus的@DS注解

## 接口文档
- 集成SpringDoc API文档
- 自定义文档配置（SpringDocConfig）
- 支持OpenAPI 3规范