|
|
@@ -1,3 +1,385 @@
|
|
|
+# 风控品控管理系统
|
|
|
+
|
|
|
+<div align="center">
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+基于 **RuoYi-Vue-Plus 5.6.2** 构建的企业级安全风险管控与质量管控一体化平台
|
|
|
+
|
|
|
+</div>
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 一、平台简介
|
|
|
+
|
|
|
+风控品控管理系统是面向生产/制造/工程类企业的安全风险与质量管控一体化 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 协议开源。
|
|
|
<img src="https://foruda.gitee.com/images/1679673773341074847/178e8451_1766278.png" width="50%" height="50%">
|
|
|
<div style="height: 10px; clear: both;"></div>
|
|
|
|
yangjingjing