How dietrich-xx/price_watcher_service works
Price Watcher Service accepts OLX listing subscriptions, verifies subscriber email, periodically checks listing prices, and emails verified subscribers when prices change. Its main path is API subscription → subscriber/listing association → scheduled batch tracking → change notification; email verification is a separate activation stage. The service/repository/model layer is shown where excerpts establish calls and persistence. Batch-job orchestration and some HTTP wiring are not excerpted, so those documented capability links cite the README rather than claiming source-level call details.
Main entry points: PriceSubscriptionService.php Subscription service · EmailVerificationService.php Email verification · SubscriberService.php Subscriber service · StorePriceSubscriptionAction.php Subscription API
Components 28
HTTP entry points
- Subscription API
app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php - Subscription request
app/Http/Requests/Api/V1/PriceSubscriptions/StorePriceSubscriptionRequest.php - Subscription response
app/Http/Resources/Api/V1/PriceSubscriptions/StorePriceSubscriptionResource.php - Verification endpoint
app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php - Resend verification
app/Http/Actions/Api/V1/EmailVerifications/ResendVerificationEmailAction.php
Subscriptions and identity
- Subscription service
app/Services/PriceSubscriptionService.php - Subscription DTO
app/Data/PriceSubscriptions/StorePriceSubscriptionData.php - Subscription result DTO
app/Data/PriceSubscriptions/SubscribeResultData.php - Subscriber service
app/Services/SubscriberService.php - Subscriber result DTO
app/Data/Subscribers/CreateSubscriberResultData.php
Price tracking
- Tracking batch
app/Jobs/TrackPrices/TrackPricesBatchJob.php - Track listing
app/Jobs/TrackPrices/TrackPricesJob.php - Price tracker
app/Services/PriceTracker.php - Tracking strategy
app/Interfaces/Strategies/PriceTrackerStrategyInterface.php - HTML parsing
app/Strategies/ParsingStrategy.php - GraphQL lookup
app/Strategies/GraphQLRemoteApiStrategy.php
Email messaging
- Email verification
app/Services/EmailVerificationService.php - Verification email
app/Mail/EmailVerificationMail.php - Notification batch
app/Jobs/NotifyPriceChanged/NotifyPriceChangedBatchJob.php - Price-change notification
app/Jobs/NotifyPriceChanged/NotifyPriceChangedJob.php - Price-change email
app/Mail/PriceChangedMail.php
Persistence
- Subscription repository
app/Repositories/PriceSubscriptionRepository.php - Subscriber repository
app/Repositories/SubscriberRepository.php - Price subscription
app/Models/PriceSubscription.php - Subscriber
app/Models/Subscriber.php
Other components
- Subscriber
- OLX
- Email provider
Connections 32
- Subscriber → Subscription API: submits URL
- Subscription API → Subscription request: validates input
- Subscription API → Subscription service: creates subscription
- Subscription service → Subscription DTO: accepts data
app/Services/PriceSubscriptionService.php - Subscription service → Subscriber service: creates subscriber
app/Services/PriceSubscriptionService.php - Subscription service → Subscription repository: finds listing
app/Services/PriceSubscriptionService.php - Subscription service → Price subscription: associates subscriber
app/Services/PriceSubscriptionService.php - Subscription service → Subscription result DTO: returns result
app/Services/PriceSubscriptionService.php - Subscription service → Subscription response: formats response
- Subscriber service → Subscriber repository: finds subscriber
app/Services/SubscriberService.php - Subscriber service → Subscriber result DTO: returns result
app/Services/SubscriberService.php - Subscriber service → Email verification: queues verification
app/Services/SubscriberService.php - Subscriber → Verification endpoint: confirms email
- Verification endpoint → Email verification: verifies token
app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php - Subscriber → Resend verification: requests resend
- Resend verification → Email verification: resends email
- Email verification → Subscriber repository: updates verification
app/Services/EmailVerificationService.php - Email verification → Verification email: sends verification
app/Services/EmailVerificationService.php - Verification email → Email provider: delivers email
- Tracking batch → Track listing: dispatches batches
- Track listing → Price tracker: checks price
- Price tracker → Tracking strategy: delegates lookup
- Tracking strategy → HTML parsing: selects configured mode
app/Providers/AppServiceProvider.php - Tracking strategy → GraphQL lookup: selects configured mode
app/Providers/AppServiceProvider.php - HTML parsing → OLX: parses listing
- GraphQL lookup → OLX: queries listing
- Track listing → Subscription repository: updates price
- Notification batch → Price-change notification: dispatches batches
- Price-change notification → Price-change email: sends change notice
- Price-change email → Email provider: delivers email
- Subscription repository → Price subscription: persists listing
app/Repositories/PriceSubscriptionRepository.php - Subscriber repository → Subscriber: persists subscriber
app/Repositories/SubscriberRepository.php