How sneakysolo/wrap-it-up works
Wrap-it-up generates an on-demand Spotify listening summary through an asynchronous, Kafka-driven pipeline. A user authenticates, starts a generation, and can poll for status and retrieve the completed result; repeat requests may use the Redis cache. The README documents the cross-service event flow and analytics capabilities. Source excerpts show the gateway, request orchestration, Spotify snapshot fetching and normalization, and cache behavior; analyzer internals and some event-consumer wiring are not sampled.
Main entry points: WrapController.java Wrap API · FrontendController.java Gateway frontend · SpotifySnapshotListener.java Snapshot listener · WrapAnalysisCompletedConsumer.java Analysis result consumer
Components 22
User experience
- Gateway frontend
gateway-service/src/main/java/com/wrapitup/gateway/FrontendController.java - Wrap result model
common/src/main/java/com/wrapitup/common/dto/WrapResponse.java
Spotify identity
- OAuth and identity
auth-service/src/main/java/com/wrapitup/auth/controller/AuthController.java - Spotify user context
auth-service/src/main/java/com/wrapitup/auth/service/SpotifyUserContextService.java
Generation orchestration
- Wrap API
wrap-service/src/main/java/com/wrapitup/wrap/controller/WrapController.java - Generation state
wrap-service/src/main/java/com/wrapitup/wrap/service/GenerationStateService.java - Generation request publisher
wrap-service/src/main/java/com/wrapitup/wrap/service/WrapGenerationRequestedProducer.java - Analysis result consumer
wrap-service/src/main/java/com/wrapitup/wrap/kafka/WrapAnalysisCompletedConsumer.java - Failure consumer
wrap-service/src/main/java/com/wrapitup/wrap/kafka/WrapGenerationFailedConsumer.java - Completed wrap cache
wrap-service/src/main/java/com/wrapitup/wrap/cache/WrapCacheService.java
Listening data
- Generation request consumer
spotify-service/src/main/java/com/wrapitup/spotify/event/WrapGenerationRequestedConsumer.java - Listening snapshot fetcher
spotify-service/src/main/java/com/wrapitup/spotify/service/SpotifyListeningSnapshotService.java - Spotify API client
spotify-service/src/main/java/com/wrapitup/spotify/client/SpotifyApiClient.java - Data normalizer
spotify-service/src/main/java/com/wrapitup/spotify/service/SpotifyDataNormalizer.java
Wrap analysis
- Snapshot listener
analysis-service/src/main/java/com/wrapitup/analysis/kafka/SpotifySnapshotListener.java - Listening analyzers
analysis-service/src/main/java/com/wrapitup/analysis/analyzer - Personality engine
analysis-service/src/main/java/com/wrapitup/analysis/engine/PersonalityEngine.java
Other components
- Listener
- Spotify OAuth and profile
- Kafka events
- Spotify Web API
- Redis
Connections 26
- Listener → Gateway frontend: starts wrap
README.md - Gateway frontend → OAuth and identity: checks session
gateway-service/src/main/java/com/wrapitup/gateway/FrontendController.java - OAuth and identity → Spotify user context: resolves account
auth-service/src/main/java/com/wrapitup/auth/controller/AuthController.java - Spotify user context → Spotify OAuth and profile: fetches profile
auth-service/src/main/java/com/wrapitup/auth/service/SpotifyUserContextService.java - Gateway frontend → Wrap API: starts and polls
gateway-service/src/main/java/com/wrapitup/gateway/FrontendController.java - Wrap API → OAuth and identity: resolves account
wrap-service/src/main/java/com/wrapitup/wrap/controller/WrapController.java - Wrap API → Completed wrap cache: checks or reads
wrap-service/src/main/java/com/wrapitup/wrap/controller/WrapController.java - Wrap API → Generation state: tracks status
wrap-service/src/main/java/com/wrapitup/wrap/controller/WrapController.java - Wrap API → Generation request publisher: publishes request
wrap-service/src/main/java/com/wrapitup/wrap/controller/WrapController.java - Generation request publisher → Kafka events: publishes event
README.md - Kafka events → Generation request consumer: delivers request
README.md - Generation request consumer → Listening snapshot fetcher: fetches snapshot
README.md - Listening snapshot fetcher → Spotify API client: requests listening data
spotify-service/src/main/java/com/wrapitup/spotify/service/SpotifyListeningSnapshotService.java - Spotify API client → Spotify Web API: fetches Spotify data
spotify-service/src/main/java/com/wrapitup/spotify/client/SpotifyApiClient.java - Listening snapshot fetcher → Data normalizer: normalizes responses
spotify-service/src/main/java/com/wrapitup/spotify/service/SpotifyListeningSnapshotService.java - Generation request consumer → Kafka events: publishes snapshot
README.md - Kafka events → Snapshot listener: delivers snapshot
README.md - Snapshot listener → Listening analyzers: runs analytics
README.md - Snapshot listener → Personality engine: runs personality rules
README.md - Snapshot listener → Kafka events: publishes result
README.md - Kafka events → Analysis result consumer: delivers result
README.md - Analysis result consumer → Completed wrap cache: caches completed wrap
README.md - Completed wrap cache → Redis: reads and writes
wrap-service/src/main/java/com/wrapitup/wrap/cache/WrapCacheService.java - Kafka events → Failure consumer: delivers failure
README.md - Analysis result consumer → Wrap result model: stores result shape
- Gateway frontend → Wrap result model: renders retrieved wrap
gateway-service/src/main/java/com/wrapitup/gateway/FrontendController.java