Symfony Weather Reminder

Automated weather monitoring and personalized temperature alerts

Application Overview

Symfony Weather Reminder is a weather-fetching gateway providing data caching, user subscription management, and automated alerts triggered by temperature thresholds.

This application operates entirely within a Docker container environment and is based on the php-docker-dev-env architecture.

Application Core Logic

1. Authentication (JWT)

Stateless security model via lexik/jwt-authentication-bundle. User registration and secure token exchange for protected API access.

2. Orchestration & Caching

Implements a Cache-Aside pattern. Checks WeatherCacheRepository for fresh data before fetching from external APIs.

3. Threshold Logic

Support for tempLowerBoundary and tempUpperBoundary. Uses Stateful Alerting to prevent notification spam.

4. Asynchronous Pipeline

Decoupled logic using Symfony Messenger and Redis. Distributed across specialized worker containers.

Background Pipeline Steps

Step 1: Sync (Scheduler)

The scheduler identifies stale cities in the cache based on WEATHER_CACHE_TTL_MINUTES and initiates the update chain.

Step 2: Update (Workers)

Workers fetch live data from external providers, update the WeatherCache, and signal the detection stage.

Step 3: Detect (Logic)

Compares data against subscriptions. If a threshold is crossed, it sets the isTriggered flag to true and requests a notification.

Step 4: Notify & Email

Persists the Notification entity for user history and dispatches the email via Symfony Mailer.