# niravhingu/cartify-ecommerce architecture

> Architecture diagram of the GitHub repository niravhingu/cartify-ecommerce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/niravhingu/cartify-ecommerce
- Repository: https://github.com/niravhingu/cartify-ecommerce

## Overview

Cartify is a full-stack e-commerce store. Shoppers discover and filter products, manage a database-backed cart, submit checkout details, receive server-calculated totals, and place orders; demo payment methods do not move money. Account, wishlist, reviews, support, and order tracking complement the shopping flow, while administrators manage catalog, orders, users, payments, and analytics. The graph separates the React experience, Express routing, domain operations, and PostgreSQL access. Some UI and controller files were not sampled, so their documented capabilities are shown without asserting unverified internal calls.

Main entry points: [`Cartify/src/App.jsx`](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/App.jsx) (React app and routes), [`Cartify/src/api.js`](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/api.js) (API client), [`backend/routes/orderRoutes.js`](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/routes/orderRoutes.js) (Customer API routes), [`backend/controllers/orderController.js`](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/orderController.js) (Order operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Shopper experience"]
  node_app["React app and routes<br/>[App.jsx]"]
  node_catalog["Browse and search<br/>[Products.jsx]"]
  node_product["Product details and reviews<br/>[ProductDetails.jsx]"]
  node_cart["Cart and checkout<br/>[Checkout.jsx]"]
  node_payment["Demo payment<br/>[Payment.jsx]"]
  node_ordersui["Orders and receipt<br/>[MyOrders.jsx]"]
  node_account["Account and profile<br/>[Login.jsx]"]
  node_wishlist["Wishlist and support<br/>[Wishlist.jsx]"]
  node_storecontext["Store state<br/>[StoreContext.jsx]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_admin["Store administration"]
  node_adminui["Admin console<br/>[AdminProducts.jsx]"]
  node_adminui2["Admin analytics and operations<br/>[AdminAnalytics.jsx]"]
end

subgraph group_http["Backend API"]
  node_server["Express application<br/>[app.js]"]
  node_routes["Customer API routes<br/>[orderRoutes.js]"]
  node_adminroutes["Admin API routes<br/>[adminRoutes.js]"]
end

subgraph group_domain["Commerce operations"]
  node_products["Product operations"]
  node_orders["Order operations<br/>[orderController.js]"]
  node_orderlogic["Order lifecycle<br/>[orderService.js]"]
  node_pricing["Pricing rules<br/>[pricing.js]"]
  node_adminops["Admin operations"]
end

subgraph group_state["Persistence and security"]
  node_auth["Session authentication<br/>[authMiddleware.js]"]
  node_dbpool["PostgreSQL connection pool<br/>[db.js]"]
end

node_shopper(("Shopper"))
node_adminactor(("Administrator"))
node_database[("PostgreSQL database")]

node_shopper -->|"uses"| node_app
node_adminactor -->|"manages store"| node_adminui
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_cart
node_app -->|"routes to"| node_payment
node_app -->|"routes to"| node_ordersui
node_app -->|"provides state"| node_storecontext
node_app -->|"routes to"| node_adminui
node_catalog -.->|"requests catalog"| node_api
node_product -.->|"requests details"| node_api
node_cart -.->|"submits checkout"| node_api
node_payment -->|"requests payment"| node_api
node_adminui -->|"requests changes"| node_api
node_adminui2 -->|"requests analytics"| node_api
node_api -->|"sends HTTP requests"| node_server
node_server -->|"mounts routes"| node_routes
node_server -->|"mounts routes"| node_adminroutes
node_routes -->|"dispatches requests"| node_orders
node_routes -->|"dispatches requests"| node_products
node_adminroutes -->|"mounts product routes"| node_adminops
node_orders -->|"calculates totals"| node_pricing
node_orders -->|"updates order status"| node_orderlogic
node_orders -->|"reads and writes"| node_dbpool
node_products -->|"queries catalog"| node_dbpool
node_adminops -->|"manages products"| node_dbpool
node_dbpool -->|"connects to"| node_database
node_routes -->|"protects requests"| node_auth
node_adminroutes -->|"checks login"| node_auth

click node_app "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/App.jsx"
click node_catalog "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Products.jsx"
click node_product "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/ProductDetails.jsx"
click node_cart "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Checkout.jsx"
click node_payment "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Payment.jsx"
click node_ordersui "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/MyOrders.jsx"
click node_account "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Login.jsx"
click node_wishlist "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Wishlist.jsx"
click node_storecontext "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/context/StoreContext.jsx"
click node_api "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/api.js"
click node_adminui "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/admin_Dashboard/pages/AdminProducts.jsx"
click node_adminui2 "https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/admin_Dashboard/pages/AdminAnalytics.jsx"
click node_server "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/app.js"
click node_routes "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/routes/orderRoutes.js"
click node_adminroutes "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/routes/admin/adminRoutes.js"
click node_products "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/productController.js"
click node_orders "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/orderController.js"
click node_orderlogic "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/services/orderService.js"
click node_pricing "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/utils/pricing.js"
click node_adminops "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/admin/productController.js"
click node_auth "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/middleware/authMiddleware.js"
click node_dbpool "https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/config/db.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_catalog,node_product,node_cart,node_payment,node_ordersui,node_account,node_wishlist,node_storecontext,node_api toneBlue
class node_adminui,node_adminui2,node_database toneAmber
class node_server,node_routes,node_adminroutes toneMint
class node_products,node_orders,node_orderlogic,node_pricing,node_adminops toneRose
class node_auth,node_dbpool,node_shopper,node_adminactor toneIndigo
```

## Components

### Shopper experience

- [React app and routes](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/App.jsx): `Cartify/src/App.jsx`
- [Browse and search](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Products.jsx): `Cartify/src/pages/Products.jsx`
- [Product details and reviews](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/ProductDetails.jsx): `Cartify/src/pages/ProductDetails.jsx`
- [Cart and checkout](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Checkout.jsx): `Cartify/src/pages/Checkout.jsx`
- [Demo payment](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Payment.jsx): `Cartify/src/pages/Payment.jsx`
- [Orders and receipt](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/MyOrders.jsx): `Cartify/src/pages/MyOrders.jsx`
- [Account and profile](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Login.jsx): `Cartify/src/pages/Login.jsx`
- [Wishlist and support](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/pages/Wishlist.jsx): `Cartify/src/pages/Wishlist.jsx`
- [Store state](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/context/StoreContext.jsx): `Cartify/src/context/StoreContext.jsx`
- [API client](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/api.js): `Cartify/src/api.js`

### Store administration

- [Admin console](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/admin_Dashboard/pages/AdminProducts.jsx): `Cartify/src/admin_Dashboard/pages/AdminProducts.jsx`
- [Admin analytics and operations](https://github.com/niravhingu/cartify-ecommerce/blob/main/Cartify/src/admin_Dashboard/pages/AdminAnalytics.jsx): `Cartify/src/admin_Dashboard/pages/AdminAnalytics.jsx`

### Backend API

- [Express application](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/app.js): `backend/app.js`
- [Customer API routes](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Admin API routes](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/routes/admin/adminRoutes.js): `backend/routes/admin/adminRoutes.js`

### Commerce operations

- [Product operations](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Order operations](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Order lifecycle](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/services/orderService.js): `backend/services/orderService.js`
- [Pricing rules](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/utils/pricing.js): `backend/utils/pricing.js`
- [Admin operations](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/controllers/admin/productController.js): `backend/controllers/admin/productController.js`

### Persistence and security

- [Session authentication](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [PostgreSQL connection pool](https://github.com/niravhingu/cartify-ecommerce/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Shopper**
- **Administrator**
- **PostgreSQL database**

## Connections

- Shopper → React app and routes: uses (evidence: `Cartify/src/App.jsx`)
- Administrator → Admin console: manages store
- React app and routes → Browse and search: routes to (evidence: `Cartify/src/App.jsx`)
- React app and routes → Product details and reviews: routes to (evidence: `Cartify/src/App.jsx`)
- React app and routes → Cart and checkout: routes to (evidence: `Cartify/src/App.jsx`)
- React app and routes → Demo payment: routes to (evidence: `Cartify/src/App.jsx`)
- React app and routes → Orders and receipt: routes to (evidence: `Cartify/src/App.jsx`)
- React app and routes → Store state: provides state (evidence: `Cartify/src/App.jsx`)
- React app and routes → Admin console: routes to (evidence: `Cartify/src/App.jsx`)
- Browse and search → API client: requests catalog
- Product details and reviews → API client: requests details
- Cart and checkout → API client: submits checkout
- Demo payment → API client: requests payment (evidence: `Cartify/src/pages/Payment.jsx`)
- Admin console → API client: requests changes (evidence: `Cartify/src/admin_Dashboard/pages/AdminProducts.jsx`)
- Admin analytics and operations → API client: requests analytics (evidence: `Cartify/src/admin_Dashboard/pages/AdminAnalytics.jsx`)
- API client → Express application: sends HTTP requests (evidence: `Cartify/src/api.js`)
- Express application → Customer API routes: mounts routes (evidence: `backend/app.js`)
- Express application → Admin API routes: mounts routes (evidence: `backend/app.js`)
- Customer API routes → Order operations: dispatches requests (evidence: `backend/routes/orderRoutes.js`)
- Customer API routes → Product operations: dispatches requests
- Admin API routes → Admin operations: mounts product routes (evidence: `backend/routes/admin/adminRoutes.js`)
- Order operations → Pricing rules: calculates totals (evidence: `backend/controllers/orderController.js`)
- Order operations → Order lifecycle: updates order status (evidence: `backend/controllers/orderController.js`)
- Order operations → PostgreSQL connection pool: reads and writes (evidence: `backend/controllers/orderController.js`)
- Product operations → PostgreSQL connection pool: queries catalog (evidence: `backend/controllers/productController.js`)
- Admin operations → PostgreSQL connection pool: manages products (evidence: `backend/controllers/admin/productController.js`)
- PostgreSQL connection pool → PostgreSQL database: connects to (evidence: `backend/config/db.js`)
- Customer API routes → Session authentication: protects requests (evidence: `backend/routes/orderRoutes.js`)
- Admin API routes → Session authentication: checks login (evidence: `backend/routes/admin/adminRoutes.js`)
