# 🚀 ぽんるーむ Lite - 完全スタートガイド

**プロジェクト名**: ぽんるーむ Lite (Ponshu Room Lite)
**バージョン**: 2.0 - "My Digital Sake Cellar with Personality"
**作成日**: 2025-12-29
**このフォルダの状態**: 完全にクリーン（設計書のみ）

---

## 💡 「Lite」の意味

**「Lite」= 機能制限ではなく、「洗練されたコア体験」**

- ✅ 写真を主役にした雑誌のようなUI
- ✅ 完全ローカル保存（プライバシー最優先）
- ✅ MBTI・四柱推命と日本酒を掛け合わせた「あなただけの診断」
- ✅ フォント切り替え機能（明朝体 ⇔ ゴシック体）

**将来の「Pro」版**:
- Synology NAS連携
- 高度な統計分析
- チーム共有機能

---

## 🎯 このアプリの3つの魂

### 🍶 1. 「瞬撮」- 魔法の解析体験
カメラを向けて撮るだけで、Gemini 3.0がリアルタイム実況しながら解析。
```
「ラベルを読んでいます...」
「お、これは山口県の銘柄ですね...」
「データを整理しています...」
```

### 🎨 2. 「美録」- インスタ映えする情報の見せ方
雑誌のようなレイアウト、選べるフォント、Instagram用正方形画像生成。

### 🧩 3. 「遊び心」- あなただけのパーソナライズ
- **MBTI × 日本酒相性診断**: 「このお酒はENFPのあなたにピッタリ！」
- **四柱推命 × 今日の一滴**: 「今日の運気を上げる辛口な一本」
- **フレーバー・マトリックス**: あなたの好みを可視化

---

## ✅ このフォルダの状況

```
現在のフォルダ: C:\Users\maita\posimai-project\ponshu_room_lite

含まれるもの:
✅ FINAL_REQUIREMENTS.md（最終仕様書）
✅ ANTIGRAVITY_PROMPT.md（実装手順書）
✅ UI_UX_DECISION_GUIDE.md（デザイン決定ガイド）
✅ START_HERE_FINAL.md（このファイル）

含まれないもの:
❌ 古いWeb版のコード（完全に除外）
❌ lib/ フォルダ
❌ pubspec.yaml
❌ 何のコードもありません
```

**これは意図的です。完全にゼロから始めます。**

---

## 🎯 Antigravity向け - 最終完全プロンプト

以下をAntigravityに送ってください：

---

