# sidhantsingla0-gif/onecart architecture

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

- Interactive diagram: https://gitdiagram.com/sidhantsingla0-gif/onecart
- Repository: https://github.com/sidhantsingla0-gif/onecart

## Overview

oneCart is a MERN storefront with a separate admin dashboard. Shoppers authenticate, browse the catalog, manage a persistent cart, and place and review orders; administrators authenticate separately to add products, manage inventory, and review orders. The React applications use shared contexts for identity and shopping state, while an Express API routes requests through authorization to controllers and MongoDB models. The README documents the broad client/API/database flow; some connections below are limited to source-index references because not all implementation files were excerpted.

Main entry points: [`backend/index.js`](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/index.js) (Express API), [`frontend/src/App.jsx`](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/App.jsx) (Storefront App), [`admin/src/App.jsx`](https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/App.jsx) (Admin Dashboard), [`backend/routes/orderRoutes.js`](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/orderRoutes.js) (Order Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopper["Storefront"]
  node_storefront["Storefront App<br/>[App.jsx]"]
  node_user_identity["User State<br/>[UserContext.jsx]"]
  node_shop_state["Shop &amp; Cart State<br/>[ShopContext.jsx]"]
  node_catalog_ui["Catalog &amp; Product Views<br/>[Collections.jsx]"]
  node_checkout_ui["Checkout &amp; Orders<br/>[PlaceOrder.jsx]"]
  node_axios_client["Axios Client<br/>[axios.js]"]
end

subgraph group_admin["Admin Dashboard"]
  node_admin_app["Admin Dashboard<br/>[App.jsx]"]
  node_admin_inventory["Product Management<br/>[Add.jsx]"]
  node_admin_orders["Order Management<br/>[Orders.jsx]"]
  node_admin_state["Admin State<br/>[AdminContext.jsx]"]
end

subgraph group_api["Backend API"]
  node_api_server["Express API<br/>[index.js]"]
  node_auth_routes["Auth &amp; User Routes<br/>[authRoute.js]"]
  node_product_routes["Product Routes<br/>[productRoute.js]"]
  node_cart_routes["Cart Routes<br/>[cartRoute.js]"]
  node_order_routes["Order Routes<br/>[orderRoutes.js]"]
  node_product_logic["Product Operations"]
  node_cart_logic["Cart Operations<br/>[cartController.js]"]
  node_order_logic["Order Operations<br/>[orderController.js]"]
  node_user_logic["User Lookup<br/>[userController.js]"]
  node_payment["Razorpay Payments<br/>[orderController.js]"]
end

subgraph group_identity["Identity &amp; Access"]
  node_auth_logic["Authentication Logic<br/>[authController.js]"]
  node_access_middleware["Access Checks<br/>[isAuth.js]"]
  node_admin_middleware["Admin Access<br/>[adminAuth.js]"]
end

subgraph group_data["Persistence &amp; Media"]
  node_user_store[("User Records<br/>[userModel.js]")]
  node_product_store[("Product Records<br/>[productModel.js]")]
  node_order_store[("Order Records<br/>[orderModel.js]")]
  node_mongo[("MongoDB<br/>[db.js]")]
  node_media_service["Cloudinary<br/>[cloudinary.js]"]
end

node_customer(("Shopper"))
node_admin_actor(("Administrator"))

node_customer -->|"uses"| node_storefront
node_storefront -->|"routes to"| node_catalog_ui
node_storefront -->|"routes to"| node_checkout_ui
node_storefront -->|"checks identity"| node_user_identity
node_shop_state -->|"reads identity"| node_user_identity
node_shop_state -->|"requests API"| node_axios_client
node_user_identity -->|"requests API"| node_axios_client
node_checkout_ui -->|"reads cart state"| node_shop_state
node_checkout_ui -->|"submits order"| node_axios_client
node_axios_client -->|"calls REST API"| node_api_server
node_admin_actor -->|"uses"| node_admin_app
node_admin_app -->|"routes to"| node_admin_inventory
node_admin_app -->|"routes to"| node_admin_orders
node_admin_app -->|"checks access"| node_admin_state
node_admin_state -->|"fetches admin"| node_api_server
node_api_server -->|"mounts routes"| node_auth_routes
node_api_server -->|"mounts routes"| node_product_routes
node_api_server -->|"mounts routes"| node_cart_routes
node_api_server -->|"mounts routes"| node_order_routes
node_auth_routes -->|"dispatches to"| node_auth_logic
node_auth_logic -->|"reads/writes"| node_user_store
node_auth_logic -.->|"issues JWT"| node_access_middleware
node_cart_routes -->|"guards requests"| node_access_middleware
node_cart_routes -->|"dispatches to"| node_cart_logic
node_cart_logic -->|"reads/writes"| node_user_store
node_order_routes -->|"guards user routes"| node_access_middleware
node_order_routes -->|"guards admin routes"| node_admin_middleware
node_order_routes -->|"dispatches to"| node_order_logic
node_order_logic -->|"reads/writes"| node_order_store
node_order_logic -->|"reads/writes"| node_user_store
node_order_logic -.->|"handles payment"| node_payment
node_product_routes -->|"guards changes"| node_admin_middleware
node_product_routes -->|"dispatches to"| node_product_logic
node_product_logic -->|"reads/writes"| node_product_store
node_product_logic -->|"uploads images"| node_media_service
node_user_logic -->|"reads user"| node_user_store
node_api_server -->|"connects database"| node_mongo

click node_storefront "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/App.jsx"
click node_user_identity "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/context/UserContext.jsx"
click node_shop_state "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/context/ShopContext.jsx"
click node_catalog_ui "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/pages/Collections.jsx"
click node_checkout_ui "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/pages/PlaceOrder.jsx"
click node_admin_app "https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/App.jsx"
click node_admin_inventory "https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/pages/Add.jsx"
click node_admin_orders "https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/pages/Orders.jsx"
click node_admin_state "https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/context/AdminContext.jsx"
click node_api_server "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/index.js"
click node_auth_routes "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/authRoute.js"
click node_product_routes "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/productRoute.js"
click node_cart_routes "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/cartRoute.js"
click node_order_routes "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/orderRoutes.js"
click node_auth_logic "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/authController.js"
click node_access_middleware "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/middleware/isAuth.js"
click node_admin_middleware "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/middleware/adminAuth.js"
click node_product_logic "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/productController.js"
click node_cart_logic "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/cartController.js"
click node_order_logic "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/orderController.js"
click node_user_logic "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/userController.js"
click node_user_store "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/userModel.js"
click node_product_store "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/productModel.js"
click node_order_store "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/orderModel.js"
click node_mongo "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/config/db.js"
click node_media_service "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/config/cloudinary.js"
click node_axios_client "https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/config/axios.js"
click node_payment "https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/orderController.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_storefront,node_user_identity,node_shop_state,node_catalog_ui,node_checkout_ui,node_axios_client toneBlue
class node_admin_app,node_admin_inventory,node_admin_orders,node_admin_state toneAmber
class node_api_server,node_auth_routes,node_product_routes,node_cart_routes,node_order_routes,node_product_logic,node_cart_logic,node_order_logic,node_user_logic,node_payment toneMint
class node_auth_logic,node_access_middleware,node_admin_middleware toneRose
class node_user_store,node_product_store,node_order_store,node_mongo,node_media_service,node_customer,node_admin_actor toneIndigo
```

## Components

### Storefront

- [Storefront App](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [User State](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/context/UserContext.jsx): `frontend/src/context/UserContext.jsx`
- [Shop & Cart State](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/context/ShopContext.jsx): `frontend/src/context/ShopContext.jsx`
- [Catalog & Product Views](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/pages/Collections.jsx): `frontend/src/pages/Collections.jsx`
- [Checkout & Orders](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/pages/PlaceOrder.jsx): `frontend/src/pages/PlaceOrder.jsx`
- [Axios Client](https://github.com/sidhantsingla0-gif/onecart/blob/main/frontend/src/config/axios.js): `frontend/src/config/axios.js`

### Admin Dashboard

- [Admin Dashboard](https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/App.jsx): `admin/src/App.jsx`
- [Product Management](https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/pages/Add.jsx): `admin/src/pages/Add.jsx`
- [Order Management](https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/pages/Orders.jsx): `admin/src/pages/Orders.jsx`
- [Admin State](https://github.com/sidhantsingla0-gif/onecart/blob/main/admin/src/context/AdminContext.jsx): `admin/src/context/AdminContext.jsx`

### Backend API

- [Express API](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/index.js): `backend/index.js`
- [Auth & User Routes](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/authRoute.js): `backend/routes/authRoute.js`
- [Product Routes](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/productRoute.js): `backend/routes/productRoute.js`
- [Cart Routes](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/cartRoute.js): `backend/routes/cartRoute.js`
- [Order Routes](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Product Operations](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/productController.js): `backend/controller/productController.js`
- [Cart Operations](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/cartController.js): `backend/controller/cartController.js`
- [Order Operations](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/orderController.js): `backend/controller/orderController.js`
- [User Lookup](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/userController.js): `backend/controller/userController.js`
- [Razorpay Payments](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/orderController.js): `backend/controller/orderController.js`

### Identity & Access

- [Authentication Logic](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/controller/authController.js): `backend/controller/authController.js`
- [Access Checks](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/middleware/isAuth.js): `backend/middleware/isAuth.js`
- [Admin Access](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/middleware/adminAuth.js): `backend/middleware/adminAuth.js`

### Persistence & Media

- [User Records](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/userModel.js): `backend/model/userModel.js`
- [Product Records](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/productModel.js): `backend/model/productModel.js`
- [Order Records](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/model/orderModel.js): `backend/model/orderModel.js`
- [MongoDB](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/config/db.js): `backend/config/db.js`
- [Cloudinary](https://github.com/sidhantsingla0-gif/onecart/blob/main/backend/config/cloudinary.js): `backend/config/cloudinary.js`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Storefront App: uses (evidence: `README.md`)
- Storefront App → Catalog & Product Views: routes to (evidence: `frontend/src/App.jsx`)
- Storefront App → Checkout & Orders: routes to (evidence: `frontend/src/App.jsx`)
- Storefront App → User State: checks identity (evidence: `frontend/src/App.jsx`)
- Shop & Cart State → User State: reads identity (evidence: `frontend/src/context/ShopContext.jsx`)
- Shop & Cart State → Axios Client: requests API (evidence: `frontend/src/context/ShopContext.jsx`)
- User State → Axios Client: requests API (evidence: `frontend/src/context/UserContext.jsx`)
- Checkout & Orders → Shop & Cart State: reads cart state (evidence: `frontend/src/pages/PlaceOrder.jsx`)
- Checkout & Orders → Axios Client: submits order (evidence: `frontend/src/pages/PlaceOrder.jsx`)
- Axios Client → Express API: calls REST API (evidence: `README.md`)
- Administrator → Admin Dashboard: uses (evidence: `README.md`)
- Admin Dashboard → Product Management: routes to (evidence: `admin/src/App.jsx`)
- Admin Dashboard → Order Management: routes to (evidence: `admin/src/App.jsx`)
- Admin Dashboard → Admin State: checks access (evidence: `admin/src/App.jsx`)
- Admin State → Express API: fetches admin (evidence: `admin/src/context/AdminContext.jsx`)
- Express API → Auth & User Routes: mounts routes (evidence: `backend/index.js`)
- Express API → Product Routes: mounts routes (evidence: `backend/index.js`)
- Express API → Cart Routes: mounts routes (evidence: `backend/index.js`)
- Express API → Order Routes: mounts routes (evidence: `backend/index.js`)
- Auth & User Routes → Authentication Logic: dispatches to (evidence: `backend/routes/authRoute.js`)
- Authentication Logic → User Records: reads/writes (evidence: `backend/controller/authController.js`)
- Authentication Logic → Access Checks: issues JWT
- Cart Routes → Access Checks: guards requests (evidence: `backend/routes/cartRoute.js`)
- Cart Routes → Cart Operations: dispatches to (evidence: `backend/routes/cartRoute.js`)
- Cart Operations → User Records: reads/writes (evidence: `backend/controller/cartController.js`)
- Order Routes → Access Checks: guards user routes (evidence: `backend/routes/orderRoutes.js`)
- Order Routes → Admin Access: guards admin routes (evidence: `backend/routes/orderRoutes.js`)
- Order Routes → Order Operations: dispatches to (evidence: `backend/routes/orderRoutes.js`)
- Order Operations → Order Records: reads/writes (evidence: `backend/controller/orderController.js`)
- Order Operations → User Records: reads/writes (evidence: `backend/controller/orderController.js`)
- Order Operations → Razorpay Payments: handles payment (evidence: `backend/controller/orderController.js`)
- Product Routes → Admin Access: guards changes (evidence: `backend/routes/productRoute.js`)
- Product Routes → Product Operations: dispatches to (evidence: `backend/routes/productRoute.js`)
- Product Operations → Product Records: reads/writes (evidence: `backend/controller/productController.js`)
- Product Operations → Cloudinary: uploads images (evidence: `backend/controller/productController.js`)
- User Lookup → User Records: reads user (evidence: `backend/controller/userController.js`)
- Express API → MongoDB: connects database (evidence: `backend/index.js`)
