30 lines
1.0 KiB
Markdown
30 lines
1.0 KiB
Markdown
# 系统基础模块前端实现
|
|
|
|
## 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 等页面复用枚举字典。
|
|
- 运行观测页面复用统一状态颜色和错误提示格式。
|
|
|