# バグレポート解析・原因分析・修正案生成 — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | IT・開発 |
| ユースケース | バグレポート解析・原因分析・修正案生成 |
| WFパターン | `start → knowledge-retrieval(類似バグ検索) → llm(原因分析+修正案) → template(レポート整形) → end` |
| RAG | あり |
| 検証結果 | E2E pass |
| デモURL例 | http://localhost/workflow/7vyAMlhNDqeKnC88 |

## 概要

バグチケットを入力として、根本原因の特定・修正コード案・再発防止策を生成する。

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「バグレポート解析・原因分析・修正案生成」の「デモ生成」ボタンをクリック
3. 業種「IT・開発」、UC「バグレポート解析・原因分析・修正案生成」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを顧客に共有

## ナレッジベース（RAG）

このワークフローにはナレッジベースが必要です。

### 同梱ドキュメント

`knowledge/` フォルダに以下のテキストファイルが保存されています:

- `過去バグ事例DB_日付関連.txt`

### デプロイ手順

1. Dify管理画面 → ナレッジ → 新規作成
2. 上記テキストファイルをアップロード
3. インデキシング完了を待つ
4. WFのKRノードで作成したナレッジベースを選択

またはDDFパイプラインで自動セットアップ:
```
run_pipeline(knowledge_docs=[...])  # 自動でKB作成+ID注入
```

**顧客デモ時は、顧客の実ドキュメントに差し替えるとインパクトが大きくなります。**


## テスト入力例

### 入力例1
```
バグ: 月末（31日）の深夜バッチが失敗する。頻度: 月1回（31日がある月のみ）。
エラー: ValueError: day is out of range for month
スタックトレース: billing/scheduler.py line 234: next_date = current_date.replace(day=current_date.day+1)
再現手順: 1月31日にバッチ実行→2月31日を生成しようとしてエラー
期待動作: 翌月1日に正しく遷移すること
```


## 顧客への説明ポイント

- 「これは自動生成されたプロトタイプです。本番利用には追加の設計・開発が必要です」
- 「御社の実データ/ドキュメントを使えば、さらに精度の高いデモをお見せできます」
- 「Self-hostedなので、御社のデータは外部に出ません」

## AI品質評価コメント

出力は、ユースケース要件であるバグ原因分析・修正案生成を完全に満たしています。具体的なバグチケットの内容（製品名、症状、エラーログ、スタックトレース）を正確に捉え、以下の要素を網羅した高品質な技術レポートとして生成されています：
1. 5 Whys分析による根本原因の特定
2. 具体的な修正コード案（差分表示付き）と理由、追加テストケースの例
3. 影響範囲の推定（ビジネス、顧客、運用、データ整合性への影響と関連モジュール/サービス）
4. コード、テスト、プロセスの各観点からの詳細な再発防止策
5. 類似バグが起きやすい箇所とその検出手法

内容は非常に詳細かつ専門的で、汎用的なテンプレートに留まらず、入力されたバグ情報に深く踏み込んだ具体的な分析と提案がなされており、顧客デモとして十分な品質があります。

## 次のステップ（受託提案）

1. 顧客の実データでカスタマイズデモ（POC: 5-10万円）
2. 本番環境設計・構築（受託開発）
3. 既存システム（kintone/Salesforce等）とのAPI連携
4. 運用保守サポート