编辑 | blame | 历史 | 原始文档

芋道 ruoyi-vue-pro 工作流程操作文档

一、项目概述

1.1 项目简介

芋道 ruoyi-vue-pro 是一套全部开源的企业级快速开发平台,基于 Spring Boot 4.0 + Vue 3 构建,包含系统管理、工作流、CRM、ERP、MES、WMS 等多个业务模块。

1.2 已解锁模块

模块 说明 表数量
yudao-module-system 系统管理(用户、角色、菜单、字典等) 32
yudao-module-infra 基础设施(代码生成、文件、定时任务等) 11
yudao-module-bpm 工作流引擎 8
yudao-module-crm 客户关系管理 19
yudao-module-erp 企业资源计划 33
yudao-module-mes 制造执行系统 71
yudao-module-wms 仓库管理系统 16

二、开发环境配置

2.1 环境要求

  • JDK 21+
  • MySQL 8.0+
  • Redis 6.0+
  • Node.js 18+
  • Maven 3.8+

2.2 数据库初始化

# 1. 创建数据库
CREATE DATABASE `ruoyi-vue-pro` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 2. 执行 SQL 脚本
mysql -u root -p ruoyi-vue-pro < docs/database_schema.sql

# 3. 导入初始数据(菜单、字典等)
mysql -u root -p ruoyi-vue-pro < sql/ruoyi-vue-pro.sql

2.3 后端启动

# 1. 进入项目目录
cd ruoyi-vue-pro

# 2. 编译项目
mvn clean install -DskipTests

# 3. 启动服务
cd yudao-server
mvn spring-boot:run -Dspring-boot.run.profiles=local

2.4 前端启动

# 1. 进入前端目录
cd yudao-ui-admin

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev

三、功能模块工作流程

3.1 系统管理模块 (System)

3.1.1 用户管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  新增用户   │ -> │  分配角色   │ -> │  分配部门   │
└─────────────┘    └─────────────┘    └─────────────┘
                           │
                           v
                    ┌─────────────┐
                    │  启用/禁用  │
                    └─────────────┘

操作步骤:

  1. 登录系统管理后台
  2. 进入【系统管理】->【用户管理】
  3. 点击【新增】按钮,填写用户基本信息
  4. 选择用户所属部门
  5. 分配用户角色(可多选)
  6. 设置用户岗位
  7. 点击【确定】保存

涉及表:
- system_users - 用户表
- system_user_role - 用户角色关联表
- system_user_post - 用户岗位关联表

3.1.2 角色权限配置流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  创建角色   │ -> │  分配菜单   │ -> │  分配数据   │
│             │    │  权限       │    │  权限范围   │
└─────────────┘    └─────────────┘    └─────────────┘

操作步骤:

  1. 进入【系统管理】->【角色管理】
  2. 点击【新增】创建角色
  3. 点击【菜单权限】分配菜单访问权限
  4. 点击【数据权限】设置数据范围(全部、本部门、仅本人等)
  5. 保存配置

涉及表:
- system_role - 角色表
- system_role_menu - 角色菜单关联表


3.2 工作流模块 (BPM)

3.2.1 流程设计流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  创建流程   │ -> │  设计表单   │ -> │  设计流程   │ -> │  发布流程   │
│  分类       │    │             │    │  图         │    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

操作步骤:

  1. 进入【工作流】->【流程管理】->【流程分类】
  2. 创建流程分类(如:审批流程、业务流程)
  3. 进入【表单管理】,创建业务表单
  4. 进入【流程模型】,点击【新增模型】
  5. 选择表单类型(动态表单/自定义表单)
  6. 使用流程设计器设计流程(拖拽节点、配置审批人)
  7. 点击【发布】启用流程

涉及表:
- bpm_category - 流程分类表
- bpm_form - 表单定义表
- bpm_process_definition_info - 流程定义扩展表

3.2.2 流程审批流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  发起申请   │ -> │  提交审批   │ -> │  审批处理   │ -> │  流程归档   │
│             │    │             │    │  (通过/驳回)│    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

审批人操作:

  1. 登录系统,进入【待办任务】
  2. 查看待办事项,点击【处理】
  3. 查看申请内容和表单数据
  4. 选择审批结果:通过/驳回/转办
  5. 填写审批意见
  6. 点击【提交】完成审批

