商业版用户使用指南
本指南面向已购买 RuoYi Office 商业版的用户，涵盖代码获取、项目部署、需求与缺陷提交等核心流程。
购买须知
🙏 感谢您选择 RuoYi Office 商业版！为确保双方合作顺畅、预期一致，请在使用前仔细阅读以下说明。
产品定位
本项目以提供企业级源码服务为核心，适合以下场景：
- 有经验的 IT 从业者：基于成熟架构快速搭建业务系统，大幅缩减从零开发的周期和成本；
- 学生与技术爱好者：学习真实的企业级项目结构、技术选型与工程实践；
- 中小企业：以较低成本获得完整的办公协同、CRM、ERP 等功能模块源码，按需裁剪部署。
重要说明
源码 ≠ 开箱即用的标准化产品 本项目是一个持续迭代中的源码工程，不同于一键安装的 SaaS 产品。您获得的是完整的、可编译的工程源码，但将其落地为满足自身业务的系统，通常还需要经历以下环节：
- ⚙️ 个性化开发：根据自身业务需求进行功能定制与二次开发
- 🖥️ 运维部署：服务器选型、环境搭建、安全加固、性能调优
- 📋 实施配置：业务流程梳理、菜单权限配置、数据初始化
技术支持的边界 我们提供源码层面的答疑与缺陷修复（详见下文「提需求与缺陷」章节），但以下事项需由您或您的团队自行负责：
- 服务器采购、域名备案、SSL 证书等基础设施
- 生产环境的部署上线、日常运维与监控
- 基于源码的个性化业务定制开发
- 第三方系统对接与数据迁移
持续迭代，共同成长 项目处于活跃迭代中，我们会持续优化功能、修复问题、完善文档。您可以通过
git pull同步最新代码，也欢迎通过云效工作项反馈建议，一起让产品变得更好。
⚠️ 免责声明：购买即视为认可上述说明。本项目提供的是源码授权与技术支持服务，不承诺特定业务场景下的开箱即用效果。因部署环境、二次开发、运维操作等引发的问题，不属于售后服务范畴。请根据自身技术能力与团队资源，合理评估后再做决策。
一、获取代码
1.1 加入云效代码仓库
购买商业版后，请联系客服获取 阿里云云效项目邀请链接，步骤如下：
- 点击客服提供的邀请链接；
- 使用 阿里云账号 登录（可用手机号免费注册）；
- 加入 RuoYi Office 云效项目，即可访问私有代码仓库。
💡 不想注册阿里云账号？ 可联系客服直接索取代码压缩包。
1.2 克隆代码
访问 https://codeup.aliyun.com/ 找到对应仓库，使用以下命令克隆： 
# 后端项目
git clone <客服提供的后端仓库地址>
# 前端项目
git clone <客服提供的前端仓库地址>
# APP项目
git clone <客服提供的APP仓库地址>
# 数据库文件
git clone <客服提供的数据库文件仓库地址>📌 仓库地址以客服实际提供的为准。
二、项目部署
商业版提供两种部署方式，请根据实际需求选择：
| 部署方式 | 适用场景 | 参考文档 |
|---|---|---|
| 快速部署（单体模式） | 中小型团队、资源有限、快速上线 | 快速部署指南 |
| 微服务部署 | 大型团队、高并发、独立扩缩容 | 微服务部署指南 |
| 本地开发启动 | 开发调试、功能体验 | 快速启动文档 |
| 普通部署（单体模式） | 普通部署的详细部署指南 | 普通部署指南 |
| Docker 部署（单体模式） | Docker 部署的详细部署指南 | Docker 部署指南 |
2.1 环境要求
在开始部署前，请确认以下环境已就绪：
| 组件 | 版本要求 | 说明 |
|---|---|---|
| JDK | 17 或 21 | 推荐 OpenJDK |
| MySQL | 5.7+ / 8.0+ | 主数据库 |
| Redis | 5.0+ | 缓存与会话 |
| Nacos | 2.x | 微服务模式必需，单体模式不需要 |
| Nginx | 1.18+ | 前端静态文件 & API 反向代理 |
2.2 初始化数据库
执行上一步 git 拉取数据库仓库下最新的数据库脚本，初始化项目：
-- 创建数据库
CREATE DATABASE IF NOT EXISTS `ruoyi-office` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 然后在该数据库下执行 ruoyi-office-20260301.sql2.3 默认账号
部署完成后，使用以下账号登录管理后台：
| 账号 | 密码 | 权限 |
|---|---|---|
| admin | admin123 | 超级管理员 |
⚠️ 安全提示：首次登录后请立即修改默认密码。
三、获取更新
商业版持续迭代，如需同步最新代码：
# 拉取远程最新代码
git pull origin master
# 如有数据库变更，请同步执行增量 SQL（变更记录见仓库 CHANGELOG 或 sql/ 目录）💡 每次更新后请留意仓库的 变更说明，确认是否有配置项或数据库结构变更需要手动处理。
四、提需求与缺陷
4.1 提交渠道
请通过以下方式提交需求或缺陷：
- 云效工作项：在云效项目中创建工作项（推荐，方便跟踪进度）
- 联系客服：通过客服反馈，由客服协助录入工作项
4.2 提交规范
为提高处理效率，请按以下格式填写：
缺陷（Bug）格式：
【缺陷】简短描述问题标题
- 复现步骤：1. xxx 2. xxx 3. xxx
- 期望结果：xxx
- 实际结果：xxx
- 影响版本：vx.x.x
- 截图/录屏：（可附附件）需求格式：
【需求】简短描述需求标题
- 业务背景：为什么需要该功能
- 功能描述：具体要做什么
- 优先级：高 / 中 / 低4.3 处理流程
提交工作项 → 研发团队评估合理性 → 采纳后排期开发 → 版本发布后通知⚠️ 注意：研发团队会对每条需求和缺陷进行合理性评估，只有被采纳的条目才会排期处理。重复、超出商业版范围或不合理的需求将予以关闭。
五、获取技术支持
| 支持渠道 | 说明 |
|---|---|
| 客服 | 购买后由客服拉入专属技术支持群 |
| 文档站 | https://doc.ruoyioffice.com（持续更新） |
| 云效工作项 | 进度透明，可实时跟踪处理状态 |
💡 建议：技术问题优先查阅文档，若文档无法解答再联系技术支持，可大幅缩短响应时间。
六、常见问题
Q1：加入云效项目后看不到代码仓库？
确认已使用邀请链接中绑定的阿里云账号登录，并且链接未过期。如有问题请联系客服重新发送邀请。
Q2：数据库初始化报错？
检查数据库版本是否满足要求，字符集是否为 utf8mb4，以及 SQL 执行用户是否有足够权限。
Q3：如何判断使用单体模式还是微服务模式？
- 服务器内存 < 8GB，或同时在线人数 < 100 人，推荐 单体模式；
- 需要模块独立扩缩容、团队规模较大，推荐 微服务模式。
Q4：商业版是否包含源码？
是的，商业版提供完整源码，可自行修改和二次开发。
如有其他疑问，请联系客服获取帮助。