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

Aberta Para iniciantes
#490 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
74/100
Tipo de issue
Refatoração
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
go
Domínio
backend

Direção de pesquisa

O trabalho está em internal/httpapi/insights.go, dentro de validateInsightExecution, onde o loop por usage mistura verificações de provider/model, deduplicação e verificações de Token/custo. Comece lendo esse loop e depois mova as verificações de Token e custo para uma função no nível do pacote validateInsightUsageAmounts(u domain.InsightUsage) string, mantendo as mensagens e a ordem das verificações inalteradas. Concluído quando TestInsightsValidationAndHTTP ainda passar, um novo teste table-driven cobrir valores de limite válidos e cada ramo de erro, e gofmt, go vet ./internal/httpapi/ e go test ./internal/httpapi/ estiverem limpos.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

现状问题

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/。
Linguagem predominante
Go
Estrelas
141
Forks
28
Merge médio
1d 15h
PRs com merge (30d)
113

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de Tencent/LoopForge

Todas as issues de Tencent/LoopForge

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.