How purvanshjoshi/price-tracker works
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: EngineManager.java Search orchestrator · AmazonScraper.java Amazon scraper · FlipkartScraper.java Flipkart scraper · CromaScraper.java Croma scraper
Components 21
Browser Extension
- Page injection
extension/content.js - Compare UI
extension/popup.js - Extension background
extension/background.js
Search Backend
- Search and history API
backend/src/main/java/com/pricetracker/ApiServer.java - Search orchestrator
backend/src/main/java/com/pricetracker/engine/EngineManager.java - Product result model
backend/src/main/java/com/pricetracker/model/Product.java
Marketplace Scraping
- Scraper task contract
backend/src/main/java/com/pricetracker/scrapers/ScraperCallable.java - Amazon scraper
backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java - Flipkart scraper
backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java - Croma scraper
backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java - Reliance scraper
backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java - Stealth browser factory
backend/src/main/java/com/pricetracker/engine/WebDriverFactory.java - Selector configuration
backend/src/main/java/com/pricetracker/engine/SelectorConfig.java
History and Prediction
- History writer
backend/src/main/java/com/pricetracker/database/DatabaseManager.java - History reader
backend/src/main/java/com/pricetracker/engine/PriceHistoryDAO.java - SQLite price history
backend/price_history.db - Schema migrations
backend/src/main/java/com/pricetracker/database/MigrationRunner.java - Prediction service
intelligence-service/app/main.py - Price trend predictor
intelligence-service/app/models/price_predictor.py
Other components
- Product-page user
- Retailer websites
Connections 30
- Product-page user → Page injection: uses page
README.md - Page injection → Compare UI: opens compare
README.md - Compare UI → Search and history API: requests search
README.md - Search and history API → Search orchestrator: dispatches search
backend/src/main/java/com/pricetracker/ApiServer.java - Search orchestrator → Amazon scraper: submits task
backend/src/main/java/com/pricetracker/engine/EngineManager.java - Search orchestrator → Flipkart scraper: submits task
backend/src/main/java/com/pricetracker/engine/EngineManager.java - Search orchestrator → Croma scraper: submits task
backend/src/main/java/com/pricetracker/engine/EngineManager.java - Search orchestrator → Reliance scraper: submits task
backend/src/main/java/com/pricetracker/engine/EngineManager.java - Amazon scraper → Stealth browser factory: creates driver
backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java - Flipkart scraper → Stealth browser factory: creates driver
backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java - Croma scraper → Stealth browser factory: creates driver
backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java - Reliance scraper → Stealth browser factory: creates driver
backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java - Amazon scraper → Selector configuration: loads selectors
backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java - Flipkart scraper → Selector configuration: loads selectors
backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java - Croma scraper → Selector configuration: loads selectors
backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java - Reliance scraper → Selector configuration: loads selectors
backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java - Amazon scraper → Retailer websites: searches
backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java - Flipkart scraper → Retailer websites: searches
README.md - Croma scraper → Retailer websites: searches
README.md - Reliance scraper → Retailer websites: searches
backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java - Amazon scraper → Product result model: returns product
backend/src/main/java/com/pricetracker/scrapers/AmazonScraper.java - Flipkart scraper → Product result model: returns product
backend/src/main/java/com/pricetracker/scrapers/FlipkartScraper.java - Croma scraper → Product result model: returns product
backend/src/main/java/com/pricetracker/scrapers/CromaScraper.java - Reliance scraper → Product result model: returns product
backend/src/main/java/com/pricetracker/scrapers/RelianceScraper.java - Search orchestrator → History writer: saves results
backend/src/main/java/com/pricetracker/engine/EngineManager.java - History writer → SQLite price history: inserts history
backend/src/main/java/com/pricetracker/database/DatabaseManager.java - Search and history API → History reader: fetches history
backend/src/main/java/com/pricetracker/ApiServer.java - History reader → SQLite price history: reads history
- Prediction service → Price trend predictor: uses model
intelligence-service/app/main.py - Extension background → Search and history API: communicates