# rakhichhh/plantpal-ai architecture

> Architecture diagram of the GitHub repository rakhichhh/plantpal-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rakhichhh/plantpal-ai
- Repository: https://github.com/rakhichhh/plantpal-ai

## Overview

PlantPal is a Spring Boot plant-care application with a browser UI. Users add plants manually or review AI photo suggestions, then manage plants, care modes, tasks, and in-app notifications; analytics can be viewed and exported as CSV. The workflow is split across API controllers, services and a facade, domain/pattern implementations, and persistent repositories. The README documents capabilities not fully visible in sampled source; edges for those are shown only where the README or source index supports them.

Main entry points: [`src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java) (Care workflow facade), [`src/main/java/com/plantpal/service/PlantService.java`](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/PlantService.java) (Plant service), [`src/main/java/com/plantpal/repository`](https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/repository) (JPA repositories), [`src/main/java/com/plantpal/service/CarePlanningService.java`](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/CarePlanningService.java) (Care planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience and API"]
  node_browser["PlantPal UI<br/>[app.js]"]
  node_plant_api["Plant API"]
  node_workflow_api["Workflow API"]
  node_planning_api["Planning API"]
  node_recognition_api["Recognition API"]
end

subgraph group_care["Plant and care workflows"]
  node_plant_service["Plant service<br/>[PlantService.java]"]
  node_care_facade["Care workflow facade"]
  node_planning_service["Care planning"]
  node_task_strategies["Scheduling strategies"]
  node_task_factories["Task creators"]
  node_plant_builder["Plant builder<br/>[PlantBuilder.java]"]
  node_photo_service["Photo analysis service"]
  node_gemini_adapter["Gemini adapter"]
  node_gemini_gateway["Gemini HTTP gateway"]
end

subgraph group_insights["Notifications and reporting"]
  node_event_observers["Care event observers"]
  node_notifications["Notification center"]
  node_notification_enrichment["Notification decorators"]
  node_report_visitor["Care statistics visitor"]
  node_report_export["CSV report export"]
end

subgraph group_persistence["Domain and persistence"]
  node_plant_domain["Plant records<br/>[Plant.java]"]
  node_care_domain["Care tasks and settings<br/>[CareTask.java]"]
  node_repositories[("JPA repositories")]
end

node_user(("Plant caretaker"))
node_gemini{{"Gemini API"}}
node_h2[("H2 file database")]

node_user -->|"uses"| node_browser
node_browser -.->|"submits workflows"| node_workflow_api
node_browser -.->|"requests analysis"| node_recognition_api
node_workflow_api -->|"delegates workflows"| node_care_facade
node_plant_api -->|"delegates plant actions"| node_plant_service
node_planning_api -->|"delegates planning"| node_planning_service
node_recognition_api -->|"requests analysis"| node_photo_service
node_care_facade -->|"registers and completes"| node_plant_service
node_care_facade -->|"changes care mode"| node_planning_service
node_plant_service -->|"builds plants"| node_plant_builder
node_plant_service -->|"creates initial tasks"| node_task_factories
node_photo_service -->|"requests recognition"| node_gemini_adapter
node_gemini_adapter -->|"uses gateway"| node_gemini_gateway
node_gemini_gateway -->|"sends photo analysis"| node_gemini
node_planning_service -->|"reads and saves settings"| node_repositories
node_planning_service -->|"publishes care event"| node_event_observers
node_plant_service -->|"stores plants and tasks"| node_repositories
node_event_observers -->|"reschedules tasks"| node_task_strategies
node_event_observers -->|"reads and updates care data"| node_repositories
node_care_facade -->|"collects statistics"| node_report_visitor
node_care_facade -->|"reads report records"| node_repositories
node_workflow_api -->|"exports CSV"| node_report_export
node_report_export -->|"gets care summary"| node_care_facade
node_notification_enrichment -->|"enriches notification text"| node_notifications
node_repositories -->|"persists records"| node_h2

click node_browser "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/resources/static/app.js"
click node_plant_api "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantController.java"
click node_workflow_api "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantCareWorkflowController.java"
click node_planning_api "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/CarePlanningController.java"
click node_recognition_api "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantRecognitionController.java"
click node_plant_service "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/PlantService.java"
click node_care_facade "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java"
click node_planning_service "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/CarePlanningService.java"
click node_task_strategies "https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/strategy"
click node_task_factories "https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/factory"
click node_plant_builder "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/builder/PlantBuilder.java"
click node_photo_service "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/PlantPhotoService.java"
click node_gemini_adapter "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/adapter/GeminiPlantAdapter.java"
click node_gemini_gateway "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/adapter/GeminiHttpGateway.java"
click node_event_observers "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java"
click node_notifications "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/CareNotification.java"
click node_notification_enrichment "https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/decorator"
click node_report_visitor "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/visitor/CareStatisticsVisitor.java"
click node_report_export "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/CareReportExportService.java"
click node_plant_domain "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/Plant.java"
click node_care_domain "https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/CareTask.java"
click node_repositories "https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/repository"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_plant_api,node_workflow_api,node_planning_api,node_recognition_api toneBlue
class node_plant_service,node_care_facade,node_planning_service,node_task_strategies,node_task_factories,node_plant_builder,node_photo_service,node_gemini_adapter,node_gemini_gateway,node_h2 toneAmber
class node_event_observers,node_notifications,node_notification_enrichment,node_report_visitor,node_report_export,node_gemini toneMint
class node_plant_domain,node_care_domain,node_repositories toneRose
class node_user toneIndigo
```

## Components

### User experience and API

- [PlantPal UI](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/resources/static/app.js): `src/main/resources/static/app.js`
- [Plant API](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantController.java): `src/main/java/com/plantpal/api/PlantController.java`
- [Workflow API](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantCareWorkflowController.java): `src/main/java/com/plantpal/api/PlantCareWorkflowController.java`
- [Planning API](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/CarePlanningController.java): `src/main/java/com/plantpal/api/CarePlanningController.java`
- [Recognition API](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/api/PlantRecognitionController.java): `src/main/java/com/plantpal/api/PlantRecognitionController.java`

### Plant and care workflows

- [Plant service](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/PlantService.java): `src/main/java/com/plantpal/service/PlantService.java`
- [Care workflow facade](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java): `src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`
- [Care planning](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/CarePlanningService.java): `src/main/java/com/plantpal/service/CarePlanningService.java`
- [Scheduling strategies](https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/strategy): `src/main/java/com/plantpal/pattern/strategy`
- [Task creators](https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/factory): `src/main/java/com/plantpal/pattern/factory`
- [Plant builder](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/builder/PlantBuilder.java): `src/main/java/com/plantpal/pattern/builder/PlantBuilder.java`
- [Photo analysis service](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/PlantPhotoService.java): `src/main/java/com/plantpal/service/PlantPhotoService.java`
- [Gemini adapter](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/adapter/GeminiPlantAdapter.java): `src/main/java/com/plantpal/pattern/adapter/GeminiPlantAdapter.java`
- [Gemini HTTP gateway](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/adapter/GeminiHttpGateway.java): `src/main/java/com/plantpal/pattern/adapter/GeminiHttpGateway.java`

### Notifications and reporting

- [Care event observers](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java): `src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java`
- [Notification center](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/CareNotification.java): `src/main/java/com/plantpal/domain/CareNotification.java`
- [Notification decorators](https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/pattern/decorator): `src/main/java/com/plantpal/pattern/decorator`
- [Care statistics visitor](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/pattern/visitor/CareStatisticsVisitor.java): `src/main/java/com/plantpal/pattern/visitor/CareStatisticsVisitor.java`
- [CSV report export](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/service/CareReportExportService.java): `src/main/java/com/plantpal/service/CareReportExportService.java`

### Domain and persistence

- [Plant records](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/Plant.java): `src/main/java/com/plantpal/domain/Plant.java`
- [Care tasks and settings](https://github.com/rakhichhh/plantpal-ai/blob/main/src/main/java/com/plantpal/domain/CareTask.java): `src/main/java/com/plantpal/domain/CareTask.java`
- [JPA repositories](https://github.com/rakhichhh/plantpal-ai/tree/main/src/main/java/com/plantpal/repository): `src/main/java/com/plantpal/repository`

### Other components

- **Plant caretaker**
- **Gemini API**
- **H2 file database**

## Connections

- Plant caretaker → PlantPal UI: uses
- PlantPal UI → Workflow API: submits workflows
- PlantPal UI → Recognition API: requests analysis
- Workflow API → Care workflow facade: delegates workflows (evidence: `src/main/java/com/plantpal/api/PlantCareWorkflowController.java`)
- Plant API → Plant service: delegates plant actions (evidence: `src/main/java/com/plantpal/api/PlantController.java`)
- Planning API → Care planning: delegates planning (evidence: `src/main/java/com/plantpal/api/CarePlanningController.java`)
- Recognition API → Photo analysis service: requests analysis (evidence: `src/main/java/com/plantpal/api/PlantRecognitionController.java`)
- Care workflow facade → Plant service: registers and completes (evidence: `src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`)
- Care workflow facade → Care planning: changes care mode (evidence: `src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`)
- Plant service → Plant builder: builds plants (evidence: `src/main/java/com/plantpal/service/PlantService.java`)
- Plant service → Task creators: creates initial tasks (evidence: `src/main/java/com/plantpal/service/PlantService.java`)
- Photo analysis service → Gemini adapter: requests recognition (evidence: `src/main/java/com/plantpal/service/PlantPhotoService.java`)
- Gemini adapter → Gemini HTTP gateway: uses gateway (evidence: `src/main/java/com/plantpal/pattern/adapter/GeminiPlantAdapter.java`)
- Gemini HTTP gateway → Gemini API: sends photo analysis
- Care planning → JPA repositories: reads and saves settings (evidence: `src/main/java/com/plantpal/service/CarePlanningService.java`)
- Care planning → Care event observers: publishes care event (evidence: `src/main/java/com/plantpal/service/CarePlanningService.java`)
- Plant service → JPA repositories: stores plants and tasks (evidence: `src/main/java/com/plantpal/service/PlantService.java`)
- Care event observers → Scheduling strategies: reschedules tasks (evidence: `src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java`)
- Care event observers → JPA repositories: reads and updates care data (evidence: `src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java`)
- Care workflow facade → Care statistics visitor: collects statistics (evidence: `src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`)
- Care workflow facade → JPA repositories: reads report records (evidence: `src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java`)
- Workflow API → CSV report export: exports CSV (evidence: `src/main/java/com/plantpal/api/PlantCareWorkflowController.java`)
- CSV report export → Care workflow facade: gets care summary (evidence: `src/main/java/com/plantpal/service/CareReportExportService.java`)
- Notification decorators → Notification center: enriches notification text (evidence: `src/main/java/com/plantpal/pattern/decorator/NotificationDecorator.java`)
- JPA repositories → H2 file database: persists records
