# 前端规则

## 适用范围

Vue3、Vite、Pinia、路由、API 请求、页面状态、按钮权限、看板和表单。

## JeecgBoot 前端约束

1. 路径别名优先使用 `/@/`，不要随意引入新的 alias。
2. API 请求必须复用项目请求层 `defHttp`，不要在页面中直接创建独立 axios 实例。
3. 用户、权限、动态路由相关状态优先查 Pinia store。
4. 新增页面必须考虑 loading、empty、error、forbidden 状态。
5. 按钮权限不能作为安全边界，必须同步检查后端接口权限。
6. 字典字段优先复用项目已有字典组件或工具，不在页面硬编码中文枚举。
7. 表单提交必须考虑防重复提交、接口失败和参数校验反馈。

## 输出验收

| 检查项 | 通过标准 |
| --- | --- |
| API 层 | 页面没有绕过 `defHttp` |
| 权限 | 页面按钮和后端接口都被检查 |
| 状态 | loading、empty、error、forbidden 齐全 |
| 字典 | 状态、优先级、类型不硬编码 |
| 验证 | 给出浏览器或接口验收动作 |