# ruoyi-plus-uniapp

**Repository Path**: luanxd_admin/ruoyi-plus-uniapp

## Basic Information

- **Project Name**: ruoyi-plus-uniapp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RuoYi-Plus-UniApp 全栈多租户管理系统

> 基于 RuoYi-Vue-Plus 5.6.0 的全栈多租户管理系统，包含后端、Web 前端和移动端 UniApp

[![JDK](https://img.shields.io/badge/JDK-17+-blue.svg)](https://openjdk.java.net/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.x-brightgreen.svg)](https://spring.io/projects/spring-boot)
[![Vue](https://img.shields.io/badge/Vue-3.5.x-green.svg)](https://vuejs.org/)
[![UniApp](https://img.shields.io/badge/UniApp-3.x-blue.svg)](https://uniapp.dcloud.net.cn/)

## 项目架构

```
ruoyi_plus_uniapp_1/
├── ruoyi-vue-plus-5.6.0/       # 后端 (Spring Boot 3.5.x)
│   ├── ruoyi-admin/            # 启动入口
│   ├── ruoyi-common/           # 22 个通用模块
│   ├── ruoyi-modules/          # 5 个业务模块
│   └── script/sql/             # SQL 初始化脚本
├── plus-ui/                    # Web 前端 (Vue 3 + Element Plus)
├── ruo-yi-uni-app-plus/        # 移动端 (UniApp 3.x)
├── docker/                     # Docker 配置
└── docker-compose.yml          # Docker 编排
```

## 技术栈

| 模块 | 技术栈 |
|------|--------|
| **后端** | Spring Boot 3.5.x + MyBatis-Plus 3.5.16 + Sa-Token 1.44.0 + Redisson 3.52.0 + JDK 17/21 |
| **Web 前端** | Vue 3.5.x + TypeScript 5.9.x + Element Plus 2.13.x + Vite 7.x + Pinia 3.x |
| **移动端** | UniApp 3.x + Vue 3 + UView Plus |
| **基础设施** | MySQL 8.0 + Redis 7.2 + Nginx (Docker Compose) |

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- Node.js >= 20.19.0
- Docker & Docker Compose

### 1. 启动基础设施

```bash
docker-compose up -d
```

### 2. 启动后端

```bash
cd ruoyi-vue-plus-5.6.0
mvn clean install
mvn spring-boot:run -Pdev
```

### 3. 启动 Web 前端

```bash
cd plus-ui
npm install --registry=https://registry.npmmirror.com
npm run dev
```

### 4. 启动移动端 (H5)

```bash
cd ruo-yi-uni-app-plus
npm install --registry=https://registry.npmmirror.com
npm run dev:h5
```

### 访问地址

| 服务 | 地址 |
|------|------|
| Web 前端 | http://localhost:5173 |
| 后端 API | http://localhost:8080 |
| Swagger 文档 | http://localhost:8080/swagger-ui/index.html |
| 移动端 H5 | http://localhost:3002 |

## 核心功能

- 🏢 **多租户 SaaS** - 租户隔离、套餐管理
- 🔐 **权限安全** - Sa-Token + 数据脱敏 + 接口加密
- 📱 **全栈支持** - Web 前端 + UniApp 移动端
- 🗄️ **多数据源** - MySQL/Oracle/PostgreSQL/SQLServer
- ☁️ **分布式支持** - 分布式锁、幂等、任务调度
- 📊 **监控** - Spring Boot Admin + 链路追踪
- 🔧 **代码生成** - 快速生成 CRUD 代码

## 目录说明

### 后端模块

| 模块 | 说明 |
|------|------|
| `ruoyi-admin` | 启动入口 |
| `ruoyi-common-*` | 22 个通用模块（core, mybatis, redis, security 等） |
| `ruoyi-system` | 系统管理（用户/角色/菜单等） |
| `ruoyi-generator` | 代码生成器 |
| `ruoyi-workflow` | WarmFlow 工作流引擎 |
| `ruoyi-job` | 定时任务管理 |
| `ruoyi-demo` | 示例代码 |

### 前端模块

| 模块 | 说明 |
|------|------|
| `plus-ui` | Web 前端（Vue 3 + Element Plus） |
| `ruo-yi-uni-app-plus` | 移动端（UniApp，支持 H5/小程序/App） |

## 开发规范

### Git 提交格式

```
<type>: <description>
```

**Types**: `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `perf`, `ci`

### API 设计规范

| 操作 | HTTP 方法 | 路径 |
|------|----------|------|
| 分页查询 | GET | `/list` |
| 获取详情 | GET | `/{id}` |
| 新增 | POST | `/` |
| 修改 | PUT | `/` |
| 删除 | DELETE | `/{ids}` |

## 常用命令

### 后端

```bash
mvn clean install                 # 安装依赖
mvn spring-boot:run -Pdev         # 启动 (dev 环境)
mvn clean package -DskipTests -Pprod  # 打包
mvn test -pl ruoyi-common/ruoyi-common-core  # 运行单测
mvn spotless:apply                # 代码格式化
```

### 前端

```bash
npm run dev                       # 开发模式
npm run build:prod                # 生产构建
npm run lint:eslint               # 代码检查
npm run prettier                  # 代码格式化
```

### 移动端

```bash
npm run dev:h5                    # H5 开发
npm run dev:mp-weixin             # 微信小程序开发
npm run build:h5                  # H5 生产构建
npm run type-check                # TypeScript 类型检查
```

### Docker

```bash
docker-compose up -d              # 启动服务
docker-compose ps                 # 查看状态
docker-compose logs -f mysql      # 查看日志
docker-compose down               # 停止服务
```

## 配置说明

### 数据库连接

后端 `ruoyi-admin/src/main/resources/application-dev.yml`:

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ry-vue?useUnicode=true&characterEncoding=utf8&...
    username: root
    password: root
  redis:
    host: localhost
    port: 6379
    password: ruoyi123
```

### 前端 API 代理

前端 `plus-ui/.env.development`:

```env
VITE_APP_BASE_API = '/dev-api'
VITE_APP_BASE_URL = 'http://localhost:8080'
```

## 参考资源

- **官方文档**: https://plus-doc.dromara.org
- **后端 Gitee**: https://gitee.com/dromara/RuoYi-Vue-Plus
- **前端 Gitee**: https://gitee.com/JavaLionLi/plus-ui

## License

MIT