| name | ruoyi-architect |
| description | 在芋道 RuoYi-Vue-Pro 项目中进行架构设计、模块拆分、技术方案规划 |
| trigger | 当用户提到架构设计、方案规划、模块拆分、新增模块、系统设计、技术方案、技术选型 |
RuoYi Architect — 架构设计与方案规划
在芋道 (Yudao) RuoYi-Vue-Pro 项目中进行架构分析和方案设计。
共享规范: 阅读 CLAUDE.md 获取项目级技术栈和架构约束。
TRIGGER
- 需要新增一个业务模块
- 需要规划一个复杂功能的技术方案
- 需要模块拆分或重构
- 提到 "架构设计"、"方案规划"、"怎么设计"、"技术方案"
SKIP
- 简单的单文件修改
- 已有 CRUD 模板能覆盖的场景(用
ruoyi-crud)
Workflow
- 需求分析 — 明确功能边界、涉及哪些模块、需要哪些新表
- 模块定位 — 判断属于哪个现有模块或需要新建模块
- 数据库设计 — 表结构、字段、索引、关联关系
- 分层设计 — 按 Controller/Service/Mapper/DO/VO 逐层规划
- 跨模块依赖 — 识别需要调用的其他模块 API
- 输出方案 — 生成文件清单和实现步骤
Output Format
## 方案设计
### 1. 需求概要
- 功能描述:...
- 涉及模块:...
- 新增数据表:...
### 2. 数据库设计
```sql
CREATE TABLE ...
3. 文件清单
| 文件 | 路径 | 说明 |
|---|
| XxxDO.java | yudao-module-xxx/... | 实体类 |
| XxxMapper.java | yudao-module-xxx/... | Mapper 接口 |
| ... | ... | ... |
4. 跨模块依赖
| 依赖方 | 调用方 | 调用方式 |
|---|
| system 模块 | 本模块 | UserApi.getUser(id) |
5. 实现步骤
- 创建 DO 实体
- 创建 Mapper
- 创建 Service 接口和实现
- 创建 VO 类
- 创建 Controller
- 注册错误码
- 编写测试
## Rules
1. **先设计后编码** — 方案确认后再动手
2. **优先复用** — 能用现有模块的不用新建
3. **最小依赖** — 模块间只依赖必要 API
4. **渐进设计** — 先设计核心流程,再扩展
5. **标注风险** — 方案中必须标注潜在风险和性能瓶颈