# 塔非管理系统Taffe

**Repository Path**: skyrocks/taffe

## Basic Information

- **Project Name**: 塔非管理系统Taffe
- **Description**: 基于SpringBoot, Vue3的管理系统 易读易懂、上手容易。 核心技术采用Spring, SpringSecurity, MyBatis，Vue3, Maven做项目管理，可按需依赖所需模块.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2022-10-28
- **Last Updated**: 2025-06-18

## Categories & Tags

**Categories**: backend

**Tags**: None

## README

# 塔非管理系统Taffe

一款开箱即用的中后台管理系统框架, 基于SpringBoot, Vue3的管理系统, 模块低耦合, 快速搭建, 上手容易。
                      
阿里云专享特惠 [点击进入](https://www.aliyun.com/daily-act/ecs/activity_selection?userCode=bshxhu60) \
腾讯云特惠专区 [点击进入](https://url.cn/ziIRAgbe)

#### 技术选型
* 前端UI: Vue3+Ts+Element UI+Vue Router+Pinia+Vite
* 后端核心: Spring Boot
* 权限框架: Spring Security
* 持久层框架: Mybatis+Mybatis-Plus
* 数据库链接: Alibaba Druid
* 缓存框架: Redis
* 日志框架: Logback
* 工具类: Apache Commons、HuTools
* 定时器: Quartz
* 验证框架: Hibernate-validator
* API文档: Knife4j+OpenAPI3
* 文件存储: Minio
* Excel函数库: POI

#### 框架特点
* 模块低耦合，非核心功能分离成独立模块，按实际业务所需进行引用
* 后台项目用Maven进行统一版本号管理，版本升级一条命令实现，避免出现低级错误
* 自建代码生成模块，根据实现更能自行控制生成代码文件类型
* 日志模块将api请求日志和页面用户操作日志分开处理
* 主库与日志库分离, 提供实现多数据库的扩展接口
* 封装Pagehelper, 实现文本模糊过滤功能
* 登录验证支持三种模式，前端图片滑动验证，后端图片计算验证，后端图片验证码验证
* 封装ElementUI的Table组件, 将分页集成在内，表头文本列过滤, 列显示, 下载等功能, 使用简单
* 两条脚本实现快速打包安装部署完整项目

#### 目录结构
```
Taffe     
├── doc                    // 项目文档
├── docker                 // docker部署环境脚本
├── sql                    // 数据库脚本 
├── taffe-auth             // 鉴权模块
├── taffe-code             // 代码生成模块
├── taffe-excel            // Excel处理模块
├── taffe-fiel             // Excel文件模块
├── taffe-framework        // 框架核心模块
├── taffe-job              // 任务调度模块
├── taffe-log              // 操作日志模块
├── taffe-monitor          // 监控模块
├── taffe-sms-alibaba      // 阿里云短信模块
├── taffe-sms-tencent      // 腾讯云短信模块
├── taffe-web              // 业务模块,后台启动入口模块
├── taffe-web-ui           // 前台Vue项目
├──pom.xml                 // 父pom
```

#### 内置功能
* 用户管理：用户是系统操作者，该功能主要完成系统用户配置。
* 角色管理：维护角色信息，添加角色内用户。
* 权限管理：角色菜单权限分配、这种角色的操作权限，按钮权限。
* 定时任务：在线编辑任务调度包含执行结果日志。
* 服务日志：用户页面操作记录和查询。
* 访问日志：系统正常操作日志记录和查询；系统异常信息日志记录和查询。
* 在线用户：当前系统中登录用户状态监控。
* 服务监控：监视当前系统CPU、内存、磁盘、堆栈等相关信息。
* 数据库监控：监视当前系统数据库连接池状态，可分析SQL性能瓶颈。
* 代码生成：前后端代码的生成（java、xml、vue、sql）。
* 系统接口：根据业务代码自动生成相关的api接口文档。

#### 开发调试
1. 后台启动\
   taffe-web 为业务项目模块，项目clone后,建议自行创建本地多环境配置文件application-local.yml(application-test.yml包括所有配置项),  在idea开发环境中启动此项目即可，默认端口：6201
2. 前台起来\
   taffe-web-ui 为前台项目，Vite作为前端工具链，项目clone后,建议自行创建本地多环境配置文件 .evn.development.local 必填参数VITE_API_DOMAIN， 例如：VITE_API_DOMAIN=http://localhost:6201 \
   安装并启动命令:
   ```
   yarn && yarn dev
   ```
   默认端口：5173
3. 数据库初始化\
   sql目录中提供初始化脚本，默认主库名taffe, 日志库名taffe_log
4. 代码生成(后续此功能将集成在系统中)
   后台以local启动时默认依赖了taffe-code模块，生成代码直接发起get请求即可codeType类型包括: controller, service, mapper, entity, xml, vue, api, sql
   ```
   http://localhost:6201/code?tableName=t_order&codeType=controller,service,mapper,entity,xml,vue,api,sql
   ```
5. api文档\
   访问地址:
   ```
   http://localhost:6201/doc
   ```

#### 项目部署
* 开发环境测试打包部署
  1. 执行打包脚本(windows环境后续更新中提供)
     ```
     ./package.sh
     ```
  2. 执行部署脚本
     ```
     cd docker && docker-compose up -d
     ```
  3. 升级，再次执行打包脚本，并重启docker服务即可
* 集成环境或生产环境打包部署\
  执行打包脚本后，把整个docker目录复制到服务器，再进入docker目录执行部署脚本

   > 首次部署时删除掉docker中的自动创建目录及文件\
   > /docker/minio\
   > /docker/mysql/*\
   > !/docker/mysql/conf.d\
   > /docker/nginx/html\
   > /docker/service/*\
   > !/docker/service/dockerfile

> 特别鸣谢：[若依 / RuoYi](https://gitee.com/y_project/RuoYi)