How mahekagrwl/shopmind-ai works
ShopMind AI is a retail POS and store-management application. The main workflow is landing and authentication, store onboarding, then dashboard navigation to billing and operational features; the frontend calls a FastAPI backend that manages business data and analytics. The graph preserves the documented UI feature areas, including customer, reporting, and AI tools. Source excerpts show selected component calls and backend behavior; other UI relationships rely on the SOURCE INDEX, and unsampled backend routes are not expanded.
Main entry points: App.tsx App navigation · api.ts API client · main.py FastAPI routes · LandingPage.tsx Landing page
Components 24
Entry & Setup
- Landing page
frontend/src/components/LandingPage.tsx - Authentication
frontend/src/components/AuthModal.tsx - Store onboarding
frontend/src/components/OnboardingWizard.tsx - Category configuration
frontend/src/config/categories.ts
Retail Operations
- Dashboard
frontend/src/components/DashboardOverview.tsx - POS checkout
frontend/src/components/POSView.tsx - Product catalog
frontend/src/components/ProductsView.tsx - Inventory
frontend/src/components/InventoryView.tsx - Suppliers
frontend/src/components/SuppliersView.tsx - Wastage
frontend/src/components/WastageView.tsx - Employees
frontend/src/components/EmployeesView.tsx - Customers
frontend/src/components/CustomersView.tsx
Insights & Engagement
- Demand forecasting
frontend/src/components/AIDemandForecastingView.tsx - What-if simulator
frontend/src/components/WhatIfSimulatorView.tsx - Reports
frontend/src/components/ReportsView.tsx - Notifications
frontend/src/components/NotificationsView.tsx - Customer portal
frontend/src/components/CustomerPortalView.tsx - AI assistant
frontend/src/components/AIAssistantModal.tsx
Application & API
- App navigation
frontend/src/App.tsx - API client
frontend/src/services/api.ts
Backend & State
- FastAPI routes
backend/main.py - Domain models
backend/models.py - In-memory store
backend/database.py
Other components
- Shop owner / staff
Connections 36
- Shop owner / staff → Landing page: opens
frontend/src/components/LandingPage.tsx - Shop owner / staff → Authentication: signs in
frontend/src/components/AuthModal.tsx - Shop owner / staff → Store onboarding: sets up store
frontend/src/components/OnboardingWizard.tsx - Landing page → Category configuration: uses categories
frontend/src/components/LandingPage.tsx - Store onboarding → Category configuration: uses categories
frontend/src/components/OnboardingWizard.tsx - App navigation → Landing page: renders
frontend/src/App.tsx - App navigation → Authentication: renders
frontend/src/App.tsx - App navigation → Store onboarding: renders
frontend/src/App.tsx - App navigation → Dashboard: renders
frontend/src/App.tsx - App navigation → POS checkout: renders
frontend/src/App.tsx - App navigation → Product catalog: renders
frontend/src/App.tsx - App navigation → Inventory: renders
frontend/src/App.tsx - App navigation → Suppliers: renders
frontend/src/App.tsx - App navigation → Wastage: renders
frontend/src/App.tsx - App navigation → Employees: renders
frontend/src/App.tsx - App navigation → Customers: renders
frontend/src/App.tsx - App navigation → Demand forecasting: renders
frontend/src/App.tsx - App navigation → What-if simulator: renders
frontend/src/App.tsx - App navigation → Reports: renders
frontend/src/App.tsx - App navigation → Notifications: renders
frontend/src/App.tsx - App navigation → Customer portal: renders
frontend/src/App.tsx - App navigation → AI assistant: renders
frontend/src/App.tsx - Authentication → API client: sends auth requests
frontend/src/components/AuthModal.tsx - POS checkout → API client: submits checkout
frontend/src/components/POSView.tsx - Product catalog → API client: manages products
frontend/src/components/ProductsView.tsx - Inventory → API client: requests data
frontend/src/components/InventoryView.tsx - Suppliers → API client: requests data
frontend/src/components/SuppliersView.tsx - Wastage → API client: requests data
frontend/src/components/WastageView.tsx - Employees → API client: requests data
frontend/src/components/EmployeesView.tsx - Customers → API client: requests data
frontend/src/components/CustomersView.tsx - Notifications → API client: requests data
frontend/src/components/NotificationsView.tsx - What-if simulator → API client: requests data
frontend/src/components/WhatIfSimulatorView.tsx - App navigation → API client: loads store data
frontend/src/App.tsx - API client → FastAPI routes: sends HTTP requests
frontend/src/services/api.ts - FastAPI routes → Domain models: validates payloads
backend/main.py - FastAPI routes → In-memory store: reads and writes
backend/main.py