How jez500/pricebuddy works
PriceBuddy is a self-hosted product price tracker. A user adds a product URL in the web app; PriceBuddy scrapes it on a schedule, records price and availability history, compares listings, and sends alerts when configured conditions are met. The graph also preserves product-source search, price insights, configurable scraping, and optional AI-assisted extraction and repair. Edges are limited to relationships stated in the README or visible in the supplied excerpts and SOURCE INDEX; unsampled subsystems are represented without speculative internal links.
Main entry points: Url.php Tracked listings · Product.php Product catalog · SearchService.php Product search · AiConfigHealer.php AI strategy repair
Components 20
User experience
- Web control room
app/Filament/Resources/ProductResource.php - REST API
app/Filament/Resources/ProductResource/Api/ProductApiService.php
Products and stores
- Product catalog
app/Models/Product.php - Tracked listings
app/Models/Url.php - Store strategies
app/Models/Store.php - Search sources
app/Models/ProductSource.php
Search and scraping
- Product search
app/Services/SearchService.php - Source scraper
app/Services/ProductSourceSearchService.php - Page scraper
app/Services/ScrapeUrl.php - Metadata extraction
app/Services/MetaExtractionService.php - AI strategy repair
app/Services/AiConfigHealer.php
Tracking and insights
- Price history
app/Models/Price.php - Price insights
app/Services/Insights/ProductInsights.php - Scheduled checks
app/Jobs/UpdateAllPricesJob.php
Alerts and integrations
- Alert delivery
app/Notifications/PriceAlertNotification.php - Notification channels
app/Notifications/Channels/AppriseChannel.php
Other components
- User
- Stores and search
- AI providers
- Notification services
Connections 24
- User → Web control room: tracks products
README.md - User → REST API: scripts tracking
README.md - Web control room → Product catalog: manages products
README.md - REST API → Product catalog: manages products
- Product catalog → Tracked listings: tracks listings
README.md - Tracked listings → Store strategies: resolves store
app/Models/Url.php - Tracked listings → Page scraper: scrapes page
app/Models/Url.php - Page scraper → Stores and search: fetches page
README.md - Scheduled checks → Tracked listings: checks listings
README.md - Tracked listings → Price history: records prices
README.md - Price history → Product catalog: updates price cache
app/Models/Price.php - Product catalog → Price insights: calculates insights
app/Models/Product.php - Product catalog → Alert delivery: triggers alerts
README.md - Alert delivery → Notification services: delivers alerts
README.md - Notification channels → Notification services: sends notifications
- User → Product search: searches products
README.md - Product search → Search sources: queries sources
app/Services/SearchService.php - Search sources → Source scraper: delegates search
app/Models/ProductSource.php - Source scraper → Stores and search: scrapes results
app/Services/ProductSourceSearchService.php - Product search → Store strategies: matches domains
app/Services/SearchService.php - User → Metadata extraction: extracts page data
- Metadata extraction → AI strategy repair: repairs strategy
app/Services/MetaExtractionService.php - Tracked listings → AI strategy repair: heals scrape config
app/Models/Url.php - AI strategy repair → AI providers: uses provider