```
@Antigravity

ぽんるーむ Lite をゼロから実装します。
このフォルダ（ponshu_room_lite）は完全にクリーンです。

📂 現在のフォルダ:
C:\Users\maita\posimai-project\ponshu_room_lite

📄 読み込むべきドキュメント:
1. START_HERE_FINAL.md（最初に読む）
2. ANTIGRAVITY_PROMPT.md（メイン実装手順）
3. FINAL_REQUIREMENTS.md（完全仕様書）

🔑 新しいAPIキー:
AIzaSyA2BSr16R2k0bHjSYcSUdmLoY8PKwaFts0

🎨 デザイン方針（Lite版の魂）:

【写真最大化】
- 余白は最小限（padding: 8dp, separator: 4dp）
- 写真サイズ: 120x120
- フル幅カード
- 極細ボーダー（0.5px）で区切り

【フォント戦略】
- デフォルト: Noto Sans JP（親しみやすいゴシック体）
- 設定で切り替え可能: Noto Serif JP（高級感のある明朝体）
- ユーザーが好みで選べるようにする

【パーソナライズ機能の準備】
- UserProfileモデルを作成:
  - MBTI診断結果（16タイプ）
  - 生年月日（四柱推命用）
  - 好みのフォント設定
- これらは Phase 2以降で使用（今は枠だけ準備）

⚠️ 絶対にやってはいけないこと:
❌ ../ponshu-room/ フォルダを参照しない
❌ 古いコードをコピーしない
❌ Web版のUIを踏襲しない

✅ やるべきこと（Phase 1）:

【1-1. プロジェクト初期化】
1. このフォルダで flutter create . を実行
2. pubspec.yaml を設定（google_fonts, hive, riverpod, etc.）
3. Android設定（compileSdk: 36, targetSdk: 35）

【1-2. データモデル】
1. SakeItem モデル:
   - 基本情報（銘柄名、酒蔵、都道府県、etc.）
   - キャッチコピー（Geminiが自動生成）
   - フレーバースコア（sweetnessScore, bodyScore）

2. UserProfile モデル（🆕）:
   - mbtiType: String?  // 例: "ENFP"
   - birthDate: DateTime?  // 四柱推命用
   - fontPreference: String  // "serif" or "sans"
   - createdAt: DateTime

【1-3. テーマ設定】
1. AppTheme を作成:
   - posimaiカラー（#376495）
   - 動的フォント切り替え対応
   - デフォルトは Noto Sans JP

2. FontProvider（Riverpod）を作成:
   - UserProfileからフォント設定を読み込み
   - アプリ全体でリアクティブに切り替え

【1-4. Gemini AI解析】
1. GeminiService:
   - モデル: gemini-2.5-flash-latest
   - リアルタイム実況機能
   - キャッチコピー自動生成

【1-5. UI実装】
1. ホーム画面（4タブ）:
   - 酒リスト（フル幅カード）
   - マップ
   - AIソムリエ
   - プロフィール

2. フル幅カード:
   - 左: 写真120x120
   - 右: 銘柄名（選択したフォント）、データ

3. プロフィール画面:
   - フォント切り替えスイッチ
   - MBTI入力欄（今は空でOK）
   - 生年月日入力欄（今は空でOK）

【1-6. SafeArea対応】
- すべての画面でSafeAreaを徹底使用
- Android 15で見切れ・重なりゼロ

🚀 開始:
ANTIGRAVITY_PROMPT.md の「プロジェクト作成」セクションから開始してください。
Phase 1-1（プロジェクト初期化）完了後に報告をお願いします。

💡 重要な追加仕様:

【フォント切り替えの実装】
設定画面に以下を追加:

```dart
// 設定画面の一部
Row(
  mainAxisAlignment: MainAxisAlignment.spaceBetween,
  children: [
    Text('フォント設定'),
    SegmentedButton(
      segments: [
        ButtonSegment(value: 'sans', label: Text('ゴシック')),
        ButtonSegment(value: 'serif', label: Text('明朝')),
      ],
      selected: {currentFont},
      onSelectionChanged: (Set<String> newSelection) {
        // UserProfileを更新
        // AppThemeを再構築
      },
    ),
  ],
)
```

【UserProfileモデルの完全コード】

```dart
// lib/models/user_profile.dart
import 'package:hive/hive.dart';

part 'user_profile.g.dart';

@HiveType(typeId: 1)
class UserProfile extends HiveObject {
  @HiveField(0)
  String? mbtiType;  // "ENFP", "INTJ", etc.

  @HiveField(1)
  DateTime? birthDate;  // 四柱推命用

  @HiveField(2)
  String fontPreference;  // "serif" or "sans"

  @HiveField(3)
  DateTime createdAt;

  @HiveField(4)
  DateTime? updatedAt;

  UserProfile({
    this.mbtiType,
    this.birthDate,
    this.fontPreference = 'sans',  // デフォルトはゴシック
    required this.createdAt,
    this.updatedAt,
  });
}
```

【Phase 2以降の予告】
- MBTI × 日本酒相性診断
- 四柱推命 × 今日の一滴
- フレーバー・マトリックス
- Instagram用画像生成（診断結果入り）

これらは Phase 1完了後に実装します。
今は UserProfile の枠だけ準備してください。
```

---

## 📋 実装の流れ

### Phase 0: 準備（今ここ）
- [x] 新しいフォルダ作成（ponshu_room_lite）
- [x] 設計書をコピー
- [ ] Antigravityに指示を送る

