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

一、项目概述

1.1 项目简介

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

1.2 已解锁模块

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

1.3 模块集成架构（核心改造）

本项目已实现 MDM 主数据管理 模块，打通 ERP、MES、WMS 三个业务模块的数据孤岛：

                        ┌─────────────────────────────────────┐
                        │         MDM 主数据管理模块           │
                        │  (物料、SKU、分类、单位、品牌)        │
                        └──────────────┬──────────────────────┘
                                       │
                    ┌──────────────────┼──────────────────┐
                    │                  │                  │
                    ▼                  ▼                  ▼
           ┌───────────────┐  ┌───────────────┐  ┌───────────────┐
           │   ERP 模块     │  │   WMS 模块     │  │   MES 模块     │
           │  产品 = 成品   │  │ 商品 = 物料    │  │ 物料 = 原料    │
           │ itemType=2    │  │ itemType=1    │  │ itemType=1    │
           └───────┬───────┘  └───────┬───────┘  └───────┬───────┘
                   │                  │                  │
                   └──────────────────┼──────────────────┘
                                      │
                        ┌─────────────▼─────────────┐
                        │     WMS 库存管理 API       │
                        │  (统一库存入库/出库/查询)  │
                        └───────────────────────────┘

数据统一说明：

业务模块	原数据表	现数据源	物料类型映射
ERP	erp_product	MDM Item	itemType=2（成品）
WMS	wms_item + wms_item_sku	MDM Item + SKU	itemType=1（物料）
MES	mes_md_item	MDM Item	itemType=1（物料）

二、开发环境配置

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

三、主数据管理模块 (MDM)

3.1 MDM 模块概述

MDM（Master Data Management）主数据管理模块是整个系统的数据核心，负责统一管理：

物料主数据 - 产品、物料、半成品的统一档案
物料 SKU - 物料的规格变体（尺寸、颜色等）
物料分类 - 物料的分类体系
计量单位 - 统一的计量单位管理
品牌管理 - 品牌档案管理

3.2 物料类型说明

┌─────────────────────────────────────────────────────────────────┐
│                      MDM 物料类型 (itemType)                      │
├─────────────────────────────────────────────────────────────────┤
│  1 - 物料/原料    → 用于 WMS 商品、MES 物料                      │
│  2 - 成品/产品    → 用于 ERP 产品                                 │
│  3 - 半成品       → 用于 MES 生产中间件                           │
│  4 - 辅料         → 用于生产辅助材料                              │
└─────────────────────────────────────────────────────────────────┘

3.3 物料管理流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  创建物料   │ -> │  设置分类   │ -> │  配置 SKU   │ -> │  启用物料   │
│  基本信息   │    │  单位品牌   │    │  规格价格   │    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │
       v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 编码生成    │    │ 分类关联    │    │ 多规格支持  │
│ 条码管理    │    │ 单位换算    │    │ 价格体系    │
└─────────────┘    └─────────────┘    └─────────────┘

操作步骤：

进入【MDM】->【物料管理】
点击【新增】，填写物料基本信息

物料编码（唯一）
物料名称
物料条码
规格型号

选择物料分类、计量单位、品牌
设置物料类型（物料/成品/半成品）
配置价格（采购价、销售价、成本价）
保存后，可添加 SKU 规格

涉及表：
- mdm_item - 物料主表
- mdm_item_sku - 物料 SKU 表
- mdm_item_category - 物料分类表
- mdm_unit_measure - 计量单位表
- mdm_brand - 品牌表

3.4 SKU 管理说明

┌─────────────────────────────────────────────────────────────┐
│                        物料 (Item)                           │
│  id: 1001  code: ITEM001  name: T恤                         │
├─────────────────────────────────────────────────────────────┤
│                          SKU 列表                            │
├─────────────────┬─────────────────┬─────────────────────────┤
│ SKU-001         │ SKU-002         │ SKU-003                 │
│ 红色 / L        │ 蓝色 / M        │ 黑色 / XL               │
│ 条码: 001REDL   │ 条码: 001BLUEM  │ 条码: 001BLACKXL        │
│ 销售价: 99      │ 销售价: 99      │ 销售价: 109             │
└─────────────────┴─────────────────┴─────────────────────────┘

