实现统一模型 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 规范文件
175 lines
3.7 KiB
Go
175 lines
3.7 KiB
Go
package handler
|
|
|
|
import (
|
|
"errors"
|
|
"net/http"
|
|
|
|
"github.com/gin-gonic/gin"
|
|
"gorm.io/gorm"
|
|
|
|
appErrors "nex/backend/pkg/errors"
|
|
|
|
"nex/backend/internal/domain"
|
|
"nex/backend/internal/service"
|
|
)
|
|
|
|
// ProviderHandler 供应商管理处理器
|
|
type ProviderHandler struct {
|
|
providerService service.ProviderService
|
|
}
|
|
|
|
// NewProviderHandler 创建供应商处理器
|
|
func NewProviderHandler(providerService service.ProviderService) *ProviderHandler {
|
|
return &ProviderHandler{providerService: providerService}
|
|
}
|
|
|
|
// CreateProvider 创建供应商
|
|
func (h *ProviderHandler) CreateProvider(c *gin.Context) {
|
|
var req struct {
|
|
ID string `json:"id" binding:"required"`
|
|
Name string `json:"name" binding:"required"`
|
|
APIKey string `json:"api_key" binding:"required"`
|
|
BaseURL string `json:"base_url" binding:"required"`
|
|
Protocol string `json:"protocol"`
|
|
}
|
|
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{
|
|
"error": "缺少必需字段: id, name, api_key, base_url",
|
|
})
|
|
return
|
|
}
|
|
|
|
protocol := req.Protocol
|
|
if protocol == "" {
|
|
protocol = "openai"
|
|
}
|
|
|
|
provider := &domain.Provider{
|
|
ID: req.ID,
|
|
Name: req.Name,
|
|
APIKey: req.APIKey,
|
|
BaseURL: req.BaseURL,
|
|
Protocol: protocol,
|
|
}
|
|
|
|
err := h.providerService.Create(provider)
|
|
if err != nil {
|
|
if err == appErrors.ErrInvalidProviderID {
|
|
c.JSON(http.StatusBadRequest, gin.H{
|
|
"error": appErrors.ErrInvalidProviderID.Message,
|
|
"code": appErrors.ErrInvalidProviderID.Code,
|
|
})
|
|
return
|
|
}
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
provider.MaskAPIKey()
|
|
c.JSON(http.StatusCreated, provider)
|
|
}
|
|
|
|
// ListProviders 列出所有供应商
|
|
func (h *ProviderHandler) ListProviders(c *gin.Context) {
|
|
providers, err := h.providerService.List()
|
|
if err != nil {
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
c.JSON(http.StatusOK, providers)
|
|
}
|
|
|
|
// GetProvider 获取供应商
|
|
func (h *ProviderHandler) GetProvider(c *gin.Context) {
|
|
id := c.Param("id")
|
|
|
|
provider, err := h.providerService.Get(id, true)
|
|
if err != nil {
|
|
if err == gorm.ErrRecordNotFound {
|
|
c.JSON(http.StatusNotFound, gin.H{
|
|
"error": "供应商未找到",
|
|
})
|
|
return
|
|
}
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
c.JSON(http.StatusOK, provider)
|
|
}
|
|
|
|
// UpdateProvider 更新供应商
|
|
func (h *ProviderHandler) UpdateProvider(c *gin.Context) {
|
|
id := c.Param("id")
|
|
|
|
var req map[string]interface{}
|
|
if err := c.ShouldBindJSON(&req); err != nil {
|
|
c.JSON(http.StatusBadRequest, gin.H{
|
|
"error": "无效的请求格式",
|
|
})
|
|
return
|
|
}
|
|
|
|
err := h.providerService.Update(id, req)
|
|
if err != nil {
|
|
if err == gorm.ErrRecordNotFound {
|
|
c.JSON(http.StatusNotFound, gin.H{
|
|
"error": "供应商未找到",
|
|
})
|
|
return
|
|
}
|
|
if errors.Is(err, appErrors.ErrImmutableField) {
|
|
c.JSON(http.StatusBadRequest, gin.H{
|
|
"error": appErrors.ErrImmutableField.Message,
|
|
"code": appErrors.ErrImmutableField.Code,
|
|
})
|
|
return
|
|
}
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
provider, err := h.providerService.Get(id, true)
|
|
if err != nil {
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
c.JSON(http.StatusOK, provider)
|
|
}
|
|
|
|
// DeleteProvider 删除供应商
|
|
func (h *ProviderHandler) DeleteProvider(c *gin.Context) {
|
|
id := c.Param("id")
|
|
|
|
err := h.providerService.Delete(id)
|
|
if err != nil {
|
|
if err == gorm.ErrRecordNotFound {
|
|
c.JSON(http.StatusNotFound, gin.H{
|
|
"error": "供应商未找到",
|
|
})
|
|
return
|
|
}
|
|
writeError(c, err)
|
|
return
|
|
}
|
|
|
|
c.Status(http.StatusNoContent)
|
|
}
|
|
|
|
// writeError 统一错误响应处理
|
|
func writeError(c *gin.Context, err error) {
|
|
if appErr, ok := appErrors.AsAppError(err); ok {
|
|
c.JSON(appErr.HTTPStatus, gin.H{
|
|
"error": appErr.Message,
|
|
"code": appErr.Code,
|
|
})
|
|
return
|
|
}
|
|
c.JSON(http.StatusInternalServerError, gin.H{
|
|
"error": err.Error(),
|
|
})
|
|
}
|