# dietrich-xx/price_watcher_service architecture

> Architecture diagram of the GitHub repository dietrich-xx/price_watcher_service, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dietrich-xx/price_watcher_service
- Repository: https://github.com/dietrich-xx/price_watcher_service

## Overview

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: [`app/Services/PriceSubscriptionService.php`](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/PriceSubscriptionService.php) (Subscription service), [`app/Services/EmailVerificationService.php`](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/EmailVerificationService.php) (Email verification), [`app/Services/SubscriberService.php`](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/SubscriberService.php) (Subscriber service), [`app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php`](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php) (Subscription API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP entry points"]
  node_api["Subscription API"]
  node_request["Subscription request"]
  node_result["Subscription response"]
  node_verify_action["Verification endpoint"]
  node_resend_action["Resend verification"]
end

subgraph group_subscription["Subscriptions and identity"]
  node_subscribe["Subscription service"]
  node_subscription_data["Subscription DTO"]
  node_subscribe_result["Subscription result DTO"]
  node_subscriber_service["Subscriber service"]
  node_subscriber_result["Subscriber result DTO"]
end

subgraph group_tracking["Price tracking"]
  node_track_batch["Tracking batch"]
  node_track_job["Track listing<br/>[TrackPricesJob.php]"]
  node_tracker["Price tracker<br/>[PriceTracker.php]"]
  node_strategy["Tracking strategy"]
  node_html_strategy["HTML parsing"]
  node_graphql_strategy["GraphQL lookup"]
end

subgraph group_messaging["Email messaging"]
  node_verification["Email verification"]
  node_verify_mail["Verification email"]
  node_notify_batch["Notification batch"]
  node_notify_job["Price-change notification"]
  node_price_mail["Price-change email"]
end

subgraph group_persistence["Persistence"]
  node_subscription_repo["Subscription repository"]
  node_subscriber_repo["Subscriber repository"]
  node_subscription_model[("Price subscription")]
  node_subscriber_model[("Subscriber<br/>[Subscriber.php]")]
end

node_user(("Subscriber"))
node_olx(("OLX"))
node_mail_service(("Email provider"))

node_user -->|"submits URL"| node_api
node_api -.->|"validates input"| node_request
node_api -.->|"creates subscription"| node_subscribe
node_subscribe -->|"accepts data"| node_subscription_data
node_subscribe -->|"creates subscriber"| node_subscriber_service
node_subscribe -->|"finds listing"| node_subscription_repo
node_subscribe -->|"associates subscriber"| node_subscription_model
node_subscribe -->|"returns result"| node_subscribe_result
node_subscribe -.->|"formats response"| node_result
node_subscriber_service -->|"finds subscriber"| node_subscriber_repo
node_subscriber_service -->|"returns result"| node_subscriber_result
node_subscriber_service -->|"queues verification"| node_verification
node_user -->|"confirms email"| node_verify_action
node_verify_action -->|"verifies token"| node_verification
node_user -->|"requests resend"| node_resend_action
node_resend_action -.->|"resends email"| node_verification
node_verification -->|"updates verification"| node_subscriber_repo
node_verification -->|"sends verification"| node_verify_mail
node_verify_mail -->|"delivers email"| node_mail_service
node_track_batch -->|"dispatches batches"| node_track_job
node_track_job -.->|"checks price"| node_tracker
node_tracker -.->|"delegates lookup"| node_strategy
node_strategy -->|"selects configured mode"| node_html_strategy
node_strategy -->|"selects configured mode"| node_graphql_strategy
node_html_strategy -->|"parses listing"| node_olx
node_graphql_strategy -->|"queries listing"| node_olx
node_track_job -.->|"updates price"| node_subscription_repo
node_notify_batch -->|"dispatches batches"| node_notify_job
node_notify_job -->|"sends change notice"| node_price_mail
node_price_mail -->|"delivers email"| node_mail_service
node_subscription_repo -->|"persists listing"| node_subscription_model
node_subscriber_repo -->|"persists subscriber"| node_subscriber_model

click node_api "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php"
click node_request "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Requests/Api/V1/PriceSubscriptions/StorePriceSubscriptionRequest.php"
click node_result "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Resources/Api/V1/PriceSubscriptions/StorePriceSubscriptionResource.php"
click node_subscribe "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/PriceSubscriptionService.php"
click node_subscription_data "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/PriceSubscriptions/StorePriceSubscriptionData.php"
click node_subscribe_result "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/PriceSubscriptions/SubscribeResultData.php"
click node_subscriber_service "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/SubscriberService.php"
click node_subscriber_result "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/Subscribers/CreateSubscriberResultData.php"
click node_verify_action "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php"
click node_resend_action "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Api/V1/EmailVerifications/ResendVerificationEmailAction.php"
click node_verification "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/EmailVerificationService.php"
click node_verify_mail "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Mail/EmailVerificationMail.php"
click node_track_batch "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/TrackPrices/TrackPricesBatchJob.php"
click node_track_job "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/TrackPrices/TrackPricesJob.php"
click node_tracker "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/PriceTracker.php"
click node_strategy "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Interfaces/Strategies/PriceTrackerStrategyInterface.php"
click node_html_strategy "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Strategies/ParsingStrategy.php"
click node_graphql_strategy "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Strategies/GraphQLRemoteApiStrategy.php"
click node_notify_batch "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/NotifyPriceChanged/NotifyPriceChangedBatchJob.php"
click node_notify_job "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/NotifyPriceChanged/NotifyPriceChangedJob.php"
click node_price_mail "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Mail/PriceChangedMail.php"
click node_subscription_repo "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Repositories/PriceSubscriptionRepository.php"
click node_subscriber_repo "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Repositories/SubscriberRepository.php"
click node_subscription_model "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Models/PriceSubscription.php"
click node_subscriber_model "https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Models/Subscriber.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_request,node_result,node_verify_action,node_resend_action toneBlue
class node_subscribe,node_subscription_data,node_subscribe_result,node_subscriber_service,node_subscriber_result toneAmber
class node_track_batch,node_track_job,node_tracker,node_strategy,node_html_strategy,node_graphql_strategy toneMint
class node_verification,node_verify_mail,node_notify_batch,node_notify_job,node_price_mail toneRose
class node_subscription_repo,node_subscriber_repo,node_subscription_model,node_subscriber_model,node_user,node_olx,node_mail_service toneIndigo
```

## Components

### HTTP entry points

- [Subscription API](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php): `app/Http/Actions/Api/V1/PriceSubscriptions/StorePriceSubscriptionAction.php`
- [Subscription request](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Requests/Api/V1/PriceSubscriptions/StorePriceSubscriptionRequest.php): `app/Http/Requests/Api/V1/PriceSubscriptions/StorePriceSubscriptionRequest.php`
- [Subscription response](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Resources/Api/V1/PriceSubscriptions/StorePriceSubscriptionResource.php): `app/Http/Resources/Api/V1/PriceSubscriptions/StorePriceSubscriptionResource.php`
- [Verification endpoint](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php): `app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php`
- [Resend verification](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Http/Actions/Api/V1/EmailVerifications/ResendVerificationEmailAction.php): `app/Http/Actions/Api/V1/EmailVerifications/ResendVerificationEmailAction.php`

### Subscriptions and identity

- [Subscription service](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/PriceSubscriptionService.php): `app/Services/PriceSubscriptionService.php`
- [Subscription DTO](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/PriceSubscriptions/StorePriceSubscriptionData.php): `app/Data/PriceSubscriptions/StorePriceSubscriptionData.php`
- [Subscription result DTO](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/PriceSubscriptions/SubscribeResultData.php): `app/Data/PriceSubscriptions/SubscribeResultData.php`
- [Subscriber service](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/SubscriberService.php): `app/Services/SubscriberService.php`
- [Subscriber result DTO](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Data/Subscribers/CreateSubscriberResultData.php): `app/Data/Subscribers/CreateSubscriberResultData.php`

### Price tracking

- [Tracking batch](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/TrackPrices/TrackPricesBatchJob.php): `app/Jobs/TrackPrices/TrackPricesBatchJob.php`
- [Track listing](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/TrackPrices/TrackPricesJob.php): `app/Jobs/TrackPrices/TrackPricesJob.php`
- [Price tracker](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/PriceTracker.php): `app/Services/PriceTracker.php`
- [Tracking strategy](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Interfaces/Strategies/PriceTrackerStrategyInterface.php): `app/Interfaces/Strategies/PriceTrackerStrategyInterface.php`
- [HTML parsing](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Strategies/ParsingStrategy.php): `app/Strategies/ParsingStrategy.php`
- [GraphQL lookup](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Strategies/GraphQLRemoteApiStrategy.php): `app/Strategies/GraphQLRemoteApiStrategy.php`

### Email messaging

- [Email verification](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Services/EmailVerificationService.php): `app/Services/EmailVerificationService.php`
- [Verification email](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Mail/EmailVerificationMail.php): `app/Mail/EmailVerificationMail.php`
- [Notification batch](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/NotifyPriceChanged/NotifyPriceChangedBatchJob.php): `app/Jobs/NotifyPriceChanged/NotifyPriceChangedBatchJob.php`
- [Price-change notification](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Jobs/NotifyPriceChanged/NotifyPriceChangedJob.php): `app/Jobs/NotifyPriceChanged/NotifyPriceChangedJob.php`
- [Price-change email](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Mail/PriceChangedMail.php): `app/Mail/PriceChangedMail.php`

### Persistence

- [Subscription repository](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Repositories/PriceSubscriptionRepository.php): `app/Repositories/PriceSubscriptionRepository.php`
- [Subscriber repository](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Repositories/SubscriberRepository.php): `app/Repositories/SubscriberRepository.php`
- [Price subscription](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Models/PriceSubscription.php): `app/Models/PriceSubscription.php`
- [Subscriber](https://github.com/dietrich-xx/price_watcher_service/blob/main/app/Models/Subscriber.php): `app/Models/Subscriber.php`

### Other components

- **Subscriber**
- **OLX**
- **Email provider**

## Connections

- Subscriber → Subscription API: submits URL
- Subscription API → Subscription request: validates input
- Subscription API → Subscription service: creates subscription
- Subscription service → Subscription DTO: accepts data (evidence: `app/Services/PriceSubscriptionService.php`)
- Subscription service → Subscriber service: creates subscriber (evidence: `app/Services/PriceSubscriptionService.php`)
- Subscription service → Subscription repository: finds listing (evidence: `app/Services/PriceSubscriptionService.php`)
- Subscription service → Price subscription: associates subscriber (evidence: `app/Services/PriceSubscriptionService.php`)
- Subscription service → Subscription result DTO: returns result (evidence: `app/Services/PriceSubscriptionService.php`)
- Subscription service → Subscription response: formats response
- Subscriber service → Subscriber repository: finds subscriber (evidence: `app/Services/SubscriberService.php`)
- Subscriber service → Subscriber result DTO: returns result (evidence: `app/Services/SubscriberService.php`)
- Subscriber service → Email verification: queues verification (evidence: `app/Services/SubscriberService.php`)
- Subscriber → Verification endpoint: confirms email
- Verification endpoint → Email verification: verifies token (evidence: `app/Http/Actions/Web/EmailVerifications/EmailVerifyAction.php`)
- Subscriber → Resend verification: requests resend
- Resend verification → Email verification: resends email
- Email verification → Subscriber repository: updates verification (evidence: `app/Services/EmailVerificationService.php`)
- Email verification → Verification email: sends verification (evidence: `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 (evidence: `app/Providers/AppServiceProvider.php`)
- Tracking strategy → GraphQL lookup: selects configured mode (evidence: `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 (evidence: `app/Repositories/PriceSubscriptionRepository.php`)
- Subscriber repository → Subscriber: persists subscriber (evidence: `app/Repositories/SubscriberRepository.php`)