涉及表:
- bpm_oa_leave - 请假申请表(示例业务表)
- bpm_process_instance_copy - 流程抄送表


3.3 客户关系管理模块 (CRM)

3.3.1 线索转客户流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  录入线索   │ -> │  跟进线索   │ -> │  转化客户   │ -> │  分配负责人 │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │
       v                  v
┌─────────────┐    ┌─────────────┐
│  线索池     │    │  跟进记录   │
│  公海回收   │    │             │
└─────────────┘    └─────────────┘

操作步骤:

  1. 进入【CRM】->【线索管理】
  2. 点击【新增】录入线索信息(姓名、联系方式、来源等)
  3. 在线索详情页,添加【跟进记录】
  4. 线索成熟后,点击【转化为客户】
  5. 系统自动创建客户档案,关联原线索
  6. 为客户分配负责人

涉及表:
- crm_clue - 线索表
- crm_customer - 客户表
- crm_follow_up_record - 跟进记录表
- crm_permission - 数据权限表

3.3.2 商机销售流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  创建商机   │ -> │  关联产品   │ -> │  阶段推进   │ -> │  生成合同   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  商机阶段   │    │  产品报价   │    │  赢单/输单  │
│  管理       │    │             │    │             │
└─────────────┘    └─────────────┘    └─────────────┘

涉及表:
- crm_business - 商机表
- crm_business_product - 商机产品关联表
- crm_business_status - 商机状态表
- crm_contract - 合同表


3.4 企业资源计划模块 (ERP)

3.4.1 采购业务流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  采购申请   │ -> │  采购订单   │ -> │  采购入库   │ -> │  采购付款   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  需求部门   │    │  供应商     │    │  仓库       │    │  财务       │
│  发起       │    │  确认       │    │  验收       │    │  结算       │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

采购订单操作步骤:

  1. 进入【ERP】->【采购管理】->【采购订单】
  2. 点击【新增】,选择供应商
  3. 添加采购产品明细(产品、数量、单价)
  4. 设置交货日期、结算账户
  5. 点击【提交】或直接【审核】
  6. 订单审核后,可进行入库操作

采购入库操作步骤:

  1. 进入【采购入库】页面
  2. 选择已审核的采购订单
  3. 系统自动带入产品明细
  4. 选择入库仓库
  5. 确认入库数量,点击【提交】
  6. 审核通过后,库存自动增加

涉及表:
- erp_supplier - 供应商表
- erp_purchase_order - 采购订单表
- erp_purchase_order_items - 采购订单项表
- erp_purchase_in - 采购入库表
- erp_stock - 库存表

3.4.2 销售业务流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  销售报价   │ -> │  销售订单   │ -> │  销售出库   │ -> │  销售收款   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  客户询价   │    │  合同签订   │    │  发货       │    │  对账开票   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

涉及表:
- erp_customer - 客户表
- erp_sale_order - 销售订单表
- erp_sale_out - 销售出库表
- erp_finance_receipt - 收款单表

3.4.3 库存管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  库存查询   │ -> │  库存盘点   │ -> │  库存调拨   │
└─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  实时库存   │    │  盘盈/盘亏  │    │  跨仓调拨   │
│  明细       │    │  处理       │    │             │
└─────────────┘    └─────────────┘    └─────────────┘

涉及表:
- erp_warehouse - 仓库表
- erp_stock - 库存表
- erp_stock_record - 库存流水表
- erp_stock_check - 盘点单表
- erp_stock_move - 调拨单表


3.5 制造执行系统模块 (MES)

3.5.1 生产主数据管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  物料管理   │ -> │  BOM 管理   │ -> │  工艺路线   │ -> │  工作站     │
│             │    │             │    │             │    │  配置       │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 物料分类    │ │ 产品结构    │ │ 工序定义    │ │ 设备/人员   │
│ 计量单位    │ │ 替代料      │ │ 顺序配置    │ │ 工具夹具    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

物料管理操作:

  1. 进入【MES】->【主数据】->【物料管理】
  2. 新增物料分类(树形结构)
  3. 创建物料档案(编码、名称、规格、单位等)
  4. 配置物料批次属性

