How rakhichhh/plantpal-ai works
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: PlantCareFacade.java Care workflow facade · PlantService.java Plant service · repository JPA repositories · CarePlanningService.java Care planning
Components 25
User experience and API
- PlantPal UI
src/main/resources/static/app.js - Plant API
src/main/java/com/plantpal/api/PlantController.java - Workflow API
src/main/java/com/plantpal/api/PlantCareWorkflowController.java - Planning API
src/main/java/com/plantpal/api/CarePlanningController.java - Recognition API
src/main/java/com/plantpal/api/PlantRecognitionController.java
Plant and care workflows
- Plant service
src/main/java/com/plantpal/service/PlantService.java - Care workflow facade
src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java - Care planning
src/main/java/com/plantpal/service/CarePlanningService.java - Scheduling strategies
src/main/java/com/plantpal/pattern/strategy - Task creators
src/main/java/com/plantpal/pattern/factory - Plant builder
src/main/java/com/plantpal/pattern/builder/PlantBuilder.java - Photo analysis service
src/main/java/com/plantpal/service/PlantPhotoService.java - Gemini adapter
src/main/java/com/plantpal/pattern/adapter/GeminiPlantAdapter.java - Gemini HTTP gateway
src/main/java/com/plantpal/pattern/adapter/GeminiHttpGateway.java
Notifications and reporting
- Care event observers
src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java - Notification center
src/main/java/com/plantpal/domain/CareNotification.java - Notification decorators
src/main/java/com/plantpal/pattern/decorator - Care statistics visitor
src/main/java/com/plantpal/pattern/visitor/CareStatisticsVisitor.java - CSV report export
src/main/java/com/plantpal/service/CareReportExportService.java
Domain and persistence
- Plant records
src/main/java/com/plantpal/domain/Plant.java - Care tasks and settings
src/main/java/com/plantpal/domain/CareTask.java - JPA repositories
src/main/java/com/plantpal/repository
Other components
- Plant caretaker
- Gemini API
- H2 file database
Connections 25
- Plant caretaker → PlantPal UI: uses
- PlantPal UI → Workflow API: submits workflows
- PlantPal UI → Recognition API: requests analysis
- Workflow API → Care workflow facade: delegates workflows
src/main/java/com/plantpal/api/PlantCareWorkflowController.java - Plant API → Plant service: delegates plant actions
src/main/java/com/plantpal/api/PlantController.java - Planning API → Care planning: delegates planning
src/main/java/com/plantpal/api/CarePlanningController.java - Recognition API → Photo analysis service: requests analysis
src/main/java/com/plantpal/api/PlantRecognitionController.java - Care workflow facade → Plant service: registers and completes
src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java - Care workflow facade → Care planning: changes care mode
src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java - Plant service → Plant builder: builds plants
src/main/java/com/plantpal/service/PlantService.java - Plant service → Task creators: creates initial tasks
src/main/java/com/plantpal/service/PlantService.java - Photo analysis service → Gemini adapter: requests recognition
src/main/java/com/plantpal/service/PlantPhotoService.java - Gemini adapter → Gemini HTTP gateway: uses gateway
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
src/main/java/com/plantpal/service/CarePlanningService.java - Care planning → Care event observers: publishes care event
src/main/java/com/plantpal/service/CarePlanningService.java - Plant service → JPA repositories: stores plants and tasks
src/main/java/com/plantpal/service/PlantService.java - Care event observers → Scheduling strategies: reschedules tasks
src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java - Care event observers → JPA repositories: reads and updates care data
src/main/java/com/plantpal/pattern/observer/CareScheduleObserver.java - Care workflow facade → Care statistics visitor: collects statistics
src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java - Care workflow facade → JPA repositories: reads report records
src/main/java/com/plantpal/pattern/facade/PlantCareFacade.java - Workflow API → CSV report export: exports CSV
src/main/java/com/plantpal/api/PlantCareWorkflowController.java - CSV report export → Care workflow facade: gets care summary
src/main/java/com/plantpal/service/CareReportExportService.java - Notification decorators → Notification center: enriches notification text
src/main/java/com/plantpal/pattern/decorator/NotificationDecorator.java - JPA repositories → H2 file database: persists records