How alexmarqs/musicweather-api-clean-architecture works
MusiWeather is a Spring Boot API that returns a playlist suggestion based on current weather. The documented workflow accepts a city or coordinates, obtains the temperature, applies temperature-to-genre rules, and returns a Spotify playlist. The README names the clean/hexagonal architecture, external APIs, Redis, and both use cases; source excerpts were unavailable, so implementation-level calls and Redis behavior cannot be verified. Dashed edges mark those unverified links.
Main entry points: PlaylistWeatherController.java Playlist endpoint · GetPlaylistByCityNameUseCaseImpl.java City use case · GetPlaylistByCoordinatesUseCaseImpl.java Coordinates use case · PlaylistByCategoryPort.java Playlist lookup port
Components 13
HTTP API
- Playlist endpoint
src/main/java/example/musiweather/app/infrastructure/web/controller/v1/PlaylistWeatherController.java - Playlist response
src/main/java/example/musiweather/app/infrastructure/web/dto/PlaylistWeatherDTO.java
Playlist Use Cases
- City use case
src/main/java/example/musiweather/app/core/application/usecase/GetPlaylistByCityNameUseCaseImpl.java - Coordinates use case
src/main/java/example/musiweather/app/core/application/usecase/GetPlaylistByCoordinatesUseCaseImpl.java - Temperature categories
src/main/java/example/musiweather/app/core/domain/PlaylistCategory.java - Playlist lookup port
src/main/java/example/musiweather/app/core/application/port/out/PlaylistByCategoryPort.java
External Integrations
- Weather lookup
src/main/java/example/musiweather/app/infrastructure/openweathermap/OpenWeatherAdapter.java - Spotify playlist adapter
src/main/java/example/musiweather/app/infrastructure/spotify/SpotifyAdapter.java
Runtime Configuration
- Redis configuration
src/main/java/example/musiweather/app/infrastructure/configuration/CacheRedisConfiguration.java
Other components
- API caller
- OpenWeather API
- Spotify API
- Redis
Connections 14
- API caller → Playlist endpoint: requests playlist
README.md - Playlist endpoint → City use case: dispatches city
- Playlist endpoint → Coordinates use case: dispatches coordinates
- City use case → Weather lookup: gets weather
- Coordinates use case → Weather lookup: gets weather
- Weather lookup → OpenWeather API: requests temperature
README.md - City use case → Temperature categories: applies thresholds
- Coordinates use case → Temperature categories: applies thresholds
- City use case → Playlist lookup port: requests category playlist
- Coordinates use case → Playlist lookup port: requests category playlist
- Playlist lookup port → Spotify playlist adapter: implemented by
- Spotify playlist adapter → Spotify API: requests playlist
README.md - Playlist endpoint → Playlist response: returns suggestion
- Redis configuration → Redis: configures