ruoyi-vue-pro/QUICK_START.md

🚀 快速开始指南

3分钟搭建完整的企业级开发平台！

⚡ 一键启动（推荐）

🐳 Docker 方式（最简单）

# 1. 克隆项目
git clone https://gitee.com/zhijiantianya/ruoyi-vue-pro.git
cd ruoyi-vue-pro

# 2. 一键启动（包含前端+后端+数据库+Redis）
cd script/docker
docker compose up -d

# 3. 访问系统
# 前端地址：http://localhost:8080
# 后端地址：http://localhost:48080
# 默认账号：admin / admin123

✅ 就这么简单！ 系统已经可以使用了。

💻 传统方式启动

软件	版本要求	说明
JDK	8+	推荐 JDK 11
Maven	3.6+	项目构建工具
MySQL	5.7+	主数据库
Redis	5.0+	缓存数据库

快速启动

# 1. 克隆项目
git clone https://gitee.com/zhijiantianya/ruoyi-vue-pro.git
cd ruoyi-vue-pro

# 2. 初始化数据库
mysql -u root -p -e "CREATE DATABASE ruoyi_vue_pro DEFAULT CHARACTER SET utf8mb4;"
mysql -u root -p ruoyi_vue_pro < sql/mysql/ruoyi-vue-pro.sql

# 3. 修改数据库配置（编辑 yudao-server/src/main/resources/application-local.yaml）
# 4. 启动项目
mvn clean install && cd yudao-server && mvn spring-boot:run

服务	地址	说明
🌐 后端API	http://localhost:48080	接口服务
📚 接口文档	http://localhost:48080/doc.html	Swagger文档
💻 管理后台	需启动前端项目	Vue3管理界面

账号类型	用户名	密码	说明
超级管理员	admin	admin123	全部权限
普通用户	test	test123	部分权限

🌟 核心特性速览

🎛️ 系统管理 - 完整的RBAC权限体系

• 用户管理、角色管理、菜单管理
• 部门管理、岗位管理、字典管理
• 多租户SaaS、数据权限控制
• 操作日志、登录日志、错误码管理

🔄 工作流程 - 仿钉钉+BPMN双引擎

• 在线流程设计器（仿钉钉风格）
• 专业BPMN流程设计器
• 会签、或签、依次审批、驳回、转办
• 动态表单、流程监控

🏪 商城系统 - 完整电商解决方案

• 商品管理、订单管理、库存管理
• 优惠券、满减、秒杀、拼团
• 分销系统、积分系统、会员等级
• 支付对接（微信、支付宝）

🤖 AI大模型 - 集成主流AI平台

• 对话聊天、图像生成、文档解析
• 支持OpenAI、文心一言、通义千问
• 知识库问答、AI写作助手

📱 启动前端（可选）

前端版本	特点	启动命令
Vue3 + Element Plus	🔥 推荐，功能最全	点击查看
Vue3 + Ant Design	💼 企业级设计	点击查看
Vue2 + Element UI	📱 稳定版本	点击查看

🔧 实用工具

一键重置脚本

# 重置数据库（谨慎使用）
mysql -u root -p -e "DROP DATABASE IF EXISTS ruoyi_vue_pro; CREATE DATABASE ruoyi_vue_pro DEFAULT CHARACTER SET utf8mb4;"
mysql -u root -p ruoyi_vue_pro < sql/mysql/ruoyi-vue-pro.sql

健康检查脚本

# 检查服务状态
curl -s http://localhost:48080/actuator/health | jq .

常用端口检查

# 检查端口占用
netstat -tulpn | grep -E ':48080|:3306|:6379'

⚠️ 常见问题

❌ 启动失败

1. 端口被占用 → lsof -i :48080 查看占用进程
2. JDK版本不对 → java -version 确认版本 ≥ 8
3. Maven依赖 → mvn clean install -U 重新下载

🔌 数据库连接失败

1. 服务未启动 → systemctl status mysql
2. 密码错误 → 检查 application-local.yaml 配置
3. 数据库不存在 → 重新执行初始化SQL

📡 Redis连接失败

1. 服务未启动 → systemctl status redis
2. 密码配置 → 检查Redis密码设置
3. 端口访问 → telnet localhost 6379

🚀 下一步

操作	链接	说明
📖 深入学习	开发指南	开发规范和最佳实践
🚀 生产部署	部署指南	生产环境部署方案
🎮 在线体验	演示地址	在线演示系统
💬 获取帮助	QQ群：3147719	技术交流群