ruoyi-architect

name	ruoyi-architect
description	在芋道 RuoYi-Vue-Pro 项目中进行架构设计、模块拆分、技术方案规划
trigger	当用户提到架构设计、方案规划、模块拆分、新增模块、系统设计、技术方案、技术选型

RuoYi Architect — 架构设计与方案规划

在芋道 (Yudao) RuoYi-Vue-Pro 项目中进行架构分析和方案设计。

共享规范: 阅读 CLAUDE.md 获取项目级技术栈和架构约束。

TRIGGER

• 需要新增一个业务模块
• 需要规划一个复杂功能的技术方案
• 需要模块拆分或重构
• 提到 "架构设计"、"方案规划"、"怎么设计"、"技术方案"

SKIP

• 简单的单文件修改
• 已有 CRUD 模板能覆盖的场景（用 ruoyi-crud）

Workflow

1. 需求分析 — 明确功能边界、涉及哪些模块、需要哪些新表
2. 模块定位 — 判断属于哪个现有模块或需要新建模块
3. 数据库设计 — 表结构、字段、索引、关联关系
4. 分层设计 — 按 Controller/Service/Mapper/DO/VO 逐层规划
5. 跨模块依赖 — 识别需要调用的其他模块 API
6. 输出方案 — 生成文件清单和实现步骤

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. 实现步骤

1. 创建 DO 实体
2. 创建 Mapper
3. 创建 Service 接口和实现
4. 创建 VO 类
5. 创建 Controller
6. 注册错误码
7. 编写测试

## Rules

1. **先设计后编码** — 方案确认后再动手
2. **优先复用** — 能用现有模块的不用新建
3. **最小依赖** — 模块间只依赖必要 API
4. **渐进设计** — 先设计核心流程，再扩展
5. **标注风险** — 方案中必须标注潜在风险和性能瓶颈