レポートのスキーマとバージョン管理

トップレベルの結果

• URL またはターゲットと完了日。
• セキュリティ スコア、グレード、合計ペナルティ、および除外の詳細（利用可能な場合）。
• Engine_version、ruleset_version、scoring_version。
• 選択したモジュール、カバレッジ、エラー、およびサーフェスが提供する場合のメトリクス。
• 検出された問題の配列。

問題のあるフィールドが検出されました

• rules_id とフィンガープリント。
• 重大度、分類、信頼度。
• モジュール、タイトル、詳細、証拠、推奨事項。
• マッピングが使用可能な場合のソースの場所。
• 正規化された結果モデルによって付加されたエンジンとルールセットのバージョン。

最小のJSON形状

1{
2  "url": "project",
3  "date": "2026-07-16T10:00:00.000Z",
4  "score": 92,
5  "grade": "A",
6  "engine_version": "3.x",
7  "ruleset_version": "2026.x",
8  "scoring_version": "3.x",
9  "findings": []
10}

バージョンを個別に追跡する

• エンジンのバージョンは、チェックを実行した VICE 実装を識別します。
• ルールセットのバージョンは、検出ポリシーとルールの動作を識別します。
• スコアリング バージョンにより、ペナルティ、除外、採点動作が識別されます。
• CLI パッケージのバージョンは、インストールされている vice-security リリースを識別します。
• GitHub Action バージョンは、ワークフローで使用されるパブリック アクション リリースを識別します。

コンテキストと比較する

ルールセットまたはスコア更新後のセキュリティ スコア デルタは、アプリケーションの変更ではなく、より適切な検出を反映している可能性があります。保存されたすべての結果の横に、バージョン、選択したモジュール、baseline、およびカバレッジのメタデータを保持します。