# fastboot

**Repository Path**: sunalee/fastboot

## Basic Information

- **Project Name**: fastboot
- **Description**: 基于SpringBoot的脚手架-FastBoot2.0
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2020-11-10
- **Last Updated**: 2025-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: SpringBoot, Java, 脚手架, 开源框架, Spring

## README

<p align="center">
  <a href="https://gitee.com/sunalee/fastboot">
   <img alt="iFillDream公众号" src="https://filldream.oss-cn-hangzhou.aliyuncs.com/fastboot.png" width="298" height="201">
  </a>
</p>

<p align="center">
  一款基于SpringBoot的快速构建框架，致力于每个项目的高效开发.
</p>

<p align="center">
  <a href="https://spring.io/projects/spring-boot">
      <img alt="code style" src="https://img.shields.io/badge/SpringBoot-2.7.18-brightgreen?style=flat-square">
  </a>
  <a href="https://www.apache.org/licenses/LICENSE-2.0">
    <img alt="code style" src="https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=flat-square">
  </a>
  <a href="https://gitee.com/sunalee/fastboot">
     <img alt="code style" src="https://img.shields.io/badge/Version-FastBoot2.0.6-informational.svg?style=flat-square">
  </a>
  <a href="https://gitee.com/sunalee/fastboot-vue">
      <img alt="code style" src="https://img.shields.io/badge/FastBoot-Vue-7996ff.svg?style=flat-square">
  </a>
  <a href="https://mp.weixin.qq.com/s?__biz=MzU5NDMyODA2MQ==&mid=100000095&idx=1&sn=ff09d8155c86d2f4ce5e3d12dee0224f&chksm=7e03a1cd497428dbd3baa1a8bbfe3148d7213c249c15175d2adb658facb0eedfc1aa8706879d#rd">
      <img alt="code style" src="https://img.shields.io/badge/公众号-iFillDream-orange.svg?style=flat-square">
  </a>
</p>

# 简介 | Intro

