How siddhant205singh-ctrl/apna-bazar works
Kirana is a grocery storefront with customer ordering and store-owner operations. Customers browse products, maintain a cart, authenticate, place orders, and track order status; owners manage products, orders, customers, and dashboard data. The frontend calls a Node/Express API backed by MongoDB models, with Socket.IO for order notifications. The graph preserves the documented-by-code feature areas; links for unsampled modules rely only on SOURCE INDEX references, so uncertain relationships are omitted.
Main entry points: server.js API and socket server · App.jsx Frontend router · auth.js JWT authorization · orderController.js Order processing
Components 29
Customer storefront
- Frontend router
kirana_frontend/src/App.jsx - Product browsing
kirana_frontend/src/pages/customer/HomePage.jsx - Cart state
kirana_frontend/src/context/CartContext.jsx - Cart and checkout
kirana_frontend/src/pages/customer/CheckoutModal.jsx - Customer orders
kirana_frontend/src/pages/customer/OrdersPage.jsx - Authentication state
kirana_frontend/src/context/AuthContext.jsx - HTTP API client
kirana_frontend/src/api/api.js - Realtime client
kirana_frontend/src/api/socket.js - Realtime events
kirana_frontend/src/hooks/useSocket.js
Owner operations
- Owner dashboard
kirana_frontend/src/pages/owner/DashboardPage.jsx - Order management
kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx - Product management
kirana_frontend/src/pages/owner/ProductsPage.jsx - Customer records
kirana_frontend/src/pages/owner/CustomersPage.jsx
Backend services
- API and socket server
kirana_backend/server.js - Authentication routes
kirana_backend/src/routes/auth.js - Product routes
kirana_backend/src/routes/products.js - Order routes
kirana_backend/src/routes/orders.js - Dashboard routes
kirana_backend/src/routes/dashboard.js - Authentication logic
kirana_backend/src/controllers/authController.js - Catalog logic
kirana_backend/src/controllers/productController.js - Order processing
kirana_backend/src/controllers/orderController.js - Dashboard data
kirana_backend/src/controllers/dashboardController.js - JWT authorization
kirana_backend/src/middleware/auth.js
Domain data
Other components
- Customer
- Store owner
- MongoDB
Connections 41
- Customer → Product browsing: browses
- Store owner → Owner dashboard: manages
- Frontend router → Product browsing: routes to
kirana_frontend/src/App.jsx - Frontend router → Customer orders: routes to
kirana_frontend/src/App.jsx - Frontend router → Order management: routes to
kirana_frontend/src/App.jsx - Frontend router → Product management: routes to
kirana_frontend/src/App.jsx - Frontend router → Customer records: routes to
kirana_frontend/src/App.jsx - Frontend router → Owner dashboard: routes to
kirana_frontend/src/App.jsx - Product browsing → Cart state: updates
kirana_frontend/src/pages/customer/HomePage.jsx - Cart and checkout → Cart state: reads
kirana_frontend/src/pages/customer/CheckoutModal.jsx - Cart and checkout → HTTP API client: submits order
kirana_frontend/src/pages/customer/CheckoutModal.jsx - Customer orders → HTTP API client: fetches orders
kirana_frontend/src/pages/customer/OrdersPage.jsx - Authentication state → HTTP API client: authenticates
kirana_frontend/src/context/AuthContext.jsx - Authentication state → Realtime client: connects
kirana_frontend/src/context/AuthContext.jsx - Customer orders → Realtime events: subscribes
kirana_frontend/src/pages/customer/OrdersPage.jsx - Order management → Realtime events: subscribes
kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx - Realtime events → Realtime client: listens on
kirana_frontend/src/hooks/useSocket.js - HTTP API client → API and socket server: HTTP requests
- API and socket server → Authentication routes: mounts
kirana_backend/server.js - API and socket server → Product routes: mounts
kirana_backend/server.js - API and socket server → Order routes: mounts
kirana_backend/server.js - API and socket server → Dashboard routes: mounts
kirana_backend/server.js - Authentication routes → Authentication logic: dispatches
kirana_backend/src/routes/auth.js - Product routes → Catalog logic: dispatches
kirana_backend/src/routes/products.js - Order routes → Order processing: dispatches
kirana_backend/src/routes/orders.js - Dashboard routes → Dashboard data: dispatches
kirana_backend/src/routes/dashboard.js - Authentication routes → JWT authorization: protects
kirana_backend/src/routes/auth.js - Product routes → JWT authorization: protects
kirana_backend/src/routes/products.js - Order routes → JWT authorization: protects
kirana_backend/src/routes/orders.js - Dashboard routes → JWT authorization: protects
kirana_backend/src/routes/dashboard.js - JWT authorization → Users: loads user
kirana_backend/src/middleware/auth.js - Authentication logic → Users: uses
kirana_backend/src/controllers/authController.js - Catalog logic → Products: reads and writes
kirana_backend/src/controllers/productController.js - Order processing → Products: validates items
kirana_backend/src/controllers/orderController.js - Order processing → Orders: creates and updates
kirana_backend/src/controllers/orderController.js - Dashboard data → Orders: queries
kirana_backend/src/controllers/dashboardController.js - Dashboard data → Products: queries
kirana_backend/src/controllers/dashboardController.js - Dashboard data → Users: queries
kirana_backend/src/controllers/dashboardController.js - API and socket server → MongoDB: connects
kirana_backend/server.js - API and socket server → Realtime client: emits realtime events
- Order processing → API and socket server: emits order events
kirana_backend/src/controllers/orderController.js