kvf-admin是一套基于springboot、mybatis、

<p align="center"> <img src="http://cloud.kalvinbg.cn/image/kvf-admin-logo.png" alt="kvf-admin-logo"> </p> <p align="center"> <a href="https://github.com/kalvinGit/kvf-admin/blob/master/LICENSE"> <img src="https://img.shields.io/github/license/mashape/apistatus.svg" alt="license"> </a> <a href="https://spring.io/projects/spring-boot"> <img src="https://img.shields.io/badge/springboot-v2.2.4-green" alt="springboot"> </a> <a href="https://mp.baomidou.com"> <img src="https://img.shields.io/badge/mybatis--plus-v3.3.0-blue" alt="mybatis-plus"> </a> <a href="https://github.com/kalvinGit/kvf-admin/wiki/kvf%E4%BB%A3%E7%A0%81%E7%94%9F%E6%88%90%E5%99%A8%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3" rel="nofollow"> <img src="https://img.shields.io/badge/code--generator-wiki-orange" alt="code-generator"> </a> <a href="https://www.layui.com/doc/"> <img src="https://img.shields.io/badge/layui-v2.5.6-brightgreen" alt="layui"> </a> <a href="https://www.hutool.cn/"> <img src="https://img.shields.io/badge/hutool--all-v4.5.1%20-yellow" alt="hutool"> </a> <a href="https://www.activiti.org/"> <img src="https://img.shields.io/badge/activiti-v6.0.0-lightgrey" alt="activiti6"> </a> </p> # kvf-admin kvf-admin是一套快速开发框架、脚手架、后台管理系统、权限系统，上手简单，拿来即用。为广大开发者去除大部分重复繁锁的代码工作，让开发者拥有更多的时间陪恋人、家人和朋友。<br>**技术交流群：214768328** <a href="http://cloud.kalvinbg.cn/image/kvf_code.png" target="_blank"> <img src="https://img.shields.io/badge/%E6%8A%80%E6%9C%AF%E4%BA%A4%E6%B5%81%E7%BE%A4-%E4%BA%8C%E7%BB%B4%E7%A0%81-blue" alt="二维码"> </a> * 后端采用spring boot、mybatis(已集成mybatis-plus增强插件，开发更迅速，可查看官方文档了解更多：[mybatis-plus](https://mp.baomidou.com/))、shiro框架 * 前端采用layui作为UI框架，实现90%的移动端自适应，支持主题更换 * 提供代码生成器([wiki使用文档](https://github.com/kalvinGit/kvf-admin/wiki/kvf%E4%BB%A3%E7%A0%81%E7%94%9F%E6%88%90%E5%99%A8%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3))，只需编写20%左右的代码，剩下全部自动生成；支持一键及批量功能模块生成，并支持一定程度上的自定义配置并生成代码，相对比较灵活 #### 基础框架功能模块 * [x] 用户管理 * [x] 部门管理 * [x] 菜单管理 * [x] 角色管理 * [x] 字典管理 * [x] 操作日志 * [x] 代码生成 * [x] 组件管理 ## kvf-admin-activiti（工作流OA版本） kvf-admin-activiti是基于kvf-admin脚手架集成了工作流引擎（activiti6），并封装了核心工作流程（OA）功能模块。如下： 目前工作流（OA）模块还处于初始阶段，代码也比较粗糙，后续再不断完善优化。<br> 备注：工作流版本在【activiti】分支 * [x] 核心API（支持启动流程、提交任务、驳回、驳回任意环节、驳回首环节、撤回、挂起/激活流程等API） * [x] 流程管理（支持流程在线设计器、发布/部署、挂起、激活、导出/导入、配置表单、启动、删除） * [x] 表单管理（支持快速表单在线设计器、增/删/改/查、预览表单） * [x] 我的流程（发起流程申请） * [x] 我的待办（支持快速办理、查看任务表单办理、历史审批意见、流程实时流转图等） * [x] 我的已办（支持撤回功能） * [x] 我的申请（查看所有当前用户申请过的流程情况） * [ ] 下一步计划，期待大家的反馈意见！ ### 更新日志 [👳👉‍点我点我点我](https://github.com/kalvinGit/kvf-admin/wiki/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97) ### 项目结构树 ```` kvf-admin │ │ pom.xml maven依赖管理pom文件 │ ├─sql │ kvf_sys.sql 项目初始化数据表及基础数据sql脚本 │ └─src ├─main │ ├─java │ │ └─com │ │ └─kalvin │ │ └─kvf │ │ │ KvfAdminApplication.java 项目启动类 │ │ │ │ │ ├─common 通用模块 │ │ └─modules 功能模块 │ │ ├─generator 代码生成器模块 │ │ └─sys 系统模块（核心） │ └─resources │ │ application.yml spring boot 配置文件 │ │ ehcache.xml ehcache缓存配置文件 │ │ │ ├─mapper mybatis mapper文件 │ ├─static 静态资料 │ └─templates 模板 │ │ 403.html 403页面 │ │ home.html 系统首页页面 │ │ index.html 主页 │ │ login.html 登录页 │ │ │ ├─common 通用模板 │ │ base.html │ │ sys_tpl.html │ │ │ ├─generator 生成器模板 │ │ │ └─sys 系统页面模板 │ └─test 单元测试块 ```` ### 软件需求 * jdk8+ * mysql5.7+ ### 所用技术 #### 前端 * jQuery * [layui v2.5.6](https://www.layui.com/doc/) (UI框架) #### 后端 * spring boot v2.2.4.RELEASE * Mybatis * [Mybatis-plus v3.3.0](https://mp.baomidou.com/guide/wrapper.html#abstractwrapper) (mybatis增强插件，无侵入。非常强大的插件，除了联表操作，几乎都可以使用它的sql条件构造器完成) * Shiro v1.4.0 * Druid v1.1.21 * ehcache * redis * [hutool-all v4.5.1](https://hutool.cn/docs/#/) (java通用工具类，此包几乎包括了所有常用的工具方法，你也可以按需引入相应工具模块包) ### 项目特点 * 非常精简且轻量级的权限系统，代码简洁易懂，无论学习还是项目中应用，都是非常简单易上手的项目 * 拥有界面配置化代码生成器，支持一键生成及简单自定义配置生成代码 * 自动过滤输入的非法字符串，防止XSS攻击 * 使用ehcache + redis作为缓存，对需要加入缓存的方法上添加@Cacheable注解即可（你也可以使用redisTemplate添加获取缓存），提升系统运行速度 * 支持日志记录，可在需要加入日志操作记录的controller方法上添加@Log("业务操作备注")即可完成日志记录 * 系统全局统一异常处理，所有异常信息统一处理返回R对象，前端处理提示信息更方便 * 支持工作流（OA）功能 * 完美支持多种部署方式（jar、tomcat、docker等） ### 本地部署 * 通过git/gitee下载源码(推荐使用git，因为gitee不是实时更新的)，若是工作流OA版本，请clone activiti分支 * 创建数据库：执行sql/kvf_admin.sql脚本创建数据库及表并初始化系统基础数据，若是工作流OA版本需要额外执行sql/kvf_admin_activiti.sql脚本 * 修改开发环境配置文件application-dev.yml，配置数据库账号和密码 * 开发工具idea或eclipse还需要安装lombok插件，否则会提示找不到实体类的的get/set方法 * 运行KvfAdminApplication.java，启动项目【kvf-admin】 * idea启动访问：http://localhost/【一般idea都会自动去掉项目名】【这里使用80端口】 * eclipse启动访问：http://localhost/kvf-admin【这里使用80端口】 * 账号密码：admin/123456 ### linux部署 注意：以下三种方式部署前，记得初始化数据库哦 #### 打包 ###### 开发环境(dev)： ``` mvn package -P dev ``` ###### 测试环境(test)： ``` mvn package -P test -Dmaven.test.skip=true ``` ###### 生产环境(prod)： ``` mvn package -P prod -Dmaven.test.skip=true ``` #### jar包方式部署 项目已解决以jar包运行的情况下，无法读取文件等各种问题，所以放心使用 ###### 运行 ``` nohup java -jar kvf-admin.jar & ``` #### tomcat部署 打包前