工艺路线操作:

  1. 进入【工艺路线】管理
  2. 先定义【工序】(加工、检验、装配等)
  3. 创建工艺路线,关联产品
  4. 配置工序顺序、工时定额
  5. 关联工作中心/设备

涉及表:
- mes_md_item - 物料表
- mes_md_item_type - 物料分类表
- mes_md_product_bom - BOM 表
- mes_pro_process - 工序表
- mes_pro_route - 工艺路线表
- mes_md_workstation - 工作站表

3.5.2 生产执行流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  生产工单   │ -> │  工单派工   │ -> │  生产领料   │ -> │  生产报工   │
│  下达       │    │             │    │             │    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 计划排程    │ │ 任务分配    │ │ 物料消耗    │ │ 进度反馈    │
│ 物料检查    │ │ 工作站指派  │ │ 批次追溯    │ │ 质量记录    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │
       v
┌─────────────┐
│  生产入库   │
└─────────────┘

生产工单操作步骤:

  1. 进入【MES】->【生产管理】->【生产工单】
  2. 点击【新增】,选择产品
  3. 系统自动带入 BOM 和工艺路线
  4. 设置计划数量、计划开始/结束时间
  5. 点击【下达】工单
  6. 工单下达后可进行派工、领料操作

生产报工操作:

  1. 进入【报工】页面
  2. 扫码或选择工单、工序
  3. 填写报工数量(合格/报废)
  4. 记录工时、设备使用情况
  5. 提交报工数据

涉及表:
- mes_pro_work_order - 生产工单表
- mes_pro_task - 生产任务表
- mes_pro_work_record - 报工记录表
- mes_wm_item_consume - 物料消耗表

3.5.3 设备管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  设备台账   │ -> │  点检保养   │ -> │  维修管理   │
└─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 设备档案    │ │ 点检计划    │ │ 维修工单    │
│ 设备状态    │ │ 保养计划    │ │ 故障记录    │
│ 车间分布    │ │ 执行记录    │ │ 验收确认    │
└─────────────┘    └─────────────┘    └─────────────┘

设备点检操作:

  1. 进入【设备管理】->【点检方案】
  2. 创建点检方案,配置点检项目
  3. 关联设备和周期
  4. 执行点检时,进入【点检记录】
  5. 逐项检查,记录结果
  6. 发现异常,自动触发报修

涉及表:
- mes_dv_machinery - 设备台账表
- mes_dv_check_plan - 点检方案表
- mes_dv_check_record - 点检记录表
- mes_dv_repair - 维修工单表

3.5.4 质量管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  来料检验   │ -> │  过程检验   │ -> │  成品检验   │ -> │  出货检验   │
│  (IQC)      │    │  (IPQC)     │    │  (FQC)      │    │  (OQC)      │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 采购入库    │ │ 生产工序    │ │ 生产完成    │ │ 销售出库    │
│ 前检验      │ │ 抽检/巡检   │ │ 全检/抽检   │ │ 前检验      │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

质检方案配置:

  1. 进入【质量管理】->【质检方案】
  2. 创建质检模板,配置检测项目
  3. 设置抽样方案(全检/抽检比例)
  4. 配置检验指标和标准值

检验操作:

  1. 选择待检单据(采购入库单/生产工单等)
  2. 创建检验单
  3. 逐项检验,记录数据
  4. 判定结果(合格/不合格/让步接收)
  5. 不合格品进入处理流程

涉及表:
- mes_qc_template - 质检方案表
- mes_qc_iqc - 来料检验表
- mes_qc_ipqc - 过程检验表
- mes_qc_oqc - 出货检验表
- mes_qc_defect_record - 缺陷记录表


3.6 仓库管理系统模块 (WMS)

3.6.1 入库业务流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  入库预约   │ -> │  到货登记   │ -> │  收货验收   │ -> │  上架作业   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ ERP采购单   │ │ 送货单据    │ │ 质量检验    │ │ 库位分配    │
│ 生成预约    │ │ 车辆信息    │ │ 数量确认    │ │ 批次管理    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

入库操作步骤:

  1. 进入【WMS】->【入库管理】->【入库单】
  2. 新建入库单,选择入库类型(采购入库/生产入库/其他入库)
  3. 添加入库商品明细
  4. 选择仓库
  5. 提交审核
  6. 审核通过后,库存增加

