ponshu-room-lite/docs/PROJECT_TODO.md

146 lines
5.2 KiB
Markdown

# 📋 Ponshu Room Lite - Current TODO List
**Last Updated**: 2026-01-21
**Status**: Active Task Tracking
**For**: Multi-AI Collaboration (Claude + Antigravity + Gemini)
---
## 🔴 CRITICAL: Deferred Tasks (DO NOT FORGET)
### Dark Mode Visibility Fixes (Phase 1 - INCOMPLETE)
- [x] ✅ Create Dark Mode guidelines ([DARK_MODE_COLOR_GUIDELINES.md](DARK_MODE_COLOR_GUIDELINES.md))
- [x] ✅ Redesign app_theme.dart to use Material 3 ColorScheme
- [x] ✅ Fix guide_screen.dart (section headers to secondary color)
- [x] ✅ Fix soul_screen.dart (10+ manual dark mode checks removed)
- [ ] ⏸️ **DEFERRED**: Fix [sake_detail_screen.dart](../lib/screens/sake_detail_screen.dart)
- **Why Deferred**: 1500+ lines, recently modified, needs careful review
- **Issues**: 9 instances of `Theme.of(context).primaryColor` usage
- **Location**: Lines need investigation with `Grep` tool
- **Priority**: High (core feature screen)
- **Estimated Time**: 2-3 hours
- **Action Plan**:
1. Search for all `primaryColor` instances in file
2. Replace with appropriate `colorScheme` properties
3. Test thoroughly in both Light and Dark modes
4. Verify all UI elements (buttons, icons, charts, dialogs)
- [ ] ⏸️ **DEFERRED**: Fix shop_settings_screen.dart
- **Issues**: Manual dark mode checks present
- **Priority**: Medium
- **Estimated Time**: 1 hour
- [ ] ⏸️ **DEFERRED**: Fix remaining widgets with `primaryColor` usage
- **Files**: badge_case.dart, level_title_card.dart, sake_grid_item.dart, etc.
- **Count**: ~40 instances across multiple files
- **Priority**: Low-Medium
- **Estimated Time**: 4-6 hours total
- **Strategy**: Fix incrementally during feature work
---
## 🟡 Phase 2: Planned Features (READY TO START)
See detailed implementation plan: [PHASE_2_IMPLEMENTATION_PLAN.md](PHASE_2_IMPLEMENTATION_PLAN.md)
**Summary**:
1. **Help Button Placement** (Pattern C: Hybrid approach) - 6 hours
2. **AI-Powered "あわせて飲みたい" Recommendations** - 12 hours
3. **AI Analysis Info Editing** - 8 hours
**Total Estimated Time**: 26 hours
---
## 🟢 Phase 3: Technical Debt & Cleanup
### Coach Mark / Tutorial Cleanup
- [ ] Remove `hasSeenTutorial` from UserProfile model
- [ ] Remove `hasSeenCoachMarks` from UserProfile model
- [ ] Remove tutorial-related methods from theme_provider.dart
- [ ] Remove tutorial-related images/assets
- **Why**: Tutorial service was deleted due to persistence bugs
- **Priority**: Low (not breaking anything, just cluttering code)
- **Estimated Time**: 1 hour
### Flutter Analyze Warnings
- [ ] Fix 49 warnings (see `flutter analyze` output)
- Unused imports
- Deprecated API usage
- Type warnings
- **Priority**: Medium
- **Estimated Time**: 2 hours
### Image Compression
- [ ] Implement real image compression (not just file copy)
- **Current Issue**: ImageCompressionService just copies files
- **Solution**: Use flutter_image_compress or similar
- **Priority**: Medium (affects storage usage)
- **Estimated Time**: 3 hours
---
## 📚 Documentation Status
### ✅ Complete & Up-to-date
- [DARK_MODE_COLOR_GUIDELINES.md](DARK_MODE_COLOR_GUIDELINES.md) - Dark Mode implementation guide
- [PROJECT_BACKLOG_MASTER.md](PROJECT_BACKLOG_MASTER.md) - High-level roadmap
- [UI_UX_BACKLOG.md](UI_UX_BACKLOG.md) - UI/UX improvement tracking
- [CURSOR_CHAT_MASTER_CONTEXT.md](architecture/CURSOR_CHAT_MASTER_CONTEXT.md) - Antigravity handoff
### 🔄 Needs Update
- [PROJECT_BACKLOG_MASTER.md](PROJECT_BACKLOG_MASTER.md) - Mark Dark Mode tasks as partially complete
- [UI_UX_BACKLOG.md](UI_UX_BACKLOG.md) - Update Coach Mark status
### 📝 New Documents Created
- This file (PROJECT_TODO.md)
- [README.md](README.md) - Documentation index (TO BE CREATED)
- [PHASE_2_IMPLEMENTATION_PLAN.md](PHASE_2_IMPLEMENTATION_PLAN.md) (TO BE CREATED)
---
## 🎯 Recommended Next Steps
For immediate work, choose ONE of the following:
### Option A: Complete Dark Mode Fixes
1. Fix sake_detail_screen.dart (~2-3 hours)
2. Fix shop_settings_screen.dart (~1 hour)
3. Mark Dark Mode project as complete
### Option B: Start Phase 2 Features
1. Implement Help Button Placement (~6 hours)
2. Creates user value immediately
3. Defer remaining Dark Mode fixes to incremental work
### Option C: Quick Wins
1. Technical debt cleanup (~3 hours total)
- Coach mark removal
- Flutter analyze fixes
2. Builds confidence, cleans codebase
**Recommended by Previous Claude Instance**: Option B (Phase 2) - Delivers user value while Dark Mode is "good enough" for now.
---
## 🚨 Known Issues to Avoid
1. **Image Path Repair Service** - Works correctly after Day 4 bug fix
2. **Backup/Restore** - Functional, tested successfully
3. **Tutorial Service** - Deleted, do not attempt to restore
4. **Dark Mode** - Fixed for core screens, remaining issues documented above
---
## 📞 For Future AI Collaborators
- **Before modifying Dark Mode code**: Read [DARK_MODE_COLOR_GUIDELINES.md](DARK_MODE_COLOR_GUIDELINES.md)
- **Before adding new features**: Check this TODO and [PROJECT_BACKLOG_MASTER.md](PROJECT_BACKLOG_MASTER.md)
- **Before committing**: Run `flutter analyze` and fix new warnings
- **For documentation questions**: See [docs/README.md](README.md) (index file)
---
*This is a living document. Update status after completing tasks.*