mai
/
ponshu-room-lite
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity
ponshu-room-lite/docs/archive/START_HERE_FINAL.md

11 KiB
Raw Blame History

🚀 ぽんるーむ 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モデルの完全コード】

// 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 を完璧に仕上げましょう！