SKU 字段：
- SKU 编码、SKU 名称、SKU 条码
- 尺寸（长/宽/高）
- 重量（毛重/净重）
- 价格（成本价/销售价）

四、功能模块工作流程

4.1 系统管理模块 (System)

4.1.1 用户管理流程

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

操作步骤：

登录系统管理后台
进入【系统管理】->【用户管理】
点击【新增】按钮，填写用户基本信息
选择用户所属部门
分配用户角色（可多选）
设置用户岗位
点击【确定】保存

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

4.1.2 角色权限配置流程

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

操作步骤：

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

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

4.2 工作流模块 (BPM)

4.2.1 流程设计流程

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

操作步骤：

进入【工作流】->【流程管理】->【流程分类】
创建流程分类（如：审批流程、业务流程）
进入【表单管理】，创建业务表单
进入【流程模型】，点击【新增模型】
选择表单类型（动态表单/自定义表单）
使用流程设计器设计流程（拖拽节点、配置审批人）
点击【发布】启用流程

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

4.2.2 流程审批流程

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

审批人操作：

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

涉及表：
- bpm_oa_leave - 请假申请表（示例业务表）
- bpm_process_instance_copy - 流程抄送表

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

4.3.1 线索转客户流程

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

操作步骤：

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

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

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

4.4.1 产品管理（MDM 集成）

┌─────────────────────────────────────────────────────────────────┐
│                    ERP 产品 = MDM 物料 (itemType=2)             │
├─────────────────────────────────────────────────────────────────┤
│  ErpProductService                                              │
│       │                                                         │
│       ▼                                                         │
│  MdmItemApi.createItem()  ──→  MDM 创建物料                      │
│  MdmItemApi.updateItem()  ──→  MDM 更新物料                      │
│  MdmItemApi.getItem()     ──→  MDM 查询物料                      │
│  MdmItemApi.getItemPage() ──→  MDM 分页查询                      │
└─────────────────────────────────────────────────────────────────┘

字段映射：

ERP 字段	MDM 字段	说明
id	id	统一 ID
name	name	产品名称
barCode	barCode	产品条码
standard	specification	规格型号
unitId	unitMeasureId	单位编号
salePrice	salesPrice	销售价格
minPrice	costPrice	最低价格/成本价

4.4.2 采购业务流程

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

采购入库集成：

ERP 采购入库
    │
    ▼
ErpStockRecordService.createStockRecord()
    │
    ▼
WmsInventoryApi.receipt()  ──→  WMS 入库操作
    │
    ▼
WMS 库存增加

涉及表：
- erp_supplier - 供应商表
- erp_purchase_order - 采购订单表
- erp_purchase_in - 采购入库表
- erp_stock_record - 库存流水表（ERP 本地记录）

4.4.3 销售业务流程

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

销售出库集成：

ERP 销售出库
    │
    ▼
ErpStockRecordService.createStockRecord()
    │
    ▼
WmsInventoryApi.shipment()  ──→  WMS 出库操作
    │
    ▼
WMS 库存减少

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

4.4.4 库存查询（WMS 集成）

┌─────────────────────────────────────────────────────────────────┐
│                    ERP 库存 = WMS 库存 API                       │
├─────────────────────────────────────────────────────────────────┤
│  ErpStockService                                                │
│       │                                                         │
│       ▼                                                         │
│  MdmItemSkuApi.getItemSkuListByItemId() ──→ 获取默认 SKU        │
│       │                                                         │
│       ▼                                                         │
│  WmsInventoryApi.getAvailableQuantity() ──→ 查询可用库存        │
│  WmsInventoryApi.getInventoryList()      ──→ 查询库存列表       │
└─────────────────────────────────────────────────────────────────┘

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

4.5.1 物料管理（MDM 集成）

┌─────────────────────────────────────────────────────────────────┐
│                    MES 物料 = MDM 物料 (itemType=1)             │
├─────────────────────────────────────────────────────────────────┤
│  MesMdItemService                                               │
│       │                                                         │
│       ▼                                                         │
│  MdmItemApi.getItem()     ──→  MDM 查询物料                      │
│  MdmItemApi.getItemList() ──→  MDM 查询物料列表                  │
└─────────────────────────────────────────────────────────────────┘

