PlantGuide/Docs/auto-add-care-items-plan.md

Plant Detail Auto-Add Care Items with Notifications

Summary

Add an "Auto-Add Care Items" feature to the plant detail screen that:

1. Creates recurring care tasks (watering, fertilizing) based on Trefle API data
2. Allows per-task-type notification toggles
3. Sends local notifications at user-configured time
4. Adds "Notify Me Time" setting in Settings

Current State Analysis

What Already Exists:

• PlantDetailView shows plant info, care requirements, and upcoming tasks
• PlantDetailViewModel has loadCareInfo() and createSchedule() methods
• FetchPlantCareUseCase fetches care info from Trefle API
• CreateCareScheduleUseCase generates watering/fertilizer tasks for 30 days
• CoreDataCareScheduleStorage persists care schedules to CoreData
• NotificationService exists with notification scheduling capabilities
• CarePreferences has preferredWateringHour and preferredWateringMinute

Gap Analysis:

1. No UI to trigger schedule creation
2. Schedules not persisted to CoreData
3. No notification toggles per task type
4. No "Notify Me Time" setting in Settings UI
5. No local notification scheduling when tasks are created

Implementation Steps

Step 1: Add Notification Time Setting to Settings

Files:

• PlantGuide/Presentation/Scenes/Settings/SettingsView.swift
• PlantGuide/Presentation/Scenes/Settings/SettingsViewModel.swift

Add:

• "Notify Me Time" DatePicker (time only) in Settings
• Store in UserDefaults: settings_notification_time_hour, settings_notification_time_minute
• Default to 8:00 AM

Step 2: Create CareNotificationPreferences Model

File (new): PlantGuide/Domain/Entities/CareNotificationPreferences.swift

struct CareNotificationPreferences: Codable, Sendable, Equatable {
    var wateringEnabled: Bool = true
    var fertilizingEnabled: Bool = true
    var repottingEnabled: Bool = false
    var pruningEnabled: Bool = false
}

Step 3: Update PlantDetailViewModel

File: PlantGuide/Presentation/Scenes/PlantDetail/PlantDetailViewModel.swift

Add:

• Dependency on CareScheduleRepositoryProtocol
• Dependency on NotificationService
• notificationPreferences: CareNotificationPreferences (per plant, stored in UserDefaults by plantID)
• hasExistingSchedule: Bool
• isCreatingSchedule: Bool
• Load existing schedule on loadCareInfo()
• createSchedule() → persist schedule + schedule notifications
• updateNotificationPreference(for:enabled:) → update toggles + reschedule

Step 4: Update PlantDetailView UI

File: PlantGuide/Presentation/Scenes/PlantDetail/PlantDetailView.swift

Add:

• "Auto-Add Care Items" button (if no schedule exists)
• Notification Toggles Section (if schedule exists):

  Notifications
  ├─ Watering reminders    [Toggle]
  ├─ Fertilizer reminders  [Toggle]
  

• Success feedback when schedule created
• Show task count when schedule exists

Step 5: Update DIContainer

File: PlantGuide/Core/DI/DIContainer.swift

Update makePlantDetailViewModel() to inject:

• careScheduleRepository
• notificationService

Step 6: Schedule Local Notifications

File: PlantGuide/Core/Services/NotificationService.swift

Add/verify methods:

• scheduleCareTaskNotification(task:plantName:) - schedules notification for task
• cancelCareTaskNotifications(for plantID:) - cancels all for plant
• cancelCareTaskNotifications(for taskType:plantID:) - cancels by type

File Changes Summary

File	Action	Changes
SettingsView.swift	Modify	Add "Notify Me Time" picker
SettingsViewModel.swift	Modify	Add notification time storage
CareNotificationPreferences.swift	Create	New model for per-plant toggles
PlantDetailViewModel.swift	Modify	Add repository, notifications, preferences
PlantDetailView.swift	Modify	Add button + notification toggles
DIContainer.swift	Modify	Update factory injection
NotificationService.swift	Modify	Add care task notification methods

Data Flow

1. User configures "Notify Me Time" in Settings (e.g., 9:00 AM)
   ↓
2. User taps "Auto-Add Care Items" on plant detail
   ↓
3. CreateCareScheduleUseCase creates tasks
   ↓
4. CareScheduleRepository.save() → CoreData
   ↓
5. For each task type where notification enabled:
   NotificationService.scheduleCareTaskNotification()
   ↓
6. Notifications fire at configured time on scheduled dates

UI Design

Settings Screen Addition

┌─────────────────────────────────────┐
│ NOTIFICATIONS                       │
├─────────────────────────────────────┤
│ Notify Me Time          [9:00 AM ▼] │
│ Time to receive care reminders      │
└─────────────────────────────────────┘

Plant Detail Screen

┌─────────────────────────────────────┐
│ [Plant Header with Image]           │
├─────────────────────────────────────┤
│ Care Information                    │
│ • Light: Bright indirect           │
│ • Water: Every 7 days              │
│ • Temperature: 18-27°C             │
├─────────────────────────────────────┤
│ ┌─────────────────────────────────┐ │
│ │  Auto-Add Care Items            │ │  ← Button (if no schedule)
│ └─────────────────────────────────┘ │
│                                     │
│   OR if schedule exists:            │
│                                     │
│ Care Reminders                      │
│ ├─ Watering            [ON ────●]  │
│ └─ Fertilizer          [ON ────●]  │
├─────────────────────────────────────┤
│ Upcoming Tasks (8 total)            │
│ • Water tomorrow                    │
│ • Fertilize in 14 days             │
└─────────────────────────────────────┘

Verification

1. Settings:

   • Open Settings → see "Notify Me Time" picker
   • Change time → value persists on restart

2. Plant Detail - Create Schedule:

   • Navigate to plant without schedule
   • See "Auto-Add Care Items" button
   • Tap → loading state → success with task count
   • Button replaced with notification toggles

3. Notification Toggles:

   • Toggle watering OFF → existing watering notifications cancelled
   • Toggle watering ON → notifications rescheduled

4. Notifications Fire:

   • Create schedule with watering in 1 minute (for testing)
   • Receive local notification at configured time

5. Persistence:

   • Close app, reopen → schedule still exists, toggles preserved

6. Care Tab:

   • Tasks appear in Care tab grouped by date