# Product Specification — Sakaen

## 1. プロダクト・ポジショニング

Sakaenは、「日本酒に特化した、AIパーソナル・コンシェルジュ・アプリ」として位置付ける。Webアプリ（PWA）から始め、iOS / Android ネイティブアプリ、LINEミニアプリへと展開する。

### 1.1 プロダクト・ストーリー

「あなたが好きな〆張鶴の系統に近い、新潟の純米吟醸を10種以上揃えています。さらに、本日は冷蔵保管中の生酛純米『天明』が入荷したばかり。日本橋から徒歩7分、カウンター8席のみの隠れ家『月の雫』をおすすめします。」

これが、Sakaenが提供するユーザー体験である。点数や口コミの羅列ではなく、「なぜあなたに合うのか」を一人称で語りかけるAIコンシェルジュ。それが Sakaen の本質である。

## 2. ユーザーフロー（Happy Path）

### 2.1 初回利用

1. **オンボーディング** — LINE連携 or メアド登録（30秒）
2. **酒縁プロファイル初期登録**（任意・後でも可、3分）
   - 好きな銘柄を3つ入力（オプション、未入力でもOK）
   - 好きな日本酒の系統（純米吟醸／純米酒／大吟醸／生酛・山廃／にごり／古酒 のチェック）
   - 苦手な系統（同上）
   - 普段の予算帯（〜¥5,000 / 〜¥10,000 / 〜¥15,000 / それ以上）
3. **AIヒアリング**（3分・チャット形式）
   - 「今日のシーンを教えてください」（一人 / デート / 仕事仲間 / 接待 / 家族）
   - 「ご希望のエリアは？」（GPS自動取得 + 駅指定可）
   - 「今日の気分は？」（しっとり / わいわい / 静か / お祝い / 落ち込み・癒し）
   - 「合わせたい肴のイメージ」（魚介中心 / 肉系 / 季節野菜 / おまかせ）
   - 「予算（一人あたり）」
4. **AI厳選** — 3〜5店を順位付きで提示
5. **店舗詳細閲覧** — 「あなたに合う理由」全文 + メニュー・営業時間・予約状況
6. **予約** — Sakaen内で直接予約 or 提携OEM予約システム経由
7. **訪問後** — レビュー入力（任意・1分）→ 学習データに反映

### 2.2 リピート利用

- 過去の好みプロファイルを利用し、ヒアリング質問数を6→3に短縮
- 「前回行った『月の雫』、また同系統で別の店を見たい」のような会話継続が可能
- 通知で「今夜の気分はどんな感じ？」と Push 提案（任意）

## 3. 主要機能

### 3.1 AIヒアリング・エンジン

- LLM: GPT-4o / Claude 3.5 Sonnet を併用（A/Bテスト）
- システムプロンプトに「日本酒銘柄500種・系統データベース」を RAG 注入
- 6つの質問軸を、ユーザーの回答に応じて動的に深掘り
- 3分以内・最大10ターンで意思決定に到達

### 3.2 店舗マッチング・エンジン

- 全国数千件の店舗データベース（銘柄・温度管理・席数・予算・雰囲気タグ）
- ユーザープロファイル × ヒアリング結果 × 店舗特性 の3者マッチング
- ベクトル類似度（Sentence Embedding）と協調フィルタリングのハイブリッド
- 「あなたの好きな◯◯系統」というユーザー語彙で説明文を自動生成

### 3.3 「なぜ」言語化エンジン

- マッチング結果に対し、AIが「なぜこの店があなたに合うのか」を3〜5文で生成
- ユーザー過去発言（プロファイル + 過去レビュー）から固有名詞・好み語彙を抽出
- 出力例: 「あなたが◯◯と言っていた点、この店の××が合致します」

### 3.4 予約システム

- 自社直接予約（提携店向けに Sakaen Reserve SDK 提供）
- TableCheck / TORETA / OpenTable 等の連携API
- LINE通知での確認・リマインド

### 3.5 訪問後レビュー学習

