GUI ガイド
aaai-gui を起動します。
aaai-gui
1. Opening 画面（プロジェクト選択）
起動後に最初に表示される画面です。
| フィールド | 説明 |
|---|---|
| 比較元フォルダ | 変更前のフォルダパス（Before） |
| 比較先フォルダ | 変更後のフォルダパス（After） |
| 監査定義ファイル | audit.yaml のパス。空欄にすると空の定義で開始 |
| .aaaiignore file | 除外パターンファイルのパス。省略時は Before/.aaaiignore を自動検索 |
プロファイル機能 — よく使う設定の組み合わせをプロファイルとして保存できます。
- 4つのフィールドを入力する
- プロファイル名を入力して「現在の設定をプロファイルとして保存」をクリック
- 次回以降は保存済みプロファイルを「読み込む」ボタンで一発展開
「監査を開始」ボタンを押すと、バックグラウンドスレッドでフォルダ比較を実行します（大規模フォルダでも GUI は応答を維持します）。
2. メイン画面（3 ペイン）
2-1. ダッシュボード
ファイルを選択する前に表示されます。
- 結果バナー — PASSED（緑）または FAILED（赤）を大きく表示
- サマリーカード — OK / Pending / Failed / Error / Ignored の件数
- 要注意リスト — Failed / Pending / Error のエントリを最大 8 件表示
2-2. ファイルツリー（左ペイン）
変更のあった全ファイルを一覧表示します。
| バッジ | 意味 |
|---|---|
+ 緑 | Added — 追加されたファイル |
- 赤 | Removed — 削除されたファイル |
~ 黄 | Modified — 変更されたファイル |
! 赤 | Unreadable — 読み取れないファイル |
⚠N 黄枠 | N 件の advisory 警告あり |
フィルターバー — 「変更のみ」「すべて」「未承認」「失敗・エラー」で絞り込めます。
検索バー — パス名でインクリメンタルフィルターをかけられます。
バッチ選択 — 各行のチェックボックスで複数選択し、「Batch Approve」ボタンで共通理由を入力して一括承認できます。
2-3. 差分ビューア（中央ペイン）
ファイルを選択すると左右並列の差分を表示します。
- 追加行 — 緑の背景
- 削除行 — 赤の背景
- 行番号 — 左端に表示
- 統計バー — ヘッダー下に
+N lines/−N linesとサイズ変化を表示 - バイナリファイル — SHA-256・サイズ・一致/不一致を専用パネルで表示
2-4. インスペクター（右ペイン）
選択したファイルの審査・承認を行います。
ヘッダー
- パス・差分種別・ステータスバッジを表示
AuditWarningがある場合は黄色の警告ブロックを表示
入力フィールド
| フィールド | 必須 | 説明 |
|---|---|---|
| 理由 | ✅ | この変更を許容する根拠（必須・空欄だと承認不可） |
| チケット | — | JIRA-123 などのイシュー番号 |
| 承認者 | — | 承認者の名前または ID |
| 有効期限 | — | YYYY-MM-DD 形式。期限を設けたい場合に設定 |
| 内容監査方式 | — | None / Checksum / LineMatch / Regex / Exact から選択 |
| テンプレートを適用 | — | 定型パターンをワンクリックで設定 |
| メモ | — | 補足情報（判定に影響しない） |
「承認して適用」ボタンで承認します。承認後は「保存」ボタンで定義ファイルに書き込みます。
3. キーボードショートカット
| ショートカット | 動作 |
|---|---|
Ctrl+S | 定義ファイルを保存 |
Ctrl+R | 監査を再実行 |
Ctrl+Z | 最後の承認を取り消し（Undo） |
↑ / ↓ | ファイルツリーで前/次のエントリに移動 |
4. フッター
| 要素 | 説明 |
|---|---|
● 未保存の変更があります | 保存されていない承認がある場合に表示 |
| ショートカット凡例 | Main 画面のみ。上記キーボードショートカットを常時表示 |
| 言語ピッカー | 日本語 / English を切り替え |
| バージョン番号 | アプリのバージョン |
5. レポート出力
ツールバーの Export MD / Export JSON ボタンでレポートを出力できます。
出力先: カレントディレクトリの aaai-report.md / aaai-report.json
6. 典型的なワークフロー
1. aaai-gui を起動
2. Before / After / 定義ファイルを指定して「監査を開始」
3. ダッシュボードで全体状況を把握
4. Pending エントリをファイルツリーで選択
5. 差分ビューアで変更内容を確認
6. インスペクターで理由・戦略を入力して「承認して適用」
7. Ctrl+S で保存
8. Ctrl+R で再実行して全 OK を確認
9. Export MD でレポートを出力