How kiranrajdd/market works
This is a full-stack market-basket analysis and product-recommendation application. Customers authenticate, browse products, receive cart recommendations, and check out; admins manage datasets and users and inspect dashboards and association rules. Dataset ingestion feeds Apriori analysis, while checkout records transactions and broadcasts live events. The graph combines sampled source with README-documented capabilities; several route and page implementations were not excerpted, so their internal behavior is not expanded.
Main entry points: api.js API client · main.py FastAPI application · App.jsx App routing · transactions.py Checkout and history
Components 28
Web application
- App routing
frontend/src/App.jsx - Session context
frontend/src/context/AuthContext.jsx - API client
frontend/src/services/api.js - Product storefront
frontend/src/pages/ProductStorefrontPage.jsx - Live cart
frontend/src/pages/LiveCartPage.jsx - History and recommendations
frontend/src/pages/RecommendationPage.jsx - Dashboard
frontend/src/pages/DashboardPage.jsx - Dataset manager
frontend/src/pages/DatasetPage.jsx - Rules explorer
frontend/src/pages/AnalysisPage.jsx - Admin management
frontend/src/pages/AdminPage.jsx - Login page
frontend/src/pages/LoginPage.jsx
API and domain
- Authentication routes
backend/app/routes/auth.py - Product routes
backend/app/routes/products.py - Checkout and history
backend/app/routes/transactions.py - Analysis routes
backend/app/routes/analysis.py - Recommendation routes
backend/app/routes/recommendations.py - Dashboard routes
backend/app/routes/dashboard.py - User administration
backend/app/routes/admin.py - FastAPI application
backend/app/main.py
Analysis engine
- CSV preprocessing
backend/app/ml/preprocessing.py - Apriori mining
backend/app/ml/apriori_model.py - Rule recommender
backend/app/ml/recommender.py
Persistence and events
- Dataset loading
backend/app/services/dataset_service.py - Database session
backend/app/database.py - Domain records
backend/app/models.py - WebSocket broadcast
backend/app/websocket_manager.py
Other components
- Customer
- Administrator
Connections 48
- Customer → App routing: uses
README.md - Administrator → App routing: uses
README.md - App routing → Session context: provides session
frontend/src/App.jsx - App routing → Login page: routes to
frontend/src/App.jsx - App routing → Product storefront: routes to
frontend/src/App.jsx - App routing → Live cart: routes to
frontend/src/App.jsx - App routing → Dashboard: routes to
frontend/src/App.jsx - App routing → Dataset manager: routes to
frontend/src/App.jsx - App routing → Rules explorer: routes to
frontend/src/App.jsx - App routing → Admin management: routes to
frontend/src/App.jsx - Session context → API client: calls auth APIs
frontend/src/context/AuthContext.jsx - Login page → Session context: uses session
frontend/src/pages/LoginPage.jsx - Product storefront → API client: requests products
frontend/src/pages/ProductStorefrontPage.jsx - Live cart → API client: checks out
frontend/src/pages/LiveCartPage.jsx - History and recommendations → API client: requests recommendations
frontend/src/pages/RecommendationPage.jsx - Dashboard → API client: loads metrics
frontend/src/pages/DashboardPage.jsx - Dataset manager → API client: manages dataset
frontend/src/pages/DatasetPage.jsx - Rules explorer → API client: requests rules
frontend/src/pages/AnalysisPage.jsx - Admin management → API client: manages users
frontend/src/pages/AdminPage.jsx - API client → Authentication routes: calls auth endpoints
frontend/src/services/api.js - API client → Product routes: calls product endpoints
frontend/src/services/api.js - API client → Checkout and history: calls checkout endpoints
frontend/src/services/api.js - API client → Analysis routes: calls analysis endpoints
frontend/src/services/api.js - API client → Recommendation routes: calls recommendation endpoints
frontend/src/services/api.js - API client → Dashboard routes: calls dashboard endpoints
frontend/src/services/api.js - API client → User administration: calls admin endpoints
frontend/src/services/api.js - FastAPI application → Authentication routes: registers
backend/app/main.py - FastAPI application → Product routes: registers
backend/app/main.py - FastAPI application → Checkout and history: registers
backend/app/main.py - FastAPI application → Analysis routes: registers
backend/app/main.py - FastAPI application → Recommendation routes: registers
backend/app/main.py - FastAPI application → Dashboard routes: registers
backend/app/main.py - FastAPI application → User administration: registers
backend/app/main.py - FastAPI application → WebSocket broadcast: accepts admin sockets
backend/app/main.py - FastAPI application → Dataset loading: loads startup data
backend/app/main.py - FastAPI application → CSV preprocessing: validates startup CSV
backend/app/main.py - Authentication routes → Database session: gets sessions
backend/app/routes/auth.py - Authentication routes → Domain records: queries users
backend/app/routes/auth.py - User administration → Database session: gets sessions
backend/app/routes/admin.py - User administration → Domain records: manages accounts
backend/app/routes/admin.py - Product routes → Database session: gets sessions
backend/app/routes/products.py - Product routes → Domain records: queries products
backend/app/routes/products.py - Checkout and history → CSV preprocessing: validates uploads
backend/app/routes/transactions.py - Checkout and history → Dataset loading: loads uploaded data
backend/app/routes/transactions.py - Checkout and history → WebSocket broadcast: broadcasts checkout
backend/app/routes/transactions.py - Checkout and history → Rule recommender: generates suggestions
backend/app/routes/transactions.py - Analysis routes → Dataset loading: reads transactions
backend/app/routes/analysis.py - Analysis routes → Apriori mining: runs mining
backend/app/routes/analysis.py