# コーディング規約引き — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | システム開発 |
| ユースケース | コーディング規約引き |
| WFパターン | `` |
| RAG | あり |
| 検証結果 | E2E pass |
| デモURL例 | https://dify.ddf-cloud.com/workflow/MJDgaoLbxGce6gEP |

## 概要

合格です。出力は意味のあるテキストであり（1）、設計差分レビュー（注文管理システムのAPI/認証/DB/Webhook等）というユースケースに直接関連した内容を含んでいます（2）。顧客デモとして十分な構成・詳細（変更点、影響範囲、後方互換性リスク、互換サポート案、移行手順と工数見積もり、参照資料）があり品質基準を満たしています（3）。旧版／新版のファイル名や具体的な変更（orderId→id、st

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「コーディング規約引き」の「デモ生成」ボタンをクリック
3. 業種「システム開発」、UC「コーディング規約引き」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを顧客に共有

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

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

### 同梱ドキュメント

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

- `Java: 戻り値のnull禁止と定数命名（Optional_空コレクション推奨）.txt`
- `Python: 可変デフォルト引数禁止と型ヒント（Mutable default _ Type hint）.txt`
- `JavaScript_TypeScript: 非同期処理はasync_await＋try_catch、厳密等価を使用.txt`

### デプロイ手順

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

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

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


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

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

## AI品質評価コメント

出力は空やエラーではなく具体的な日本語テキストが含まれており（1）、ユースケースのテーマである『コーディング規約／社内スタイルガイド／レビュー指摘事例』に直接関連する内容（Spring Boot の Controller/Service/Repository、命名規則、null禁止、例外処理、ログ、トランザクション等）を網羅している（2）。顧客デモに耐える詳細度と具体例（NG/OK の短いコード例、レビューコメント例、参照ファイル名）があり最低限の品質を満たしている（3）。入力クエリ固有の要素（Spring Boot マイクロサービス、各層の責務、@Transactional、MDC、Optional/空コレクション等）に明確に言及している（4）。また、汎用テンプレのみではなく具体的ルールと修正例が含まれているためテンプレート依存ではない（5）。よって合格です。

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

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