# ruoyi-lowflow

**Repository Path**: haobinjun/ruoyi-lowflow

## Basic Information

- **Project Name**: ruoyi-lowflow
- **Description**: 若依+Activiti工作流集成LowFlow低代码流程设计器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 吕梁野山坡OA系统

> 基于若依(RuoYi) + Activiti工作流 + LowFlow低代码流程设计器的企业级OA系统

## 项目简介

吕梁野山坡OA系统是为吕梁野山坡沙棘汁公司定制开发的办公自动化平台，核心能力是**可视化流程设计**——业务人员无需编码即可设计审批流程、拖拽式构建业务表单，实现请假、报销、合同审批等常见办公场景的数字化管理。

## 技术栈

| 组件 | 技术 | 版本 | 目录 |
|------|------|------|------|
| 后端 | Spring Boot + Activiti + MyBatis | 2.2.6 + 7.1.0.M6 | `ruoyi-backend/` |
| 前端主框架 | Vue + Element UI | 2.6.10 + 2.13.2 | `ruoyi-ui/` |
| 流程设计器 | Vue 3 + Element Plus + Vite | 3.4.21 + 2.7.2 | `lowflow-design/`（iframe嵌入） |
| JSON→BPMN转换器 | Java Spring Boot | — | `lowflow-design-converter/` |
| 数据库 | MySQL + Redis | — | `sql/` |

## 核心功能

### 可视化流程设计

通过四Tab页面的模式，完成从表单到流程的一站式设计：

- **① 基础设置** — 图标颜色选择、流程标识/名称/分组、描述、流程管理员
- **② 表单设计** — 三栏拖拽式表单设计器（19种有效字段：16基础+1上传+2布局），基于vuedraggable
- **③ 流程设计** — 可视化流程设计器，支持9种节点类型（发起/审批/抄送/条件分支/互斥网关/计时/通知/服务/结束），通过iframe嵌入lowflow-design
- **④ 高级设置** — 撤销控制、流程标题、打印模板、审批人重复处理

### 节点类型体系

| 节点 | 功能 | BPMN映射 |
|------|------|---------|
| 发起人节点 | 定义流程发起者和表单权限 | StartEvent |
| 审批人节点 | 单人/串行/会签审批，支持操作权限配置 | UserTask + MultiInstanceLoopCharacteristics |
| 抄送人节点 | 流程流转时自动抄送相关人员 | ServiceTask |
| 条件分支 | 基于表单字段的条件表达式（12种操作符） | SequenceFlow + conditionExpression |
| 互斥网关 | 多条件分支的排他路由 | ExclusiveGateway |
| 计时等待 | 延时/定时触发 | IntermediateCatchEvent + TimerEventDefinition |
| 消息通知 | 邮件/站内信通知 | ServiceTask |
| 服务节点 | 外部系统调用 | ServiceTask |

### 工作流管理

- 流程设计CRUD（新增/编辑/删除/复制）
- 一键部署到Activiti引擎（JSON → BPMN XML自动转换）
- 流程定义管理（版本管理/挂起/激活/导出XML）
- 高级审批功能（审批通过/退回上一步/退回发起人/转办）
- 审批意见（通过/退回/转办均支持附带评论）
- 站内信通知（流程自动通知 + Navbar铃铛组件 + 未读计数）
- 流程监控看板（统计卡片 + echarts趋势图 + 待办排行榜）
- 字段权限控制（每个节点可设置字段为编辑/只读/隐藏）
- 操作日志（按业务键查询/最近操作记录）
- 流程历史追踪（高亮图、表单版本记录）

### 系统管理（若依原生）

- 用户/角色/权限管理（RBAC）
- 部门/岗位管理
- 菜单/字典管理
- 系统配置/通知公告
- 定时任务/代码生成/系统监控

## 代码规模

| 模块 | 文件数 | 代码行数 | 说明 |
|------|--------|---------|------|
| 后端 Java | 291 | 32,171 | Spring Boot + Activiti + MyBatis |
| 前端 Vue/JS | 154 | 4,329 | Vue 2 + Element UI |
| 转换器 Java | 26 | 1,229 | JSON→BPMN |
| 设计器 TS/Vue | 56 | 771 | Vue 3 + Vite |
| SQL | 8 | 221 | 建表+迁移脚本 |
| **代码合计** | **535** | **38,721** | |
| 文档 Markdown | 39 | 6,963 | 项目文档+代码导航+API参考 |
| **总计** | **574** | **45,684** | |

## 项目结构

