# 风控品控管理系统
![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.15-success.svg) ![JDK](https://img.shields.io/badge/JDK-17-green.svg) ![Vue](https://img.shields.io/badge/Vue-3.5-brightgreen.svg) ![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg) ![Element Plus](https://img.shields.io/badge/Element%20Plus-2.x-409EFF.svg) ![MyBatis Plus](https://img.shields.io/badge/MyBatis%20Plus-3.5-orange.svg) ![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1.svg) ![License](https://img.shields.io/badge/License-MIT-blue.svg) 基于 **RuoYi-Vue-Plus 5.6.2** 构建的企业级安全风险管控与质量管控一体化平台
--- ## 一、平台简介 风控品控管理系统是面向生产/制造/工程类企业的安全风险与质量管控一体化 SaaS 平台,覆盖 **人员管理、隐患排查、危险源管控、风险警示、特种设备、巡检作业、事故上报、舆情监控** 等核心业务场景,提供完整的数据看板、移动化作业流程与多维度统计决策支持。 底层基于 Dromara 开源框架 RuoYi-Vue-Plus(重写 RuoYi-Vue 针对分布式集群与多租户场景的全方位升级版本)深度定制开发。 ### 核心特性 - 🔐 **安全可靠** — Sa-Token 鉴权、AES+RSA 接口传输加密、数据脱敏、SQL 监控 - 🚀 **高性能** — Undertow 容器、Redisson 客户端、HikariCP 连接池、雪花 ID - 🧩 **业务完备** — 12 大风控业务模块,覆盖 200+ 个企业风险管控场景 - 📊 **数据驱动** — 内置 4 大仪表盘接口、20+ 个统计维度、动态图表可视化 - 🌐 **企业级** — 多租户/多角色/数据权限、MinIO 分布式文件存储、操作日志全留痕 --- ## 二、业务模块 ### 1. 人员与组织 | 模块 | 路径 | 功能 | |---|---|---| | 人员信息 | `/risk/personnel` | 员工档案、岗位、工种、状态管理 | | 人员变更 | `/risk/personnelChange` | 岗位/部门/工种变动履历记录 | | 人员证书 | `/risk/personnelCert` | 特种作业证、健康证等资质文件 | ### 2. 风险管控 | 模块 | 路径 | 功能 | |---|---|---| | 安全隐患 | `/risk/hiddenDanger` | 隐患上报、整改、复查、销项全流程闭环 | | 危险源上报 | `/risk/dangerSource` | 危险源登记、风险等级评估、防控措施落实 | | 风险警示 | `/risk/warning` | 风险预警信息发布与跟踪 | | 舆情推送 | `/risk/publicOpinion` | 重大舆情监测、影响范围、定级处置 | ### 3. 设备与巡检 | 模块 | 路径 | 功能 | |---|---|---| | 特种设备 | `/risk/specialEquipment` | 设备台账、检验日期、维护记录 | | 巡检任务 | `/risk/inspectionTask` | 巡检计划、打卡、巡检项/记录/详情三级管理 | ### 4. 作业与事故 | 模块 | 路径 | 功能 | |---|---|---| | 作业上报 | `/risk/workReport` | 高危作业申报、审批、监护 | | 事故上报 | `/risk/accident` | 事故登记、调查、考核、闭环 | | 审计工作 | `/risk/auditFile` | 审计文件上传、归档、检索 | ### 5. 数据看板 | 模块 | 路径 | 功能 | |---|---|---| | 工作台首页 | `/index` | 4 张数据卡片 + 2 张图表 + 最新隐患/培训/公告三段式布局 | 仪表盘内置 4 个真实数据接口(无任何 mock fallback): ``` GET /risk/dashboard/stats 数据统计(卡片 + 月度趋势 + 隐患类型分布) GET /risk/dashboard/recentDangers 最新隐患 Top N GET /risk/dashboard/recentTrainings 近期培训列表 GET /risk/dashboard/recentNotices 最近公告(对接 sys_notice) ``` --- ## 三、技术栈 ### 后端 | 技术 | 版本 | 用途 | |---|---|---| | Spring Boot | 3.5.15 | 主框架 | | JDK | 17 | 运行时 | | MyBatis Plus | 3.5.x | ORM 框架 | | Sa-Token | 1.45.x | 鉴权与单点登录 | | Undertow | - | Web 容器 | | Redisson | 3.x | Redis 客户端 | | MinIO | 8.x | 分布式文件存储 | | MySQL Connector | 8.x | 数据库驱动 | | Druid | 1.2.x | SQL 监控 | | Hutool | 5.x | 工具集 | | MapStruct Plus | - | Bean 转换 | ### 前端 | 技术 | 版本 | 用途 | |---|---|---| | Vue | 3.5.x | 主框架 | | TypeScript | 5.x | 类型系统 | | Element Plus | 2.x | UI 组件库 | | Vite | 5.x | 构建工具 | | Pinia | 2.x | 状态管理 | | Vue Router | 4.x | 路由 | | ECharts | 5.x | 图表 | | Axios | 1.x | HTTP 客户端 | ### 基础设施 | 组件 | 版本 | 用途 | |---|---|---| | MySQL | 8.0+ | 业务数据库 | | Redis | 6.0+ | 缓存/分布式锁 | | MinIO | RELEASE.2024+ | 对象存储 | | Nginx | 1.24+ | 反向代理 | --- ## 四、项目结构 ``` RuoYi-Vue-Plus/ ├── ruoyi-admin/ # 启动模块 │ ├── src/main/java/ │ │ └── org/dromara/web/ │ │ └── domain/vo/ # Web 层 VO(如 TenantListVo) │ └── src/main/resources/ │ ├── application.yml # 主配置 │ ├── application-dev.yml # 开发环境 │ └── application-prod.yml # 生产环境 │ ├── ruoyi-common/ # 通用组件 │ ├── ruoyi-common-core/ # 核心工具 │ ├── ruoyi-common-redis/ # Redis 封装 │ ├── ruoyi-common-security/ # 安全框架 │ ├── ruoyi-common-mybatis/ # MyBatis 扩展 │ ├── ruoyi-common-oss/ # 对象存储 │ ├── ruoyi-common-excel/ # Excel 导入导出 │ ├── ruoyi-common-encrypt/ # 加密解密 │ ├── ruoyi-common-satoken/ # Sa-Token 集成 │ ├── ruoyi-common-web/ # Web 拦截器/过滤器 │ ├── ruoyi-common-tenant/ # 多租户 │ ├── ruoyi-common-sensitive/ # 数据脱敏 │ ├── ruoyi-common-log/ # 日志 │ ├── ruoyi-common-idempotent/ # 分布式幂等 │ ├── ruoyi-common-ratelimiter/ # 限流 │ ├── ruoyi-common-websocket/ # WebSocket │ ├── ruoyi-common-sse/ # SSE 推送 │ ├── ruoyi-common-mail/ # 邮件 │ ├── ruoyi-common-sms/ # 短信 │ ├── ruoyi-common-social/ # 三方登录 │ ├── ruoyi-common-translation/ # 数据翻译 │ ├── ruoyi-common-doc/ # 接口文档 │ └── ruoyi-common-bom/ # 版本管理 │ ├── ruoyi-modules/ # 业务模块 │ ├── ruoyi-system/ # 系统管理(用户/角色/菜单/部门/字典等) │ ├── ruoyi-workflow/ # 工作流 │ ├── ruoyi-job/ # 分布式任务调度 │ ├── ruoyi-generator/ # 代码生成器 │ ├── ruoyi-demo/ # Demo 案例 │ └── ruoyi-risk/ # ★ 风控业务模块(本系统核心) │ └── src/main/ │ ├── java/org/dromara/risk/ │ │ ├── controller/ # REST 控制器 │ │ ├── service/ # 业务接口 │ │ │ └── impl/ # 业务实现(含 DashboardServiceImpl) │ │ ├── mapper/ # MyBatis Mapper │ │ ├── domain/ # 实体 │ │ │ ├── bo/ # 入参对象 │ │ │ └── vo/ # 出参对象 │ │ └── utils/ # 工具类 │ └── resources/mapper/risk/ # MyBatis XML │ ├── ruoyi-extend/ # 扩展模块 │ ├── ruoyi-monitor-admin/ # SpringBoot Admin │ └── ruoyi-snailjob-server/ # SnailJob 调度服务端 │ ├── ruoyi-ui/ # 旧版前端(Vue2 + Element UI)— 弃用 ├── sql/ # 业务 SQL 脚本 │ ├── risk_menu.sql # 菜单数据 │ └── risk_tables.sql # 建表脚本 │ └── script/ # 运维脚本 ├── bin/ # 启动/停止/重启 └── docker/ # Docker 编排 ``` > **前端项目位于仓库外**:`/Users/yangjingjing/Programmer/code/risk/plus-ui`(Vue 3 + TypeScript + Element Plus) --- ## 五、数据库设计 ### 风控业务表(共 12 张主表 + 关联子表) | 表名 | 说明 | 关键字段 | |---|---|---| | `risk_personnel` | 人员档案 | personnel_code, name, dept_id, position | | `risk_personnel_change` | 人员变更履历 | change_type, before_value, after_value | | `risk_personnel_cert` | 人员证书 | cert_type, cert_no, expire_date | | `risk_hidden_danger` | 安全隐患 | danger_code, level, status, handler | | `risk_danger_source` | 危险源 | source_code, source_type, risk_level | | `risk_warning` | 风险警示 | title, level, release_time | | `risk_special_equipment` | 特种设备 | equipment_code, type, next_check_date | | `risk_inspection_task` | 巡检任务 | task_code, plan_date, status | | `risk_inspection_record` | 巡检记录 | task_id, inspector, check_time | | `risk_inspection_record_detail` | 巡检明细 | record_id, item_id, result | | `risk_work_report` | 作业上报 | report_code, work_type, status | | `risk_audit_file` | 审计文件 | file_name, biz_type, biz_id, upload_time | | `risk_accident` | 事故上报 | accident_code, level, status, report_time | | `risk_public_opinion` | 舆情推送 | title, level, publish_time, influence | ### 建表规范 所有时间戳字段(`report_time` / `discover_time` / `publish_time` / `release_time` / `upload_time` 等)均为 **NOT NULL Default NULL**。前端表单不传时,由对应 `*ServiceImpl.insertByBo` 在 `MapstructUtils.convert` 之前自动填充 `new java.util.Date()`。 > ⚠️ 此为风控业务模块强约定,避免 MyBatis Plus 默认 insert 行为引发 `Field doesn't have a default value` 错误。 ### 业务编号生成 `RiskCodeGenerator` 工具类统一生成防冲突业务编号,格式为 `{业务前缀}-{企业编码}-{yyyyMMdd}-{4 位流水号}`,保证全局唯一。 --- ## 六、接口规范 ### 加密通信 - **传输加密**:基于动态 AES + RSA 加密请求体,每次请求使用不同秘钥 - **登录加密**:用户名密码使用 AES 加密后传输 - **请求头约定**:`isEncrypt: true` 标识启用加密 ### 统一响应 ```json { "code": 200, "msg": "操作成功", "data": { ... } } ``` ### 权限注解 ```java @SaCheckLogin // 登录校验 @SaCheckRole("admin") // 角色校验 @SaCheckPermission("risk:danger:add") // 权限校验 @SaCheckSafe("二级认证") // 二级认证校验 ``` ### 字典翻译 ```java @Dict(dictCode = "danger_level", source = "level") private String level; // 自动翻译为 "重大/较大/一般/轻微" ``` --- ## 七、本地开发 ### 环境要求 - JDK 17+ - Maven 3.8+ - Node.js 18+ - MySQL 8.0+ - Redis 6.0+ - MinIO(可选,文件存储用) ### 后端启动 ```bash cd RuoYi-Vue-Plus mvn clean install -DskipTests # 启动应用 java -jar ruoyi-admin.jar \ --spring.profiles.active=dev ``` ### 前端启动 ```bash cd plus-ui npm install npm run dev # 开发模式 npm run build:prod # 生产构建(输出至 dist/) ``` ### 初始化数据 ```bash # 1. 创建数据库 mysql -uroot -p -e "CREATE DATABASE risk_control_platform DEFAULT CHARSET utf8mb4;" # 2. 导入系统表 + 风控业务表 mysql -uroot -p risk_control_platform < script/sql/ry_vue_5.X.sql mysql -uroot -p risk_control_platform < sql/risk_tables.sql mysql -uroot -p risk_control_platform < sql/risk_menu.sql ``` ### 默认账号 | 账号 | 密码 | 角色 | |---|---|---| | `admin` | `admin123` | 超级管理员 | --- ## 八、部署架构 ``` ┌──────────────┐ │ Nginx │ :80/:443 反向代理 └──────┬───────┘ │ ┌──────────────┴──────────────┐ │ │ ┌────▼─────┐ ┌─────▼────┐ │ Frontend │ │ Backend │ ruoyi-admin.jar │ (Vite) │ │(Spring │ │ dist/ │ │ Boot 3) │ └──────────┘ └────┬─────┘ │ ┌────────────┬───────────────┼─────────────┬────────────┐ │ │ │ │ │ ┌────▼───┐ ┌─────▼────┐ ┌───────▼────┐ ┌─────▼────┐ ┌────▼────┐ │ MySQL │ │ Redis │ │ MinIO │ │ SnailJob │ │ Admin │ │ 8.0 │ │ 6.0+ │ │ 分布式存储 │ │ 调度中心 │ │ 监控 │ └────────┘ └──────────┘ └────────────┘ └──────────┘ └─────────┘ ``` > **生产部署**:参考 `script/docker/docker-compose.yml` 一键编排 --- ## 九、安全与性能约定 | 项 | 配置 | |---|---| | **接口加密** | `api-decrypt.enabled=true`(生产必须) | | **登录验证码** | 已关闭(多租户/三方登录/验证码一并关闭) | | **SQL 监控** | p6spy 完整输出 | | **数据脱敏** | 身份证/手机号/银行卡/邮箱 | | **接口幂等** | `@Idempotent` 注解防重 | | **分布式限流** | Redisson 限流器 | | **文件上传** | Nginx `client_max_body_size 100m;` | --- ## 十、远程仓库 - **Gitea**: http://134.175.81.27:3000/yangjingjing/risk_control_platform.git - **Gitee** (上游): https://gitee.com/dromara/RuoYi-Vue-Plus.git --- ## 十一、版本历史 | 版本 | 日期 | 说明 | |---|---|---| | v1.0.0 | 2026-06 | 整合 12 大风控业务模块,首版上线 | | 5.6.2 | - | 基于 RuoYi-Vue-Plus 官方版本 | --- ## 十二、致谢 本项目基于开源框架 [RuoYi-Vue-Plus](https://gitee.com/dromara/RuoYi-Vue-Plus) 开发,遵循 MIT 协议开源。
- - - ## 平台简介 [![码云Gitee](https://gitee.com/dromara/RuoYi-Vue-Plus/badge/star.svg?theme=blue)](https://gitee.com/dromara/RuoYi-Vue-Plus) [![GitHub](https://img.shields.io/github/stars/dromara/RuoYi-Vue-Plus?style=social&label=Github%20Stars)](https://github.com/dromara/RuoYi-Vue-Plus) [![Star](https://gitcode.com/dromara/RuoYi-Vue-Plus/star/badge.svg)](https://gitcode.com/dromara/RuoYi-Vue-Plus) [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://gitee.com/dromara/RuoYi-Vue-Plus/blob/5.X/LICENSE)
[![RuoYi-Vue-Plus](https://img.shields.io/badge/RuoYi_Vue_Plus-5.6.2-success.svg)](https://gitee.com/dromara/RuoYi-Vue-Plus) [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5-blue.svg)]() [![JDK-17](https://img.shields.io/badge/JDK-17-green.svg)]() [![JDK-21](https://img.shields.io/badge/JDK-21-green.svg)]() > Dromara RuoYi-Vue-Plus 是重写 RuoYi-Vue 针对 `分布式集群与多租户` 场景全方位升级(不兼容原框架) > 项目代码、文档 均开源免费可商用 遵循开源协议在项目中保留开源协议文件即可
活到老写到老 为兴趣而开源 为学习而开源 为让大家真正可以学到技术而开源 > 系统演示: [传送门](https://plus-doc.dromara.org/#/common/demo_system) > 官方前端项目地址: [gitee](https://gitee.com/JavaLionLi/plus-ui) - [github](https://github.com/JavaLionLi/plus-ui) - [gitcode](https://gitcode.com/dromara/plus-ui)
> 成员前端项目地址: 基于vben5 [ruoyi-plus-vben5](https://github.com/imdap/ruoyi-plus-vben5)
> 成员前端项目地址: 基于soybean [ruoyi-plus-soybean](https://gitee.com/xlsea/ruoyi-plus-soybean)
> 成员项目地址: 删除多租户与工作流 [RuoYi-Vue-Plus-Single](https://gitee.com/ColorDreams/RuoYi-Vue-Plus-Single)
> 文档地址: [plus-doc](https://plus-doc.dromara.org) 国内加速: [plus-doc.top](https://plus-doc.top) ## 赞助商 MaxKey 业界领先单点登录产品 - https://gitee.com/dromara/MaxKey
CCFlow 驰聘低代码-流程-表单 - https://gitee.com/opencc/RuoYi-JFlow
数舵科技 软件定制开发APP小程序等 - https://www.shuduokeji.com/
Mall4J 高质量Java商城系统 - https://www.mall4j.com/cn/?statId=11
aizuda flowlong 工作流 - https://gitee.com/aizuda/flowlong
Ruoyi-Plus-Uniapp - https://ruoyi.plus
Topiam IAM/IDaaS身份管理平台 - https://www.topiam.cn/
稳定低价的大模型中转站 - https://aicodelink.top/register?aff=pHeG
[如何成为赞助商 加群联系作者详谈 每日PV2500-3000 IP1700-2500](https://plus-doc.dromara.org/#/common/add_group) # 本框架与RuoYi的功能差异 | 功能 | 本框架 | RuoYi | |-------------|-------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------| | 前端项目 | 采用 Vue3 + TS + ElementPlus 重写 | 基于Vue2/Vue3 + JS | | 后端项目结构 | 采用插件化 + 扩展包形式 结构解耦 易于扩展 | 模块相互注入耦合严重难以扩展 | | 后端代码风格 | 严格遵守Alibaba规范与项目统一配置的代码格式化 | 代码书写与常规结构不同阅读障碍大 | | Web容器 | 采用 Undertow 基于 XNIO 的高性能容器 | 采用 Tomcat | | 权限认证 | 采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展 | Spring Security 配置繁琐扩展性极差 | | 权限注解 | 采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验
角色与权限校验支持多种条件 如 `AND` `OR` 或 `权限 OR 角色` 等复杂表达式 | 只支持是否存在匹配 | | 三方鉴权 | 采用 JustAuth 第三方登录组件 支持微信、钉钉等数十种三方认证 | 无 | | 关系数据库支持 | 原生支持 MySQL、Oracle、PostgreSQL、SQLServer
可同时使用异构切换(支持其他 mybatis-plus 支持的所有数据库 只需要增加jdbc依赖即可使用 达梦金仓等均有成功案例) | 支持 Mysql、Oracle 不支持同时使用、不支持异构切换 | | 缓存数据库 | 支持 Redis >= 6 支持大部分新功能特性 如 分布式限流、分布式队列 | Redis 简单 get set 支持 | | Redis客户端 | 采用 Redisson Redis官方推荐 基于Netty的客户端工具
支持Redis 90%以上的命令 底层优化规避很多不正确的用法 例如: keys被转换为scan
支持单机、哨兵、单主集群、多主集群等模式 | Lettuce + RedisTemplate 支持模式少 工具使用繁琐
连接池采用 common-pool Bug多经常性出问题 | | 缓存注解 | 采用 Spring-Cache 注解 对其扩展了实现支持了更多功能
例如 过期时间 最大空闲时间 组最大长度等 只需一个注解即可完成数据自动缓存 | 需手动编写Redis代码逻辑 | | ORM框架 | 采用 Mybatis-Plus 基于对象几乎不用写SQL全java操作 功能强大插件众多
例如多租户插件 分页插件 乐观锁插件等等 | 采用 Mybatis 基于XML需要手写SQL | | SQL监控 | 采用 p6spy 可输出完整SQL与执行时间监控 | log输出 需手动拼接sql与参数无法快速查看调试问题 | | 数据分页 | 采用 Mybatis-Plus 分页插件
框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序 | 采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好 | | 数据权限 | 采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤
只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色 | 采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展
生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用 | | 数据脱敏 | 采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件
支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展 | 无 | | 数据加解密 | 采用 注解 + mybatis 拦截器 对存取数据期间自动加解密
支持多种策略 如BASE64、AES、RSA、SM2、SM4等 | 无 | | 接口传输加密 | 采用 动态 AES + RSA 加密请求 body 每一次请求秘钥都不同大幅度降低可破解性 | 无 | | 数据翻译 | 采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译
支持多种模式: `映射翻译` `直接翻译` `其他扩展条件翻译` 接口化两步即可完成自定义扩展 内置多种翻译实现 | 无 | | 多数据源框架 | 采用 dynamic-datasource 支持市面大部分数据库
通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源
支持spel表达式从请求头参数等条件切换数据源 | 基于 druid 手动编写代码配置数据源 配置繁琐 支持性差 | | 多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 | | 数据库连接池 | 采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下 | 采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般 | | 数据库主键 | 采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁 | 采用 数据库自增ID 支持数据量有限 不支持多数据源主键唯一 | | WebSocket协议 | 基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物 | 无 | | SSE推送 | 采用 Spring SSE 实现 扩展了Token鉴权与分布式会话同步 | 无 | | 序列化 | 采用 Jackson Spring官方内置序列化 靠谱!!! | 采用 fastjson bugjson 远近闻名 | | 分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 | | 分布式锁 | 采用 Lock4j 底层基于 Redisson | 无 | | 分布式任务调度 | 采用 SnailJob 天生支持分布式 统一的管理中心 支持多种数据库 支持分片重试DAG任务流等 | 采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造 | | 文件存储 | 采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储
支持权限管理 安全可靠 文件可加密存储 | 采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应 | | 云存储 | 采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家 | 不支持 | | 短信 | 采用 sms4j 短信融合包 支持数十种短信厂家 只需在yml配置好厂家密钥即可使用 可多厂家共用 | 不支持 | | 邮件 | 采用 mail-api 通用协议支持大部分邮件厂商 | 不支持 | | 接口文档 | 采用 SpringDoc、javadoc 无注解零入侵基于java注释
只需把注释写好 无需再写一大堆的文档注解了 | 采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成 | | 校验框架 | 采用 Validation 支持注解与工具类校验 注解支持国际化 | 仅支持注解 且注解不支持国际化 | | Excel框架 | 采用 FastExcel(原Alibaba EasyExcel) 基于插件化
框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等 | 基于 POI 手写实现 功能有限 复杂 扩展性差 | | 工作流支持 | 支持各种复杂审批 转办 委派 加减签 会签 或签 票签 等功能 | 无 | | 工具类框架 | 采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码 | 手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等 | | 监控框架 | 采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制
实时监控服务状态 框架还为其扩展了在线日志查看监控 | 无 | | 链路追踪 | 采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗
用了它即可实时查看请求经过的每一处每一个节点 | 无 | | 代码生成器 | 只需设计好表结构 一键生成所有crud代码与页面
降低80%的开发量 把精力都投入到业务设计上
框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成 | 代码生成原生结构 只支持单数据源生成 | | 部署方式 | 支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼 | 原生jar部署 其他环境需手动下载安装 自行搭建 | | 项目路径修改 | 提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的 | 需要做很多改造 文档说明有限 | | 国际化 | 基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化 | 只提供基础功能 其他需自行编写扩展 | | 代码单例测试 | 提供单例测试 使用方式编写方法与maven多环境单测插件 | 只提供基础功能 其他需自行编写扩展 | | Demo案例 | 提供框架功能的实际使用案例 单独一个模块提供了很多很全 | 无 | ## 本框架与RuoYi的业务差异 | 业务 | 功能说明 | 本框架 | RuoYi | |--------|----------------------------------------------------------------------|-----|------------------| | 租户管理 | 系统内租户的管理 如:租户套餐、过期时间、用户数量、企业信息等 | 支持 | 无 | | 租户套餐管理 | 系统内租户所能使用的套餐管理 如:套餐内所包含的菜单等 | 支持 | 无 | | 客户端管理 | 系统内对接的所有客户端管理 如: pc端、小程序端等
支持动态授权登录方式 如: 短信登录、密码登录等 支持动态控制token时效 | 支持 | 无 | | 用户管理 | 用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等 | 支持 | 支持 | | 部门管理 | 配置系统组织机构(公司、部门、小组) 树结构展现支持数据权限 | 支持 | 支持 | | 岗位管理 | 配置系统用户所属担任职务 | 支持 | 支持 | | 菜单管理 | 配置系统菜单、操作权限、按钮权限标识等 | 支持 | 支持 | | 角色管理 | 角色菜单权限分配、设置角色按机构进行数据范围权限划分 | 支持 | 支持 | | 字典管理 | 对系统中经常使用的一些较为固定的数据进行维护 | 支持 | 支持 | | 参数管理 | 对系统动态配置常用参数 | 支持 | 支持 | | 通知公告 | 系统通知公告信息发布维护 | 支持 | 支持 | | 操作日志 | 系统正常操作日志记录和查询 系统异常信息日志记录和查询 | 支持 | 支持 | | 登录日志 | 系统登录日志记录查询包含登录异常 | 支持 | 支持 | | 文件管理 | 系统文件展示、上传、下载、删除等管理 | 支持 | 无 | | 文件配置管理 | 系统文件上传、下载所需要的配置信息动态添加、修改、删除等管理 | 支持 | 无 | | 在线用户管理 | 已登录系统的在线用户信息监控与强制踢出操作 | 支持 | 支持 | | 定时任务 | 运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等 | 支持 | 仅支持任务与日志管理 | | 代码生成 | 多数据源前后端代码的生成(java、html、xml、sql)支持CRUD下载 | 支持 | 仅支持单数据源 | | 系统接口 | 根据业务代码自动生成相关的api接口文档 | 支持 | 支持 | | 服务监控 | 监视集群系统CPU、内存、磁盘、堆栈、在线日志、Spring相关配置等 | 支持 | 仅支持单机CPU、内存、磁盘监控 | | 缓存监控 | 对系统的缓存信息查询,命令统计等。 | 支持 | 支持 | | 使用案例 | 系统的一些功能案例 | 支持 | 不支持 | ## 参考文档 使用框架前请仔细阅读文档重点注意事项
>[初始化项目 必看](https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/init) >>[https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/init](https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/init) > >[专栏与视频 入门必看](https://plus-doc.dromara.org/#/common/column) >>[https://plus-doc.dromara.org/#/common/column](https://plus-doc.dromara.org/#/common/column) > >[部署项目 必看](https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/deploy) >>[https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/deploy](https://plus-doc.dromara.org/#/ruoyi-vue-plus/quickstart/deploy) > >[如何加群](https://plus-doc.dromara.org/#/common/add_group) >>[https://plus-doc.dromara.org/#/common/add_group](https://plus-doc.dromara.org/#/common/add_group) > >[参考文档 Wiki](https://plus-doc.dromara.org) >>[https://plus-doc.dromara.org](https://plus-doc.dromara.org) ## 软件架构图 ![Plus部署架构图](https://foruda.gitee.com/images/1678981882624240692/ae2a3f3e_1766278.png "Plus部署架构图.png") ## 如何参与贡献 [参与贡献的方式 https://plus-doc.dromara.org/#/common/contribution](https://plus-doc.dromara.org/#/common/contribution) ## 捐献作者 作者为兼职做开源,平时还需要工作,如果帮到了您可以请作者吃个盒饭 ## 演示图例 | | | |--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | ![输入图片说明](https://foruda.gitee.com/images/1680077524361362822/270bb429_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680077619939771291/989bf9b6_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680077681751513929/1c27c5bd_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680077721559267315/74d63e23_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680077765638904515/1b75d4a6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078026375951297/eded7a4b_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078237104531207/0eb1b6a7_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078254306078709/5931e22f_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078287971528493/0b9af60a_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078308138770249/8d3b6696_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078352553634393/db5ef880_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078378238393374/601e4357_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078414983206024/2aae27c1_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078446738419874/ecce7d59_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078475971341775/149e8634_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078491666717143/3fadece7_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078558863188826/fb8ced2a_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078574561685461/ae68a0b2_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078594932772013/9d8bfec6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078626493093532/fcfe4ff6_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078643608812515/0295bd4f_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078685196286463/d7612c81_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078703877318597/56fce0bc_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078716586545643/b6dbd68f_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078734103217688/eb1e6aa6_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078759131415480/73c525d8_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078779416197879/75e3ed02_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078802329118061/77e10915_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078893627848351/34a1c342_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078928175016986/f126ec4a_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680078941718318363/b68a0f72_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680078963175518631/3bb769a1_1766278.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1735829153637063344/3c21fd4c_1419627.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1735829181303499815/4522cefa_1419627.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1735829377205259767/76a705d7_1419627.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1722959592856812900/e2d0d342_1419627.png "屏幕截图") | | ![输入图片说明](https://foruda.gitee.com/images/1680079274333484664/4dfdc7c0_1766278.png "屏幕截图") | ![输入图片说明](https://foruda.gitee.com/images/1680079290467458224/d6715fcf_1766278.png "屏幕截图") |