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:
@@ -28,9 +28,10 @@
|
||||
#### Scenario: 初始迁移文件
|
||||
|
||||
- **WHEN** 创建初始迁移
|
||||
- **THEN** SHALL 创建 001_initial_schema.sql
|
||||
- **THEN** SHALL 创建单个初始迁移文件(如 `20260421000001_initial_schema.sql`)
|
||||
- **THEN** SHALL 包含 providers、models、usage_stats 表的创建语句
|
||||
- **THEN** SHALL 包含外键约束
|
||||
- **THEN** SHALL 包含索引创建语句
|
||||
|
||||
#### Scenario: Up 迁移
|
||||
|
||||
@@ -42,25 +43,19 @@
|
||||
#### Scenario: Down 迁移
|
||||
|
||||
- **WHEN** 执行 down 迁移
|
||||
- **THEN** SHALL 删除所有表
|
||||
- **THEN** SHALL 删除所有表和索引
|
||||
- **THEN** SHALL 按正确顺序删除(避免外键约束错误)
|
||||
|
||||
### Requirement: 添加索引迁移
|
||||
### Requirement: models 表 schema 变更
|
||||
|
||||
系统 SHALL 创建索引迁移。
|
||||
系统 SHALL 在初始迁移脚本中直接创建新的 models 表结构(服务未上线,无需考虑数据迁移,迁移脚本已合并为单个初始迁移文件)。
|
||||
|
||||
#### Scenario: 索引迁移文件
|
||||
#### Scenario: 初始迁移 models 表结构
|
||||
|
||||
- **WHEN** 创建索引迁移
|
||||
- **THEN** SHALL 创建 002_add_indexes.sql
|
||||
- **THEN** SHALL 为常用查询字段添加索引
|
||||
|
||||
#### Scenario: 索引定义
|
||||
|
||||
- **WHEN** 添加索引
|
||||
- **THEN** SHALL 为 models(provider_id) 添加索引
|
||||
- **THEN** SHALL 为 models(model_name) 添加索引
|
||||
- **THEN** SHALL 为 usage_stats(provider_id, model_name, date) 添加复合索引
|
||||
- **WHEN** 执行迁移
|
||||
- **THEN** SHALL CREATE models 表,包含字段:id(TEXT PRIMARY KEY,存储 UUID 字符串)、provider_id(TEXT NOT NULL)、model_name(TEXT NOT NULL)、enabled(INTEGER DEFAULT 1)、created_at(DATETIME)
|
||||
- **THEN** SHALL 存在 UNIQUE(provider_id, model_name) 约束
|
||||
- **THEN** SHALL 存在 FOREIGN KEY (provider_id) REFERENCES providers(id) ON DELETE CASCADE
|
||||
|
||||
### Requirement: 迁移命令集成
|
||||
|
||||
|
||||
Reference in New Issue
Block a user