```
ruoyi-lowflow/
├── ruoyi-backend/               # 后端（Spring Boot多模块）
│   ├── ruoyi-admin/             #   启动模块
│   ├── ruoyi-activiti/          #   ⭐ Activiti工作流核心模块
│   ├── ruoyi-workflow/          #   业务工作流（请假示例）
│   ├── ruoyi-framework/         #   安全框架（JWT/权限）
│   ├── ruoyi-system/            #   系统管理
│   ├── ruoyi-common/            #   公共工具
│   ├── ruoyi-generator/         #   代码生成器
│   └── ruoyi-quartz/            #   定时任务
├── ruoyi-ui/                    # 前端（Vue 2 + Element UI）
│   └── public/lowflow/          #   流程设计器构建产物（iframe加载）
├── lowflow-design/              # 流程设计器源码（Vue 3 + Vite）
├── lowflow-design-converter/    # JSON→BPMN转换器（ruoyi-activiti通过Maven依赖引用）
├── sql/                         # 数据库脚本
├── deploy/                      # 部署配置（nginx/systemd/生产yml）
├── docs/                        # 项目文档（14份+archive）
│   └── archive/                 #   历史文档（提示词/旧计划）
├── CLAUDE.md                    # AI开发认知文档
├── CODEMAP_BACKEND.md           # 后端代码导航
├── CODEMAP_FRONTEND.md          # 前端代码导航
├── CODEMAP_DESIGNER.md          # 设计器代码导航
├── reference_ruoyi_lowflow_api.md  # API端点与数据结构参考
└── README.md                    # 本文档
```

## 快速开始

### 环境要求

- JDK 8+
- MySQL 5.7+
- Redis 3.0+
- Node.js 12+ / npm 6+
- pnpm 8+（设计器开发用）

### 后端启动

```bash
cd ruoyi-backend
# 1. 导入 sql/ 下的SQL文件到MySQL
# 2. 修改 src/main/resources/application-druid.yml（数据库连接）
# 3. 修改 src/main/resources/application.yml（Redis连接、JWT密钥）
# 4. mvn package -pl ruoyi-admin -am -DskipTests
# 5. java -jar ruoyi-admin/target/ruoyi-admin.jar
# 端口：8080
```

### 前端启动

```bash
cd ruoyi-ui
npm install
npm run dev
# 端口：80，API代理 /dev-api → http://localhost:8080
```

### 流程设计器（独立开发）

```bash
cd lowflow-design
pnpm install
pnpm dev          # 开发模式，端口3200
pnpm build        # 构建，产物需复制到 ruoyi-ui/public/lowflow/
```

### 默认账号

- 管理员：`admin / admin123`

## 文档导航

### 代码导航（AI开发用，随代码同步更新）

> CODEMAP 是行号级别的代码定位索引，供AI快速找到文件和方法；docs/ 是架构级别的项目文档。

| 文档 | 用途 |
|------|------|
| [CLAUDE.md](CLAUDE.md) | AI开发认知文档（每次开发必读） |
| [CODEMAP_BACKEND.md](CODEMAP_BACKEND.md) | 后端代码导航 |
| [CODEMAP_FRONTEND.md](CODEMAP_FRONTEND.md) | 前端代码导航 |
| [CODEMAP_DESIGNER.md](CODEMAP_DESIGNER.md) | 设计器&转换器代码导航 |
| [reference_ruoyi_lowflow_api.md](reference_ruoyi_lowflow_api.md) | API端点与数据结构参考 |

### 项目文档（深度分析，位于 docs/）

| 文档 | 用途 |
|------|------|
| [docs/01-architecture.md](docs/01-architecture.md) | 架构设计文档 |
| [docs/02-data-flow.md](docs/02-data-flow.md) | 数据流转文档 |
| [docs/03-module-flow-designer.md](docs/03-module-flow-designer.md) | 流程设计器模块详解 |
| [docs/04-module-form-designer.md](docs/04-module-form-designer.md) | 表单设计器模块详解 |
| [docs/05-module-workflow.md](docs/05-module-workflow.md) | 工作流引擎模块详解 |
| [docs/06-deployment.md](docs/06-deployment.md) | 部署指南 |
| [docs/07-bug-fix-record.md](docs/07-bug-fix-record.md) | Bug修复记录 |
| [docs/08-tech-debt.md](docs/08-tech-debt.md) | 技术债与风险评估 |
| [docs/09-security-audit.md](docs/09-security-audit.md) | 安全审计报告 |
| [docs/10-feature-matrix.md](docs/10-feature-matrix.md) | 功能完整度矩阵 |
| [docs/11-delivery-assessment.md](docs/11-delivery-assessment.md) | 交付评估报告 |
| [docs/12-next-steps.md](docs/12-next-steps.md) | 优化路线图 |

## 来源与致谢

- [若依框架](https://gitee.com/y_project/RuoYi-Vue) — 基础管理框架
- [LowFlow流程设计器](https://gitee.com/cai_xiao_feng/lowflow-design) — 可视化流程设计
- [LowFlow转换器(Activiti分支)](https://gitee.com/cai_xiao_feng/lowflow-design-converter) — JSON→BPMN转换