ponshu-room-lite/docs/PROJECT_TODO.md

# 📋 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.*