92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
|
# さけのわAPI連携ドキュメント
|
|||
|
|
|
|||
|
|
## 概要
|
|||
|
|
Ponshu Room Liteはさけのわ（Sakenowa）APIを活用し、日本酒ランキング・ブランド情報・フレーバーチャートを取得しています。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## API エンドポイント
|
|||
|
|
|
|||
|
|
| エンドポイント | 説明 | 更新頻度 |
|
|||
|
|
|:---------------|:-----|:---------|
|
|||
|
|
| `/rankings` | TOP100ランキング | 毎日 |
|
|||
|
|
| `/brands` | 銘柄マスタ（16,000件以上） | 週次 |
|
|||
|
|
| `/flavor-charts` | 6軸フレーバーチャート | 週次 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## データモデル
|
|||
|
|
|
|||
|
|
### SakenowaRanking
|
|||
|
|
```dart
|
|||
|
|
class SakenowaRanking {
|
|||
|
|
final int rank; // 順位
|
|||
|
|
final String brandId; // 銘柄ID
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### SakenowaBrand
|
|||
|
|
```dart
|
|||
|
|
class SakenowaBrand {
|
|||
|
|
final String id; // 銘柄ID
|
|||
|
|
final String name; // 銘柄名
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### SakenowaFlavorChart
|
|||
|
|
```dart
|
|||
|
|
class SakenowaFlavorChart {
|
|||
|
|
final String brandId;
|
|||
|
|
final double f1; // 華やか (0-1)
|
|||
|
|
final double f2; // 芳醇
|
|||
|
|
final double f3; // 重厚
|
|||
|
|
final double f4; // 穏やか
|
|||
|
|
final double f5; // 軽快
|
|||
|
|
final double f6; // ドライ
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Riverpodプロバイダー
|
|||
|
|
|
|||
|
|
```dart
|
|||
|
|
// lib/providers/sakenowa_providers.dart
|
|||
|
|
final sakenowaRankingsProvider = FutureProvider<List<SakenowaRanking>>();
|
|||
|
|
final sakenowaBrandsProvider = FutureProvider<List<SakenowaBrand>>();
|
|||
|
|
final sakenowaFlavorChartsProvider = FutureProvider<List<SakenowaFlavorChart>>();
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 実装済み機能
|
|||
|
|
|
|||
|
|
### 1. ソムリエ画面
|
|||
|
|
- **SakenowaNewRecommendationSection**: コサイン類似度で未飲銘柄を推薦
|
|||
|
|
- **SakenowaRankingSection**: 3Dカルーセルでランキング表示、既飲ハイライト+MBTI相性
|
|||
|
|
|
|||
|
|
### 2. MBTI相性計算
|
|||
|
|
```dart
|
|||
|
|
// 6軸フレーバー → 5軸五味へのマッピング
|
|||
|
|
f1(華やか) → aroma
|
|||
|
|
f2(芳醇)+f4(穏やか) → sweetness
|
|||
|
|
f3(重厚) → body
|
|||
|
|
f5(軽快) → acidity
|
|||
|
|
f6(ドライ) → bitterness
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 未実装/改善予定
|
|||
|
|
|
|||
|
|
| 項目 | 状態 |
|
|||
|
|
|:-----|:-----|
|
|||
|
|
| カード詳細画面でのさけのわ連携おすすめ | ❌ 未実装 |
|
|||
|
|
| ランキングカードから詳細画面遷移 | ❌ 未実装 |
|
|||
|
|
| オフラインキャッシュ | ✅ 実装済み |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 帰属表示
|
|||
|
|
データ提供: さけのわ (https://sakenowa.com)
|