视频教程与学习路线

本页用于把 RuoYi Office 的学习内容按阶段组织起来。它不是上游课程页面的镜像，也不承载外部社区或付费课程信息；重点是帮助开发者和交付人员按正确顺序掌握本项目。

如果你刚接触项目，建议先按「部署运行 -> 前端理解 -> 后端理解 -> 工作流 -> 业务模块 -> 二开交付」的顺序推进。

学习路线总览

阶段	学习目标	推荐入口
1. 快速跑起来	准备 MySQL、Redis、JDK、Node.js，启动后端和 PC 管理端	快速启动
2. 理解工程结构	明确后端、PC、移动端、文档站、数据库仓库的边界	RuoYi Office 简介
3. 掌握 PC 前端	理解 Vben、Ant Design Vue、VxeTable、业务组件和页面组织	前端组件
4. 掌握流程审批	会配置流程模型、流程表单、业务表单、审批人和字段权限	工作流 BPM
5. 开发表单单据	会用表单开发、业务表单、附件、字段权限、单据打印完成闭环	表单开发
6. 部署交付	能在客户服务器完成部署、排障和升级	部署选型 · Windows 部署

第一阶段：快速启动

目标是把项目在本地跑起来，确认数据库、Redis、后端和 PC 管理端都正常。

建议掌握：

• JDK、Maven、Node.js、pnpm、MySQL、Redis 的版本要求。
• 单体模式和微服务模式的区别。
• yudao-server 后端启动入口。
• ruoyi-office-vben/apps/web-antd PC 管理端启动入口。
• 登录页、工作台和基础菜单是否正常加载。

推荐文档：

• 快速启动
• PC 管理端快速启动
• 部署选型

第二阶段：理解整体架构

这一阶段不要急着改业务代码，先把工程边界看清楚。

重点理解：

• 后端多模块 Maven 工程如何拆分。
• yudao-framework、yudao-module-*、yudao-server 的职责。
• PC 管理端 apps/web-antd/src/api 与 views 的对应关系。
• 移动端如何通过分包组织 OA、HRM、BPM 页面。
• 数据库增量 SQL 如何归档到 ruoyi-office-db/{YYYYMMDD}_update/。

推荐文档：

• RuoYi Office 简介
• 产品功能
• 前端组件

第三阶段：PC 前端开发

RuoYi Office 的 PC 管理端不是简单 CRUD 页面堆叠。常见业务页会组合表头、表单、附件、审批、流程记录、打印和底部按钮。

需要重点掌握：

• Page、useVbenModal、useVbenVxeGrid、TableAction。
• BasicForm、CardContainer、AttachmentList、FileUpload、ImageUpload。
• api 与 views 的模块同构组织。
• valueFormat 与后端日期类型的配套。
• 表单只读、审批态、字段权限的优先级。

推荐文档：

• 前端组件
• 表单开发

第四阶段：工作流与表单

工作流是 RuoYi Office 的关键能力。建议用真实业务单据学习，不要只看流程设计器。

建议按以下顺序学习：

1. 先理解 BPM 模块启用和菜单权限。
2. 创建一个流程模型，配置审批人。
3. 对比流程表单和业务表单的适用场景。
4. 为业务表单绑定数据模型和明细表。
5. 配置节点字段权限。
6. 发起流程、审批、驳回、加签、转办、抄送。
7. 配置单据打印模板。

推荐文档：

• 工作流 BPM
• 流程表单接入
• 业务表单接入
• 流程表单 VS 业务表单
• 单据打印

第五阶段：业务模块二开

进入业务二开时，建议从一个完整闭环开始，例如出差申请、用印申请、合同审批或项目立项。

一个完整业务单据通常包含：

• 主表和明细表设计。
• 后端 controller、service、mapper、vo。
• PC 列表页和详情页。
• 移动端申请页和审批详情。
• 流程模型、字段权限和通知。
• 附件、流程记录、单据打印。
• 增量 SQL 和初始化数据。

推荐先阅读：

• OA 协同办公
• HRM 人力资源
• CRM 客户关系
• 合同管理
• 项目管理

第六阶段：部署与交付

交付阶段重点不是“能启动”，而是要能定位问题、解释环境差异并形成可复用操作手册。

建议掌握：

• Windows 客户服务器部署。
• 普通 JAR 包部署。
• Docker 部署。
• 后端日志路径和常见异常排查。
• 前端构建产物和接口地址配置。
• 数据库初始化、增量 SQL、静态数据导出。

推荐文档：

• 单体部署
• 微服务部署
• Windows 部署
• Jenkins 流水线
• 上线文档

视频内容生产建议

后续录制视频时，建议每个视频只解决一个明确问题，配套文档页面同步更新。

视频主题	建议时长	配套文档
30 分钟本地快速启动	20-40 分钟	快速启动
PC 管理端目录和组件讲解	30-45 分钟	前端组件
创建一个流程模型并发起审批	30-60 分钟	工作流 BPM
业务表单接入流程	45-60 分钟	业务表单接入
单据打印模板配置	20-40 分钟	单据打印
Windows 客户部署实操	30-60 分钟	Windows 部署

每个视频对应的文档应包含截图、配置路径、常见问题和验证清单，避免只有口头演示。