How jayxdev/smart-shopping works
Smart Shopping serves two user-facing workflows: a personalized recommendation app and an analytics dashboard. In the app, customer and product CSVs are loaded, customer segments and product records are prepared, and a selected customer receives ranked recommendations with an optional Ollama-generated description; recommendation history is persisted in SQLite. The dashboard independently builds segments, profiles them, and generates targeting strategies. The graph follows the shown calls and documented capabilities; the dashboard excerpt is partial, so internal details beyond it are not inferred.
Main entry points: main.py Shopping App · dashboard.py Analytics Dashboard · ecommerce.db SQLite Database · recommendation_agent.py Recommendation Engine
Components 16
Recommendation App
- Shopping App
main.py - Recommendation Results
main.py - Recommendation History
main.py
Recommendation Engine
- Customer Segmentation
agents/customer_agent.py - Product Catalog Setup
agents/product_agent.py - Recommendation Engine
agents/recommendation_agent.py
Analytics Dashboard
- Analytics Dashboard
dashboard.py - Feature Preparation
dashboard.py - Dynamic Clustering
dashboard.py - Cluster Profiles
dashboard.py - Targeting Strategies
dashboard.py
Data and Persistence
- CSV Data Loader
utils/data_utils.py - Customer and Product CSVs
data - SQLite Database
ecommerce.db
Other components
- Shopper
- Ollama LLM
Connections 24
- Shopper → Shopping App: selects customer
README.md - Shopping App → CSV Data Loader: loads CSVs
main.py - CSV Data Loader → Customer and Product CSVs: reads
utils/data_utils.py - Shopping App → Customer Segmentation: segments customers
main.py - Customer Segmentation → SQLite Database: writes clusters
agents/customer_agent.py - Shopping App → Product Catalog Setup: prepares products
main.py - Product Catalog Setup → SQLite Database: stores product data
agents/product_agent.py - Shopper → Shopping App: requests recommendations
README.md - Shopping App → Recommendation Engine: requests ranking
main.py - Recommendation Engine → SQLite Database: reads clusters and similarity
agents/recommendation_agent.py - Recommendation Engine → SQLite Database: stores recommendations
agents/recommendation_agent.py - Recommendation Engine → Ollama LLM: requests description
agents/recommendation_agent.py - Shopping App → Ollama LLM: starts service
main.py - Shopping App → Recommendation Results: displays results
main.py - Shopping App → Customer Segmentation: requests segmentation plot
main.py - Shopping App → Recommendation History: queries history
main.py - Recommendation History → SQLite Database: reads history
main.py - Shopper → Analytics Dashboard: explores analytics
README.md - Analytics Dashboard → Customer and Product CSVs: loads data
README.md - Analytics Dashboard → Feature Preparation: prepares inputs
dashboard.py - Analytics Dashboard → Dynamic Clustering: creates clusters
dashboard.py - Dynamic Clustering → Feature Preparation: uses features
dashboard.py - Analytics Dashboard → Cluster Profiles: profiles segments
dashboard.py - Analytics Dashboard → Targeting Strategies: generates strategies
dashboard.py