1
0

feat: 前端适配后端新接口

适配后端统一模型 ID、协议字段、UUID 自动生成和结构化错误响应:

- 类型定义:Provider 新增 protocol 字段,Model 新增 unifiedId,CreateModelInput 移除 id
- API 客户端:提取结构化错误响应中的错误码
- 供应商管理:添加协议选择下拉框和表格列
- 模型管理:移除 ID 输入,显示统一模型 ID(只读)
- Hooks:错误码映射为友好中文消息
- 测试:所有组件测试通过,mock 数据适配新字段
- 文档:更新 README 说明协议字段和统一模型 ID
This commit is contained in:
2026-04-21 20:49:37 +08:00
parent 24f03595a7
commit feff97acbd
28 changed files with 547 additions and 78 deletions

View File

@@ -4,6 +4,28 @@
管理模型的增删改查,通过 handler → service → repository 分层实现业务逻辑和数据访问,支持供应商关联验证。
### Requirement: 前端适配统一模型 ID 显示
前端 SHALL 在模型管理界面显示统一模型 ID。
#### Scenario: 模型列表返回统一 ID
- **WHEN** 向 `/api/models` 发送 GET 请求
- **THEN** 每个模型 SHALL 包含 unified_id 字段
- **THEN** unified_id 格式 SHALL 为 `{provider_id}/{model_name}`
#### Scenario: 创建模型返回统一 ID
- **WHEN** 向 `/api/models` 发送 POST 请求创建模型
- **THEN** 返回的模型 SHALL 包含 unified_id 字段
- **THEN** unified_id SHALL 由后端根据 provider_id 和 model_name 生成
#### Scenario: 更新模型返回统一 ID
- **WHEN** 向 `/api/models/:id` 发送 PUT 请求更新模型
- **THEN** 返回的模型 SHALL 包含更新后的 unified_id
- **THEN** unified_id SHALL 反映最新的 provider_id 和 model_name 组合
### Requirement: 创建模型配置
网关 SHALL 允许为供应商创建新的模型配置。
@@ -16,6 +38,7 @@
- **THEN** 网关 SHALL 返回创建的模型,状态码为 201
- **THEN** 模型 SHALL 默认启用
- **THEN** 返回的模型 SHALL 包含 `unified_id` 字段,值为 `{provider_id}/{model_name}`
- **THEN** 前端 SHALL NOT 在请求体中发送 id 字段
#### Scenario: 使用不存在的供应商创建模型