## 项目概述

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。

**一键启动**：
```bash
# 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/](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 仓库**：[https://github.com/yuqing2026/ruoyi-office](https://github.com/yuqing2026/ruoyi-office)
- **在线演示**：[http://ruoyioffice.com/web/](http://ruoyioffice.com/web/)
- **快速启动指南**：[https://ruoyioffice.com/quick-start/](https://ruoyioffice.com/quick-start/)

## 信息来源和分析时间

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