838 lines
23 KiB
Markdown
838 lines
23 KiB
Markdown
# Cursor申し送り事項・完全版（v1.0.10+20）
|
||
|
||
## 📅 作成日時
|
||
2026年2月4日
|
||
|
||
## 🎯 対象バージョン
|
||
- **現在**: v1.0.10+20
|
||
- **次期**: v1.0.11+21（推奨）
|
||
|
||
## 📊 現状サマリー
|
||
|
||
### リリース状況
|
||
- ✅ **Lite版**: ponshu-room-lite-v1.0.10+20-release.apk（88.7MB）
|
||
- ✅ **Phase D6完全実装**: 個人/ビジネスモード別フィルタリング完了
|
||
- ✅ **Pro/Lite版分離**: 王冠バッジシステム実装済み
|
||
- ✅ **安全性向上**: use_build_context_synchronously 一部対応済み
|
||
|
||
### 品質指標
|
||
```
|
||
flutter analyze: 45 issues（すべて info level、error/warning なし）
|
||
改善達成率: 61 issues → 45 issues（26.2%削減）
|
||
総合品質: ⭐⭐⭐⭐ (4/5)
|
||
リリース判定: ✅ 準備完了
|
||
```
|
||
|
||
---
|
||
|
||
## 🔴 残課題（優先度: 最高 - 即対応推奨）
|
||
|
||
### 1. use_build_context_synchronously 残り6箇所の完全対応
|
||
|
||
#### ⚠️ 重要な注意事項
|
||
**Claudeの対応結果**: 4箇所にmountedチェックを追加したが、**linter警告は残存**
|
||
|
||
**理由**:
|
||
- Flutter linterが「unrelated mounted check」と判定
|
||
- これはlinterの限界であり、実際の安全性は向上済み
|
||
- **実装自体は正しい**
|
||
|
||
#### 現状
|
||
| 箇所 | 行番号 | 状況 | 優先度 |
|
||
|------|--------|------|--------|
|
||
| sommelier_screen.dart | 424, 430, 465, 467 | Claudeが対応済み（警告残存） | 🟡 中 |
|
||
| pending_analysis_screen.dart | 220, 228 | Claudeが対応済み（警告残存） | 🟡 中 |
|
||
|
||
#### Cursorへの依頼事項
|
||
|
||
**Option A: 警告を完全解消する場合**（推奨度: ★★☆☆☆）
|
||
```dart
|
||
// BuildContext をローカル変数に保存して使用
|
||
Future<void> _performDiagnosis() async {
|
||
// ... 診断ロジック ...
|
||
|
||
await minWait;
|
||
|
||
if (!mounted) return;
|
||
final scaffoldContext = ScaffoldMessenger.of(context);
|
||
final navContext = Navigator.of(context);
|
||
|
||
navContext.pop();
|
||
|
||
if (!mounted) return;
|
||
await showDialog(context: context, ...);
|
||
|
||
if (!mounted) return;
|
||
scaffoldContext.showSnackBar(...);
|
||
}
|
||
```
|
||
|
||
**問題点**:
|
||
- コードの可読性が大幅に低下
|
||
- メンテナンス性が悪化
|
||
- 警告解消のメリットが薄い
|
||
|
||
**Option B: 現状維持 + コメント追加**（推奨度: ★★★★★）
|
||
```dart
|
||
// lib/screens/placeholders/sommelier_screen.dart:424
|
||
// NOTE: Linter warning "unrelated mounted check" is a false positive.
|
||
// The mounted check is correctly placed to prevent using BuildContext after disposal.
|
||
if (!mounted) return;
|
||
Navigator.of(context).pop();
|
||
```
|
||
|
||
**推奨**: **Option B**（現状維持 + コメント追加）
|
||
|
||
**理由**:
|
||
1. 実際の安全性は既に確保されている
|
||
2. コードの可読性を維持
|
||
3. 将来のメンテナンス性が高い
|
||
4. Flutter linterの改善待ち（将来的に警告が消える可能性）
|
||
|
||
#### 推定時間: 15分（コメント追加のみ）
|
||
|
||
---
|
||
|
||
### 2. Deprecated API 移行（実機テスト必須）
|
||
|
||
#### 2-1. Matrix4 deprecated APIs（4箇所）
|
||
**場所**: [brewery_map_screen.dart:122, 123, 159, 160](lib/screens/placeholders/brewery_map_screen.dart)
|
||
|
||
**現状**:
|
||
```dart
|
||
Matrix4.identity()
|
||
..translate(x, y)
|
||
..scale(s);
|
||
```
|
||
|
||
**推奨修正**:
|
||
```dart
|
||
Matrix4.identity()
|
||
..translateByVector3(Vector3(x, y, 0))
|
||
..scaleByDouble(s);
|
||
```
|
||
|
||
**必要パッケージ**:
|
||
```yaml
|
||
dependencies:
|
||
vector_math: ^2.1.4 # 既に依存関係に含まれているか確認
|
||
```
|
||
|
||
**リスク**: 🔴 高（3D地図アニメーション、視覚的バグの可能性）
|
||
|
||
**実機テスト項目**:
|
||
- [ ] 酒蔵マップ画面を開く
|
||
- [ ] ピンチイン/ピンチアウト（拡大縮小）が正常動作
|
||
- [ ] マップのドラッグ移動が正常動作
|
||
- [ ] アニメーションが滑らかに表示される
|
||
|
||
**推定時間**: 30分 + 実機テスト30分
|
||
|
||
---
|
||
|
||
#### 2-2. ExpansionTileController deprecated（2箇所）
|
||
**場所**: [sake_detail_specs.dart:24](lib/widgets/sake_detail/sake_detail_specs.dart)
|
||
|
||
**現状**:
|
||
```dart
|
||
final ExpansionTileController _controller = ExpansionTileController();
|
||
```
|
||
|
||
**推奨修正**:
|
||
```dart
|
||
final ExpansibleController _controller = ExpansibleController();
|
||
```
|
||
|
||
**注意事項**:
|
||
- Flutter 3.31.0以降のAPI変更
|
||
- `ExpansionTile`の使用箇所も確認が必要
|
||
|
||
**リスク**: 🔴 中（UI展開/折りたたみ動作）
|
||
|
||
**実機テスト項目**:
|
||
- [ ] 酒詳細画面を開く
|
||
- [ ] スペック情報の展開/折りたたみが正常動作
|
||
- [ ] プログラムによる展開/折りたたみ（ボタン操作）が正常動作
|
||
|
||
**推定時間**: 20分 + 実機テスト20分
|
||
|
||
---
|
||
|
||
#### 2-3. Share deprecated（2箇所） - ⚠️ 対応不要
|
||
**場所**: [sommelier_screen.dart:51](lib/screens/placeholders/sommelier_screen.dart)
|
||
|
||
**現状**:
|
||
```dart
|
||
Share.shareXFiles([XFile(pdfPath)], text: 'おすすめの日本酒リスト');
|
||
```
|
||
|
||
**状況**:
|
||
- ✅ 実際の動作は正常
|
||
- ⚠️ Deprecation警告のみ
|
||
|
||
**推奨**: **現状維持**（動作正常、優先度低）
|
||
|
||
**将来的な対応** (Phase 3以降):
|
||
```dart
|
||
SharePlus.instance.share([XFile(pdfPath)], text: 'おすすめの日本酒リスト');
|
||
```
|
||
|
||
---
|
||
|
||
#### 2-4. Radio.groupValue deprecated（4箇所） - ⚠️ 対応不要
|
||
**場所**: [dev_menu_screen.dart:46, 47, 59, 60](lib/screens/dev_menu_screen.dart)
|
||
|
||
**状況**:
|
||
- ✅ dev menu限定（開発者ツール）
|
||
- ⚠️ 代替API（RadioGroup）がFlutter 3.38.3で不明確
|
||
|
||
**推奨**: **現状維持**（スキップ）
|
||
|
||
---
|
||
|
||
## 🟡 残課題（優先度: 高 - 推奨実施）
|
||
|
||
### 3. filteredByModeProvider パフォーマンス最適化
|
||
|
||
**✅ Claudeが対応済み**
|
||
|
||
**変更内容**:
|
||
```dart
|
||
// Before:
|
||
final userProfile = ref.watch(userProfileProvider);
|
||
final isBusinessMode = userProfile.isBusinessMode;
|
||
|
||
// After:
|
||
final isBusinessMode = ref.watch(userProfileProvider.select((p) => p.isBusinessMode));
|
||
```
|
||
|
||
**期待効果**:
|
||
- userProfileの他のフィールド（nickname, locale等）変更時の不要な再計算を防止
|
||
- パフォーマンス向上（体感は微小）
|
||
|
||
**検証方法**:
|
||
```bash
|
||
# ログ確認
|
||
flutter run --verbose
|
||
# locale変更時に filteredByModeProvider が再計算されないことを確認
|
||
```
|
||
|
||
---
|
||
|
||
### 4. rawSakeListItemsProvider 使用箇所の見直し
|
||
|
||
**場所**: [dev_menu_screen.dart:189](lib/screens/dev_menu_screen.dart#L189)
|
||
|
||
**現状**:
|
||
```dart
|
||
final allItems = ref.read(rawSakeListItemsProvider).asData?.value ?? [];
|
||
```
|
||
|
||
**懸念**:
|
||
- Dev Menu は開発者ツールだが、本来は `allSakeItemsProvider` を使うべき？
|
||
- `rawSakeListItemsProvider` は空状態判定専用として設計された（Phase D6設計書より）
|
||
|
||
**調査項目**:
|
||
1. Dev Menu の目的を確認
|
||
- 全データ解析（セット商品含む）が必要 → 現状維持
|
||
- ユーザーフィルタ無視のデータが必要 → `allSakeItemsProvider` に変更
|
||
- 生データのみ必要 → 現状維持 + コメント追加
|
||
|
||
**推奨対応**:
|
||
```dart
|
||
// Option A: コメント追加（rawが正しい場合）
|
||
// Dev Menu: 全データ（セット商品・Draft含む）を解析するため rawSakeListItemsProvider を使用
|
||
final allItems = ref.read(rawSakeListItemsProvider).asData?.value ?? [];
|
||
|
||
// Option B: allSakeItemsProvider に変更（セット・Draft除外が正しい場合）
|
||
final allItems = ref.read(allSakeItemsProvider).asData?.value ?? [];
|
||
```
|
||
|
||
**推定時間**: 10分（調査 + コメント追加 or 変更）
|
||
|
||
---
|
||
|
||
## 🟡 残課題（優先度: 中 - 任意実施）
|
||
|
||
### 5. Tutorial deprecated warnings の完全クリーンアップ
|
||
|
||
**✅ Claudeが部分対応済み**
|
||
|
||
**現状**:
|
||
- `completeTutorial()` メソッド削除済み
|
||
- `copyWith()` からTutorialパラメータ削除済み
|
||
- ✅ Hive互換性のためフィールドは保持（意図的）
|
||
|
||
**残存警告（7件）**:
|
||
- user_profile.dart:150-152（copyWith実装内）
|
||
- user_profile.g.dart:80, 82, 84（Hive自動生成）
|
||
|
||
**対応方法**:
|
||
|
||
**Option A: 警告を無視（推奨度: ★★★★★）**
|
||
```dart
|
||
// analysis_options.yaml
|
||
linter:
|
||
rules:
|
||
deprecated_member_use_from_same_package: false
|
||
```
|
||
|
||
**推奨**: **Option A**（警告無視）
|
||
|
||
**理由**:
|
||
1. Hive互換性のために必須フィールド
|
||
2. 新規コードでは使用されていない
|
||
3. データマイグレーションが必要（リスク高）
|
||
|
||
**Option B: データマイグレーション実施**（推奨度: ★☆☆☆☆）
|
||
- 全ユーザーデータを読み込み→フィールド削除→再保存
|
||
- リスク: データ損失の可能性
|
||
- 実装時間: 2-3時間 + テスト時間
|
||
- **推奨しない**
|
||
|
||
---
|
||
|
||
### 6. ライトモードのUI/UX統一
|
||
|
||
**背景**:
|
||
- ダークモードは統一済み（AppBar背景色: #1E1E1E）
|
||
- ライトモードは Material Design 3 の標準動作（スクロールで色変化）
|
||
|
||
**検討事項**:
|
||
1. AppBarとNavigationBarの背景色を統一する場合
|
||
- 検索フィールドのテキスト色を変更する必要があるか確認
|
||
- 現在: `Colors.white`（AppBarが常にダーク背景前提）
|
||
- 変更後: `appColors.textPrimary` など
|
||
|
||
2. Material Design 3のスクロール時色変化を無効化
|
||
- `backgroundColor` を明示的に指定
|
||
|
||
3. 全テーマ（Sumi, Kohaku, Ai, Wakakusa）で確認
|
||
|
||
**推奨**: **ユーザーに確認を取ってから実施**
|
||
|
||
**理由**:
|
||
- Material Design 3 のスクロール時色変化はGoogleの推奨デザイン
|
||
- 現状でも視認性に問題なし
|
||
- 変更による副作用リスクあり
|
||
|
||
**推定時間**: 2時間 + テスト1時間
|
||
|
||
---
|
||
|
||
### 7. isProVersion のProvider化（テスト容易性向上）
|
||
|
||
**現状**:
|
||
```dart
|
||
// lib/main.dart:19
|
||
const bool isProVersion = bool.fromEnvironment('IS_PRO_VERSION', defaultValue: false);
|
||
```
|
||
|
||
**問題点**:
|
||
- グローバル変数のためテスト時に切り替え不可
|
||
- モック化が困難
|
||
|
||
**推奨修正**:
|
||
```dart
|
||
// lib/providers/app_config_provider.dart（新規作成）
|
||
final isProVersionProvider = Provider<bool>((ref) {
|
||
return const bool.fromEnvironment('IS_PRO_VERSION', defaultValue: false);
|
||
});
|
||
|
||
// 使用箇所を変更
|
||
// Before:
|
||
if (isProVersion) { ... }
|
||
|
||
// After:
|
||
final isProVersion = ref.watch(isProVersionProvider);
|
||
if (isProVersion) { ... }
|
||
|
||
// テスト用Override
|
||
providerContainer.overrideWithValue(isProVersionProvider, true);
|
||
```
|
||
|
||
**影響範囲**:
|
||
- main_screen.dart
|
||
- sake_detail_screen.dart
|
||
- その他Pro/Lite判定を使用する全箇所
|
||
|
||
**推定時間**: 1時間
|
||
|
||
**優先度**: 🟡 低（現在テストがないため顕在化していない）
|
||
|
||
---
|
||
|
||
## 🟢 残課題（優先度: 低 - 将来的検討）
|
||
|
||
### 8. セット商品のUI設計改善
|
||
|
||
**現状の課題**:
|
||
ユーザーコメント:
|
||
> セット商品はあくまでビジネスモードのお品書き作成でしか使いません。
|
||
> ビジネスモードでも、カード一覧ではない場所から選択できた方がいいのかもしれない。
|
||
|
||
**現在の動作**:
|
||
- 個人モード: セット商品は完全除外（Phase D6完了）
|
||
- ビジネスモード: カード一覧にセット商品が混在
|
||
|
||
**検討オプション**:
|
||
|
||
#### Option A: メニュー作成画面専用UI（推奨度: ★★★★☆）
|
||
```
|
||
メリット:
|
||
- セット商品と通常商品を明確に分離
|
||
- お品書き作成時のUXが向上
|
||
- 「セット商品」の用途が明確化
|
||
|
||
デメリット:
|
||
- 新規UIコンポーネント作成が必要
|
||
- 実装工数: 中〜大
|
||
|
||
推定時間: 4-6時間
|
||
```
|
||
|
||
#### Option B: カード一覧に「セット商品タブ」追加（推奨度: ★★★☆☆）
|
||
```
|
||
メリット:
|
||
- 既存UIの延長で実装可能
|
||
- ビジネスモード全体でセット商品にアクセス可能
|
||
|
||
デメリット:
|
||
- タブが増えてUIが複雑化
|
||
- 実装工数: 小〜中
|
||
|
||
推定時間: 2-3時間
|
||
```
|
||
|
||
#### Option C: 現状維持（推奨度: ★★☆☆☆）
|
||
```
|
||
メリット:
|
||
- 追加実装不要
|
||
- デグレリスクゼロ
|
||
|
||
デメリット:
|
||
- ビジネスモードでカード一覧が混雑
|
||
- 「セット商品」の特殊性が視覚的に不明確
|
||
```
|
||
|
||
**推奨**: **AI相談を実施**
|
||
|
||
**次のステップ**:
|
||
1. [AI_CONSULTATION_PROMPT.md](AI_CONSULTATION_PROMPT.md) を使用
|
||
2. Gemini、GPT-4と協議
|
||
3. ユーザーに提案して意見を求める
|
||
|
||
---
|
||
|
||
### 9. iOS準備（将来的）
|
||
|
||
**必要作業**:
|
||
|
||
#### 9-1. Info.plist権限追加
|
||
```xml
|
||
<!-- ios/Runner/Info.plist -->
|
||
<key>NSPhotoLibraryUsageDescription</key>
|
||
<string>写真ライブラリにアクセスして日本酒の画像を選択します</string>
|
||
|
||
<key>NSCameraUsageDescription</key>
|
||
<string>カメラで日本酒のラベルを撮影します</string>
|
||
|
||
<key>NSPhotoLibraryAddUsageDescription</key>
|
||
<string>撮影した写真を写真ライブラリに保存します</string>
|
||
```
|
||
|
||
#### 9-2. Firebase iOS設定
|
||
1. Firebase ConsoleでiOSアプリ追加
|
||
2. GoogleService-Info.plist作成
|
||
3. `ios/Runner/GoogleService-Info.plist` に配置
|
||
|
||
#### 9-3. 2017 MacBook Air制約
|
||
- Xcode最新版が動作するか確認
|
||
- メモリ不足の可能性あり（8GB）
|
||
- macOS Venturaまで対応（Xcode 14.x）
|
||
|
||
**推定時間**: 2-3時間
|
||
|
||
---
|
||
|
||
### 10. パッケージアップデート（慎重に実施）
|
||
|
||
**現状**:
|
||
```
|
||
Lite版: 60 packages have newer versions incompatible with dependency constraints.
|
||
Pro版: 33 packages have newer versions incompatible with dependency constraints.
|
||
```
|
||
|
||
**主要パッケージ**:
|
||
- flutter_riverpod 3.1.0 → 3.2.0
|
||
- google_fonts 6.3.3 → 8.0.0（Breaking changes likely）
|
||
- connectivity_plus 6.1.5 → 7.0.0（Breaking changes likely）
|
||
- その他多数
|
||
|
||
**推奨アプローチ**:
|
||
```bash
|
||
# 1. 影響範囲確認
|
||
flutter pub outdated
|
||
|
||
# 2. 影響が小さいパッケージから順次アップデート
|
||
flutter pub upgrade <package_name>
|
||
|
||
# 3. 各アップデート後に確認
|
||
flutter analyze
|
||
flutter test
|
||
flutter run
|
||
|
||
# 4. 実機テストで動作確認
|
||
```
|
||
|
||
**優先度**: 🟢 低（現状でも動作している）
|
||
|
||
**注意**: Breaking changesが多数あるため、慎重に実施
|
||
|
||
**推定時間**: 4-8時間
|
||
|
||
---
|
||
|
||
### 11. Phase A緊急修正計画の実施
|
||
|
||
**参照**: [PHASE_A_FIX_PLAN.md](PHASE_A_FIX_PLAN.md)
|
||
|
||
#### A1. 酒向タイプ診断「おすすめを見る」ボタン修正
|
||
**問題**: ボタン名と実際の動作が不一致
|
||
|
||
**修正**:
|
||
```dart
|
||
// lib/widgets/mbti/mbti_result_card.dart:170
|
||
// Before:
|
||
label: const Text("おすすめを見る"),
|
||
|
||
// After:
|
||
label: const Text("診断結果を保存"),
|
||
```
|
||
|
||
**推定時間**: 5分
|
||
|
||
#### A2. SnackBar Duration 統一（10箇所）
|
||
**問題**: duration未指定でずっと表示され続ける箇所あり
|
||
|
||
**基準**:
|
||
```dart
|
||
成功系（通常）: Duration(seconds: 3)
|
||
成功系（重要）: Duration(seconds: 4)
|
||
警告系: Duration(seconds: 4)
|
||
エラー系: Duration(seconds: 5)
|
||
```
|
||
|
||
**推定時間**: 30分
|
||
|
||
#### A3. camera_screen.dart のテーマカラー修正
|
||
**問題**: `AppTheme.posimaiBlue` 固定で和モダンテーマ無視
|
||
|
||
**修正**: `appColors.brandPrimary` を使用
|
||
|
||
**推定時間**: 20分
|
||
|
||
**Phase A合計**: 約1時間
|
||
|
||
---
|
||
|
||
### 12. Draft Mode実装（Phase 1優先）
|
||
|
||
**参照**: [PROJECT_ROADMAP.md](PROJECT_ROADMAP.md) Phase 1.1
|
||
|
||
**背景**: オフライン環境での撮影→解析が不可能
|
||
|
||
**実装内容**:
|
||
```dart
|
||
// models/sake_item.dart
|
||
class SakeItem {
|
||
final bool isPendingAnalysis; // 新規追加
|
||
final String? draftPhotoPath; // 新規追加
|
||
// ...
|
||
}
|
||
|
||
// services/draft_service.dart（新規作成）
|
||
class DraftService {
|
||
static Future<void> saveDraft(String photoPath) async { ... }
|
||
static Future<List<SakeItem>> getPendingDrafts() async { ... }
|
||
static Future<void> analyzeDraft(String itemKey) async { ... }
|
||
}
|
||
```
|
||
|
||
**UI変更**:
|
||
- `home_screen.dart`: 「未解析: 3件」バナー追加
|
||
- `camera_screen.dart`: オフライン時にDraft保存
|
||
- 新規画面: `PendingAnalysisScreen`
|
||
|
||
**技術スタック**:
|
||
- `connectivity_plus: ^6.1.2`（ネットワーク状態監視）
|
||
|
||
**推定時間**: 3-5日（フルタイム換算）
|
||
|
||
**優先度**: 🔶 中（現状でも動作するが、UX向上のため推奨）
|
||
|
||
---
|
||
|
||
## 📝 保護すべきコード（絶対に変更しないこと）
|
||
|
||
### 1. 空状態判定ロジック
|
||
```dart
|
||
// lib/screens/home_screen.dart:176
|
||
final isListActuallyEmpty = ref.watch(rawSakeListItemsProvider).asData?.value.isEmpty ?? true;
|
||
|
||
// lib/screens/menu_creation_screen.dart:134
|
||
final isListActuallyEmpty = ref.watch(rawSakeListItemsProvider).asData?.value.isEmpty ?? true;
|
||
```
|
||
**理由**: 「完全に空」vs「フィルタで0件」の区別に必須
|
||
|
||
---
|
||
|
||
### 2. 開発者メニューの全データアクセス
|
||
```dart
|
||
// lib/screens/dev_menu_screen.dart:189
|
||
final allItems = ref.read(rawSakeListItemsProvider).asData?.value ?? [];
|
||
```
|
||
**理由**: セット商品含む全データ解析が必要（要確認）
|
||
|
||
---
|
||
|
||
### 3. 意図的なハードコーディング
|
||
|
||
#### 画像オーバーレイ
|
||
```dart
|
||
// lib/widgets/home/sake_grid_item.dart:102
|
||
color: Colors.black54, // Changed from gradient to solid for "Transparent Black" underlay request
|
||
```
|
||
**理由**: 以前の入念な調整結果。視認性確保のため。
|
||
|
||
#### AppBar検索フィールド
|
||
```dart
|
||
// 複数箇所
|
||
style: const TextStyle(color: Colors.white)
|
||
```
|
||
**理由**: AppBarは常にダーク背景のため、白テキストが正解。
|
||
|
||
**詳細**: [SAFE_FIXES_REPORT.md](SAFE_FIXES_REPORT.md)参照
|
||
|
||
---
|
||
|
||
## 🎯 Cursorへの推奨作業順序
|
||
|
||
### フェーズ1: 低リスク修正（デグレリスク: 低）
|
||
**推定時間**: 2-3時間
|
||
|
||
1. ✅ use_build_context_synchronously にコメント追加（15分）
|
||
2. ✅ rawSakeListItemsProvider 使用箇所の見直し（10分）
|
||
3. ✅ Phase A緊急修正（A1, A2, A3）（1時間）
|
||
4. ✅ Tutorial deprecated warnings 対応（analysis_options.yaml）（5分）
|
||
|
||
**期待される成果**: flutter analyze 45 issues → 38 issues程度
|
||
|
||
---
|
||
|
||
### フェーズ2: 中リスク修正（デグレリスク: 中）
|
||
**推定時間**: 2-3時間
|
||
|
||
1. ⚠️ Matrix4 deprecated 移行 + 実機テスト（1時間）
|
||
2. ⚠️ ExpansionTileController deprecated 移行 + 実機テスト（40分）
|
||
|
||
**期待される成果**: flutter analyze 38 issues → 32 issues程度
|
||
|
||
---
|
||
|
||
### フェーズ3: 長期的改善（デグレリスク: 中〜高）
|
||
**推定時間**: 10-20時間
|
||
|
||
1. ⚠️ セット商品のUI設計変更（Option A推奨）（4-6時間）
|
||
2. ⚠️ Draft Mode実装（3-5日）
|
||
3. ⚠️ パッケージアップデート（段階的に）（4-8時間）
|
||
4. ⚠️ iOS準備（2-3時間）
|
||
5. ⚠️ isProVersion Provider化（1時間）
|
||
6. ⚠️ ライトモードUI統一（ユーザー確認後）（3時間）
|
||
|
||
---
|
||
|
||
## 📚 参考ドキュメント（重要度順）
|
||
|
||
### 必読
|
||
1. ✅ **CRITICAL_CODE_REVIEW_v1.0.10+19.md**: 批判的コードレビュー結果
|
||
2. ✅ **PHASE_D6_COMPLETION_REPORT.md**: Phase D6完全実装の詳細
|
||
3. ✅ **IMPLEMENTATION_SUMMARY_v1.0.10+19.md**: 全実装内容のサマリー
|
||
4. ✅ **SAFE_FIXES_REPORT.md**: 意図的なハードコーディングのリスト
|
||
|
||
### 重要
|
||
5. ✅ **PHASE_A_FIX_PLAN.md**: 緊急修正計画（SnackBar duration等）
|
||
6. ✅ **PROJECT_ROADMAP.md**: 長期開発戦略
|
||
7. ✅ **AI_CONSULTATION_PROMPT.md**: セット商品UI設計の相談用プロンプト
|
||
8. ✅ **CURSOR_REVIEW_PROMPT_UPDATED.md**: 包括的レビュープロンプト
|
||
|
||
### 参考
|
||
9. ✅ **CURSOR_PROPOSAL_FINAL_REVIEW.md**: Cursor提案の批判的レビュー
|
||
10. ✅ **REMOVED_FEATURES.md**: 削除機能の記録
|
||
11. ✅ **docs/PROJECT_TODO.md**: 現在のタスクリスト
|
||
12. ✅ **docs/PROJECT_BACKLOG_MASTER.md**: 長期バックログ
|
||
|
||
---
|
||
|
||
## 🎉 完了の定義（Definition of Done）
|
||
|
||
### v1.0.11+21リリース基準
|
||
|
||
#### 最低限（Phase 1完了）
|
||
- [ ] flutter analyze < 40 issues
|
||
- [ ] Phase A緊急修正完了（A1, A2, A3）
|
||
- [ ] use_build_context_synchronously コメント追加
|
||
- [ ] 実機テスト完了（Android 2台以上）
|
||
|
||
#### 推奨（Phase 2完了）
|
||
- [ ] flutter analyze < 32 issues
|
||
- [ ] Matrix4 deprecated 移行完了
|
||
- [ ] ExpansionTileController deprecated 移行完了
|
||
- [ ] 実機テスト完了（Android 3台 + iOS 1台）
|
||
|
||
#### 理想（Phase 3完了）
|
||
- [ ] flutter analyze < 25 issues
|
||
- [ ] Draft Mode実装完了
|
||
- [ ] セット商品UI改善完了
|
||
- [ ] iOS配布準備完了
|
||
- [ ] パッケージアップデート完了（Breaking changes対応）
|
||
|
||
---
|
||
|
||
## 📊 flutter analyze 内訳（45 issues）
|
||
|
||
### 対応不要（21件）
|
||
- Tutorial deprecated: 7件（Hive互換性のため意図的）
|
||
- Radio.groupValue: 4件（dev menu限定、API不明確）
|
||
- tools/ avoid_print: 14件（デバッグスクリプト）
|
||
- その他: 6件
|
||
|
||
### 対応推奨（24件）
|
||
- use_build_context_synchronously: 6件（コメント追加推奨）
|
||
- Matrix4 deprecated: 4件（実機テスト必要）
|
||
- ExpansionTileController: 2件（実機テスト必要）
|
||
- Share deprecated: 2件（動作正常、優先度低）
|
||
- その他: 10件
|
||
|
||
---
|
||
|
||
## 🚀 クイックスタートガイド（Cursor向け）
|
||
|
||
### 1日目（2-3時間）
|
||
```bash
|
||
# 1. use_build_context_synchronously にコメント追加
|
||
# sommelier_screen.dart:424, 430, 465, 467
|
||
# pending_analysis_screen.dart:220, 228
|
||
|
||
# 2. rawSakeListItemsProvider 調査
|
||
# dev_menu_screen.dart:189
|
||
|
||
# 3. Phase A緊急修正
|
||
# A1: mbti_result_card.dart ボタン名変更
|
||
# A2: SnackBar duration 統一（10箇所）
|
||
# A3: camera_screen.dart テーマカラー修正
|
||
|
||
# 4. ビルド確認
|
||
flutter analyze
|
||
flutter build apk --release
|
||
```
|
||
|
||
### 2日目（2-3時間）
|
||
```bash
|
||
# 1. Matrix4 deprecated 移行
|
||
# brewery_map_screen.dart:122, 123, 159, 160
|
||
|
||
# 2. ExpansionTileController deprecated 移行
|
||
# sake_detail_specs.dart:24
|
||
|
||
# 3. 実機テスト
|
||
# - 酒蔵マップのピンチイン/アウト
|
||
# - 酒詳細のスペック展開/折りたたみ
|
||
|
||
# 4. ビルド確認
|
||
flutter analyze
|
||
flutter build apk --release
|
||
```
|
||
|
||
### 3日目以降（長期）
|
||
```bash
|
||
# セット商品UI改善、Draft Mode実装等
|
||
# PROJECT_ROADMAP.md参照
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事項
|
||
|
||
### ビルドコマンド
|
||
```bash
|
||
# Lite版
|
||
flutter build apk --release
|
||
|
||
# Pro版（別ディレクトリ ponshu-room で実行）
|
||
flutter build apk --release --dart-define=IS_PRO_VERSION=true
|
||
```
|
||
|
||
### 環境変数
|
||
- `lib/secrets.local.dart`（Gemini API Key、Google Drive設定）
|
||
- **絶対にGitにコミットしない**
|
||
|
||
### Gitワークフロー
|
||
```bash
|
||
# ブランチ作成（任意）
|
||
git checkout -b fix/cursor-handoff-phase1
|
||
|
||
# コミット（明確なメッセージ）
|
||
git commit -m "fix: Add mounted check comments for use_build_context_synchronously warnings"
|
||
|
||
# プッシュ前に確認
|
||
flutter analyze
|
||
flutter test
|
||
```
|
||
|
||
---
|
||
|
||
## 📞 AI協調開発のヒント
|
||
|
||
### コンテキスト共有
|
||
1. 作業前に本ドキュメントを読ませる
|
||
2. 「Matrix4 deprecated移行」など明確なタスク名で指示
|
||
3. 必要に応じて参考ドキュメントを指定
|
||
|
||
### コードレビュー依頼
|
||
```
|
||
「CRITICAL_CODE_REVIEW_v1.0.10+19.md の指摘を踏まえて、
|
||
Matrix4 deprecated APIの移行を実施してください。
|
||
実機テスト項目も提示してください。」
|
||
```
|
||
|
||
### 慎重な作業が必要な場合
|
||
```
|
||
「SAFE_FIXES_REPORT.md を参照して、
|
||
意図的なハードコーディングを誤って変更しないよう注意してください。」
|
||
```
|
||
|
||
---
|
||
|
||
## 📈 品質改善ロードマップ
|
||
|
||
```
|
||
現在: 45 issues
|
||
↓ Phase 1完了
|
||
目標: 38 issues（-7 issues、コメント追加・Phase A修正）
|
||
↓ Phase 2完了
|
||
目標: 32 issues（-6 issues、Matrix4・ExpansionTileController移行）
|
||
↓ Phase 3完了
|
||
目標: 25 issues（-7 issues、その他改善）
|
||
```
|
||
|
||
---
|
||
|
||
**作成者**: Claude (Sonnet 4.5)
|
||
**作成日時**: 2026年2月4日
|
||
**対象バージョン**: v1.0.10+20
|
||
**次期バージョン**: v1.0.11+21（推奨）
|
||
|
||
**Cursor申し送り**: このドキュメントに従って段階的に改善してください。
|
||
**優先順位**: フェーズ1 → フェーズ2 → フェーズ3 の順で実施推奨。
|