# purvanshjoshi/price-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/purvanshjoshi/price-tracker
- Repository: https://github.com/purvanshjoshi/price-tracker

## Overview

Price Scout is a product-price comparison platform: a browser extension initiates a search, the Java API coordinates marketplace scraping, and results are sorted and persisted for price-history lookup. Its README also describes the extension’s in-page comparison UI and a separate prediction service; the latter’s model is implemented, but no connection from the Java backend is evidenced. Scraper, API, orchestration, and storage links below are supported by excerpts or the README; unsampled extension wiring is shown only where documented.

Main entry points: [`backend/src/main/java/com/pricetracker/engine/EngineManager.java`](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/EngineManager.java) (Search orchestrator), [`backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java) (Amazon scraper), [`backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java`](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java) (Flipkart scraper), [`backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java`](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java) (Croma scraper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser Extension"]
  node_content["Page injection<br/>[content.js]"]
  node_popup["Compare UI<br/>[popup.js]"]
  node_background["Extension background<br/>[background.js]"]
end

subgraph group_backend["Search Backend"]
  node_api["Search and history API<br/>[ApiServer.java]"]
  node_engine["Search orchestrator<br/>[EngineManager.java]"]
  node_product["Product result model<br/>[Product.java]"]
end

subgraph group_scraping["Marketplace Scraping"]
  node_scraperbase["Scraper task contract"]
  node_amazon["Amazon scraper<br/>[AmazonScraper.java]"]
  node_flipkart["Flipkart scraper"]
  node_croma["Croma scraper<br/>[CromaScraper.java]"]
  node_reliance["Reliance scraper"]
  node_driver["Stealth browser factory"]
  node_selectors["Selector configuration"]
end

subgraph group_data["History and Prediction"]
  node_dbmanager["History writer"]
  node_historydao["History reader"]
  node_database[("SQLite price history<br/>[price_history.db]")]
  node_migrations["Schema migrations"]
  node_predictionapi["Prediction service<br/>[main.py]"]
  node_predictor["Price trend predictor<br/>[price_predictor.py]"]
end

node_user(("Product-page user"))
node_stores["Retailer websites"]

node_user -->|"uses page"| node_content
node_content -->|"opens compare"| node_popup
node_popup -->|"requests search"| node_api
node_api -->|"dispatches search"| node_engine
node_engine -->|"submits task"| node_amazon
node_engine -->|"submits task"| node_flipkart
node_engine -->|"submits task"| node_croma
node_engine -->|"submits task"| node_reliance
node_amazon -->|"creates driver"| node_driver
node_flipkart -->|"creates driver"| node_driver
node_croma -->|"creates driver"| node_driver
node_reliance -->|"creates driver"| node_driver
node_amazon -->|"loads selectors"| node_selectors
node_flipkart -->|"loads selectors"| node_selectors
node_croma -->|"loads selectors"| node_selectors
node_reliance -->|"loads selectors"| node_selectors
node_amazon -->|"searches"| node_stores
node_flipkart -->|"searches"| node_stores
node_croma -->|"searches"| node_stores
node_reliance -->|"searches"| node_stores
node_amazon -->|"returns product"| node_product
node_flipkart -->|"returns product"| node_product
node_croma -->|"returns product"| node_product
node_reliance -->|"returns product"| node_product
node_engine -->|"saves results"| node_dbmanager
node_dbmanager -->|"inserts history"| node_database
node_api -->|"fetches history"| node_historydao
node_historydao -.->|"reads history"| node_database
node_predictionapi -->|"uses model"| node_predictor
node_background -.->|"communicates"| node_api

click node_content "https://github.com/purvanshjoshi/price-tracker/blob/master/extension/content.js"
click node_popup "https://github.com/purvanshjoshi/price-tracker/blob/master/extension/popup.js"
click node_background "https://github.com/purvanshjoshi/price-tracker/blob/master/extension/background.js"
click node_api "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/ApiServer.java"
click node_engine "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/EngineManager.java"
click node_product "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/model/Product.java"
click node_scraperbase "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/ScraperCallable.java"
click node_amazon "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java"
click node_flipkart "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java"
click node_croma "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java"
click node_reliance "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java"
click node_driver "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/WebDriverFactory.java"
click node_selectors "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/SelectorConfig.java"
click node_dbmanager "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/database/DatabaseManager.java"
click node_historydao "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/PriceHistoryDAO.java"
click node_database "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/price_history.db"
click node_migrations "https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/database/MigrationRunner.java"
click node_predictionapi "https://github.com/purvanshjoshi/price-tracker/blob/master/intelligence-service/app/main.py"
click node_predictor "https://github.com/purvanshjoshi/price-tracker/blob/master/intelligence-service/app/models/price_predictor.py"

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_content,node_popup,node_background,node_user toneBlue
class node_api,node_engine,node_product toneAmber
class node_scraperbase,node_amazon,node_flipkart,node_croma,node_reliance,node_driver,node_selectors toneMint
class node_dbmanager,node_historydao,node_database,node_migrations,node_predictionapi,node_predictor toneRose
class node_stores toneIndigo
```

## Components

### Browser Extension

- [Page injection](https://github.com/purvanshjoshi/price-tracker/blob/master/extension/content.js): `extension/content.js`
- [Compare UI](https://github.com/purvanshjoshi/price-tracker/blob/master/extension/popup.js): `extension/popup.js`
- [Extension background](https://github.com/purvanshjoshi/price-tracker/blob/master/extension/background.js): `extension/background.js`

### Search Backend

- [Search and history API](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/ApiServer.java): `backend/src/main/java/com/pricetracker/ApiServer.java`
- [Search orchestrator](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/EngineManager.java): `backend/src/main/java/com/pricetracker/engine/EngineManager.java`
- [Product result model](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/model/Product.java): `backend/src/main/java/com/pricetracker/model/Product.java`

### Marketplace Scraping

- [Scraper task contract](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/ScraperCallable.java): `backend/src/main/java/com/pricetracker/scrapers/ScraperCallable.java`
- [Amazon scraper](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java): `backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`
- [Flipkart scraper](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java): `backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java`
- [Croma scraper](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java): `backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java`
- [Reliance scraper](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java): `backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java`
- [Stealth browser factory](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/WebDriverFactory.java): `backend/src/main/java/com/pricetracker/engine/WebDriverFactory.java`
- [Selector configuration](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/SelectorConfig.java): `backend/src/main/java/com/pricetracker/engine/SelectorConfig.java`

### History and Prediction

- [History writer](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/database/DatabaseManager.java): `backend/src/main/java/com/pricetracker/database/DatabaseManager.java`
- [History reader](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/engine/PriceHistoryDAO.java): `backend/src/main/java/com/pricetracker/engine/PriceHistoryDAO.java`
- [SQLite price history](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/price_history.db): `backend/price_history.db`
- [Schema migrations](https://github.com/purvanshjoshi/price-tracker/blob/master/backend/src/main/java/com/pricetracker/database/MigrationRunner.java): `backend/src/main/java/com/pricetracker/database/MigrationRunner.java`
- [Prediction service](https://github.com/purvanshjoshi/price-tracker/blob/master/intelligence-service/app/main.py): `intelligence-service/app/main.py`
- [Price trend predictor](https://github.com/purvanshjoshi/price-tracker/blob/master/intelligence-service/app/models/price_predictor.py): `intelligence-service/app/models/price_predictor.py`

### Other components

- **Product-page user**
- **Retailer websites**

## Connections

- Product-page user → Page injection: uses page (evidence: `README.md`)
- Page injection → Compare UI: opens compare (evidence: `README.md`)
- Compare UI → Search and history API: requests search (evidence: `README.md`)
- Search and history API → Search orchestrator: dispatches search (evidence: `backend/src/main/java/com/pricetracker/ApiServer.java`)
- Search orchestrator → Amazon scraper: submits task (evidence: `backend/src/main/java/com/pricetracker/engine/EngineManager.java`)
- Search orchestrator → Flipkart scraper: submits task (evidence: `backend/src/main/java/com/pricetracker/engine/EngineManager.java`)
- Search orchestrator → Croma scraper: submits task (evidence: `backend/src/main/java/com/pricetracker/engine/EngineManager.java`)
- Search orchestrator → Reliance scraper: submits task (evidence: `backend/src/main/java/com/pricetracker/engine/EngineManager.java`)
- Amazon scraper → Stealth browser factory: creates driver (evidence: `backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`)
- Flipkart scraper → Stealth browser factory: creates driver (evidence: `backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java`)
- Croma scraper → Stealth browser factory: creates driver (evidence: `backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java`)
- Reliance scraper → Stealth browser factory: creates driver (evidence: `backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java`)
- Amazon scraper → Selector configuration: loads selectors (evidence: `backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`)
- Flipkart scraper → Selector configuration: loads selectors (evidence: `backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java`)
- Croma scraper → Selector configuration: loads selectors (evidence: `backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java`)
- Reliance scraper → Selector configuration: loads selectors (evidence: `backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java`)
- Amazon scraper → Retailer websites: searches (evidence: `backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`)
- Flipkart scraper → Retailer websites: searches (evidence: `README.md`)
- Croma scraper → Retailer websites: searches (evidence: `README.md`)
- Reliance scraper → Retailer websites: searches (evidence: `backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java`)
- Amazon scraper → Product result model: returns product (evidence: `backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java`)
- Flipkart scraper → Product result model: returns product (evidence: `backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java`)
- Croma scraper → Product result model: returns product (evidence: `backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java`)
- Reliance scraper → Product result model: returns product (evidence: `backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java`)
- Search orchestrator → History writer: saves results (evidence: `backend/src/main/java/com/pricetracker/engine/EngineManager.java`)
- History writer → SQLite price history: inserts history (evidence: `backend/src/main/java/com/pricetracker/database/DatabaseManager.java`)
- Search and history API → History reader: fetches history (evidence: `backend/src/main/java/com/pricetracker/ApiServer.java`)
- History reader → SQLite price history: reads history
- Prediction service → Price trend predictor: uses model (evidence: `intelligence-service/app/main.py`)
- Extension background → Search and history API: communicates
