538c3b78be
- Bump spring-boot from 2.4.3 to 2.4.8 - knife4j from 2.0.8 to 2.0.9 - hutool from 5.5.8 to 5.7.3 - fastjson from 1.2.75 to 1.2.76 - dynamic-datasource from 3.3.1 to 3.3.2 - spring-boot-admin from 2.4.1 to 2.4.2 - anji-captcha from 1.2.8 to 1.2.9
129 lines
7.3 KiB
Markdown
129 lines
7.3 KiB
Markdown
# BallCat
|
||
|
||
BallCat 组织旨在为项目快速开发提供一系列的基础能力，方便用户根据项目需求快速进行功能拓展。
|
||
|
||
## 前言
|
||
|
||
以前在使用其他后台管理脚手架进行开发时，经常会遇到因为项目业务原因需要进行二开的情况，在长期的开发后，一旦源项目进行迭代升级，很难进行同步更新。
|
||
|
||
所以 BallCat 推荐开发项目时，以依赖的方式引入 BallCat 中提供的所有功能，这样后续跟随 BallCat 版本升级时只需要修改对应的依赖版本号即可完成同步。
|
||
|
||
BallCat 已将所有 JAR 包都推送至中央仓库，也会为每个版本升级提供 SQL 改动文件。
|
||
|
||
> 如果在使用中遇到了必须通过二开修改源码才能解决的问题或功能时，欢迎提 issues，如果功能具有通用性，我们会为 BallCat 添加此能力，也欢迎直接 PR 你的改动。
|
||
|
||
|
||
## 相关仓库
|
||
|
||
| 项目 | 简介 | gitee 地址 | github 地址 |
|
||
| --------------- | ------------ | -------------------------------------------------- | --------------------------------------------------- |
|
||
| ballcat | 核心项目组件 | https://gitee.com/ballcat-projects/ballcat | https://github.com/ballcat-projects/ballcat |
|
||
| ballcat-ui-vue | 管理后台前端 | https://gitee.com/ballcat-projects/ballcat-ui-vue | https://github.com/ballcat-projects/ballcat-ui-vue |
|
||
| ballcat-codegen | 代码生成器 | https://gitee.com/ballcat-projects/ballcat-codegen | https://github.com/ballcat-projects/ballcat-codegen |
|
||
| ballcat-samples | 使用示例 | https://gitee.com/ballcat-projects/ballcat-samples | https://github.com/ballcat-projects/ballcat-samples |
|
||
|
||
## 地址链接
|
||
|
||
**管理后台预览**：http://preview.ballcat.cn
|
||
> admin / a123456
|
||
|
||
**代码生成器预览**：http://codegen.ballcat.cn/
|
||
|
||
**文档地址**：http://www.ballcat.cn/ （目前文档只有少量内容，会陆续填坑）
|
||
|
||
|
||
|
||
# ballcat
|
||
|
||
本仓库存放了 BallCat 提供的所有的基础 Jar 包。
|
||
|
||
如 `ballcat-admin-core` 依赖，用户引入此依赖并配合核心 sql，即可获得用户管理，OAuth2，权限控制，字典等等后台管理相关的基础功能。
|
||
|
||
`ballcat-admin-websocket` 依赖，用户引入后，后台管理即可获得 websocket 能力，对公告、字典、弹出选择框的修改可以及时通知到前端
|
||
|
||
`ballcat-spring-boot-starter-datascope` 依赖，用户引入后，根据自己的业务进行定制，即可获得数据权限控制的能力
|
||
|
||
······ 等等
|
||
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
.
|
||
|-- ballcat-admin -- 管理后台相关项目
|
||
| |-- ballcat-admin-core -- 后台管理核心模块（权限控制，字典，Oauth2等）
|
||
| |-- ballcat-admin-i18n -- 国际化使用方案
|
||
| `-- ballcat-admin-websocket -- 后台管理 websocket 支持插件（公告和字典等同步）
|
||
|-- ballcat-common -- 基础公用组件
|
||
| |-- ballcat-common-conf -- web公用配置
|
||
| |-- ballcat-common-core -- 核心组件
|
||
| |-- ballcat-common-desensitize -- 脱敏工具类
|
||
| |-- ballcat-common-model -- 公用的一些模型
|
||
| `-- ballcat-common-util -- 公用的工具类
|
||
|-- ballcat-dependencies -- ballcat项目本身各子模块的依赖管理，以及第三方模块的依赖管理
|
||
|-- ballcat-extends -- 扩展模块，大多是对于一些第三方组件的扩展处理
|
||
| |-- ballcat-extend-dingtalk -- 钉钉的一些操作封装
|
||
| |-- ballcat-extend-i18n -- 国际化的一些使用方案
|
||
| |-- ballcat-extend-kafka -- kafka 的一些操作扩展
|
||
| |-- ballcat-extend-kafka-stream -- kafka 流处理的一些操作扩展
|
||
| |-- ballcat-extend-mybatis-plus -- 基于 mybatis-plus 相关的一些扩展
|
||
| |-- ballcat-extend-pay-ali -- 针对支付宝支付的一些操作封装
|
||
| |-- ballcat-extend-pay-virtual -- 针对虚拟货币支付的一些操作封装
|
||
| |-- ballcat-extend-pay-wx -- 针对微信支付的一些操作封装
|
||
| `-- ballcat-extend-redis-module -- redis module 的扩展功能（暂时只有布隆过滤器）
|
||
|-- ballcat-log -- 日志模块（业务），封装了基本的操作日志、访问日志、登录日志的保存查询等处理
|
||
| |-- ballcat-log-biz
|
||
| |-- ballcat-log-controller
|
||
| `-- ballcat-log-model
|
||
|-- ballcat-notify -- 通知模块（业务），封装了公告信息部分功能（通知信息功能待扩展）
|
||
| |-- ballcat-notify-biz
|
||
| |-- ballcat-notify-controller
|
||
| `-- ballcat-notify-model
|
||
|-- ballcat-oauth -- oauth2 登录相关模块（业务），继承了登录图像验证码，登录AES密码解密过滤器等相关功能
|
||
| |-- ballcat-oauth-biz
|
||
| |-- ballcat-oauth-controller
|
||
| `-- ballcat-oauth-model
|
||
|-- ballcat-starters -- 对于各种能力的增强 starter, 这些 starter 与业务无关，非 ballcat 项目都可引入使用
|
||
| |-- ballcat-spring-boot-starter-datascope -- 数据权限控制
|
||
| |-- ballcat-spring-boot-starter-dingtalk -- 钉钉集成工具
|
||
| |-- ballcat-spring-boot-starter-easyexcel -- 通过注解快速导入导出excle（easyexcel）
|
||
| |-- ballcat-spring-boot-starter-i18n -- 国际化方案
|
||
| |-- ballcat-spring-boot-starter-job -- 定时任务集成（目前仅xxl-job）
|
||
| |-- ballcat-spring-boot-starter-kafka -- 消息队列 kafka 集成
|
||
| |-- ballcat-spring-boot-starter-log -- 访问日志，操作日志，TraceId注入
|
||
| |-- ballcat-spring-boot-starter-mail -- 邮件发送
|
||
| |-- ballcat-spring-boot-starter-oss -- 对象存储（所有支持 AWS S3 协议的云存储，如阿里云，七牛云，腾讯云）
|
||
| |-- ballcat-spring-boot-starter-pay -- 支付相关
|
||
| |-- ballcat-spring-boot-starter-redis -- 提供注解使用redis, 分布式锁，防击穿，全局key前缀等功能
|
||
| |-- ballcat-spring-boot-starter-sms -- 短信接入 starter
|
||
| |-- ballcat-spring-boot-starter-swagger -- swagger文档配置（提供无注册中心的文档聚合方案）
|
||
| |-- ballcat-spring-boot-starter-websocket -- websocket 集成
|
||
| `-- ballcat-spring-boot-starter-xss -- xss 防注入相关
|
||
|-- ballcat-system -- 系统模块（业务），封装了 RBAC 权限控制相关功能，以及组织机构功能
|
||
| |-- ballcat-system-biz
|
||
| |-- ballcat-system-controller
|
||
| `-- ballcat-system-model
|
||
`-- doc -- 初始化数据库脚本
|
||
|
||
|
||
```
|
||
|
||
## 核心依赖
|
||
|
||
| 依赖 | 版本 | 官网 |
|
||
| ---------------------- | ------------- | ------------------------------------------------ |
|
||
| Spring Boot | 2.4.8 | https://spring.io/projects/spring-boot#learn |
|
||
| Spring Security OAuth2 | 2.3.8.RELEASE | https://spring.io/projects/spring-security-oauth |
|
||
| Mybatis Plus | 3.4.2 | https://mp.baomidou.com/ |
|
||
| XXL-JOB | 2.3.0 | http://www.xuxueli.com/xxl-job |
|
||
| Hutool | 5.7.3 | https://www.hutool.cn/ |
|
||
|
||
|
||
## 快速搭建后台管理
|
||
|
||
参看官方文档 http://www.ballcat.cn/guide/quick-start.html
|
||
|
||
|
||
## 交流群
|
||
|
||
<img src="https://hccake-img.oss-cn-shanghai.aliyuncs.com/ballcat/ballcat-wechat-group_202106281044.png" alt="微信" width="35%"/> |