4.5.2 生产执行流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  生产工单   │ -> │  工单派工   │ -> │  生产领料   │ -> │  生产报工   │
│  下达       │    │             │    │             │    │             │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │                  │                  │                  │
       v                  v                  v                  v
┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 计划排程    │ │ 任务分配    │ │ WMS出库    │ │ 进度反馈    │
│ 物料检查    │ │ 工作站指派  │ │ API调用    │ │ 质量记录    │
└─────────────┘    └─────────────┘    └─────────────┘    └─────────────┘
       │
       v
┌─────────────┐
│  生产入库   │
│  WMS入库    │
│  API调用    │
└─────────────┘

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

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

4.6.1 商品管理（MDM 集成）

┌─────────────────────────────────────────────────────────────────┐
│                    WMS 商品 = MDM 物料 (itemType=1)             │
├─────────────────────────────────────────────────────────────────┤
│  WmsItemService                                                 │
│       │                                                         │
│       ▼                                                         │
│  MdmItemApi.createItem()  ──→  MDM 创建物料                      │
│  MdmItemApi.updateItem()  ──→  MDM 更新物料                      │
│  MdmItemApi.getItemPage() ──→  MDM 分页查询                      │
│  MdmItemApi.getItemList() ──→  MDM 查询列表                      │
└─────────────────────────────────────────────────────────────────┘

字段映射：

WMS 字段	MDM 字段	说明
id	id	统一 ID
code	code	商品编码
name	name	商品名称
unit	unitMeasure.name	单位名称（从计量单位获取）
categoryId	categoryId	分类编号
brandId	brandId	品牌编号

4.6.2 库存管理核心

┌─────────────────────────────────────────────────────────────────┐
│                    WMS 库存管理 API                              │
├─────────────────────────────────────────────────────────────────┤
│  WmsInventoryApi                                                │
│       │                                                         │
│       ├─ receipt()          入库操作                            │
│       │    └─ 参数: bizType, bizId, warehouseId, items[]        │
│       │                                                         │
│       ├─ shipment()         出库操作                            │
│       │    └─ 参数: bizType, bizId, warehouseId, items[]        │
│       │                                                         │
│       ├─ reserve()          库存预留（锁库存）                   │
│       │    └─ 参数: bizType, bizId, warehouseId, items[]        │
│       │                                                         │
│       ├─ releaseReserve()   释放预留                            │
│       │    └─ 参数: reserveNo                                   │
│       │                                                         │
│       ├─ getInventoryList() 查询库存列表                        │
│       │    └─ 参数: skuIds, warehouseIds, onlyPositive          │
│       │                                                         │
│       └─ getAvailableQuantity() 查询可用库存                    │
│            └─ 参数: skuId, warehouseId                          │
└─────────────────────────────────────────────────────────────────┘

4.6.3 入库业务流程

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

API 调用示例：

// ERP/MES 调用 WMS 入库
WmsReceiptReqDTO req = new WmsReceiptReqDTO();
req.setBizType(WmsInventoryBizTypeEnum.PURCHASE_RECEIPT.getType());
req.setBizId(purchaseInId);
req.setBizNo(purchaseInNo);
req.setWarehouseId(warehouseId);
req.setItems(List.of(
    new WmsReceiptReqDTO.Item(skuId, quantity, price)
));
wmsInventoryApi.receipt(req);

4.6.4 出库业务流程

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

API 调用示例：

// ERP/MES 调用 WMS 出库
WmsShipmentReqDTO req = new WmsShipmentReqDTO();
req.setBizType(WmsInventoryBizTypeEnum.SALE_SHIPMENT.getType());
req.setBizId(saleOutId);
req.setBizNo(saleOutNo);
req.setWarehouseId(warehouseId);
req.setItems(List.of(
    new WmsShipmentReqDTO.Item(skuId, quantity)
));
wmsInventoryApi.shipment(req);