涉及表:
- wms_receipt_order - 入库单表
- wms_receipt_order_detail - 入库单明细表
- wms_inventory - 库存表
- wms_inventory_history - 库存流水表

3.6.2 出库业务流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  出库申请   │ -> │  波次生成   │ -> │  拣货作业   │ -> │  发货确认   │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 销售订单    │ │ 订单合并    │ │ 批次分配    │ │ 装车发运    │
│ 生产领料    │ │ 优先级排序  │ │ 库位指引    │ │ 物流跟踪    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘

涉及表:
- wms_shipment_order - 出库单表
- wms_shipment_order_detail - 出库单明细表

3.6.3 库存管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  库存查询   │ -> │  库存盘点   │ -> │  移库作业   │
└─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 实时库存    │ │ 盘盈盘亏    │ │ 库位调整    │
│ 批次追溯    │ │ 差异处理    │ │ 库存优化    │
└─────────────┘    └─────────────┘    └─────────────┘

涉及表:
- wms_inventory - 库存表
- wms_check_order - 盘点单表
- wms_movement_order - 移库单表
- wms_item_sku - 商品 SKU 表


四、系统集成说明

4.1 模块间数据流转

                    ┌─────────────────┐
                    │   System 模块   │
                    │  (用户/权限)    │
                    └────────┬────────┘
                             │
              ┌──────────────┼──────────────┐
              │              │              │
              v              v              v
     ┌────────────┐  ┌────────────┐  ┌────────────┐
     │ CRM 模块   │  │ ERP 模块   │  │ MES 模块   │
     │ (客户)     │  │ (采购/销售)│  │ (生产)     │
     └─────┬──────┘  └─────┬──────┘  └─────┬──────┘
           │               │               │
           └───────────────┼───────────────┘
                           │
                    ┌──────v──────┐
                    │  WMS 模块   │
                    │  (库存)     │
                    └─────────────┘

4.2 业务数据关联

业务场景 涉及模块 数据流向
销售订单 -> 发货 CRM → WMS 客户订单触发出库
采购订单 -> 入库 ERP → WMS 采购订单触发入库
生产领料 MES → WMS 工单触发领料出库
生产入库 MES → WMS 完工触发成品入库
质量检验 WMS → MES 入库触发来料检验

五、常见问题处理

5.1 用户无法登录

排查步骤:

  1. 检查用户状态是否启用
  2. 检查用户角色是否分配
  3. 检查角色菜单权限
  4. 检查账户是否被锁定(密码错误次数过多)
  5. 查看登录日志 system_login_log

5.2 数据权限问题

排查步骤:

  1. 检查角色的数据权限范围设置
  2. CRM 模块检查 crm_permission
  3. 确认数据是否正确分配负责人

5.3 流程审批异常

排查步骤:

  1. 检查流程定义是否正确发布
  2. 确认审批人配置是否正确
  3. 查看流程实例状态
  4. 检查候选用户/用户组配置

5.4 库存数据不一致

排查步骤:

  1. 检查 wms_inventory_historyerp_stock_record 流水记录
  2. 核对出入库单据是否全部审核
  3. 执行库存盘点校正
  4. 检查是否有未完成的调拨单

六、附录

6.1 模块路径对照表

模块 后端路径 前端路径
System yudao-module-system views/system
Infra yudao-module-infra views/infra
BPM yudao-module-bpm views/bpm
CRM yudao-module-crm views/crm
ERP yudao-module-erp views/erp
MES yudao-module-mes views/mes
WMS yudao-module-wms views/wms

6.2 接口鉴权说明

所有业务接口需要携带 Token 访问:

Authorization: Bearer {access_token}

Token 获取方式:调用登录接口 /system/auth/login

6.3 多租户说明

系统支持多租户模式,租户隔离通过 tenant_id 字段实现:

  • System 模块大部分表包含 tenant_id
  • 业务模块(CRM、ERP、MES、WMS)不含租户字段,需自行实现隔离逻辑

文档版本: v1.0
更新日期: 2026-06-23
适用版本: ruoyi-vue-pro 2026.04-SNAPSHOT