# siddhant205singh-ctrl/apna-bazar architecture

> Architecture diagram of the GitHub repository siddhant205singh-ctrl/apna-bazar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddhant205singh-ctrl/apna-bazar
- Repository: https://github.com/siddhant205singh-ctrl/apna-bazar

## Overview

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: [`kirana_backend/server.js`](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/server.js) (API and socket server), [`kirana_frontend/src/App.jsx`](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/App.jsx) (Frontend router), [`kirana_backend/src/middleware/auth.js`](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/middleware/auth.js) (JWT authorization), [`kirana_backend/src/controllers/orderController.js`](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/orderController.js) (Order processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer storefront"]
  node_app["Frontend router<br/>[App.jsx]"]
  node_home["Product browsing<br/>[HomePage.jsx]"]
  node_cart["Cart state<br/>[CartContext.jsx]"]
  node_cart_checkout["Cart and checkout<br/>[CheckoutModal.jsx]"]
  node_customer_orders["Customer orders<br/>[OrdersPage.jsx]"]
  node_auth_ui["Authentication state<br/>[AuthContext.jsx]"]
  node_api_client["HTTP API client<br/>[api.js]"]
  node_socket_client["Realtime client<br/>[socket.js]"]
  node_socket_hook["Realtime events<br/>[useSocket.js]"]
end

subgraph group_owner["Owner operations"]
  node_owner_dashboard["Owner dashboard<br/>[DashboardPage.jsx]"]
  node_owner_orders["Order management"]
  node_owner_products["Product management<br/>[ProductsPage.jsx]"]
  node_owner_customers["Customer records<br/>[CustomersPage.jsx]"]
end

subgraph group_backend["Backend services"]
  node_server["API and socket server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[auth.js]"]
  node_product_routes["Product routes<br/>[products.js]"]
  node_order_routes["Order routes<br/>[orders.js]"]
  node_dashboard_routes["Dashboard routes<br/>[dashboard.js]"]
  node_auth_controller["Authentication logic<br/>[authController.js]"]
  node_product_controller["Catalog logic"]
  node_order_controller["Order processing<br/>[orderController.js]"]
  node_dashboard_controller["Dashboard data"]
  node_auth_middleware["JWT authorization<br/>[auth.js]"]
end

subgraph group_data["Domain data"]
  node_users[("Users<br/>[User.js]")]
  node_products[("Products<br/>[Product.js]")]
  node_orders[("Orders<br/>[Order.js]")]
end

node_customer_actor(("Customer"))
node_owner_actor(("Store owner"))
node_mongo[("MongoDB")]

node_customer_actor -->|"browses"| node_home
node_owner_actor -->|"manages"| node_owner_dashboard
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_customer_orders
node_app -->|"routes to"| node_owner_orders
node_app -->|"routes to"| node_owner_products
node_app -->|"routes to"| node_owner_customers
node_app -->|"routes to"| node_owner_dashboard
node_home -->|"updates"| node_cart
node_cart_checkout -->|"reads"| node_cart
node_cart_checkout -->|"submits order"| node_api_client
node_customer_orders -->|"fetches orders"| node_api_client
node_auth_ui -->|"authenticates"| node_api_client
node_auth_ui -->|"connects"| node_socket_client
node_customer_orders -->|"subscribes"| node_socket_hook
node_owner_orders -->|"subscribes"| node_socket_hook
node_socket_hook -->|"listens on"| node_socket_client
node_api_client -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_product_routes
node_server -->|"mounts"| node_order_routes
node_server -->|"mounts"| node_dashboard_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_product_routes -->|"dispatches"| node_product_controller
node_order_routes -->|"dispatches"| node_order_controller
node_dashboard_routes -->|"dispatches"| node_dashboard_controller
node_auth_routes -->|"protects"| node_auth_middleware
node_product_routes -->|"protects"| node_auth_middleware
node_order_routes -->|"protects"| node_auth_middleware
node_dashboard_routes -->|"protects"| node_auth_middleware
node_auth_middleware -->|"loads user"| node_users
node_auth_controller -->|"uses"| node_users
node_product_controller -->|"reads and writes"| node_products
node_order_controller -->|"validates items"| node_products
node_order_controller -->|"creates and updates"| node_orders
node_dashboard_controller -->|"queries"| node_orders
node_dashboard_controller -->|"queries"| node_products
node_dashboard_controller -->|"queries"| node_users
node_server -->|"connects"| node_mongo
node_server -.->|"emits realtime events"| node_socket_client
node_order_controller -->|"emits order events"| node_server

click node_app "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/App.jsx"
click node_home "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/HomePage.jsx"
click node_cart "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/context/CartContext.jsx"
click node_cart_checkout "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/CheckoutModal.jsx"
click node_customer_orders "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/OrdersPage.jsx"
click node_auth_ui "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/api/api.js"
click node_owner_dashboard "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/DashboardPage.jsx"
click node_owner_orders "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx"
click node_owner_products "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/ProductsPage.jsx"
click node_owner_customers "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/CustomersPage.jsx"
click node_socket_client "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/api/socket.js"
click node_socket_hook "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/hooks/useSocket.js"
click node_server "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/server.js"
click node_auth_routes "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/auth.js"
click node_product_routes "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/products.js"
click node_order_routes "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/orders.js"
click node_dashboard_routes "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/dashboard.js"
click node_auth_controller "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/authController.js"
click node_product_controller "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/productController.js"
click node_order_controller "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/orderController.js"
click node_dashboard_controller "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/dashboardController.js"
click node_auth_middleware "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/middleware/auth.js"
click node_users "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/User.js"
click node_products "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/Product.js"
click node_orders "https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/Order.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_home,node_cart,node_cart_checkout,node_customer_orders,node_auth_ui,node_api_client,node_socket_client,node_socket_hook toneBlue
class node_owner_dashboard,node_owner_orders,node_owner_products,node_owner_customers,node_mongo toneAmber
class node_server,node_auth_routes,node_product_routes,node_order_routes,node_dashboard_routes,node_auth_controller,node_product_controller,node_order_controller,node_dashboard_controller,node_auth_middleware toneMint
class node_users,node_products,node_orders toneRose
class node_customer_actor,node_owner_actor toneIndigo
```

## Components

### Customer storefront

- [Frontend router](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/App.jsx): `kirana_frontend/src/App.jsx`
- [Product browsing](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/HomePage.jsx): `kirana_frontend/src/pages/customer/HomePage.jsx`
- [Cart state](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/context/CartContext.jsx): `kirana_frontend/src/context/CartContext.jsx`
- [Cart and checkout](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/CheckoutModal.jsx): `kirana_frontend/src/pages/customer/CheckoutModal.jsx`
- [Customer orders](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/customer/OrdersPage.jsx): `kirana_frontend/src/pages/customer/OrdersPage.jsx`
- [Authentication state](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/context/AuthContext.jsx): `kirana_frontend/src/context/AuthContext.jsx`
- [HTTP API client](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/api/api.js): `kirana_frontend/src/api/api.js`
- [Realtime client](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/api/socket.js): `kirana_frontend/src/api/socket.js`
- [Realtime events](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/hooks/useSocket.js): `kirana_frontend/src/hooks/useSocket.js`

### Owner operations

- [Owner dashboard](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/DashboardPage.jsx): `kirana_frontend/src/pages/owner/DashboardPage.jsx`
- [Order management](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx): `kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx`
- [Product management](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/ProductsPage.jsx): `kirana_frontend/src/pages/owner/ProductsPage.jsx`
- [Customer records](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_frontend/src/pages/owner/CustomersPage.jsx): `kirana_frontend/src/pages/owner/CustomersPage.jsx`

### Backend services

- [API and socket server](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/server.js): `kirana_backend/server.js`
- [Authentication routes](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/auth.js): `kirana_backend/src/routes/auth.js`
- [Product routes](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/products.js): `kirana_backend/src/routes/products.js`
- [Order routes](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/orders.js): `kirana_backend/src/routes/orders.js`
- [Dashboard routes](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/routes/dashboard.js): `kirana_backend/src/routes/dashboard.js`
- [Authentication logic](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/authController.js): `kirana_backend/src/controllers/authController.js`
- [Catalog logic](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/productController.js): `kirana_backend/src/controllers/productController.js`
- [Order processing](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/orderController.js): `kirana_backend/src/controllers/orderController.js`
- [Dashboard data](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/controllers/dashboardController.js): `kirana_backend/src/controllers/dashboardController.js`
- [JWT authorization](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/middleware/auth.js): `kirana_backend/src/middleware/auth.js`

### Domain data

- [Users](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/User.js): `kirana_backend/src/models/User.js`
- [Products](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/Product.js): `kirana_backend/src/models/Product.js`
- [Orders](https://github.com/siddhant205singh-ctrl/apna-bazar/blob/main/kirana_backend/src/models/Order.js): `kirana_backend/src/models/Order.js`

### Other components

- **Customer**
- **Store owner**
- **MongoDB**

## Connections

- Customer → Product browsing: browses
- Store owner → Owner dashboard: manages
- Frontend router → Product browsing: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Frontend router → Customer orders: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Frontend router → Order management: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Frontend router → Product management: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Frontend router → Customer records: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Frontend router → Owner dashboard: routes to (evidence: `kirana_frontend/src/App.jsx`)
- Product browsing → Cart state: updates (evidence: `kirana_frontend/src/pages/customer/HomePage.jsx`)
- Cart and checkout → Cart state: reads (evidence: `kirana_frontend/src/pages/customer/CheckoutModal.jsx`)
- Cart and checkout → HTTP API client: submits order (evidence: `kirana_frontend/src/pages/customer/CheckoutModal.jsx`)
- Customer orders → HTTP API client: fetches orders (evidence: `kirana_frontend/src/pages/customer/OrdersPage.jsx`)
- Authentication state → HTTP API client: authenticates (evidence: `kirana_frontend/src/context/AuthContext.jsx`)
- Authentication state → Realtime client: connects (evidence: `kirana_frontend/src/context/AuthContext.jsx`)
- Customer orders → Realtime events: subscribes (evidence: `kirana_frontend/src/pages/customer/OrdersPage.jsx`)
- Order management → Realtime events: subscribes (evidence: `kirana_frontend/src/pages/owner/OwnerOrdersPage.jsx`)
- Realtime events → Realtime client: listens on (evidence: `kirana_frontend/src/hooks/useSocket.js`)
- HTTP API client → API and socket server: HTTP requests
- API and socket server → Authentication routes: mounts (evidence: `kirana_backend/server.js`)
- API and socket server → Product routes: mounts (evidence: `kirana_backend/server.js`)
- API and socket server → Order routes: mounts (evidence: `kirana_backend/server.js`)
- API and socket server → Dashboard routes: mounts (evidence: `kirana_backend/server.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `kirana_backend/src/routes/auth.js`)
- Product routes → Catalog logic: dispatches (evidence: `kirana_backend/src/routes/products.js`)
- Order routes → Order processing: dispatches (evidence: `kirana_backend/src/routes/orders.js`)
- Dashboard routes → Dashboard data: dispatches (evidence: `kirana_backend/src/routes/dashboard.js`)
- Authentication routes → JWT authorization: protects (evidence: `kirana_backend/src/routes/auth.js`)
- Product routes → JWT authorization: protects (evidence: `kirana_backend/src/routes/products.js`)
- Order routes → JWT authorization: protects (evidence: `kirana_backend/src/routes/orders.js`)
- Dashboard routes → JWT authorization: protects (evidence: `kirana_backend/src/routes/dashboard.js`)
- JWT authorization → Users: loads user (evidence: `kirana_backend/src/middleware/auth.js`)
- Authentication logic → Users: uses (evidence: `kirana_backend/src/controllers/authController.js`)
- Catalog logic → Products: reads and writes (evidence: `kirana_backend/src/controllers/productController.js`)
- Order processing → Products: validates items (evidence: `kirana_backend/src/controllers/orderController.js`)
- Order processing → Orders: creates and updates (evidence: `kirana_backend/src/controllers/orderController.js`)
- Dashboard data → Orders: queries (evidence: `kirana_backend/src/controllers/dashboardController.js`)
- Dashboard data → Products: queries (evidence: `kirana_backend/src/controllers/dashboardController.js`)
- Dashboard data → Users: queries (evidence: `kirana_backend/src/controllers/dashboardController.js`)
- API and socket server → MongoDB: connects (evidence: `kirana_backend/server.js`)
- API and socket server → Realtime client: emits realtime events
- Order processing → API and socket server: emits order events (evidence: `kirana_backend/src/controllers/orderController.js`)
