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

190 lines
6.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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緊急対応)