407 lines
12 KiB
Markdown
407 lines
12 KiB
Markdown
# 「あわせて飲みたい」機能拡張計画
|
||
|
||
**作成日**: 2026-01-22
|
||
**ステータス**: Phase 2.0（リリース後1ヶ月）で実装予定
|
||
|
||
---
|
||
|
||
## 📊 現状分析
|
||
|
||
### 実装済み機能
|
||
✅ **ローカルレコメンドエンジン**:
|
||
- 五味チャートのコサイン類似度計算
|
||
- 酒蔵・都道府県・タグによる類似度スコアリング
|
||
- スコア順にソート（最大10件）
|
||
|
||
### 制限事項
|
||
❌ **登録済みの銘柄のみ**:
|
||
- ユーザーが登録した日本酒からのみレコメンド
|
||
- 未知の銘柄（まだ登録していない日本酒）は推薦されない
|
||
|
||
---
|
||
|
||
## 🎯 Phase 2.0: 未知の銘柄のレコメンド（拡張計画）
|
||
|
||
### 1. Synology NAS上の共有データベース構築
|
||
|
||
**アーキテクチャ**:
|
||
```
|
||
┌─────────────────────────────────────┐
|
||
│ Synology NAS (PostgreSQL) │
|
||
│ posimai-nas.ts.net (Tailscale) │
|
||
│ │
|
||
│ ┌──────────────────────────────┐ │
|
||
│ │ 日本酒マスターDB │ │
|
||
│ │ │ │
|
||
│ │ - 銘柄名 │ │
|
||
│ │ - 蔵元 │ │
|
||
│ │ - 都道府県 │ │
|
||
│ │ - 五味チャート（平均値） │ │
|
||
│ │ - タグ │ │
|
||
│ │ - 人気度（登録回数） │ │
|
||
│ └──────────────────────────────┘ │
|
||
│ ↓ │
|
||
│ ┌──────────────────────────────┐ │
|
||
│ │ ユーザー登録DB │ │
|
||
│ │ │ │
|
||
│ │ - user_id (匿名化) │ │
|
||
│ │ - sake_id │ │
|
||
│ │ - 評価・レビュー │ │
|
||
│ │ - 五味チャート │ │
|
||
│ └──────────────────────────────┘ │
|
||
└─────────────────────────────────────┘
|
||
↑ HTTPS (Tailscale)
|
||
┌─────────────────────────────────────┐
|
||
│ Flutter App │
|
||
│ │
|
||
│ - 自分のカード（Hive） │
|
||
│ - 未知の銘柄（API経由） │
|
||
└─────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
### 2. API設計
|
||
|
||
#### エンドポイント: `/api/v1/recommendations`
|
||
|
||
**リクエスト**:
|
||
```json
|
||
{
|
||
"target": {
|
||
"prefecture": "新潟県",
|
||
"type": "純米吟醸",
|
||
"taste_stats": {
|
||
"aroma": 4,
|
||
"sweetness": 3,
|
||
"acidity": 3,
|
||
"bitterness": 2,
|
||
"body": 4
|
||
},
|
||
"flavor_tags": ["フルーティー", "すっきり"]
|
||
},
|
||
"exclude_ids": ["abc123", "def456"], // 既に登録済みの銘柄
|
||
"limit": 5
|
||
}
|
||
```
|
||
|
||
**レスポンス**:
|
||
```json
|
||
{
|
||
"recommendations": [
|
||
{
|
||
"id": "sake_12345",
|
||
"name": "八海山 純米吟醸",
|
||
"brewery": "八海醸造",
|
||
"prefecture": "新潟県",
|
||
"type": "純米吟醸",
|
||
"taste_stats": {
|
||
"aroma": 4,
|
||
"sweetness": 3,
|
||
"acidity": 3,
|
||
"bitterness": 2,
|
||
"body": 4
|
||
},
|
||
"flavor_tags": ["フルーティー", "すっきり"],
|
||
"similarity_score": 0.92,
|
||
"reason": "新潟県つながり / すっきり / 似た味わい",
|
||
"popularity": 1523 // 何人が登録したか
|
||
},
|
||
// ... 最大5件
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 3. ハイブリッドレコメンド実装
|
||
|
||
```dart
|
||
// lib/services/sake_recommendation_service.dart
|
||
class SakeRecommendationService {
|
||
/// ハイブリッドレコメンド（既存 + 未知の銘柄）
|
||
static Future<List<RecommendedSake>> getHybridRecommendations({
|
||
required SakeItem target,
|
||
required List<SakeItem> ownItems,
|
||
int limit = 10,
|
||
}) async {
|
||
final recommendations = <RecommendedSake>[];
|
||
|
||
// 1. 既存の銘柄から類似を検索（ローカル）
|
||
final ownRecs = getRecommendations(
|
||
target: target,
|
||
allItems: ownItems,
|
||
limit: 5, // 半分
|
||
);
|
||
recommendations.addAll(ownRecs);
|
||
|
||
// 2. 未知の銘柄を検索（API経由）
|
||
try {
|
||
final unknownRecs = await _fetchUnknownRecommendations(
|
||
target: target,
|
||
excludeIds: ownItems.map((item) => item.id).toList(),
|
||
limit: 5, // 残り半分
|
||
);
|
||
recommendations.addAll(unknownRecs);
|
||
} catch (e) {
|
||
debugPrint('⚠️ Failed to fetch unknown recommendations: $e');
|
||
// エラー時は既存のみ表示
|
||
}
|
||
|
||
// 3. スコア順にソート
|
||
recommendations.sort((a, b) => b.score.compareTo(a.score));
|
||
|
||
return recommendations.take(limit).toList();
|
||
}
|
||
|
||
/// 未知の銘柄をAPIから取得
|
||
static Future<List<RecommendedSake>> _fetchUnknownRecommendations({
|
||
required SakeItem target,
|
||
required List<String> excludeIds,
|
||
int limit = 5,
|
||
}) async {
|
||
final response = await http.post(
|
||
Uri.parse('https://posimai-nas.ts.net/api/v1/recommendations'),
|
||
headers: {'Content-Type': 'application/json'},
|
||
body: jsonEncode({
|
||
'target': {
|
||
'prefecture': target.displayData.prefecture,
|
||
'type': target.displayData.type,
|
||
'taste_stats': target.hiddenSpecs.tasteStats,
|
||
'flavor_tags': target.hiddenSpecs.flavorTags,
|
||
},
|
||
'exclude_ids': excludeIds,
|
||
'limit': limit,
|
||
}),
|
||
);
|
||
|
||
if (response.statusCode != 200) {
|
||
throw Exception('API Error: ${response.statusCode}');
|
||
}
|
||
|
||
final data = jsonDecode(response.body);
|
||
return (data['recommendations'] as List)
|
||
.map((json) => RecommendedSake.fromJson(json))
|
||
.toList();
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 4. UI改善
|
||
|
||
**Before** (現在):
|
||
```dart
|
||
Text('五味チャート・タグ・酒蔵・産地から自動選出\n※現在は登録済みの銘柄からおすすめを表示')
|
||
```
|
||
|
||
**After** (Phase 2.0):
|
||
```dart
|
||
Text('五味チャート・タグ・酒蔵・産地から自動選出\n💡 あなたにおすすめの未知の銘柄も表示中')
|
||
```
|
||
|
||
**未知の銘柄のカードにバッジ表示**:
|
||
```dart
|
||
// 未知の銘柄には「🆕 未登録」バッジを表示
|
||
Stack(
|
||
children: [
|
||
Image.network(unknownSake.imageUrl),
|
||
if (unknownSake.isUnknown)
|
||
Positioned(
|
||
top: 8,
|
||
right: 8,
|
||
child: Container(
|
||
padding: EdgeInsets.symmetric(horizontal: 8, vertical: 4),
|
||
decoration: BoxDecoration(
|
||
color: Colors.orange,
|
||
borderRadius: BorderRadius.circular(12),
|
||
),
|
||
child: Text('🆕 未登録', style: TextStyle(color: Colors.white, fontSize: 10)),
|
||
),
|
||
),
|
||
],
|
||
)
|
||
```
|
||
|
||
---
|
||
|
||
### 5. データ収集戦略
|
||
|
||
#### ステップ1: 既存ユーザーのデータを匿名化して収集
|
||
|
||
**実装**:
|
||
- アプリ初回起動時に「データ提供の同意」を取得
|
||
- ユーザーが登録した日本酒のデータをNASに送信
|
||
- `user_id`は匿名化（`device_info_plus`でデバイスIDをハッシュ化）
|
||
|
||
```dart
|
||
// lib/services/data_contribution_service.dart
|
||
class DataContributionService {
|
||
static Future<void> uploadSakeData() async {
|
||
final userProfile = ref.read(userProfileProvider);
|
||
|
||
// ユーザーが同意していない場合は送信しない
|
||
if (!userProfile.hasConsentedToDataSharing) return;
|
||
|
||
final box = Hive.box<SakeItem>('sake_items');
|
||
final allItems = box.values.toList();
|
||
|
||
final payload = allItems.map((item) => {
|
||
'name': item.displayData.name,
|
||
'brewery': item.displayData.brewery,
|
||
'prefecture': item.displayData.prefecture,
|
||
'type': item.displayData.type,
|
||
'taste_stats': item.hiddenSpecs.tasteStats,
|
||
'flavor_tags': item.hiddenSpecs.flavorTags,
|
||
'smv': item.hiddenSpecs.sakeMeterValue,
|
||
}).toList();
|
||
|
||
await http.post(
|
||
Uri.parse('https://posimai-nas.ts.net/api/v1/data/upload'),
|
||
headers: {'Content-Type': 'application/json'},
|
||
body: jsonEncode({
|
||
'user_id': await _getAnonymizedUserId(),
|
||
'sake_items': payload,
|
||
}),
|
||
);
|
||
}
|
||
}
|
||
```
|
||
|
||
#### ステップ2: 外部データソースから収集
|
||
|
||
1. **日本酒造組合中央会のデータ**:
|
||
- 公開されている酒蔵リスト
|
||
- 都道府県別の銘柄情報
|
||
|
||
2. **酒蔵の公式Webサイト**:
|
||
- 各銘柄の説明文
|
||
- 五味チャートの情報（公開されている場合）
|
||
|
||
3. **Gemini APIによる自動収集**:
|
||
- 日本酒の名前と蔵元から五味チャートを推定
|
||
- コスト: 約5円/銘柄（画像なし、テキストのみ）
|
||
|
||
---
|
||
|
||
### 6. データベーススキーマ
|
||
|
||
**テーブル: `sake_master`**
|
||
```sql
|
||
CREATE TABLE sake_master (
|
||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||
name VARCHAR(255) NOT NULL,
|
||
brewery VARCHAR(255) NOT NULL,
|
||
prefecture VARCHAR(50) NOT NULL,
|
||
type VARCHAR(50), -- 純米吟醸, 大吟醸, etc.
|
||
taste_aroma INT DEFAULT 3,
|
||
taste_sweetness INT DEFAULT 3,
|
||
taste_acidity INT DEFAULT 3,
|
||
taste_bitterness INT DEFAULT 3,
|
||
taste_body INT DEFAULT 3,
|
||
flavor_tags TEXT[], -- {フルーティー, すっきり}
|
||
smv DECIMAL(3,1), -- 日本酒度
|
||
popularity INT DEFAULT 0, -- 何人が登録したか
|
||
image_url TEXT,
|
||
created_at TIMESTAMP DEFAULT NOW(),
|
||
updated_at TIMESTAMP DEFAULT NOW()
|
||
);
|
||
|
||
CREATE INDEX idx_sake_prefecture ON sake_master(prefecture);
|
||
CREATE INDEX idx_sake_type ON sake_master(type);
|
||
CREATE INDEX idx_sake_popularity ON sake_master(popularity DESC);
|
||
```
|
||
|
||
**テーブル: `user_sake_data`**
|
||
```sql
|
||
CREATE TABLE user_sake_data (
|
||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||
user_id_hash VARCHAR(64) NOT NULL, -- 匿名化されたユーザーID
|
||
sake_id UUID REFERENCES sake_master(id),
|
||
taste_aroma INT,
|
||
taste_sweetness INT,
|
||
taste_acidity INT,
|
||
taste_bitterness INT,
|
||
taste_body INT,
|
||
rating INT, -- 1-5
|
||
created_at TIMESTAMP DEFAULT NOW()
|
||
);
|
||
|
||
CREATE INDEX idx_user_sake_user ON user_sake_data(user_id_hash);
|
||
CREATE INDEX idx_user_sake_sake ON user_sake_data(sake_id);
|
||
```
|
||
|
||
---
|
||
|
||
### 7. 実装工数見積もり
|
||
|
||
| 項目 | 工数 | 担当 |
|
||
|------|------|------|
|
||
| **PostgreSQLセットアップ** | 4時間 | Synology NAS |
|
||
| **APIサーバー構築（FastAPI）** | 8時間 | Python |
|
||
| **レコメンドアルゴリズム（サーバー側）** | 6時間 | Python |
|
||
| **Flutter側の統合** | 6時間 | Dart |
|
||
| **データ収集機能** | 4時間 | Dart + Python |
|
||
| **テスト・調整** | 4時間 | 総合 |
|
||
| **合計** | **32時間** | 約4日 |
|
||
|
||
---
|
||
|
||
### 8. リリーススケジュール
|
||
|
||
#### Phase 1.0（現在）
|
||
- ✅ ローカルレコメンドエンジン実装済み
|
||
- ✅ 既存の銘柄からの推薦
|
||
|
||
#### Phase 2.0（リリース後1ヶ月）
|
||
- 🔄 Synology NAS環境構築
|
||
- 🔄 日本酒マスターDB構築（初期データ: 100銘柄）
|
||
- 🔄 ハイブリッドレコメンド実装
|
||
- 🔄 データ収集機能実装
|
||
|
||
#### Phase 3.0（リリース後3ヶ月）
|
||
- 🔮 ソーシャル機能統合
|
||
- 🔮 「この銘柄を登録している人はこれも登録しています」
|
||
- 🔮 コミュニティの人気ランキング
|
||
|
||
---
|
||
|
||
### 9. ユーザーへの説明
|
||
|
||
**現在の表示**:
|
||
```
|
||
「あわせて飲みたい」
|
||
五味チャート・タグ・酒蔵・産地から自動選出
|
||
※現在は登録済みの銘柄からおすすめを表示
|
||
```
|
||
|
||
**Phase 2.0での表示**:
|
||
```
|
||
「あわせて飲みたい」
|
||
五味チャート・タグ・酒蔵・産地から自動選出
|
||
💡 あなたにおすすめの未知の銘柄も表示中
|
||
```
|
||
|
||
**バッジ**:
|
||
- 🆕 未登録: まだ登録していない銘柄
|
||
- 📚 登録済み: 自分のカードから推薦
|
||
|
||
---
|
||
|
||
## 📝 まとめ
|
||
|
||
**現状**: 既に優秀なローカルレコメンドエンジンが実装済み
|
||
|
||
**Phase 2.0での拡張**: 未知の銘柄を含めたハイブリッドレコメンドを実装予定
|
||
|
||
**実装工数**: 約32時間（4日）
|
||
|
||
**リリース時期**: リリース後1ヶ月（2026年3月頃）
|
||
|
||
---
|
||
|
||
**作成日**: 2026-01-22
|
||
**作成者**: Cursor AI
|
||
**レビュー**: 開発者（必要に応じて修正してください）
|