common_agent/前端实现文档/1.系统基础模块前端实现.md

系统基础模块前端实现

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 等页面复用枚举字典。
• 运行观测页面复用统一状态颜色和错误提示格式。