### Phase 1: MVP（5-6時間）
- [ ] プロジェクト初期化
- [ ] データモデル（SakeItem + UserProfile）
- [ ] フォント切り替え機能
- [ ] Gemini解析（リアルタイム実況）
- [ ] フル幅カード
- [ ] SafeArea対応

### Phase 2: パーソナライズ（3-4時間）
- [ ] MBTI入力UI
- [ ] MBTI × 日本酒相性診断
- [ ] 四柱推命 × 今日の一滴
- [ ] フレーバー・マトリックス

### Phase 3: 共有機能（2時間）
- [ ] Instagram用画像生成（診断結果入り）
- [ ] キャッチコピー付き共有

### Phase 4: 遊び心（3時間）
- [ ] 日本酒・制覇マップ
- [ ] AIソムリエチャット

**合計: 13-15時間**

---

## 🎨 フォント選択のガイド

### デフォルト: Noto Sans JP（ゴシック体）
```
印象: 親しみやすい、読みやすい、診断コンテンツと相性◎
おすすめな人: MBTIや診断を楽しみたい、カジュアルに記録したい
```

### オプション: Noto Serif JP（明朝体）
```
印象: 高級感、伝統、雑誌のような洗練
おすすめな人: 日本酒の本格的な雰囲気を大切にしたい
```

**いつでも切り替え可能！設定画面からワンタップ。**

---

## 🔐 APIキーの設定

Antigravityが `lib/secrets.dart` を作成した後、以下が正しく設定されているか確認してください:

```dart
// lib/secrets.dart
class Secrets {
  static const String geminiApiKey = 'AIzaSyA2BSr16R2k0bHjSYcSUdmLoY8PKwaFts0';
}
```

---

## ✅ 完成確認チェックリスト

### Phase 1 MVP完成の確認
- [ ] カメラで日本酒を撮影できる
- [ ] Gemini解析で「ラベルを読んでいます...」と表示される
- [ ] キャッチコピーが自動生成される
- [ ] フル幅カード（写真120x120）で表示される
- [ ] フォント切り替えが動作する（ゴシック ⇔ 明朝）
- [ ] Android 15で見切れない
- [ ] UserProfileが保存される

### Phase 2 パーソナライズ完成の確認
- [ ] MBTI診断結果を入力できる
- [ ] 「このお酒はあなた（ENFP）にピッタリ！」と表示される
- [ ] フレーバー・マトリックスが表示される

### 最終完成の確認
- [ ] すべての機能が動作
- [ ] 「雑誌のような」デザイン
- [ ] 60fpsの滑らかな動作
- [ ] 「魔法のような」心地よさ
- [ ] 知人に見せたくなる

---

## 📞 トラブルシューティング

### もしAntigravityが古いコードを参照しようとしたら

**即座に指摘してください**:
```
@Antigravity

古い ponshu-room フォルダは参照しないでください。
このフォルダ（ponshu_room_lite）内のドキュメントだけを見てください。
```

### もし余白が大きすぎたら

```
@Antigravity

余白が大きすぎます。以下に修正してください:
- ListView.padding: EdgeInsets.symmetric(horizontal: 8, vertical: 12)
- separatorBuilder: SizedBox(height: 4)
- 写真サイズ: 120x120
```

### もしフォント切り替えが動作しなかったら

```
@Antigravity

フォント切り替えが動作しません。
UserProfileのfontPreferenceを変更したら、AppThemeが再構築されるようにしてください。
Riverpodのproviderを使って、リアクティブに更新してください。
```

---

## 🎊 準備完了！

すべての準備が整いました。

**次のアクション**:
1. 上記の「Antigravityへの指示」をコピー
2. Antigravityに送信
3. 実装開始を待つ

**「ぽんるーむ Lite」の誕生を楽しみにしています！🍶✨**

---

## 💡 将来の拡張（Pro版へ）

Phase 1-4が完了し、知人にも好評だったら：

### ぽんるーむ Pro（構想）
- Synology NAS自動バックアップ
- 複数デバイス同期
- チーム共有機能
- 高度な統計分析
- カスタムテーマ
- エクスポート機能強化

**まずは Lite を完璧に仕上げましょう！**
