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

オープン 初心者向け
  • 何か問題がありますか？
#490 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
74/100
issue の種類
リファクタリング
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
go
領域
backend

調査の方向性

作業対象は internal/httpapi/insights.go の validateInsightExecution 内で、ここでは usage ごとのループが provider/model のチェック、重複排除、Token/コストのチェックを混在させています。まずそのループを読み、次に Token とコストのチェックをパッケージレベルの validateInsightUsageAmounts(u domain.InsightUsage) string に移動してください。メッセージとチェック順は変更しないでください。完了条件は、TestInsightsValidationAndHTTP が引き続き通り、新しいテーブル駆動テストが有効な境界値と各エラーブランチを網羅し、gofmt、go vet ./internal/httpapi/、go test ./internal/httpapi/ がクリーンであることです。

索引モデルが issue の本文から書いたものです。

説明

现状问题

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/。
主要言語
Go
スター
141
フォーク
28
平均マージ
1日 15時間
マージ済み PR（30日）
113

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

Tencent/LoopForge のほかの issue

Tencent/LoopForge の issue をすべて見る

似ている issue

Go の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。