【架构优化】从 validateInsightExecution 中拆出单条用量 Token/成本校验 validateInsightUsageAmounts

Abierto Apto para principiantes
#490 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
74/100
Tipo de issue
Refactorización
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
go
Área
backend

Línea de trabajo

El trabajo está en internal/httpapi/insights.go, dentro de validateInsightExecution, donde el bucle por uso mezcla comprobaciones de proveedor/modelo, deduplicación y comprobaciones de Token/coste. Empieza leyendo ese bucle y luego mueve las comprobaciones de Token y coste a una función a nivel de paquete validateInsightUsageAmounts(u domain.InsightUsage) string, manteniendo los mensajes y el orden de comprobación sin cambios. Está hecho cuando TestInsightsValidationAndHTTP siga pasando, una nueva prueba basada en tablas cubra valores límite válidos y cada rama de error, y gofmt, go vet ./internal/httpapi/ y go test ./internal/httpapi/ estén limpios.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

现状问题

internal/httpapi/insights.go 的 validateInsightExecution(圈复杂度 43)同时承担两层校验:执行汇总本身(类型、ID、状态、时间、时长、URL)和 usage 数组里每一项模型用量。单项用量的 Token 范围、缓存/推理包含关系、成本状态与金额校验约 20 行嵌在 for 循环里,和 provider/model 必填、去重混在一起,阅读和单独测试都不方便。

重构方案

  • 把循环体中 Token 与成本的校验抽成包级函数 validateInsightUsageAmounts(u domain.InsightUsage) string,错误文案与判断顺序保持原样。
  • validateInsightExecution 的循环只保留:provider/model 必填 → 同一 provider/model 去重 → 调用 validateInsightUsageAmounts,三者顺序与原实现完全一致,因此同时命中多条规则时返回的错误也不变。

影响范围

仅 internal/httpapi/insights.go 一个函数内部拆分 + 新增测试文件;/api/insights/v1/ingest 接口行为、错误文案、返回码均不变,无对外接口变化。

验证方式

  • 原有 TestInsightsValidationAndHTTP 全部通过;
  • 新增 validateInsightUsageAmounts 表驱动测试,覆盖合法输入(含边界值)与每一条错误分支;
  • gofmt、go vet ./internal/httpapi/、go test ./internal/httpapi/。
Lenguaje dominante
Go
Estrellas
141
Forks
28
Merge medio
1 d 15 h
PR fusionados (30 d)
113

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Tencent/LoopForge

Todos los issues de Tencent/LoopForge

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.