Home

Awesome

简介

:tada::tada::tada: 基于 React 和 Ant Design 版本的前端 ballcat-ui-react 已发布,欢迎大家尝鲜使用

BallCat 组织旨在为项目快速开发提供一系列的基础能力,方便使用者根据项目需求快速进行功能拓展。

在以前使用其他后台管理脚手架进行开发时,经常会遇到因为项目业务原因需要进行二开的问题,在长期的开发后,一旦源项目进行迭代升级,很难进行同步更新。

为了解决这一问题,BallCat 将自身所有的业务和功能都设计为可插拔的依赖,方便用户自由组装和卸载。

开发时,用户以依赖的方式引入 BallCat 所提供的模块,当 BallCat 项目升级时,用户只需同步更新版本号,即可获得功能更新。

Ballcat 已将所有 JAR 包都推送至中央仓库,也会为每个版本的升级改动列出详细的更新日志,以及增量 SQL。

如果在使用中遇到了必须通过二开修改源码才能解决的问题或功能时,欢迎提 issues,如果功能具有通用性,我们会为 BallCat 添加此能力,也欢迎直接 PR 你的改动。

技术栈

相关仓库

项目简介gitee 地址github 地址
ballcat核心项目组件https://gitee.com/ballcat-projects/ballcathttps://github.com/ballcat-projects/ballcat
ballcat-ui-vue管理后台前端https://gitee.com/ballcat-projects/ballcat-ui-vuehttps://github.com/ballcat-projects/ballcat-ui-vue
ballcat-ui-react管理后台前端https://gitee.com/ballcat-projects/ballcat-ui-reacthttps://github.com/ballcat-projects/ballcat-ui-react
ballcat-codegen代码生成器https://gitee.com/ballcat-projects/ballcat-codegenhttps://github.com/ballcat-projects/ballcat-codegen
ballcat-samples使用示例https://gitee.com/ballcat-projects/ballcat-sampleshttps://github.com/ballcat-projects/ballcat-samples
ballcat-boot单体应用模板项目https://gitee.com/ballcat-projects/ballcat-boothttps://github.com/ballcat-projects/ballcat-boot

注意 ballcat 是核心组件仓库,如果需要启动后端服务,请使用 ballcat-boot

项目演示

后台管理

演示地址 (账户:admin ;密码:a123456) :

http://preview.ballcat.cn/

演示效果

图片

代码生成器

代码生成器提供了在线编辑模板的功能,以及多数据源的支持。

只需启动一个代码生成器服务放在测试服,所有项目需要生成代码时都可以复用此生成器,减少了频繁切换项目启动生成器的繁琐。

演示地址

http://codegen.ballcat.cn/

演示效果

业务模块

BallCat 为后台管理的一些基本需求提供了以下五个业务模块,用户可以按需引入:

BallCat 项目模块结构

功能模块

功能模块和业务无关,非 ballcat 项目也可以引入这些模块获得功能增强,用户按照实际业务需求选择模块进行集成。

包括但不限于以下这些功能

目前提供的功能模块列表

