# REST API仕様書(OpenAPI)生成 — 運用ガイド

## 基本情報

| 項目 | 内容 |
|------|------|
| 業種 | IT・開発 |
| ユースケース | REST API仕様書(OpenAPI)生成 |
| WFパターン | `start → llm(OpenAPI YAML生成) → template(仕様書整形) → end` |
| RAG | なし |
| 検証結果 | E2E pass |
| デモURL例 | http://localhost/workflow/nkhNQhxh10SoFZUm |

## 概要

エンドポイントの日本語説明・リソース名・主要操作を入力として、OpenAPI 3.0形式のYAMLドラフトとAPIデザインガイドラインへの準拠チェックを生成する。

## デモ手順

1. DDF Web UI (`/dashboard`) を開く
2. 「REST API仕様書(OpenAPI)生成」の「デモ生成」ボタンをクリック
3. 業種「IT・開発」、UC「REST API仕様書(OpenAPI)生成」が自動入力される
4. 「デモ生成開始」をクリック
5. 生成完了後、デモURLを顧客に共有


## テスト入力例

### 入力例1
```
タスク管理API。リソース: プロジェクト(project)、タスク(task)、コメント(comment)。
操作:
- プロジェクト: 一覧取得（ページネーション）、作成、更新、論理削除
- タスク: プロジェクト内一覧取得（ステータスフィルター）、作成、更新（ステータス変更含む）、担当者アサイン、論理削除
- コメント: タスク内一覧取得、追加、編集、削除
タスクのステータス遷移: todo → in_progress → review → done
認証: Bearer JWT。ロール: admin, member, viewer。
memberはタスクCRUD可能、viewerは参照
```


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

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

## AI品質評価コメント

検証済みYAMLから即時デプロイ

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

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