report-generation

レポートの生成

レポートファイル

デフォルトの出力先：プロジェクトルートの DOCUMENT-ACCESSIBILITY-AUDIT.md。

必須セクション

すべての監査レポートには、以下のセクションを含める必要があります。

1. 監査情報 - 日付、監査担当者、プロファイル、対象範囲、件数
2. エグゼクティブサマリー - 合計、合格率、最も一般的な問題、作業量の見積もり
3. ドキュメント横断のパターン - 繰り返し発生する問題、システム上の不具合
4. ファイル別の検出結果 - ドキュメントごとの問題と、ルール ID、重大度、場所、WCAG、影響、修正方法
5. ルール別の検出結果（相互参照） - ファイル横断で集計したルールレベルの結果
6. 合格した項目 - 問題のないドキュメントやカテゴリを明示
7. 修正の優先順位 - 影響度順（直ちに／早めに／可能なときに）
8. アクセシビリティスコアカード - ドキュメントごとのスコアと評価
9. メタデータダッシュボード - ドキュメントのプロパティの状態
10. 信頼度の概要 - 信頼度レベル別の内訳

任意のセクション（該当する場合に記載）

• テンプレート分析 - 一括スキャンで共通のテンプレートが検出された場合
• 比較レポート - ベースラインと照合して再スキャンする場合
• CI/CD の推奨事項 - 設定ファイルが存在しない場合

重大度スコアの計算式

Document Score = 100 - (sum of weighted findings)

Weights:
  Error (high confidence):   -10 points
  Error (medium confidence):  -7 points
  Error (low confidence):     -3 points
  Warning (high confidence):  -3 points
  Warning (medium confidence):-2 points
  Warning (low confidence):   -1 point
  Tips:                        0 points

Floor: 0 (minimum score)

スコアの評価

スコア	評価	意味
90-100	A	優秀 - 問題が軽微、または問題なし
75-89	B	良好 - 警告がいくつかあり、エラーは少数
50-74	C	要改善 - 複数のエラーあり
25-49	D	不良 - アクセシビリティに重大な障壁あり
0-24	F	不合格 - 致命的な障壁があり、支援技術では利用できない可能性が高い

整理モード

モード	説明	最適な用途
ファイル別	各ドキュメントの下にすべての問題をまとめる	小規模な一括処理（10 ファイル未満）
問題の種類別	各ルールのすべての該当箇所をドキュメント横断でまとめる	パターンの把握
重大度別	重大、深刻、中程度、軽微の順に並べる	修正の優先順位付け

VPAT/ACR 準拠状況のエクスポート

適合レベル

レベル	基準
準拠	どのドキュメントにも、この WCAG 基準に関する検出結果がない
部分準拠	合格するドキュメントと不合格のドキュメントがある
非準拠	すべて、または大半のドキュメントが不合格
該当なし	スキャン対象のドキュメント形式には、この基準が適用されない

対応する VPAT エディション

• VPAT 2.5 (WCAG) - WCAG 2.2 の基準に対応
• VPAT 2.5 (508) - 改訂版 Section 508 基準に対応
• VPAT 2.5 (EN 301 549) - EU のアクセシビリティ指令に対応
• VPAT 2.5 (INT) - 国際版（上記 3 種すべてを統合）

修正状況の追跡

ベースラインの監査レポートと比較する場合：

ステータス	意味
修正済み	前回のレポートにあった問題が解決済み
新規	前回のレポートにはなかった問題が今回発生
継続中	前回から問題が残っている
再発	以前修正された問題が再発

進捗指標

• 問題の減少率：(fixed / previous_total) * 100
• スコアの変化：current_score - previous_score
• 改善したドキュメント：スコアが上がったドキュメントの数