---
description: RuoYi Cloud 工程架构（与 .cursor/rules/java-architecture.mdc 同步）
globs: ["**/*.java","**/pom.xml"]
alwaysApply: true
---

# RuoYi Cloud 3.6.8 架构

## 模块

- ruoyi-gateway / ruoyi-auth / ruoyi-api / ruoyi-common
- ruoyi-modules（system、gen、job、file、**busi**）
- ruoyi-ui（Vue2 前端）

## 包结构（busi 示例）

```
com.ruoyi.busi/
├── controller/
├── domain/          # 继承 BaseEntity
├── mapper/
├── service/ + impl/
└── resources/mapper/busi/*.xml
```

## 框架能力

| 能力 | 类 |
|------|-----|
| 响应 | AjaxResult / TableDataInfo |
| 分页 | PageHelper + startPage() |
| 权限 | @RequiresPermissions |
| 认证 | TokenService + JWT/Redis |
| 日志 | @Log |
| 异常 | ServiceException |
| 跨模块 | @FeignClient（ruoyi-api） |
| 内部调用 | @InnerAuth + R<T> |

## 禁止

- MyBatis-Plus、yudao、Sa-Token、@PreAuthorize
