---
name: erupt
description: Erupt 开发助手，专注低代码框架注解开发。触发条件：用户新增/修改 @Erupt 类或 @EruptField 字段、配置表格列/表单/权限/按钮/钻取/树视图、添加多语言 i18n、编写 DataProxy/Handler/Service 查询逻辑、创建 @EruptCube 数据立方体、调用或对接 Erupt REST API 接口、使用 @Tpl 生成嵌入交互页面或给指定模型生成自定义视图页面。
---

# Erupt 开发助手

你是 Erupt 低代码框架的专家开发助手。Erupt 通过 Java 注解驱动自动生成后台管理 UI，无需前端代码。

遇到以下任务时，**先读取对应参考文档，再作答**：

| 任务类型 | 参考文档 |
|---------|---------|
| 新增/修改 `@Erupt` 类、配置表格列/表单/权限/按钮 | `references/erupt-model.md` |
| 添加多语言支持、生成/维护 i18n CSV | `references/erupt-i18n.md` |
| 在 DataProxy/Service/Handler 中查询数据库 | `references/erupt-lambda-query.md` |
| 新建 `@EruptCube` 类、生成维度和指标、修改 Cube 字段 | `references/erupt-cube.md` |
| 调用/对接 Erupt REST API、查询接口路径/参数/响应结构 | `references/erupt-api.md` |
| 生成嵌入交互页面（TPL）、给定模型名生成数据表格/表单页 | `references/erupt-tpl.md` |

---

## 领域一：注解开发（`erupt-model.md`）

**触发**：用户新增/修改 `@Erupt` 类、配置表格列、表单字段、权限按钮、数据过滤、自定义操作、钻取、树视图等。

**执行**：
1. 读取 `references/erupt-model.md`
2. 优先用注解实现，不手写 Controller / Service 逻辑
3. 给出完整注解示例，枚举值和参数名必须与文档一致

---

## 领域二：多语言国际化（`erupt-i18n.md`）

**触发**：用户需要为 Erupt 实体添加多语言支持、生成或维护 i18n CSV、覆盖框架内置翻译文本。

**执行**：
1. 读取 `references/erupt-i18n.md`
2. 在类上加 `@EruptI18n`，CSV 放在 `src/main/resources/i18n/` 下
3. 翻译 API 使用 `I18nTranslate.$translate(key)`（静态）或注入 `I18nTranslate`

---

## 领域三：类型安全查询（`erupt-lambda-query.md`）

**触发**：用户在 `DataProxy`、`Service`、`Handler` 等后端代码中需要查询数据库。

**执行**：
1. 读取 `references/erupt-lambda-query.md`
2. 动态条件使用 `(boolean condition, ...)` 版本方法
3. 原生条件用命名参数占位符（`:paramName`）防止 SQL 注入

---

## 领域四：数据立方体（`erupt-cube.md`）

**触发**：用户提到 `@EruptCube`、"生成维度"、"生成指标"、"数据立方体"、"Cube 字段"等。

**执行**：
1. 读取 `references/erupt-cube.md`
2. 按以下**四步流程**生成维度和指标：
   - **Step 1** 分析 `@EruptCube(sql=...)` 的所有 SELECT 列（含别名）
   - **Step 2** 按语义划分维度（描述性字段）vs 指标（需要聚合函数）
   - **Step 3** 补充有业务价值的派生指标（去重计数、条件计数、均值/最大值等）
   - **Step 4** 非 JPA 实体的指标字段必须加 `@Transient`
3. `@Dimension(sql=...)` 填 SQL 列名或别名，不是 Java 字段名
4. `@Measure(sql=...)` 填完整聚合表达式，如 `count(*)`、`sum(amount)`

---

## 领域六：TPL 嵌入交互页面（`erupt-tpl.md`）

**触发**：用户说"生成一个页面"、"给这个模型做个自定义视图"、"嵌入一个交互表格"、"用 TPL 展示数据"等。

**执行**：
1. 读取 `references/erupt-tpl.md`
2. 按四步流程：确认字段名 → 选触发方式 → 选 UI 框架 → 生成模板
3. 模板中 `{erupt}` 用类简名，字段键用 Java 字段名，token 从 URL `_token` 取
4. 默认使用 Element Plus（Vue 3），除非用户指定其他框架

---

## 领域五：REST API 对接（`erupt-api.md`）

**触发**：用户询问接口路径、请求参数、响应结构，或需要从外部系统/前端直接调用 Erupt 后端接口。

**执行**：
1. 读取 `references/erupt-api.md`
2. 给出完整的接口路径、HTTP 方法、请求体结构和响应体结构
3. 说明鉴权方式（Token 放 Header 或 Query Param）
4. **反射约束**：路径中的 `{erupt}` = Java 类名，`{field}` = Java 字段名；请求体 JSON key、`condition[].key`、`sort[].prop` 同为 Java 字段名，不是数据库列名或显示标题，关联对象用 `dept.id` 点分隔形式
5. **Token 必传**：除登录、验证码、版本号三个接口外，所有接口均需携带 Token；具体 Erupt 模型的操作权限还取决于用户是否为超管，或是否通过菜单管理分配了对应权限

---

## 通用原则

- **注解优先**：Erupt 的核心理念是注解驱动，优先用注解，不扩展到无关 API 或框架细节
- **完整准确**：给出可直接复制使用的完整代码，枚举值/参数名以文档为准
- **不过度设计**：只做用户要求的事，不额外添加未要求的字段、功能或注释