- 訪問後3時間以内に Push: 「今日の『月の雫』、いかがでしたか？」
- 5段階評価 + 自由記述 + 「次もこの系統見たい？」の選択肢
- 入力したレビューはAIプロファイルに自動反映

### 3.6 酒縁プロファイル可視化

- マイページに「あなたの酒縁プロファイル」を可視化
- 好み傾向グラフ（純米吟醸 80%、純米酒 60%, ...）
- 訪問履歴・レビュー履歴
- 「酒縁ランク」（Bronze / Silver / Gold / Platinum）でゲーミフィケーション

## 4. システム・アーキテクチャ

### 4.1 技術スタック

- **フロントエンド**: Next.js 14 (App Router) + React Server Components + Tailwind CSS
- **バックエンド**: Hono (TypeScript) on Cloudflare Workers + Durable Objects
- **データベース**: PostgreSQL (Supabase) + Redis (Upstash) + Vector DB (Pinecone)
- **AI**: OpenAI API (GPT-4o), Anthropic API (Claude 3.5), Cohere Embed v3
- **モバイル**: React Native (Expo) for iOS/Android, LINE Front-end Framework (LIFF)
- **インフラ**: Cloudflare（CDN, Workers, R2）+ AWS（PostgreSQL backup）
- **観測**: Datadog + Sentry + PostHog

### 4.2 データフロー

```
[ユーザー] → [Next.js LIFF] → [Hono API] → [LLM Orchestrator]
                                      ↓
                              [Vector DB (店舗特徴)]
                              [PostgreSQL (ユーザープロファイル)]
                                      ↓
                              [Matching Engine]
                                      ↓
                              [LLM Reasoning (なぜ言語化)]
                                      ↓
                              [Reservation API]
                                      ↓
                              [LINE Notify]
```

### 4.3 セキュリティ・プライバシー

- 個人情報は AES-256 暗号化 + Supabase Vault管理
- 訪問履歴は ユーザー本人のみ閲覧可、店舗側には匿名化集計のみ提供
- GDPR/APPI準拠のデータ削除APIを提供
- 20歳未満アクセス制御（年齢認証 + IP遮断）

## 5. 主要画面構成

| 画面 | 機能 | KPI |
|---|---|---|
| ホーム | 酒縁診断スタート / 今週の人気店 | DAU, 診断開始率 |
| AIチャット | 6軸ヒアリング | 完了率, 所要時間 |
| 結果一覧 | 3〜5店レコメンド | クリック率, 予約遷移率 |
| 店舗詳細 | メニュー・予約・「合う理由」 | 予約完了率 |
| マイページ | 酒縁プロファイル / 履歴 | リテンション |

## 6. ローンチ機能（MVP / Phase 1）

- LINE連携ログイン
- 6軸AIヒアリング
- 東京・大阪・京都の名店200店マッチング
- 「なぜ」言語化
- Sakaen Reserve（自社予約）
- 訪問後レビュー
- 酒縁プロファイル可視化（簡易版）

## 7. Phase 2 機能

- 月額Premium導入（¥980、無制限・予約優先・高度ヒアリング）
- 全国主要10都市カバー
- iOS / Android ネイティブアプリ公開
- 店舗詳細の写真・動画追加
- ソーシャル機能（友人と「酒縁」を共有）

## 8. Phase 3 機能

- 47都道府県カバー
- 酒蔵タイアップ・蔵元体験ツアー予約
- B2Bダッシュボード（店舗向け管理画面）
- ECコラボ（おすすめボトル通販）
- 経費精算連携（freee / Money Forward）

## 9. パフォーマンス要件

- AIヒアリング応答時間: 中央値 1.5秒、95%ile 3.5秒
- レコメンド生成時間: 中央値 2.0秒、95%ile 5.0秒
- 月額稼働率: 99.95% 以上
- 同時接続: 5万 sessions（Year3 想定）

## 10. アクセシビリティ

- WCAG 2.1 AA 準拠
- 音声入力対応（モバイル）
- フォントサイズ可変（17〜24px）
- 色覚多様性対応カラーパレット