# 開発ドキュメント横断Q&A — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | IT・開発 |
| ユースケース | 開発ドキュメント横断Q&A |
| WFパターン | `` |
| RAG | あり |
| 検証結果 | E2E pass |
| デモURL例 | http://localhost/workflow/Am8GdZVvhsMQ7swo |

## 概要

開発ドキュメント横断Q&A: 要件定義書・設計書・テスト仕様書・API仕様書等をナレッジベースとして検索し、該当箇所を引用して回答を生成します。回答には必ず参照元の文書名とセクション番号を含め、該当箇所が無ければその旨を明示します。

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「開発ドキュメント横断Q&A」の「デモ生成」ボタンをクリック
3. 業種「IT・開発」、UC「開発ドキュメント横断Q&A」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを顧客に共有

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

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

### 同梱ドキュメント

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

- `テスト仕様書_認証テスト.txt`
- `基本設計書_ユーザー管理.txt`

### デプロイ手順

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

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

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


## テスト入力例

### 入力例1
```
ユーザー登録APIのリクエストパラメータとバリデーションルールを教えてください
```

### 入力例2
```
ログイン失敗時のアカウントロック仕様はどうなっていますか？何回失敗でロックされますか？
```


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

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

## AI品質評価コメント

出力は意味のある日本語テキストであり、ユーザー登録APIに関する具体的なリクエストパラメータ（email, password, name, company）と詳細なバリデーションルールを明示しているため（要件4）、ユースケース（開発ドキュメント横断Q&A）に直接関連した内容を含んでいる（要件2）。参照元文書名とセクション番号（基本設計書_ユーザー管理.txt, セクション3.1.2/3.1.1）を明記し、原文抜粋やレスポンス／エラーコードの記載、注意事項も含めており、顧客デモとしての最低限の品質を満たしている（要件3）。汎用テンプレートのみで構成されておらず、入力に固有の情報を反映しているため（要件5）合格と判断します。

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

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