涉及表：
- wms_inventory - 库存表
- wms_inventory_history - 库存流水表
- wms_inventory_reserve - 库存预留表

五、系统集成说明

5.1 模块间数据流转

                    ┌─────────────────┐
                    │   MDM 模块      │
                    │  (物料主数据)   │
                    └────────┬────────┘
                             │
              ┌──────────────┼──────────────┐
              │              │              │
              v              v              v
     ┌────────────┐  ┌────────────┐  ┌────────────┐
     │ ERP 模块   │  │ WMS 模块   │  │ MES 模块   │
     │ (成品)     │  │ (物料+SKU) │  │ (物料)     │
     │ itemType=2 │  │ itemType=1 │  │ itemType=1 │
     └─────┬──────┘  └─────┬──────┘  └─────┬──────┘
           │               │               │
           │               │               │
           └───────────────┼───────────────┘
                           │
                    ┌──────v──────┐
                    │  WMS 库存   │
                    │  API        │
                    └─────────────┘

5.2 API 接口清单

API 接口	提供方	调用方	说明
MdmItemApi	MDM	ERP/WMS/MES	物料主数据 CRUD
MdmItemSkuApi	MDM	ERP/WMS/MES	SKU 管理
MdmItemCategoryApi	MDM	ERP/WMS/MES	物料分类
MdmUnitMeasureApi	MDM	ERP/WMS/MES	计量单位
WmsInventoryApi	WMS	ERP/MES	库存入库/出库/查询

5.3 业务数据关联

业务场景	涉及模块	数据流向	API 调用
ERP 产品管理	ERP → MDM	产品 CRUD	MdmItemApi
WMS 商品管理	WMS → MDM	商品 CRUD	MdmItemApi
MES 物料管理	MES → MDM	物料查询	MdmItemApi
采购入库	ERP → WMS	库存增加	WmsInventoryApi.receipt()
销售出库	ERP → WMS	库存减少	WmsInventoryApi.shipment()
生产领料	MES → WMS	库存减少	WmsInventoryApi.shipment()
生产入库	MES → WMS	库存增加	WmsInventoryApi.receipt()
库存查询	ERP/MES → WMS	库存查询	WmsInventoryApi.getAvailableQuantity()

六、常见问题处理

6.1 用户无法登录

排查步骤：

检查用户状态是否启用
检查用户角色是否分配
检查角色菜单权限
检查账户是否被锁定（密码错误次数过多）
查看登录日志 system_login_log

6.2 数据权限问题

排查步骤：

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

6.3 流程审批异常

排查步骤：

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

6.4 物料数据不一致

排查步骤：

确认物料是否在 MDM 中正确创建
检查物料类型（itemType）是否正确
确认 SKU 是否正确配置
验证分类、单位关联是否正确

6.5 库存数据不一致

排查步骤：

检查 wms_inventory_history 库存流水记录
核对出入库单据是否全部审核
确认 WMS API 调用是否成功
执行库存盘点校正

七、附录

7.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
MDM	yudao-module-mdm	views/mdm
ERP	yudao-module-erp	views/erp
MES	yudao-module-mes	views/mes
WMS	yudao-module-wms	views/wms

7.2 接口鉴权说明

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

Authorization: Bearer {access_token}

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

7.3 多租户说明

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

System 模块大部分表包含 tenant_id
业务模块（CRM、ERP、MES、WMS、MDM）不含租户字段，需自行实现隔离逻辑

7.4 核心改造文件清单

文件	改造说明
ErpProductServiceImpl	产品 CRUD 调用 MdmItemApi
ErpStockServiceImpl	库存查询调用 WmsInventoryApi
ErpStockRecordServiceImpl	库存变更调用 WmsInventoryApi
WmsItemServiceImpl	商品 CRUD 调用 MdmItemApi
MdmItemApi	MDM 物料 API 接口
MdmItemSkuApi	MDM SKU API 接口
WmsInventoryApi	WMS 库存 API 接口

文档版本: v2.0
更新日期: 2026-06-29
适用版本: ruoyi-vue-pro 2026.04-SNAPSHOT
核心改造: MDM 主数据管理模块集成，打通 ERP/MES/WMS 数据孤岛