feat: 实现统一模型 ID 机制
实现统一模型 ID 格式 (provider_id/model_name),支持跨协议模型标识和 Smart Passthrough。 核心变更: - 新增 pkg/modelid 包:解析、格式化、校验统一模型 ID - 数据库迁移:models 表使用 UUID 主键 + UNIQUE(provider_id, model_name) 约束 - Repository 层:FindByProviderAndModelName、ListEnabled 方法 - Service 层:联合唯一校验、provider ID 字符集校验 - Conversion 层:ExtractModelName、RewriteRequestModelName/RewriteResponseModelName 方法 - Handler 层:统一模型 ID 路由、Smart Passthrough、Models API 本地聚合 - 新增 error-responses、unified-model-id 规范 测试覆盖: - 单元测试:modelid、conversion、handler、service、repository - 集成测试:统一模型 ID 路由、Smart Passthrough 保真性、跨协议转换 - 迁移测试:UUID 主键、UNIQUE 约束、级联删除 OpenSpec: - 归档 unified-model-id 变更到 archive/2026-04-21-unified-model-id - 同步 11 个 delta specs 到 main specs - 新增 error-responses、unified-model-id 规范文件
This commit is contained in:
@@ -29,7 +29,44 @@
|
||||
- **THEN** 网关 SHALL 返回错误,状态码为 400 (Bad Request)
|
||||
- **THEN** 错误 SHALL 指示缺少哪些字段
|
||||
|
||||
**变更说明:** handler 通过 ProviderService 调用,数据访问通过 ProviderRepository。API 接口保持不变。
|
||||
#### Scenario: 创建供应商时 ID 包含非法字符
|
||||
|
||||
- **WHEN** 向 `/api/providers` 发送 POST 请求,id 包含非 `[a-zA-Z0-9_]` 字符
|
||||
- **THEN** 网关 SHALL 返回错误,状态码为 400 (Bad Request)
|
||||
- **THEN** 错误 SHALL 指示 id 仅允许字母、数字、下划线
|
||||
|
||||
#### Scenario: 创建供应商时 ID 过长
|
||||
|
||||
- **WHEN** 向 `/api/providers` 发送 POST 请求,id 长度超过 64
|
||||
- **THEN** 网关 SHALL 返回错误,状态码为 400 (Bad Request)
|
||||
|
||||
### Requirement: 供应商 ID 不允许修改
|
||||
|
||||
供应商 ID 是主键,用于构建统一模型 ID,不允许修改。
|
||||
|
||||
#### Scenario: 尝试修改供应商 ID
|
||||
|
||||
- **WHEN** 向 `/api/providers/:id` 发送 PUT 请求,请求体中包含 `id` 字段
|
||||
- **THEN** ProviderService.Update SHALL 在 service 层校验并返回错误
|
||||
- **THEN** 网关 SHALL 返回错误,状态码为 400 (Bad Request)
|
||||
- **THEN** 错误 SHALL 指示供应商 ID 不允许修改
|
||||
- **THEN** 错误格式 SHALL 为:
|
||||
```json
|
||||
{
|
||||
"error": "供应商 ID 不允许修改",
|
||||
"code": "IMMUTABLE_FIELD"
|
||||
}
|
||||
```
|
||||
|
||||
**校验位置:** Service 层(`ProviderService.Update`)
|
||||
- Service 层校验保证所有调用方(handler、CLI、未来 API)统一遵守
|
||||
- Handler 层负责捕获 `ErrImmutableField` 并转换为 HTTP 400 响应
|
||||
|
||||
**原因:**
|
||||
- 供应商 ID 是主键,用于构建统一模型 ID(provider_id/model_name)
|
||||
- 修改 ID 会导致所有统一模型 ID 失效
|
||||
- 客户端缓存的模型 ID 全部失效
|
||||
- 如需修改,应创建新供应商并迁移模型
|
||||
|
||||
### Requirement: 列出所有供应商
|
||||
|
||||
|
||||
Reference in New Issue
Block a user