ponshu-room-lite/docs/archive/RELEASE_NOTES_v1.0.9.md

190 lines
6.8 KiB
Markdown
Raw Normal View History

# Ponshu Room v1.0.9 リリースノート
## 📦 リリース日
2026年1月31日
## 🎯 Phase 1緊急対応完了版
このバージョンは、**オフライン対応機能**を実装した緊急対応版です。
アプリのコアコンセプト「居酒屋や酒蔵で出会った日本酒をその場で記録」を実現するため、
電波の弱い環境でも写真を保存できるようになりました。
---
## 🆕 新機能
### 🔴 オフライン対応Draft Mode
**致命的欠陥の修正**: 電波の弱い環境での利用が不可能だった問題を解決
#### 機能概要
- **オフライン時の撮影**: インターネット接続がない環境でも写真を「解析待ち」として保存
- **未解析バナー**: ホーム画面上部に未解析の写真件数を表示(オレンジグラデーション)
- **一括解析機能**: オンライン復帰後、「すべて解析」ボタンで一括AI解析が可能
- **進捗表示**: 解析中は進捗バーとカウントをリアルタイム表示
#### 使用フロー
1. **オフライン時**:
- カメラで酒ラベル撮影
- 写真は自動的にギャラリーに保存
- 「解析待ち」として一時保存オレンジのSnackBar通知
2. **オンライン復帰後**:
- ホーム画面上部に「未解析の写真: N件」バナー表示
- バナータップ → 未解析一覧画面へ
- 「すべて解析N件」ボタンタップ
- AI解析完了後、通常のSakeItemとして登録
- バッジ「初めての一歩」などが正常に解除される
#### 技術詳細
- **新規パッケージ**: `connectivity_plus` v6.1.2
- **新規サービス**:
- `NetworkService` - ネットワーク状態管理
- `DraftService` - Draft保存・解析管理
- **新規画面**:
- `PendingAnalysisScreen` - Draft一覧・一括解析画面
- `PendingAnalysisBanner` - 未解析通知ウィジェット
- **データモデル拡張**:
- `SakeItem.isPendingAnalysis` - AI解析待ちフラグ
- `SakeItem.draftPhotoPath` - 一時保存写真パス
- Hive Field 26, 27を使用後方互換性維持
---
## 🔧 改善・修正
### 既存機能の保護
以下の機能は一切変更されていません:
- ✅ Gemini Vision API解析ロジック
- ✅ バッジ解除システムv1.0.5で修正済み)
- ✅ ゲーミフィケーション(経験値・レベル)
- ✅ Google Driveバックアップ/復元
- ✅ 王冠バッジ + Pro限定ダイアログUI
- ✅ カメラ機能(フォーカス・ズーム・露出)
- ✅ 多言語対応(日本語/英語)
- ✅ ダークモード
### コード品質
- `flutter analyze` 実行結果:
- エラー: 0件
- 警告: 0件
- ビルド成功確認済み
---
## 📄 ドキュメント追加
### 新規ドキュメント
1. **REMOVED_FEATURES.md**
- v1.0.5までに削除された機能の詳細分析
- アプリコンセプトへの影響度評価
- 将来のPro版への実装推奨度
- 具体的な実装案とコード例
2. **PROJECT_ROADMAP.md**
- Phase 1緊急対応: オフライン対応 ✅ 完了
- Phase 21-2ヶ月: Pro版機能開発
- Phase 33-6ヶ月: エンタープライズ機能
- KPI・成功指標・リリース戦略
---
## 📊 APKファイル情報
### Pro版
- **ファイル名**: `ponshu-room-pro-v1.0.9-release.apk`
- **サイズ**: 88.9 MB
- **パッケージ名**: `com.posimai.ponshu_room_lite` (※注意: build.gradle.ktsで設定)
- **ビルドコマンド**: `flutter build apk --release --dart-define=IS_PRO_VERSION=true`
- **対応機能**: すべての機能QRスキャン、Instagram、アナリティクス
### Lite版
- **ファイル名**: `ponshu-room-lite-v1.0.9-release.apk`
- **サイズ**: 88.7 MB
- **パッケージ名**: `com.posimai.ponshu_room_lite`
- **ビルドコマンド**: `flutter build apk --release --dart-define=IS_PRO_VERSION=false`
- **対応機能**: コア機能のみPro限定機能は王冠バッジ + ダイアログでロック)
### 共通仕様
- **対応アーキテクチャ**: arm64-v8a のみAPKサイズ最適化
- **最小Android SDK**: 24Android 7.0 Nougat
- **ターゲットSDK**: 34Android 14
- **フォント最適化**: Tree-shaking有効92.6%削減)
---
## ⚠️ 既知の制限事項
### 1. 32ビットデバイス非対応
- **影響**: 2014年以前の古いAndroid端末では動作不可
- **理由**: APKサイズ削減のため arm64-v8a のみビルド
- **対応端末**: 2015年以降のほぼすべてのAndroid端末64ビットCPU搭載機
### 2. x86エミュレータ制限
- **影響**: 一部のAndroidエミュレータで動作しない場合がある
- **回避策**: ARM64イメージのエミュレータを使用、または実機テスト
---
## 🚀 テスト推奨項目
### オフライン対応機能
1. **機内モードテスト**:
- 機内モードON → カメラ撮影 → Draft保存確認
- 機内モードOFF → バナー表示確認
- 一括解析実行 → 正常登録確認
2. **バッジ解除テスト**:
- Draft解析後に「初めての一歩」バッジが解除されるか
- 経験値・レベルアップ通知が正常に表示されるか
3. **エラーハンドリング**:
- 解析失敗時のエラーメッセージ表示
- リトライ機能の動作確認
### 既存機能の回帰テスト
1. **通常の撮影→解析フロー**(オンライン時)
2. **Google Driveバックアップ/復元**
3. **Pro限定機能のロック表示**Lite版のみ
4. **ダークモード切り替え**
5. **多言語切り替え(日本語⇔英語)**
---
## 🔗 関連リンク
- **プロジェクトリポジトリ**: (GitHub URLがあれば記載)
- **ドキュメント**:
- [REMOVED_FEATURES.md](REMOVED_FEATURES.md) - 削除機能分析
- [PROJECT_ROADMAP.md](PROJECT_ROADMAP.md) - 開発ロードマップ
- **バグ報告**: (Issue tracker URLがあれば記載)
---
## 👥 開発者向け情報
### ビルド環境
- **Flutter**: 3.38.3 (stable channel)
- **Dart**: 3.10.1
- **Android Gradle Plugin**: 8.x
- **Kotlin**: 最新版Android Studio JBR同梱
### 引き継ぎ事項
1. **secrets.local.dart** の設定が必要Gemini API Key、Google Drive設定
2. **IS_PRO_VERSION** フラグでPro/Lite版を切り替え
3. **Hive Field 26-27** がDraft用に予約済み
4. **connectivity_plus** パッケージが新規追加(プライバシーポリシー要確認)
### 今後の優先タスクPhase 2
1. Instagram投稿支援機能の完成
2. ビジネスアナリティクス機能の実装
3. QR/ARスキャン機能の完成
---
## 📞 サポート
質問や問題が発生した場合は、共同開発者までご連絡ください。
**Generated on**: 2026-01-31
**Build by**: Claude Code (Phase 1緊急対応)