How boopathi0910/weather-advisory-agent works
Weather Advisory Agent serves users searching city weather and receiving safety alerts and recommendations; users can also manage favorites and review dashboard data. Weather retrieval uses a recent cache, live provider data or mock data, then the request handler composes advisories and a response. Separate capabilities include authentication, forecasts, admin monitoring, and scheduled favorite-city alerting. The graph reflects README claims and the supplied source index/excerpts; unsampled implementation details are linked only where documented or indexed.
Main entry points: WeatherController.java Weather search · AutomationService.java Scheduled refresh · WeatherService.java Weather retrieval · AuthController.java Authentication
Components 27
Identity and access
- Authentication
src/main/java/com/weatheradvisor/agent/controller/AuthController.java - User service
src/main/java/com/weatheradvisor/agent/service/UserService.java - JWT security
src/main/java/com/weatheradvisor/agent/security/JwtUtil.java
Weather experience
- Dashboard
src/main/java/com/weatheradvisor/agent/controller/DashboardController.java - Weather search
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - Weather retrieval
src/main/java/com/weatheradvisor/agent/service/WeatherService.java - Weather cache
src/main/java/com/weatheradvisor/agent/model/Weather.java - Forecast
src/main/java/com/weatheradvisor/agent/service/ForecastService.java - Forecast endpoint
src/main/java/com/weatheradvisor/agent/controller/ForecastController.java - Search history
src/main/java/com/weatheradvisor/agent/repository/SearchHistoryRepository.java - Web interface
src/main/resources/static/js/main.js
Advisories and alerts
- Advisory service
src/main/java/com/weatheradvisor/agent/service/AdvisoryService.java - Recommendation engine
src/main/java/com/weatheradvisor/agent/ai/RecommendationEngine.java - AI recommendations
src/main/java/com/weatheradvisor/agent/ai/GeminiService.java - Farmer advice
src/main/java/com/weatheradvisor/agent/service/FarmerAdvisoryService.java
Automation
- Favorites
src/main/java/com/weatheradvisor/agent/repository/FavoriteRepository.java - Scheduled refresh
src/main/java/com/weatheradvisor/agent/service/AutomationService.java - Weather scheduler
src/main/java/com/weatheradvisor/agent/scheduler/WeatherScheduler.java - Alert notifications
src/main/java/com/weatheradvisor/agent/service/NotificationService.java - Email delivery
src/main/java/com/weatheradvisor/agent/service/EmailService.java
Admin and telemetry
- Admin dashboard
src/main/java/com/weatheradvisor/agent/controller/AdminController.java - HTTP client
src/main/java/com/weatheradvisor/agent/util/ApiClient.java - API logs
src/main/java/com/weatheradvisor/agent/repository/ApiLogRepository.java
Other components
- User
- Weather provider
- Gemini API
- MySQL database
Connections 29
- User → Authentication: signs in
README.md - Authentication → User service: authenticates
src/main/java/com/weatheradvisor/agent/controller/AuthController.java - Authentication → JWT security: issues token
src/main/java/com/weatheradvisor/agent/controller/AuthController.java - User → Dashboard: opens
README.md - Dashboard → Web interface: displays
README.md - User → Weather search: searches city
README.md - Weather search → Weather retrieval: gets weather
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - Weather retrieval → Weather cache: reads/writes cache
src/main/java/com/weatheradvisor/agent/service/WeatherService.java - Weather retrieval → HTTP client: fetches data
src/main/java/com/weatheradvisor/agent/service/WeatherService.java - HTTP client → Weather provider: requests weather
README.md - Weather search → Search history: records search
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - User → Forecast endpoint: requests forecast
README.md - Forecast endpoint → Forecast: delegates
src/main/java/com/weatheradvisor/agent/controller/ForecastController.java - Weather search → Advisory service: requests advice
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - Advisory service → Recommendation engine: delegates
src/main/java/com/weatheradvisor/agent/service/AdvisoryService.java - Recommendation engine → AI recommendations: requests AI advice
src/main/java/com/weatheradvisor/agent/ai/RecommendationEngine.java - AI recommendations → Gemini API: sends prompt
src/main/java/com/weatheradvisor/agent/ai/GeminiService.java - Recommendation engine → Weather search: returns alerts
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - Weather search → Farmer advice: gets farm guidance
src/main/java/com/weatheradvisor/agent/controller/WeatherController.java - Weather scheduler → Scheduled refresh: triggers cycle
src/main/java/com/weatheradvisor/agent/scheduler/WeatherScheduler.java - Scheduled refresh → Favorites: loads cities
src/main/java/com/weatheradvisor/agent/service/AutomationService.java - Scheduled refresh → Weather retrieval: refreshes weather
src/main/java/com/weatheradvisor/agent/service/AutomationService.java - Scheduled refresh → Alert notifications: triggers alerts
src/main/java/com/weatheradvisor/agent/service/AutomationService.java - Alert notifications → Email delivery: sends email
src/main/java/com/weatheradvisor/agent/service/NotificationService.java - Admin dashboard → User service: manages users
src/main/java/com/weatheradvisor/agent/controller/AdminController.java - Admin dashboard → API logs: reads telemetry
src/main/java/com/weatheradvisor/agent/controller/AdminController.java - HTTP client → API logs: records calls
src/main/java/com/weatheradvisor/agent/util/ApiClient.java - User service → MySQL database: persists users
- Weather cache → MySQL database: stored in