|-- ballcat-common                 -- 基础公用组件
|   |-- ballcat-common-core             -- 核心组件
|   |-- ballcat-common-desensitize      -- 脱敏基础组件
|   |-- ballcat-common-i18n	            -- 国际化基础组件
|   |-- ballcat-common-idempoten        -- 幂等基础组件
|   |-- ballcat-common-log              -- 日志基础组件
|   |-- ballcat-common-model            -- 公用的一些模型
|   |-- ballcat-common-redis            -- redis基础组件
|   |-- ballcat-common-security         -- 安全相关,以及资源服务器配置
|   |-- ballcat-common-util             -- 公用的工具
|   `-- ballcat-common-websocket        -- 对于 spring websocket 的一些抽象封装
|-- ballcat-dependencies           -- ballcat项目本身各子模块的依赖管理,以及第三方模块的依赖管理
|-- ballcat-extends	               -- 扩展模块,大多是对于一些第三方组件的扩展处理
|   |-- ballcat-extend-dingtalk	        -- 钉钉的一些操作封装
|   |-- ballcat-extend-kafka            -- kafka 的一些操作扩展
|   |-- ballcat-extend-kafka-stream	    -- kafka 流处理的一些操作扩展
|   |-- ballcat-extend-mybatis-plus	    -- 基于 mybatis-plus 相关的一些扩展
|   |-- ballcat-extend-openapi          -- 对 springdoc-openapi 的一点封装扩展
|   |-- ballcat-extend-pay-ali          -- 针对支付宝支付的一些操作封装
|   |-- ballcat-extend-pay-virtual      -- 针对虚拟货币支付的一些操作封装
|   |-- ballcat-extend-pay-wx           -- 针对微信支付的一些操作封装
|   |-- ballcat-extend-redis-module     -- redis module 的扩展功能(暂时只有布隆过滤器)
|   `-- ballcat-extend-tesseract        -- 对 OCR 文字识别工具的一个操作封装
|-- ballcat-starters                -- Spring Boot快速启动器      
|   |-- ballcat-spring-boot-starter-datascope   -- 数据权限控制
|   |-- ballcat-spring-boot-starter-dingtalk    -- 钉钉集成工具
|   |-- ballcat-spring-boot-starter-easyexcel   -- 通过注解快速导入导出excle(easyexcel)
|   |-- ballcat-spring-boot-starter-file        -- 文件上传 FTP or Local
|   |-- ballcat-spring-boot-starter-i18n        -- 国际化方案
|   |-- ballcat-spring-boot-starter-idempotent  -- 幂等处理方案
|   |-- ballcat-spring-boot-starter-ip2region   -- 离线IP查询方案
|   |-- 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-web         -- Web工程封装
|   |-- ballcat-spring-boot-starter-websocket	-- 基于 common-websocket 的自动配置
|   `-- ballcat-spring-boot-starter-xss	        -- xss 防注入相关

快速上手

环境准备

开始之前,请先确保您已经配置好以下环境

名称版本
JDK1.8
MySQL5.7.8 +
Redis3.2 +
node10.0 +
npm6.0 +

另:请在您的开发工具中安装好 Lombok 插件,Lombok 的使用参看其 官方文档

最新版本的 Idea 中已经自带了 Lombok 插件

数据库配置

按下面顺序依次执行 ballcat/docs 目录下的数据库脚本:

# 建库语句
scheme.sql   
# 核心库
ballcat.sql  

# 国际化相关 SQL, 无需国际化功能则不用执行此处代码
ballcat-i18n.sql

默认 oauth_client_details 脚本中有一个 test client,该 client 只能用于开发及测试环境,其登陆时会跳过图形验证码以及密码解密过程,生产环境请删除该client

注意: ballcat/docs/update 下的是各个版本升级的增量 sql,初次搭建时无需执行。
当跟随 ballcat 做版本升级时,如从 0.5.0 版本升级到 0.6.0 版本时,需执行 update 文件夹下的 0.5.0-to-0.6.0.sql

配置本地hosts

建议使用 switchHost 软件管理hosts配置!

也可直接修改本地host文件: windows系统下host文件位于 C:\Windows\System32\drivers\etc\hosts

新增如下host:

127.0.0.1 ballcat-mysql
127.0.0.1 ballcat-redis
127.0.0.1 ballcat-admin

其中 127.0.0.1 按需替换成开发环境 ip

服务端准备

代码下载

下载模板仓库 ballcat-boot 的代码,或者示例仓库 ballcat-sample 的代码

git clone https://github.com/ballcat-projects/ballcat-boot.git

或者

git clone https://github.com/ballcat-projects/ballcat-samples.git

项目启动

直接在开发工具中启动 SpringBoot 的启动类 AdminApplication 即可

前端准备

代码下载

git clone https://github.com/ballcat-projects/ballcat-ui-vue.git

依赖安装

安装项目依赖,使用 yarn 或 npm 都可以

# 安装依赖
yarn install
----- 或者 --------
# 安装依赖
npm install

项目启动

打开命令行进入项目根目录,或 在 IDE 提供的命令行工具中执行

# 启动服务
yarn serve
----- 或者 -----
# 启动服务
npm run serve

访问项目

默认前端项目路径:http://localhost:8000/

默认用户名密码:admin / a123456

注意检查前端的 vue.config.js 中的 serverAddress 属性,需要改为对应的服务端地址,如 http://ballcat-admin:8080

更多文档

参看官方文档,快速搭建一章: http://www.ballcat.cn/guide/quick-start.html

交流群

如果群二维码失效,可以扫右边我的个人微信二维码,或者添加我的微信号 Hccake_,我再邀请你入群

<img src="https://hccake-img.oss-cn-shanghai.aliyuncs.com/ballcat/ballcat-wechat-group_20211203.jpg" alt="微信" width="35%"/> <img src="https://hccake-img.oss-cn-shanghai.aliyuncs.com/ballcat/wechat-hccake.jpg" alt="微信" width="35%"/>