# 芋道 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 数据库初始化 ```bash # 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 后端启动 ```bash # 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 前端启动 ```bash # 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_history` 或 `erp_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 访问： ```http 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