&emsp;&emsp;FastBoot是一款基于SpringBoot的脚手架，简单方便，外包私活神器。  
&emsp;&emsp;我们希望FastBoot越来越简洁、规范、高效,希望有更多的小伙伴们加入我们，同时也希望大家指出FastBoot不合理的地方  
&emsp;&emsp;[FastBoot文档](http://1.117.142.97:8000/fastbootdoc/fastboot/),若打不开表示我们经费有限服务器可能过期了，买不起了  

# 版本 | Version

FastBoot未开源时就已经存在，但没有命名且不叫FastBoot,大致版本如下:  
- **FastBoot0.X**：2020.05.07-2020.06.16  
- **FastBoot1.X**：2020.06.17-2020.10.22  
- **FastBoot2.0**：2020.10.22-2021.10.09
- **FastBoot2.0.3**：2021.10.09-2023.03.23  
- **FastBoot2.0.4**：2023.03.23-2024.01.16
- **FastBoot2.0.5**：2024.01.16-2025.04.08
- **FastBoot2.0.6**：2025.04.08-至今

- **当前版本：2.0.6.0**  

**更新日志请参考**[Wiki](https://gitee.com/sunalee/fastboot/wikis/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97)**文档**

# 优点 | Advantages

- **快速**：复制框架修改相关配置即可开始编写业务代码  
- **统一token**：全局使用统一token来鉴权，使开发更加容易;通过passToken来加密请求,可以快速鉴别请求方的身份是否合法。  
- **快速追踪BUG**：可以更加灵活的设置友好的错误提示，异常报错能够以钉钉信息的方式提醒开发者，也可通过报错提醒快速定位到问题所在位置;  
- **实时项目日志**：引入WebSocket可以将项目日志输出到浏览器,通过颜色的区分,方便开发者快速定位问题和查看Sql等信息  
- **中间件**：整合了ActiveMq、WebSocket等  
- **权限控制**：由于shiro太重了，所以自定义了拦截器进行角色权限鉴权  
- **定时任务**：引入quartz定时任务，可动态实现任务的添加、修改、删除、暂停、恢复等功能  
- **第三方接口**：整合微信登陆、微信支付、微信模板推送、OSS、短信、聚合-快递查询等第三方接口  

# 文档 | Documentation
#### (一)、基本简介
- 作者:RickSun  
- 时间:2020.05.07  
- 后端Gitee：https://gitee.com/sunalee/fastboot
- 前端Gitee：https://gitee.com/sunalee/fastboot-vue

#### (二)、快速开始
    1、将代码从Git仓下载下来  
    2、以下配置按具体需求修改  
        ·根据需要修改各类包名和路径名  
        ·修改打包finalName(看需求修改)  
    3、修改配置文件、日志文件、数据库、Redis、中间件等  
    4、填充自己的业务  
##### 帮助  
·若出现配置文件字符格式不对，请设置编辑器的编码为**UTF8**  
  idea:File->Setting->Editor->FileEncoding
#### (三)、管理员权限说明
1、菜单共两大类型：菜单和非菜单，菜单拥有下级，非菜单没有下级  
2、删除菜单时需要先将子菜单删除，避免误删除  
3、可以整体移动菜单排序，也可添加和修改菜单  
4、角色分为系统角色和其他角色，系统角色是系统级别角色，而其他角色则可以用来区别公司之用，若项目不区分公司则都可为系统角色  
5、角色拥有父级角色，当父级角色ID为0时表示系统最高级别管理员角色  
6、添加角色时上级角色ID为当前登陆的用户角色ID  
7、修改角色时不允许修改父级ID  
8、若有管理员使用角色或有子级角色则不允许删除，删之则可删  
9、设置权限时必须输入包括父子级菜单在内的ID，而不仅仅输入非菜单的叶子节点的ID  
10、每个角色只能在其父级角色中挑选菜单，即子级角色小于等于父级角色，例如：  
&emsp;&emsp;A角色拥有菜单：a,b,c  
&emsp;&emsp;B角色(A的子级)拥有的菜单必须是a,b,c中的  
11、查询角色权限时，当角色父级ID为0时则展示所有权限  
12、若分公司时，管理员可指定关联id即link_id  
13、系统级角色可以看到所有角色，而其他角色只能看到自己关联的ID的管理员的角色  
14、非系统级管理员看不到系统级管理员，只能看到自己关联ID的管理员  

#### (四)、目录结构
|--fastboot-base  
|----base  业务数据模块  
|------config  数据源、mybatis配置   
|------entity  数据库生成的bean类  
|------mapper  数据库生成的mapper类  
|------request 业务请求Request类即STO  
|------response  业务返回DTO  
|----CodeGeneration  代码生成器  
|--resources  
|----mapper  数据库ORM XML文件  
  
|--fastboot-common  
|----common  通用标准模块  
|------annotation  自定义注解  
|------constant  通用常量  
|------exception  自定义异常  
|------entity  基本Bean、返回类  
|------util  工具包  
|--------entity  工具类依赖的bean  
|--resources  
  
|--fastboot-core  
|----core  业务核心模块  
|------cache  缓存相关  
|------event  事件  
|---------listener  监听事件  
|------job  定时任务  
|---------job  任务Bean  
|------manager  缓存以及下沉管理  
|------mq   Mq消息中间件  
|------service  业务service  
|--------impl  业务实现impl  
|--resources  
  
|--fastboot-web  
|----web  应用控制模块  
|------config  拦截器/跨域/时间等配置  
|------controller  应用Controller层  
|------filter  异常拦截器  
|----FastBootApplication  项目启动类  
|--resources  properties配置  

# 鸣谢 | Thanks  
排名不分先后  
- [HuTool](https://hutool.cn) 是一个小而全的Java工具类库  
- 个人贡献者：RickSun、张曦  

# 免责说明 | Disclaimer  

FastBoot仅供学习使用，禁止商用,私有或贩卖，使用时请标注开源来源  

# BUG及问题 | Issues

若出现问题或您有好的建议，可以在FastBoot中提交Issues，可以关注我们的公众号，我们将重视您提交的内容并做出响应  

# 关注我 | About Me

![笔记有云](https://filldream.oss-cn-hangzhou.aliyuncs.com/fastboot/fastboot_about_me.png "笔记有云")