# 系统基础模块前端实现

## 1. 页面范围

系统基础前端能力主要体现为枚举字典、上传控件和统一请求处理。当前已有系统枚举管理页，后续 Studio 页面继续复用这些能力。

## 2. API 使用

| 能力 | 接口 |
|------|------|
| 枚举管理查询 | `POST /api/sys-enum/queryForManagement` |
| 枚举详情 | `GET /api/sys-enum/detail` |
| 枚举保存 | `POST /api/sys-enum/save` |
| 枚举删除 | `POST /api/sys-enum/delete` |
| 附件上传 | `POST /api/attachments/upload` |

## 3. 实现约定

- API 层继续使用 `frontend/src/api/request.ts` 解包 `RequestResult<T>`。
- Long ID 继续通过 `json-bigint` 安全解析。
- 枚举展示通过字典或本地常量映射，不直接依赖数据库展示顺序。
- 上传失败时展示后端错误摘要，不吞掉异常。

## 4. Studio 复用点

- 文件解析管道复用附件上传能力。
- 知识资产、模型路由、Workflow、Agent 等页面复用枚举字典。
- 运行观测页面复用统一状态颜色和错误提示格式。