# NexusERP **Repository Path**: NexusERP/nexus-erp ## Basic Information - **Project Name**: NexusERP - **Description**: Nexus-ERP 是一套面向制造与贸易型企业的智能管理系统，在传统流程管控之上，注入 AI 智能预测（精准驱动采购与排产）、AI 视觉质检与设备故障预警，并内置 AI 智能助手（支持自然语言交互式报表查询与业务问答）。 - **Primary Language**: Java - **License**: MIT - **Default Branch**: plus - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 6 - **Forks**: 7 - **Created**: 2025-09-03 - **Last Updated**: 2026-06-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: ERP, ruoyi, MES, IOT, AI ## README # Nexus-ERP Nexus-ERP 是一套面向制造业与贸易型企业的 ERP 管理系统，基于 **RuoYi-Vue-Plus v5.6.0** 二次开发而来，围绕“基础数据、销售、采购、生产、仓储、质量、设备、报表”构建企业业务中台，目标是把分散的业务流程连接成可追踪、可协同、可落地的管理闭环。 项目早期基于 RuoYi-Vue 进行扩展，后升级到 **RuoYi-Vue-Plus 分布式多租户架构**，在保留成熟后台能力的基础上，更适合多组织、多角色、多业务线的企业场景。 - **作者**：王欢 - **仓库地址**：[Gitee](https://gitee.com/helloworld_wh18/nexus-erp/tree/plus/) - **许可证**：MIT --- ## 项目定位 Nexus-ERP 不只是一个通用后台，而是一个以企业经营流程为核心的业务系统。当前重点聚焦于以下几个方向： - **打通业务闭环**：从订单、采购、生产到仓储出入库，减少业务断点。 - **统一主数据**：围绕物料、客户、供应商、BOM、工位、仓库等核心主数据建立统一管理体系。 - **增强过程管控**：通过状态流转、审批、库存过账、生产关联等能力提升过程可控性。 - **支撑后续扩展**：为质量管理、设备管理、追溯、财务基础和 BI 分析预留扩展空间。 --- ## 演示地址 - 演示站点：http://nexuserp.website/index - 账号：admin - 密码：admin123 > 提示：演示环境仅用于体验功能，建议不要在其中录入真实业务数据。 > 演示服务器能力有限，部分功能可能无法正常使用（minio、定时任务、系统监控服务未启动），请本地部署后运行查看功能。 --- ## 业务功能 ### 基础数据管理（BD） 统一维护物料主数据、物料清单（BOM）、客户档案、供应商档案、车间定义、工位管理、计量单位、物料分类等企业基础数据，为后续业务流程提供标准数据底座。 ### 生产管理（PRD） 覆盖生产计划排程、工单下达与跟踪、工序报工、物料需求运算等核心环节，逐步实现从计划到执行的生产全过程管控。 ### 销售管理（SO） 支持客户订单、销售订单头/行管理与订单全生命周期跟踪，并与生产、仓储模块联动，形成销售驱动的业务闭环。 ### 采购管理（PU） 支持采购申请、采购订单、到货通知、收货入库、采购退货与供应商评估，打通“请购 → 采购 → 收货 → 入库”的供应链主链路，提升物料保障、采购协同与成本控制能力。 ### 排产调度（SCH） 提供班次与班组管理、工人档案、考勤记录、假期管理、生产调度排程等能力，帮助企业更精细地管理人力与产能资源。 ### 仓储管理（WM） 覆盖仓库定义、库区/储位管理、库存查询与盘点、收货与发货管理、到货通知、条码管理与库存追溯等功能，提升仓储作业的标准化、可视化与可追溯性。 ### 工作流引擎（Flowable） 集成 Flowable 7.0 工作流引擎，支持复杂审批流程、转办、委派、加减签、会签、或签、票签等场景，可与各业务模块深度联动。 ### 积木报表（JimuReport） 内置积木报表引擎，支持在线设计报表模板、拖拽式报表配置和数据可视化展示，降低业务报表开发门槛。 ### 支付管理（Pay） 集成支付网关，支持多支付渠道接入，提供统一支付请求、回调处理、退款管理、账单对账等功能。 ### AI 智能助手（AI） 集成 LangChain4j + Agent 架构，提供自然语言驱动的 ERP 数据查询与智能对话能力： - **多模型支持**：通过数据库配置厂商（DeepSeek / 通义千问 / 智谱 / Ollama）和模型，运行时动态构建 ChatModel，支持同步和流式两种模式。 - **ERP 数据查询 Agent**：基于 Supervisor + SubAgent 编排，Agent 自动调用工具链（查询表列表 → 查看表结构 → 生成并执行 SQL）回答业务问题。 - **安全防护**：SQL 执行仅允许 SELECT，内置危险关键词黑名单、表名前缀白名单（bd_/so_/pu_/prd_/wm_/sch_），自动注入租户隔离条件，行数限制与超时控制。 - **SSE 实时推送**：AI 回复通过 Redis Pub/Sub + SSE 推送到前端，支持思考中/内容/完成/错误/图表等多种消息类型。 - **前端对话抽屉**：全局 AiChatDrawer 组件，支持 Markdown 渲染、会话管理、聊天历史，可在任意页面唤起。 - **多租户隔离**：异步线程通过 AiRequestContext 传播 tenantId/userId，确保数据查询遵守租户隔离规则。 --- ## 系统截图 ### 登录与首页 | 登录页 | 首页 | |--------|------| | ![登录页](script/image/登录页.png) | ![首页](script/image/首页.png) | ### 系统管理 | 用户管理 | 代码生成 | |----------|----------| | ![用户管理](script/image/用户管理.png) | ![代码生成](script/image/代码生成.png) | ### 基础数据 | 物料管理 | |----------| | ![物料管理](script/image/物料管理.png) | ### 生产管理 | 生产计划 | |----------| | ![生产计划](script/image/生产计划.png) | ### 销售管理 | 销售订单 | |----------| | ![销售订单](script/image/销售订单.png) | ### 采购管理 | 采购订单 | |----------| | ![采购订单](script/image/采购订单.png) | ### 排产调度 | 排班计划 | 考勤记录 | |----------|----------| | ![排班计划](script/image/排班计划.png) | ![考勤记录](script/image/考勤记录.png) | ### 仓储管理 | 物料入库 | 库存清单 | 库存预警 | |----------|----------|----------| | ![物料入库](script/image/物料入库.png) | ![库存清单](script/image/库存清单.png) | ![库存预警](script/image/库存预警.png) | ### 工作流引擎 | 工作流设计 | 工作流审批 | |------------|------------| | ![工作流设计](script/image/工作流设计.png) | ![工作流审批](script/image/工作流审批.png) | ### 积木报表 | 报表填写 | |----------| | ![报表填写](script/image/报表填写.png) | ### 支付管理 | 支付管理 | |----------| | ![支付管理](script/image/支付管理.png) | ### AI 智能助手 | 智能对话 | |----------| | ![智能对话](script/image/智能对话.png) | ### 即时通讯 | 即时通讯 | |----------| | ![即时通讯](script/image/即时通讯.png) | --- ## 技术栈 | 类别 | 技术 | |------|------| | 后端框架 | Spring Boot 3.5 + Maven | | 前端框架 | Vue 3 + TypeScript + Vite 7 + Element Plus + Pinia | | 权限认证 | Sa-Token + JWT 无状态认证 | | ORM | MyBatis-Plus 3.5.x（多租户、分页、数据权限、加密、脱敏） | | 数据库 | MySQL（主）+ Oracle / PostgreSQL / SQLServer（可选） | | 缓存 | Redis（Redisson + Spring Cache） | | 工作流 | Flowable 7.0 | | 报表 | 积木报表（JimuReport） | | 任务调度 | SnailJob | | 文件存储 | Minio（S3 协议） | | AI 框架 | LangChain4j 1.13.0 + LangChain4j Agentic（Supervisor Agent） | | 接口文档 | SpringDoc（基于 Javadoc） | --- ## 项目结构 ``` nexus-erp/ ├── ruoyi-admin/ # Spring Boot 入口 (DromaraApplication) ├── ruoyi-common/ # 共享库 (核心、Web、认证、ORM、Redis、多租户、AI、SSE、工作流等) ├── ruoyi-modules/ # 业务模块 │ ├── ruoyi-system/ # 系统管理（用户、角色、菜单、部门、租户、字典等） │ ├── ruoyi-erp/ # ERP 业务（基础数据、生产、销售、排产、仓储） │ ├── ruoyi-ai/ # AI 智能助手（Agent、Tool、SSE 推送、对话管理） │ ├── ruoyi-pay/ # 支付管理 │ ├── ruoyi-flowable/ # Flowable 工作流 REST API │ ├── ruoyi-generator/ # 代码生成器 │ ├── ruoyi-job/ # 分布式任务调度 │ └── ruoyi-demo/ # 框架使用示例 ├── ruoyi-extend/ # 扩展服务（监控中心、SnailJob 控制台） ├── plus-ui/ # 前端项目（Vue 3 + TS） └── script/sql/ # 数据库初始化脚本 ``` --- ## 快速开始 ### 环境要求 - JDK >= 17 - Maven >= 3.8 - Node >= 20.19.0 - MySQL >= 8.0 - Redis >= 6 ### 后端启动 ```bash # 克隆项目 git clone https://gitee.com/helloworld_wh18/nexus-erp.git cd nexus-erp # 执行初始化 SQL（按顺序） # 1. script/sql/ry_vue.sql # 2. script/sql/ry-vue-erp.sql # 3. script/sql/app.sql(可选，添加app配置SQL) # 启动后端 mvn spring-boot:run -P dev ``` ### 前端启动 ```bash cd plus-ui npm install npm run dev ``` 前端开发服务器默认监听 `http://localhost:80`，通过 `/dev-api` 代理到后端 `http://localhost:8080`。 ### 后端打包 ```bash mvn clean package -D maven.test.skip=true -P prod ``` ### 前端打包 ```bash cd plus-ui npm run build:prod ``` --- ## 未来期望 结合当前代码基础与后续完善计划，Nexus-ERP 的长期目标不只是“能用”，而是逐步成长为一个具备完整业务闭环和可扩展能力的企业级平台。 ### 短期目标 - 补齐现有模块的关键业务流程，让销售、生产、仓储、基础数据形成稳定闭环。 - 完善工单状态流转、库存调拨、盘点、报价、退货等高频业务能力。 - 提升页面交互与业务联动体验，让核心单据真正可落地使用。 - 增强 AI 智能助手能力：支持流式 Token 推送、RAG 知识库检索、更多业务场景 Agent（如报表生成、异常预警）。 ### 中期目标 - 新增采购模块，打通"请购 → 采购 → 收货 → 入库 → 生产领料"的供应链主链路。 - 完善质量管理、设备管理与批次/SN 追溯能力，增强过程管控。 - 引入更多策略化能力，如库存估值、推荐上架/拣货、安全库存预警等。 - 构建 AI Agent 编排体系，实现多 Agent 协作处理复杂业务场景（如自动生成采购建议、库存异常诊断）。 ### 长期目标 - 构建财务基础能力，逐步扩展到应收、应付、成本核算与经营分析。 - 建立更完善的报表与 BI 能力，支持管理层从数据视角查看经营状态。 - 持续增强工作流和自动化能力，让业务系统从"记录工具"升级为"流程驱动平台"。 - 沉淀出更适合中小制造企业的 ERP 实践方案，形成可复用、可演进的行业模板。 - 打造 AI 驱动的智能 ERP 平台，实现自然语言交互式业务操作、智能决策辅助与自动化流程执行。 --- ## License MIT License。保留原始 RuoYi-Vue-Plus 开源协议文件即可。