yuqing2026 / ruoyi-office

yuqing2026/ruoyi-office

open_in_new前往仓库

基于SpringCloud+Vue3+Vben的中小企业办公一体化平台，涵盖OA协同办公、HRM人力资源、CRM客户管理、BPM审批流、ERP进销存、合同管理、项目管理、资产管理、仓储、制造执行、财务、物联网、工单、商城、AI助手及数据报表等十余个子系统。

项目概览

项目概述

RuoYi Office 是一个面向中小企业的全业务数字化办公一体化平台，基于 Spring Cloud Alibaba 微服务架构和 Vue 3 + Vben Admin 前端框架构建。项目旨在通过一个平台整合 OA 协同办公、HRM 人力资源、CRM 客户管理、ERP 进销存、BPM 审批流、合同管理、PMS 项目管理、EAM 资产、WMS 仓储、MES 制造执行、财务管理、IoT 物联网、工单管理、MALL 商城、AI 智能助手、数据报表等十余个子系统，解决中小企业多系统割裂、成本高昂、流程断裂等信息化痛点。项目采用 MIT 开源协议，提供在线演示环境，支持模块化按需启用和独立部署。

核心功能

  • OA 协同办公：用车管理、印章管理、会议室预约、企业云盘、通知公告。
  • HRM 人力资源：员工档案、入职/转正/调动/离职管理，一键生成系统账号。
  • CRM 客户管理：线索、客户、联系人、商机、合同、回款、产品管理及统计分析。
  • ERP 进销存：采购、销售、库存、产品、财务管理。
  • BPM 流程引擎：仿钉钉/飞书设计器与 BPMN 设计器，支持会签、或签、抄送、转办、委派、加签、减签、父子流程、超时审批等。
  • EAM 资产管理：资产全生命周期管理（采购→领用→维修→报废）。
  • WMS 仓储管理：仓库、采购入库、出入库、库存查询。
  • MALL 企业商城：商品、订单、营销活动（优惠券/秒杀/拼团/砍价/满减）、售后退款、分销裂变。
  • AI 智能助手：AI 对话（多模型切换）、AI 写作、AI 绘图、知识库问答、AI 思维导图。
  • 支付中心：微信支付、支付宝、多渠道管理。
  • 数据报表：报表设计器、大屏设计器、数据可视化。
  • IoT 物联网：设备管理、数据采集与监控。
  • 系统管理：用户/角色/权限/菜单、多租户 SaaS、短信/邮件/站内信、SSO 单点登录、数据权限。
  • 微信公众号：粉丝管理、消息管理、自动回复、模板消息。
  • 会员中心：会员管理、标签/等级/分组、积分签到。
  • 基础设施：代码生成器、API 文档、文件存储、定时任务、日志管理、链路追踪。

适用与不适用场景

适用场景：

  • 10~500 人规模的中小企业，覆盖制造业、贸易、互联网、建筑工程、物流运输、教育培训、医疗健康、零售连锁、金融服务、餐饮酒店、物业管理、政府/事业单位等行业。
  • 需要整合 OA、HRM、CRM、ERP 等多套系统的企业，希望降低 IT 成本、提升流程效率。
  • 需要移动办公、多租户 SaaS 模式、国产化数据库适配的企业。

不适用场景：

  • 大型企业或集团，业务复杂度高、定制需求深，可能需要更专业的企业级解决方案。
  • 对数据安全要求极高、需要完全离线部署且无法使用云服务的场景（项目依赖 Nacos、RocketMQ 等中间件）。
  • 需要极简轻量级 OA 的小微企业，可能功能过重。

技术架构与依赖

  • 微服务框架：Spring Cloud Alibaba 2025.0.0 + Spring Boot 3.5.x
  • 服务网关：Spring Cloud Gateway
  • 注册/配置中心：Nacos 2.x
  • 消息队列：RocketMQ 5.x
  • 工作流引擎：Flowable 7.0.x（仿钉钉/飞书 + BPMN 双设计器）
  • 前端框架：Vue 3.5 + Vben Admin + TypeScript 5.8
  • UI 组件库：Ant Design Vue / Element Plus / Naive UI
  • 数据库：MySQL / PostgreSQL / Oracle / 达梦 / 人大金仓 / SQL Server
  • 缓存：Redis 6.x + Redisson 3.50
  • ORM：MyBatis Plus 3.5.12
  • 安全框架：Spring Security + OAuth 2.0 + JWT
  • 定时任务：XXL-Job 2.4.x
  • 监控追踪：SkyWalking + Spring Boot Admin
  • AI 大模型：ChatGPT / 通义千问 / 文心一言 / DeepSeek 等
  • 多终端：PC Web + uni-app（APP / 小程序 / H5）

安装与快速开始

环境要求：JDK 17 或 21、MySQL 5.7+ 或 8.0+、Redis 5.0+、Node.js 18+、Maven 3.9+、Nacos 2.x。

一键启动：

# 1. 克隆项目
git clone https://github.com/your-org/ruoyi-office.git

# 2. 导入数据库
mysql -u root -p < sql/mysql/ruoyi-vue-pro.sql

# 3. 启动后端（先启动 Nacos）
cd ruoyi-office
mvn clean install -DskipTests
java -jar yudao-server/target/yudao-server.jar

# 4. 启动前端
cd ruoyi-office-vben
pnpm install
npm run dev:antd

更详细的部署文档请参考官方快速启动指南。

典型使用方法

  • 在线体验：访问 http://ruoyioffice.com/web/，账号 admin / admin123。
  • 流程配置：使用仿钉钉/飞书设计器或 BPMN 设计器，拖拽搭建审批流程，支持会签、或签、抄送等。
  • AI 助手：在 AI 模块中切换不同大模型，进行对话、写作、绘图、知识库问答。
  • 代码生成：利用基础设施模块的代码生成器，一键生成前后端代码和 SQL 脚本。
  • 多租户管理：通过系统管理模块配置租户和套餐，实现 SaaS 多租户隔离。

配置与部署要点

  • 后端部署：参考 docs/后端部署指南.md，涉及 Jenkins 自动化部署、Docker 容器化、MySQL/Redis 配置、SSH 免密登录等。
  • 数据库初始化：导入 sql/mysql/ruoyi-vue-pro.sql 和 quartz.sql。
  • 中间件：需先启动 Nacos、Redis、RocketMQ 等。
  • 配置文件：生产环境配置位于 yudao-server/src/main/resources/application-prod.yaml。
  • 安全建议：使用强密码、限制端口开放、配置 HTTPS、定期更新依赖。
  • 性能优化：根据服务器内存调整 JVM 参数、MySQL 缓冲池大小、Redis 内存限制。

限制、风险与许可证

  • 限制：项目处于持续迭代中，部分模块（如 PMS、合同管理增强版、财务管理等）尚在规划中；演示环境数据每日重置。
  • 风险：微服务架构部署复杂，需要一定的运维能力；依赖多个中间件，需确保其稳定性；AI 功能依赖第三方大模型服务，可能产生费用。
  • 许可证：MIT License，个人和企业可免费使用，无需保留版权信息。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README 及 docs/后端部署指南.md。
  • 分析时间：2026年1月22日（基于文档中出现的日期）。