**项目说明** - xjrsoft-boot是一个轻量级的，前后端分离的Java快速开发平台，能快速开发项目并交付 - 支持MySQL、Oracle、SQL Server、PostgreSQL等主流数据库 **具有如下特点** - 友好的代码结构及注释，便于阅读及二次开发 - 实现前后端分离，通过token进行数据交互，前端再也不用关注后端技术 - 灵活的权限控制，可控制到菜单、列表、按钮、表单，满足绝大部分的权限需求 - 配套前端框架使用Vue3.x，最新的技术，最好的性能、极大的提高了开发效率 - 引入power-job定时任务，可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能 - 引入Hibernate Validator校验框架，轻松实现后端校验 - 引入云存储服务，已支持：七牛云、阿里云、腾讯云、华为云、minio等 - 引入knife4J文档支持，方便编写API接口文档 - 引入sms4j支持，支持多种短信平台 - 引入ureport报表支持 - 引入liteflow框架 开发规则引擎功能 - 引入magic-api 封装 实现在线开发接口 - 引入hutool包 作为工具类 - 接入chatgpt，只需要配置中填写相应key 即可使用chatgpt赋能 - 使用mybatisplusjoin 增强mybatisplus 实现多表联查功能 - 使用satoken 作为权限框架 功能强大 好用 - 完善的代码生成器，可以自动生成各种各样的代码，包括：DTO、VO、Service、Controller、Mapper、JavaBean、Swagger等 - 支持一键发布docker镜像，方便快速部署 - 完善的xss防御 sql注入防御 黑白名单 接口限流。 - 使用camunda工作流引擎 为基础 实现符合中国的流程使用功能。 - 项目中除了个别业务逻辑需要，使用ORM完全实现零SQL编程。可以无需再编写XML文件，更好的适配所有的数据库. **项目结构** ``` xjrsoft-boot ├─common 公共模块 │ ├─annotation 常用注解 │ ├─aspect 系统日志 │ ├─exception 异常处理 │ ├─enums 后台枚举 │ ├─constant 后台常量 │ ├─handler 处理器 │ ├─model 常用数据模型 │ │ ├─base 实体类父类 │ │ ├─datasrouce 数据源有关模型封装 │ │ ├─generator 代码生成器有关模型封装 │ │ ├─result 返回值封装 │ │ └─tree 树结构模型封装 │ ├─page 分页工具类 │ ├─satoken 权限框架注解鉴权实现类 │ ├─tree 树结构接口 --用于限定数据结构 │ ├─utils 各种工具类 │ └─xss XSS过滤 │ ├─config 配置信息 │ ├─modules 功能模块 │ ├─bi 数据大屏模块 │ ├─generator 代码生成器模块 │ ├─oss 文件服务模块 │ ├─organization 组织架构模块 │ ├─form 自定义表单模块 │ ├─report 报表模块 │ └─system 系统管理模块 │ ├─XjrsoftApplication 项目启动类 │ ├──resources │ ├─mapper SQL对应的XML文件 │ │─template freemark模板文件 │ │─banner 启动banner图 │ └─logback 日志配置文件 ```
**技术选型：** - 项目 [jdk](https://www.oracle.com/java/technologies/downloads/) 采用 11 版本 - 开发框架 采用 [springboot ](https://spring.io/projects/spring-boot)版本 2.7.5 + - ORM框架 采用 [mybatis-plus](https://baomidou.com/) 版本 3.5.2+ - ORM动态数据源 采用 [dynamic-datasource](https://www.kancloud.cn/tracy5546/dynamic-datasource/2264611) 版本 3.5.1 - ORM多表联查工具类 采用 [mybatis-plus-join](https://https://gitee.com/best_handsome/mybatis-plus-join/wikis/%E5%AE%89%E8%A3%85) 版本 1.2.2+ - ORM动态数据源 采用 [mybatis-plus-dynamic-datasource](https://gitee.com/baomidou/dynamic-datasource-spring-boot-starter) 版本 3.5.1 - 数据库连接池框架采用 [druid](https://github.com/alibaba/druid) 版本 1.1.22+ - 接口文档框架采用 [knife4j](https://doc.xiaominfo.com/) 版本 2.0.7+ - json格式化工具 采用 [fastjson](https://github.com/alibaba/fastjson/wiki/Quick-Start-CN)等 版本 1.2.72+ - 代码模板框架 采用 [Freemark](http://freemarker.foofun.cn/) 版本 2.3.30+ - 权限框架采用 [sa-token](https://sa-token.dev33.cn/) 版本 1.29.0+ - 常用工具类库 采用 [hutool](https://www.hutool.cn/) 版本5.7.20+ - 注解验证 [hibernate-validator](https://hibernate.org/validator/) 版本 6.0.13.Final - 分布式定时任务框架 采用 [power-job](http://www.powerjob.tech/) 版本 4.3.2 - 工作流引擎 采用 [camunda](https://camunda.com/) 版本 7.18.0 - 在线接口 采用 [magic-api](https://www.ssssssss.org/magic-api/) 版本 2.1.1 - 短信工具类库 采用 [sms4j](https://wind.kim/) 版本 2.1.0 - java动态类库 采用 [javassist](http://www.javassist.org/) 版本 3.29.2-GA - 规则引擎 采用 [liteflow](https://liteflow.yomahub.com/) 版本 2.10.1 - excel工具类库 采用 [easyexcel](https://github.com/alibaba/easyexcel) 版本 3.1.4 - 云存储 适配 平台（[minio](http://www.minio.org.cn/),阿里云,腾讯云,华为云,七牛云） **注意事项：** - idea 必须安装lombok插件使用 - 开发或者部署 需要在application.yml 设置相应的 yml - idea 直接使用 dockerfile 打包上传到镜像 需要配置docker docker所在服务器也需要打开2375端口 - pom 里面docker-plugin 插件 用途在于 执行打包命令 会直接上传到docker 也需要打开2375端口 - 代码生成器 如果想要拥有审计字段（create_user_id 等字段）自动填充功能 表结构必须要符合框架的约定 比需要拥有这些字段（create_user_id | create_date | modyfy_user_id | modify_date | delete_mark | enabled_mark） - 框架默认使用jdk11 您也可以自己修改为jdk8 原则上jdk版本 最低jdk8 上不封顶 。 - 如果哪些接口您需要记录日志，请自行在控制器 controller 的方法上 添加 XjrLog注解 参数填写接口描述即可 - 如果您需要放行某些接口 /src/main/java/com/xjrsoft/config/SaTokenConfig.java 文件 对应新增 - 非数据优先的代码生成器功能 用户所配置的表结构 表名 字段名 如果配置的为大小写混用 默认会改为 蛇形命名法 而且默认全小写 （oracle dm 等数据库默认全大写的除外） - 代码生成器-数据优先 模板 如果 子表的外键 关联 父表的非主键字段 级联删除会失效。 如果需要级联删除 请默认子表外键 关联 父表的主键 - 如果需要使用定时任务 请根据 power-job 官网文档部署服务端 再来使用。 定时任务新增或者修改数据 将不会自动填充 审计字段 - 前端想要内嵌其他url 需要把外链地址填写到组件地址栏 - 工作流模块中 审批人、传阅人 数量不能超过21人